[
https://issues.apache.org/jira/browse/SIS-509?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17287590#comment-17287590
]
Bruno P. Kinoshita commented on SIS-509:
----------------------------------------
> HTML pages generated automatically by some tools (list of EPSG codes, list of
> projection methods): We can modify those tools for generating markdown
> instead, if the final result looks good and the page size does not inflate
> too much (the list of EPSG codes is already 1.3 Mb).
Agree, we can definitely re-write these using any scripting language to produce
the final HTML. The sources can be a markdown file, or YAML file (if lists), or
even sqlite database (maybe zipped?).
>Developer guide: for this one I tried Markdown, Maven APT, Docbook and others,
>and finally came to HTML 5 (for now). This particular document is more in the
>spirit of a book than a web site. I would like to be a little bit closer to
>semantic than what Markdown can provide (e.g. in HTML we do not said _"show
>this text in italic"_. Instead we said _"this text is a citation"_ or _"this
>text is emphasis"_). Docbook provides semantic, but it is yet another language
>to learn for little gain (I think) compared to HTML 5.
I helped with some building tools for a book (the performance of open source
software) that used pandoc. I used Docbook for an old project, but I think
pandoc was easier to produce multiple formats with few modifications. Any of
these tools would be fine for me, and I'd be happy to help.
I think these two can become new Jira issues and be implemented later?
> Migrate the web site to another site generator tool
> ---------------------------------------------------
>
> Key: SIS-509
> URL: https://issues.apache.org/jira/browse/SIS-509
> Project: Spatial Information Systems
> Issue Type: Task
> Components: Web site
> Reporter: Martin Desruisseaux
> Priority: Blocker
>
> The Apache CMS is reaching end-of-life, and projects need to move their
> websites onto a different option. More information there:
> * [Managing your project web site|https://infra.apache.org/project-site.html]
> * [Migrate your project website from the Apache
> CMS|https://cwiki.apache.org/confluence/display/INFRA/Migrate+your+project+website+from+the+Apache+CMS]
> (wiki)
> * [SIS staging
> repository|https://svn.apache.org/repos/infra/websites/staging/sis/trunk/content/]
> * [SIS production
> repository|https://svn.apache.org/repos/infra/websites/production/sis/content/]
> About the tools, two candidates (among others) are [Hugo|https://gohugo.io/]
> and [JBake|https://jbake.org/]. The later is in Java.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
