[jira] [Comment Edited] (DOXIA-617) doxia-module-markdown: Add support for --- header section marks

["Herve Boutemy (Jira)" <ji...@apache.org>]

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

Herve Boutemy edited comment on DOXIA-617 at 1/4/23 5:14 PM:
-------------------------------------------------------------

initial implementation merged:
- in [https://github.com/apache/maven-doxia/commit/d2f824edef821dabf8ca6f27941750953b7f4ed6] for Doxia 2
- in https://github.com/apache/maven-doxia/commit/5d364e097968b01e30ddb74f2ad9259204be7a26 for Doxia 1

we can later completely change the whole metadata handling algorithm (to not rely on html parsing)


was (Author: hboutemy):
initial implementation merged in [https://github.com/apache/maven-doxia/commit/d2f824edef821dabf8ca6f27941750953b7f4ed6] for Doxia 1.x

we can later completely change the whole metadata handling algorithm (to not rely on html parsing)

> doxia-module-markdown: Add support for --- header section marks
> ---------------------------------------------------------------
>
>                 Key: DOXIA-617
>                 URL: https://issues.apache.org/jira/browse/DOXIA-617
>             Project: Maven Doxia
>          Issue Type: Improvement
>          Components: Module - Markdown
>            Reporter: Bertrand Martin
>            Priority: Major
>             Fix For: 1.12.0, 2.0.0-M5
>
>
> h1. Use Case
> It is "generally" accepted that document header metadata in Markdown (like _title_, _author_, etc.) must be specified inside a header section, delimited with 3 hypens:
> {noformat}
> ---
> title: My Doc Title
> author: Myself
> keywords: great,doc
> ---
> # Introduction
> ...
> {noformat}
> See:
> * https://bookdown.org/yihui/rmarkdown/html-document.html
> * https://pandoc.org/MANUAL.html#extension-yaml_metadata_block
> * https://github.com/vsch/flexmark-java/wiki/Extensions#yaml-front-matter
> Currently, the only supported syntax for document header metadata is the very same as above, but *without* the 3 hypens marking the header section:
> {noformat}
> title: My Doc Title
> author: Myself
> keywords: great,doc
> # Introduction
> ...
> {noformat}
> h1. Specification
> Enable the YAML Front Matter Extension of Flexmark so that such header is processed automatically (nothing to code here!)
> Keep the default behavior (we want backward compatibility) with the parsing of metadatas (which won't be affected by the YAML Front Matter parsing).
> h1. Doc
> Update the documentation on how to use Markdown in Doxia. This feature (document metadata) is currently not documented.
> We should have a small guide on how to use Markdown in Doxia, and its specific features (metadatas, macros, etc.)
> h1. Test
> Add corresponding unit tests and integration tests (for both old and new syntaxes)



--
This message was sent by Atlassian Jira
(v8.20.10#820010)