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 22:28:00 GMT

    [ https://issues.apache.org/jira/browse/SIS-509?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17287811#comment-17287811
] 

Bruno P. Kinoshita commented on SIS-509:
----------------------------------------

>Thanks for the replacement of source markdown files. I browsed a few pages and everything
seem fine. Well done! I can send an email on the dev@... list if there is no other short-term
tasks planed.

No other tasks planned for now. But once it's live, I think we can
 * run spell checker through it (found a few ones but postponed fixing these)
 * run a link checker
 * update the site-management page
 * work on accessibility (why-not? I can take a look at this later)
 * mobile/responsive view (reminds me that I need to take another look at the geoapi site
for that  too)

>*About pages generated in HTML:* (...) If we have to do 90% HTML + 10% Markdown, wouldn't
it be simpler to do all in HTML for avoiding the complexity of mixing two languages?

I think so. I haven't looked at how the book is generated, but if it's producing the final
HTML version, and we are happy with this, we don't need to change it :) I'd be keen to look
if we can modernize it a bit, perhaps? Just CSS styling. What do you think?

>*About developer guide:* 

Happy to take a look at this one too later. At $work we use the default Python tools to produce
a user guide: [https://cylc.github.io/documentation/#the-cylc-user-guide]

It produces HTML and PDF, and works well for our case. If Docbook is able to produce the final
developer guide, without any issues with dependencies, build, and if it's easy for contributors,
we can leave it as is too. But the same I said above, if there's any UI/UX, styling improvements,
I'd be happy to help.

Thanks Martin! Let me know when the tickets are created or resolved. I can test the new-old
site when it's live :D

> 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