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