Render pages from Markdown #138

Nova issue

paul · 2018-02-07T21:18:33Z

paul comentou

2018-02-07 21:18:33 +00:00

I did preliminary tests, and having a prebuild job turning markdown to flat xhtml is easy.

However:
None of our pages is written in flat simple XHTML.

due to previous design choices almost every page has a multitude of specialised css classes added to its markup. Markdown is not capable of mapping those in a sensible manner. In most cases those classes do not really need to be assigned manually. Proper automatisation would either require assignment by the xsl processor, or a rewrite of the CSS files. I would prefer the latter.
We usually have a few custom attributes in the xhtml header, like for example the newsdate. Markdown files will have to be preprocessed, to support respective header lines.

ToDo

Design pandoc headers for news tags (translatable)
check header fields for author, title, translator, newsdate
find markdown compatible replacement for most common custom CSS classes
how to include the sidebar?
header field for body class

(transferred from Pauls Kan-Board)

I did preliminary tests, and having a prebuild job turning markdown to flat xhtml is easy. **However:** None of our pages is written in flat simple XHTML. 1. due to previous design choices almost every page has a multitude of specialised css classes added to its markup. Markdown is not capable of mapping those in a sensible manner. In most cases those classes do not really need to be assigned manually. Proper automatisation would either require assignment by the xsl processor, or a rewrite of the CSS files. I would prefer the latter. 2. We usually have a few custom attributes in the xhtml header, like for example the newsdate. Markdown files will have to be preprocessed, to support respective header lines. #### ToDo * Design pandoc headers for news tags (translatable) * check header fields for author, title, translator, newsdate * find markdown compatible replacement for most common custom CSS classes * how to include the sidebar? * header field for body class (transferred from Pauls Kan-Board)

paul adicionou os rótulos

feature-request

build

2018-02-07 21:18:33 +00:00

reinhard removeu a data limite 0001-01-01

2019-04-29 21:04:45 +00:00

reinhard referenciado esta issue

2020-05-13 13:37:15 +00:00

Many pages contain absolute links with fsfe.org #1378

max.mehl referenciado esta issue

2020-05-13 14:25:47 +00:00

Many pages contain absolute links with fsfe.org #1378

max.mehl comentou

2021-01-21 15:19:13 +00:00

Proprietário

In the Web Meetup 2021-01-19, we've concluded the following goals and ideas:

We want to start with simple pages, so standard news items and newsletters, to not have to overload the system from the start.
The goal is not to convert all existing pages to Markdown, but instead allow editors to use Markdown for new content.
We said that it makes most sense to convert a Markdown file to XHTML first, and then run this through our build system normally.
An open discussion is the choice of the Markdown dialect. We considered the dialects used by Gitea or Hugo to be the optimal choice to be friendly to new editors.
We probably need shortcodes for special tags like our modules or figures. Hugo's shortcodes can be an inspiration for the format, but eventually our converter has to understand it.

In the Web Meetup 2021-01-19, we've concluded the following goals and ideas: * We want to start with simple pages, so standard news items and newsletters, to not have to overload the system from the start. * The goal is not to convert all existing pages to Markdown, but instead allow editors to use Markdown for new content. * We said that it makes most sense to convert a Markdown file to XHTML first, and then run this through our build system normally. * An open discussion is the choice of the Markdown dialect. We considered the dialects used by Gitea or Hugo to be the optimal choice to be friendly to new editors. * We probably need shortcodes for special tags like our modules or figures. Hugo's shortcodes can be an inspiration for the format, but eventually our converter has to understand it.

Acesse para participar desta conversação.