[
https://issues.apache.org/jira/browse/SIS-509?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17286984#comment-17286984
]
Martin Desruisseaux commented on SIS-509:
-----------------------------------------
Wow it has been quick! I just tried and indeed the site looks the same, thanks
a lot! But I noticed that the {{*.mdtext}} source files have been translated to
something that looks like HTML. For example comparing:
* Original: https://svn.apache.org/repos/asf/sis/site/trunk/content/epsg.mdtext
* Converted:
https://raw.githubusercontent.com/kinow/sis-site-draft/master/source/epsg.md
The converted document is more difficult to read and edit. Is there a way to
configure Hugo for parsing the source files in a form close to the original
ones?
I will open the JIRA tickets, hopefully soon after we posted a report on the
developer mailing list and verified that other peoples are okay.
For the future work, all points listed above look very good to me, with one
nuance on converting HTML to markdown. We have two cases:
* 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).
* 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 propose to put conversion of current HTML documents to low priority for now.
> 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)
