[jira] [Commented] (SLING-6955) Convert Sling website to JBake and gitpubsub

["Stefan Seifert (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/SLING-6955?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16072103#comment-16072103 ] 

Stefan Seifert commented on SLING-6955:
---------------------------------------

i've spotted some issues when browsing through the generated site (and making sure to insert back /ng/ in the URL on some of the links):
# there is not "changed last by" information on the bottom right side - was quite useful to see how old the information is
# anchor links to individual headlines/sections do not work - e.g. https://sling.apache.org/ng/documentation/the-sling-engine/architecture.html#request-processing. the anchor name for "request-processing" is not generated.
# on the old website when hovering over a section headline a paragraph symbol was displayed with a link to this headline - this was useful to get a direct link to this section.
# some glitches e.g. on https://sling.apache.org/ng/documentation/bundles/models.html compared with https://sling.apache.org/ng/documentation/bundles/models.html
## the TOC is missing (useful for very long documentation pages)
## some code snippts have a {{::java}} (or other) formatting hint. this hint is displayed and not interpreted.
## there is broken link showing {{*See also [SLING-4161](https://issues.apache.org/jira/browse/SLING-4161)*}}
## in the chapter "Annotation Reference" formatting of a code snipped is broken altogether
# on https://sling.apache.org/ng/documentation/bundles/context-aware-configuration/context-aware-configuration.html the code snippet formatting is broken as well in some chapters, e.g. "Describe configurations via annotation classes"

> Convert Sling website to JBake and gitpubsub
> --------------------------------------------
>
>                 Key: SLING-6955
>                 URL: https://issues.apache.org/jira/browse/SLING-6955
>             Project: Sling
>          Issue Type: Bug
>          Components: Site
>            Reporter: Bertrand Delacretaz
>            Assignee: Bertrand Delacretaz
>
> I've started experimenting with JBake to generate the Sling website. If that works well we might switch to that + gitpubsub to have a more flexible way to generate the site.
> My current experiment is at https://github.com/bdelacretaz/sling-jbake, at this point the site starts looking like the current one and many pages work well. 
> Internal links will need to be converted, all *.md files need a more complete "front matter" section, currently I have a stub for that, and I think images need to move under the assets folder.
> To play with that, generate the site with the bake.sh script (setup shamelessly copied from https://github.com/apache/incubator-tamaya-site)



--
This message was sent by Atlassian JIRA
(v6.4.14#64029)