You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Hervé Boutemy (JIRA)" <ji...@apache.org> on 2019/01/25 16:55:00 UTC
[jira] [Assigned] (DOXIA-584) Support rewriting multiple page
documentation crosslinks from .md to .html
[ https://issues.apache.org/jira/browse/DOXIA-584?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Hervé Boutemy reassigned DOXIA-584:
-----------------------------------
Assignee: Hervé Boutemy
> Support rewriting multiple page documentation crosslinks from .md to .html
> --------------------------------------------------------------------------
>
> Key: DOXIA-584
> URL: https://issues.apache.org/jira/browse/DOXIA-584
> Project: Maven Doxia
> Issue Type: New Feature
> Components: Module - Markdown
> Affects Versions: 1.7, 1.8
> Reporter: Josep Monés Teixidor
> Assignee: Hervé Boutemy
> Priority: Major
> Time Spent: 0.5h
> Remaining Estimate: 0h
>
> Doxia markdown module doesn't seem to be able to convert links to other markdown files, to links to the converted html files, by rewriting them. As a result, it cannot generate sets of crosslinked markdown files.
> There's a need for this feature (including myself), as it can be seen in the following stack overflow question: https://stackoverflow.com/questions/36708241/getting-doxia-module-markdown-to-rewrite-md-links
> The current workaround suggested in this stackoverflow is using markdown-page-generator-plugin instead (a different generation plugin), that has an option called {{transformRelativeMarkdownLinks}}. This still seems to be valid for doxia-module-markdown 1.8.
> {{markdown-page-generator-plugin}} can also provide some example on how to implement this. It seems to implement {{LinkResolver}}. See [https://github.com/walokra/markdown-page-generator-plugin/blob/master/src/main/java/com/ruleoftech/markdown/page/generator/plugin/FlexmarkLinkResolver.java]
>
> Setting this rewrite as an option, as {{markdown-page-generator-plugin}} does, seems sensitive as some documentations may legitimately link to Markdown files. If options want to be avoided, I suggest that rewrite is enabled only for relative links.
>
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)