manifoldcf-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "David Ciamberlano (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (CONNECTORS-1495) Brand new website
Date Mon, 05 Mar 2018 08:08:00 GMT

    [ 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)

Mime
View raw message