maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Hervé Boutemy (JIRA) <j...@apache.org>
Subject [jira] [Comment Edited] (DOXIA-492) Add support for doxia macros in markdown documents.
Date Wed, 25 Nov 2015 07:25:11 GMT

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

Hervé Boutemy edited comment on DOXIA-492 at 11/25/15 7:24 AM:
---------------------------------------------------------------

SUCCESS: Integrated in doxia-all #175 (See [https://builds.apache.org/job/doxia-all/175/])
[DOXIA-492] fixed macro support, with unit test (hboutemy: [r1716285|http://svn.apache.org/r1716285])
* ./doxia/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownParser.java
* ./doxia/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownParserTest.java
* ./doxia/doxia-modules/doxia-module-markdown/src/test/resources/macro-toc.md



was (Author: hudson):
SUCCESS: Integrated in doxia-all #175 (See [https://builds.apache.org/job/doxia-all/175/])
[DOXIA-492] fixed macro support, with unit test (hboutemy: rev 1716285)
* ./doxia/doxia-modules/doxia-module-markdown/src/main/java/org/apache/maven/doxia/module/markdown/MarkdownParser.java
* ./doxia/doxia-modules/doxia-module-markdown/src/test/java/org/apache/maven/doxia/module/markdown/MarkdownParserTest.java
* ./doxia/doxia-modules/doxia-module-markdown/src/test/resources/macro-toc.md


> Add support for doxia macros in markdown documents.
> ---------------------------------------------------
>
>                 Key: DOXIA-492
>                 URL: https://issues.apache.org/jira/browse/DOXIA-492
>             Project: Maven Doxia
>          Issue Type: Improvement
>          Components: Module - Markdown
>    Affects Versions: 1.4
>            Reporter: Juergen Kellerer
>            Assignee: Hervé Boutemy
>             Fix For: 1.7
>
>         Attachments: maven-site-plugin-integration-test.patch, screen.png
>
>
> It would be nice if doxia macros could be supported also inside markdown documents (similar
to APT).
> Existing macros (especially snippet) is very useful, however with the power of maven
there's the ability to register own macros for a build process which enables reuse of resources
and improves dryness in general.
> A syntax which may work could be the following:
> * Block Level
> {noformat}
>    #`??MACRO_NAME MACRO_ARGS`
> {noformat}
> * Inline
> {noformat}
> `??MACRO_NAME MACRO_ARGS`
> {noformat}
> Reference: http://hackage.haskell.org/packages/archive/yesod-markdown/0.0/doc/html/Yesod-Markdown-Macros.html
> E.g. using "Texts" it works just from the Editor:
> !screen.png!
> When macros are not interpreted, they fallback to a code block, thus it's easy to edit
these sort of documents with one of the existing nice markdown editors.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message