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/22 09:47:00 UTC
[jira] [Comment Edited] (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:comment-tabpanel&focusedCommentId=16748555#comment-16748555 ]
Hervé Boutemy edited comment on DOXIA-584 at 1/22/19 9:46 AM:
--------------------------------------------------------------
you're lucky: I'm currently in vacation :)
and this is IMHO a useful feature: as a user, I'd like it
On how to implement, I really have no clue: I'm not a Flexmark Markdown parser specialist. That's why I proposed you to provide a PR: you're at the same level of knowledge than me, if you are fluent with GitHub Pull Requests for the contribution process, and Maven for the source build...
I'll let you try: don't hesitate to ping me if I can help
was (Author: hboutemy):
you're lucky: I'm currently in vacation :)
and this is IMHO a useful feature: as a user, I'd like it
On how to implement, I really have no clue: I'm not a Flexmark Markdown parser specialist. That's why I proposed you to provide a PR: you're at the same level of knowledge than me, if you are fluent with GitHut Pull Requests for the contribution process, and Maven for the source build...
I'll let you try: don't hesitate to ping me if I can help
> 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
> Priority: Major
>
> 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)