sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Bruno P. Kinoshita (Jira)" <j...@apache.org>
Subject [jira] [Commented] (SIS-509) Migrate the web site to another site generator tool
Date Sat, 20 Feb 2021 08:07:00 GMT

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

Mime
View raw message