first PR is online: https://github.com/asciidoctor/asciidoctor-maven-plugin explanations about the 2 ways of using asciidoctor (as an independant plugin or as a Maven site integration) should be easier to understand feedback welcome
I'll see how to have the changes also in http://asciidoctor.org/docs/asciidoctor-maven-plugin/ Then: if anybody want to add asciidoc as additionnal Markup language in MojoHaus parent pom, or any plugin, I think you can do it. Regards, Hervé Le jeudi 28 septembre 2017 05:06:51 UTC+2, Hervé Boutemy a écrit : > > Thank you Manfred: this is exactly the type of example I wanted to see. > Good news, it can be used as an additional source markup format to > maven-site-plugin (see > http://asciidoctor.org/docs/asciidoctor-maven-plugin/#maven-site-integration > for reference documentation on this scenario) > > So, yes, the maven plugin adds asciidoc support to Doxia (see > https://github.com/asciidoctor/asciidoctor-maven-plugin/tree/master/src/main/java/org/asciidoctor/maven/site > > for the integration code) > > and full +1 for me if anybody wants to add some pages in > *src/site/asciidoc*: we'll see later if we really migrate existing > content from other source formats. > After some successful test in on Mojohaus plugin, we could add the > configuration of this new format in parent pom. > > I think I'll open a PR to improve the explanations about this scenario: in > this scenario, the "asciidoctor-maven-plugin" artifact is not used as a > Maven plugin but as a Doxia module. That's where the explanation is > confusing for some people who better know the internals of > maven-site-plugin vs Doxia... :) > > Regards, > > Hervé > > 2017-09-28 3:32 GMT+02:00 Manfred Moser <[email protected]>: > >> Well the Maven plugin works with asciidoc... I use it for the complete >> site of the Android Maven Plugin >> >> http://simpligility.github.io/android-maven-plugin/ >> >> And github supports it for readme and such as well. >> >> And if you want to do a full site and esp towards pdf output it is >> generally better (a bit anyway). But for most simple use cases markdown is >> just fine and better known.Tooling is maybe a bit more common for markdown >> but there is plenty for asciidoc around as well. >> >> So my vote is +- 0 ;-) >> >> manfred >> >> >> On Tue, Sep 26, 2017 at 11:03 AM, Jochen Wiedmann < >> [email protected]> wrote: >> >>> On Thu, Sep 21, 2017 at 6:50 PM, 'Jörg Hohwiller' via mojohaus-dev >>> <[email protected]> wrote: >>> >>> > Therefore I just wanted to ask if other users think the same and would >>> > welcome to use *.adoc in advance to *.md on github (e.g. Readme.md, >>> > Contributing.md as well as in wikis). >>> > Otherwise I am fine with staying as is. >>> >>> Question: Does Doxia support adoc? >>> >>> jochen >>> >>> >>> -- >>> The next time you hear: "Don't reinvent the wheel!" >>> >>> >>> http://www.keystonedevelopment.co.uk/wp-content/uploads/2014/10/evolution-of-the-wheel-300x85.jpg >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "mojohaus-dev" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to [email protected]. >>> To post to this group, send email to [email protected]. >>> To view this discussion on the web visit >>> https://groups.google.com/d/msgid/mojohaus-dev/CAF8HOZL10R4tyD3R0SRYqa05rd0QGR4uLHRnt8%3Dc7H68kLKudg%40mail.gmail.com >>> . >>> For more options, visit https://groups.google.com/d/optout. >>> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "mojohaus-dev" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/mojohaus-dev/CABffhO4no9r%3D%3DXh0ei%3DkJHtN0%2B79R%2BcSjkK0-%3DGd-cosCr%3Dobw%40mail.gmail.com >> >> <https://groups.google.com/d/msgid/mojohaus-dev/CABffhO4no9r%3D%3DXh0ei%3DkJHtN0%2B79R%2BcSjkK0-%3DGd-cosCr%3Dobw%40mail.gmail.com?utm_medium=email&utm_source=footer> >> . >> >> For more options, visit https://groups.google.com/d/optout. >> > > Le jeudi 28 septembre 2017 05:06:51 UTC+2, Hervé Boutemy a écrit : > > Thank you Manfred: this is exactly the type of example I wanted to see. > Good news, it can be used as an additional source markup format to > maven-site-plugin (see > http://asciidoctor.org/docs/asciidoctor-maven-plugin/#maven-site-integration > for reference documentation on this scenario) > > So, yes, the maven plugin adds asciidoc support to Doxia (see > https://github.com/asciidoctor/asciidoctor-maven-plugin/tree/master/src/main/java/org/asciidoctor/maven/site > > for the integration code) > > and full +1 for me if anybody wants to add some pages in > *src/site/asciidoc*: we'll see later if we really migrate existing > content from other source formats. > After some successful test in on Mojohaus plugin, we could add the > configuration of this new format in parent pom. > > I think I'll open a PR to improve the explanations about this scenario: in > this scenario, the "asciidoctor-maven-plugin" artifact is not used as a > Maven plugin but as a Doxia module. That's where the explanation is > confusing for some people who better know the internals of > maven-site-plugin vs Doxia... :) > > Regards, > > Hervé > > 2017-09-28 3:32 GMT+02:00 Manfred Moser <[email protected]>: > >> Well the Maven plugin works with asciidoc... I use it for the complete >> site of the Android Maven Plugin >> >> http://simpligility.github.io/android-maven-plugin/ >> >> And github supports it for readme and such as well. >> >> And if you want to do a full site and esp towards pdf output it is >> generally better (a bit anyway). But for most simple use cases markdown is >> just fine and better known.Tooling is maybe a bit more common for markdown >> but there is plenty for asciidoc around as well. >> >> So my vote is +- 0 ;-) >> >> manfred >> >> >> On Tue, Sep 26, 2017 at 11:03 AM, Jochen Wiedmann < >> [email protected]> wrote: >> >>> On Thu, Sep 21, 2017 at 6:50 PM, 'Jörg Hohwiller' via mojohaus-dev >>> <[email protected]> wrote: >>> >>> > Therefore I just wanted to ask if other users think the same and would >>> > welcome to use *.adoc in advance to *.md on github (e.g. Readme.md, >>> > Contributing.md as well as in wikis). >>> > Otherwise I am fine with staying as is. >>> >>> Question: Does Doxia support adoc? >>> >>> jochen >>> >>> >>> -- >>> The next time you hear: "Don't reinvent the wheel!" >>> >>> >>> http://www.keystonedevelopment.co.uk/wp-content/uploads/2014/10/evolution-of-the-wheel-300x85.jpg >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "mojohaus-dev" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to [email protected]. >>> To post to this group, send email to [email protected]. >>> To view this discussion on the web visit >>> https://groups.google.com/d/msgid/mojohaus-dev/CAF8HOZL10R4tyD3R0SRYqa05rd0QGR4uLHRnt8%3Dc7H68kLKudg%40mail.gmail.com >>> . >>> For more options, visit https://groups.google.com/d/optout. >>> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "mojohaus-dev" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/mojohaus-dev/CABffhO4no9r%3D%3DXh0ei%3DkJHtN0%2B79R%2BcSjkK0-%3DGd-cosCr%3Dobw%40mail.gmail.com >> >> <https://groups.google.com/d/msgid/mojohaus-dev/CABffhO4no9r%3D%3DXh0ei%3DkJHtN0%2B79R%2BcSjkK0-%3DGd-cosCr%3Dobw%40mail.gmail.com?utm_medium=email&utm_source=footer> >> . >> >> For more options, visit https://groups.google.com/d/optout. >> > > Le jeudi 28 septembre 2017 05:06:51 UTC+2, Hervé Boutemy a écrit : > > Thank you Manfred: this is exactly the type of example I wanted to see. > Good news, it can be used as an additional source markup format to > maven-site-plugin (see > http://asciidoctor.org/docs/asciidoctor-maven-plugin/#maven-site-integration > for reference documentation on this scenario) > > So, yes, the maven plugin adds asciidoc support to Doxia (see > https://github.com/asciidoctor/asciidoctor-maven-plugin/tree/master/src/main/java/org/asciidoctor/maven/site > > for the integration code) > > and full +1 for me if anybody wants to add some pages in > *src/site/asciidoc*: we'll see later if we really migrate existing > content from other source formats. > After some successful test in on Mojohaus plugin, we could add the > configuration of this new format in parent pom. > > I think I'll open a PR to improve the explanations about this scenario: in > this scenario, the "asciidoctor-maven-plugin" artifact is not used as a > Maven plugin but as a Doxia module. That's where the explanation is > confusing for some people who better know the internals of > maven-site-plugin vs Doxia... :) > > Regards, > > Hervé > > 2017-09-28 3:32 GMT+02:00 Manfred Moser <[email protected]>: > >> Well the Maven plugin works with asciidoc... I use it for the complete >> site of the Android Maven Plugin >> >> http://simpligility.github.io/android-maven-plugin/ >> >> And github supports it for readme and such as well. >> >> And if you want to do a full site and esp towards pdf output it is >> generally better (a bit anyway). But for most simple use cases markdown is >> just fine and better known.Tooling is maybe a bit more common for markdown >> but there is plenty for asciidoc around as well. >> >> So my vote is +- 0 ;-) >> >> manfred >> >> >> On Tue, Sep 26, 2017 at 11:03 AM, Jochen Wiedmann < >> [email protected]> wrote: >> >>> On Thu, Sep 21, 2017 at 6:50 PM, 'Jörg Hohwiller' via mojohaus-dev >>> <[email protected]> wrote: >>> >>> > Therefore I just wanted to ask if other users think the same and would >>> > welcome to use *.adoc in advance to *.md on github (e.g. Readme.md, >>> > Contributing.md as well as in wikis). >>> > Otherwise I am fine with staying as is. >>> >>> Question: Does Doxia support adoc? >>> >>> jochen >>> >>> >>> -- >>> The next time you hear: "Don't reinvent the wheel!" >>> >>> >>> http://www.keystonedevelopment.co.uk/wp-content/uploads/2014/10/evolution-of-the-wheel-300x85.jpg >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "mojohaus-dev" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to [email protected]. >>> To post to this group, send email to [email protected]. >>> To view this discussion on the web visit >>> https://groups.google.com/d/msgid/mojohaus-dev/CAF8HOZL10R4tyD3R0SRYqa05rd0QGR4uLHRnt8%3Dc7H68kLKudg%40mail.gmail.com >>> . >>> For more options, visit https://groups.google.com/d/optout. >>> >> >> -- >> You received this message because you are subscribed to the Google Groups >> "mojohaus-dev" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To post to this group, send email to [email protected]. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/mojohaus-dev/CABffhO4no9r%3D%3DXh0ei%3DkJHtN0%2B79R%2BcSjkK0-%3DGd-cosCr%3Dobw%40mail.gmail.com >> >> <https://groups.google.com/d/msgid/mojohaus-dev/CABffhO4no9r%3D%3DXh0ei%3DkJHtN0%2B79R%2BcSjkK0-%3DGd-cosCr%3Dobw%40mail.gmail.com?utm_medium=email&utm_source=footer> >> . >> >> For more options, visit https://groups.google.com/d/optout. >> > > -- You received this message because you are subscribed to the Google Groups "mojohaus-dev" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/mojohaus-dev/eae9a6f9-6459-4186-881c-75447dbce86b%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
