[
https://issues.apache.org/jira/browse/CONNECTORS-1495?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16385755#comment-16385755
]
David Ciamberlano commented on CONNECTORS-1495:
-----------------------------------------------
Hi,
I’ve installed jekyll on my PC and I’ve tried to (manually) convert a couple of
pages in markdown.
Here some preliminary considerations:
1. The site structure needs to be rethought in a way that better adapts to the
jekyll folder structure. In particular, we need to consider the multilingual
nature of the actual site. We need to consider also that in jekyll we can use
the tag or category system to group the pages.
2. How can we use (if it’s possible) the markdown syntax with the asiatic
languages?
3. Jekyll hasn’t a native search engine. As suggested by Piergiorgio, we could
use solr (like now). In that case we might need to modify the jekyll theme to
integrate the search form and the results page.
4. A manual conversion of the existing pages in markdown isn’t too difficult or
too long. The text structure is quite simple. The slowest (and boring) part is
related to the insertion of the inline images and the rebuild of the tables.
5. We should consider splitting the longest documents in smaller pieces (for
example the "end user documentation").
6. We need to select the jekyll plugins (syntax highlight, image manager,
tables, etc) to use for the site. The jekyll plugin list is here:
[https://jekyllrb.com/docs/plugins/|https://jekyllrb.com/docs/plugins/)]
> Brand new website
> -----------------
>
> Key: CONNECTORS-1495
> URL: https://issues.apache.org/jira/browse/CONNECTORS-1495
> Project: ManifoldCF
> Issue Type: New Feature
> Components: Site
> Affects Versions: ManifoldCF 2.9.1
> Reporter: Piergiorgio Lucidi
> Assignee: Piergiorgio Lucidi
> Priority: Major
> Fix For: ManifoldCF next
>
> Original Estimate: 480h
> Remaining Estimate: 480h
>
> The community decided to work on a brand new website:
> [http://mail-archives.apache.org/mod_mbox/manifoldcf-dev/201712.mbox/%3CCAHVHQx8odjgXMw%3DnhmSeDt0pYOUd0j%2BtkmMNtFnCJvHFcZwyEg%40mail.gmail.com%3E]
> The proposed technology is Jekyll but we have also to decide the website
> template to use.
> [~kamaci] suggested the [Apache CloudStack|https://cloudstack.apache.org/]
> template.
> [~molgun] proposed this approach:
> # Find a modern new static site generator like Jekyll [1]
> # Create a template
> # Start to use it in a specific path like
> [https://manifoldcf.apache.org/*new*]
> # Migrate our Forrest xml's to Markdown (we can automate this somehow)
> # Start to serve our new site on root path
> [1] [https://jekyllrb.com/docs/home/]
>
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
