sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Martin Desruisseaux (Jira)" <j...@apache.org>
Subject [jira] [Commented] (SIS-509) Migrate the web site to another site generator tool
Date Fri, 19 Feb 2021 10:32:00 GMT

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

Mime
View raw message