[
https://issues.apache.org/jira/browse/MNGSITE-507?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17895372#comment-17895372
]
ASF GitHub Bot commented on MNGSITE-507:
----------------------------------------
kwin commented on PR #573:
URL: https://github.com/apache/maven-site/pull/573#issuecomment-2455318587
> Next diff: Code blocks from APT, not verbatim ones are lost, so is
autohighlight. Example: developers/committer-settings.html
Well, https://maven.apache.org/developers/committer-settings.html has the
following APT:
https://github.com/apache/maven-site/blob/923f866d01b9f54c436d3e30f1c2789b45b4affe/content/apt/developers/committer-settings.apt#L41-L60
According to
https://maven.apache.org/doxia/references/apt-format.html#verbatim-text this is
just verbatim text with a box around it.
This is converted to
https://github.com/apache/maven-site/pull/573/files#diff-ad6899066ecffca374fb2b9eb533e56c42e397026a9a577f78c42ac3fae9902cR36.
I see that the HTML generated out of the converted MD is lacking the
hightlighting and line number, but I think this is due to
https://issues.apache.org/jira/browse/MSKINS-245 because the HTML looks good to
me i.e. enclosed in {{<pre><code>...</code></pre>). In MD every verbatim text
is emitted in code blocks!
What exactly do you consider wrong here @michael-o ?
> Convert APT to markdown sources
> -------------------------------
>
> Key: MNGSITE-507
> URL: https://issues.apache.org/jira/browse/MNGSITE-507
> Project: Maven Project Web Site
> Issue Type: Improvement
> Reporter: Konrad Windszus
> Assignee: Konrad Windszus
> Priority: Major
>
> With the help of [doxia-converter
> 1.3|https://maven.apache.org/doxia/doxia-tools/doxia-converter/] it is now
> possible to automatically convert APT sources to markdown. In order to ease
> contribution with the well-known markdown format we should convert all APT
> sources currently located in
> https://github.com/apache/maven-site/tree/master/content/apt to markdown with
> that approach.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
