Remember, if you use AsciiDoctor without the site plugin it could work just fine. But yes, the Log4J site has a lot of content. Also, we automatically convert the “manual” section of the site into a pdf book.
Ralph > On Apr 29, 2019, at 6:36 PM, Remko Popma <[email protected]> wrote: > > Yes, I like AsciiDoc. It is much richer than MarkDown. > The picocli site is much simpler than the Log4j site though. > > Looking at > https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/166, it > seems that the AsciiDoctor maintainers are taking the issue seriously so > that gives hope that they will be able to help come up with a solution. > >> On Tue, Apr 30, 2019 at 9:04 AM Matt Sicker <[email protected]> wrote: >> >> The CMS seems even harder to use. I think Remko uses Asciidoc for his >> picocli site. >> >> On Mon, Apr 29, 2019 at 18:55, Ralph Goers <[email protected]> >> wrote: >> >>> The alternative would be to not use Maven at all to build the web site, >> or >>> at least not the majority of the site. It is possible we could use it to >>> create the javadoc and a few other things, but there are other >> alternatives >>> for many of the site reports. Theoretically, we could just have the >> whole >>> site managed by the ASF CMS at https://cms.apache.org/logging/ < >>> https://cms.apache.org/logging/>, although I am not a fan of that at >> all. >>> >>> Ralph >>> >>>> On Apr 29, 2019, at 1:53 PM, Matt Sicker <[email protected]> wrote: >>>> >>>> I haven't exactly seen a better alternative to maven-site-plugin for >>> maven. >>>> >>>> On Mon, 29 Apr 2019 at 15:36, Ralph Goers <[email protected]> >>> wrote: >>>>> >>>>> Gary, if you want to contribute patches for AsciiDoctor go for it. I >>> simply don’t have time. They have basically admitted that when generating >>> the body AsciiDoctor ignores the Maven Site theme, which is the root of >> the >>> problem. I’m not even sure that their proposed solution of using an >>> AsciiDoctor extension would work since the site plugin uses Doxia which, >> as >>> I understand it, is requires Doxia modules to provide unrendered data to >> it >>> so that all the HTML is really being generated by Doxia. >>>>> >>>>> At this point I am convinced we have to switch back to Markdown or >> xdoc >>> where Markdown doesn’t work. Either that or we abandon the site plugin to >>> generate the Log4j web site. >>>>> >>>>> Ralph >>>>> >>>>>> On Apr 29, 2019, at 11:25 AM, Gary Gregory <[email protected]> >>> wrote: >>>>>> >>>>>> Based on the reply to my comment I just saw on the github page for >> the >>>>>> issue, it seems like the developer is willing to help, we just need >> to >>>>>> provide PRs or a description of what we'd like to change... >>>>>> >>>>>> Gary >>>>>> >>>>>> On Mon, Apr 29, 2019 at 12:48 PM Ralph Goers < >>> [email protected]> >>>>>> wrote: >>>>>> >>>>>>> The issue isn’t marked as fixed. The problem I am having is that >>> tables >>>>>>> are rendered without borders. This is because asciidoc doesn’t >>> include its >>>>>>> css file when building the site because the “normal” asciidoc css >>> would >>>>>>> break the site. Asciidoc generates tables with css class names to >>> generate >>>>>>> the borders and grids. According to the Jira issue other markup has >>> the >>>>>>> same issue. >>>>>>> >>>>>>> Ralph >>>>>>> >>>>>>>> On Apr 29, 2019, at 8:50 AM, Matt Sicker <[email protected]> wrote: >>>>>>>> >>>>>>>> I had converted them to asciidoc a while back because it provided >>> more >>>>>>>> syntactical features than markdown. Many of the files I converted >>>>>>>> weren't markdown but xdoc. >>>>>>>> >>>>>>>> Also, there was a new asciidoctor release just the other day. >> Unsure >>>>>>>> if it's related. >>>>>>>> >>>>>>>> On Mon, 29 Apr 2019 at 10:34, Ralph Goers < >>> [email protected]> >>>>>>> wrote: >>>>>>>>> >>>>>>>>> The master branch was converted to use AsciiDoctor. To be honest, >> I >>>>>>> don’t remember why. But after trying to create a new page with it I >>>>>>> discovered that AsciiDoctor simply doesn’t work properly with the >>> Maven >>>>>>> Site Plugin. See >>>>>>> https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/166 >> < >>>>>>> https://github.com/asciidoctor/asciidoctor-maven-plugin/issues/166 >>> . >>> As >>>>>>> such I believe the site documents in Master need to be converted >> back >>> to >>>>>>> Markdown. >>>>>>>>> >>>>>>>>> Ralph >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> Matt Sicker <[email protected]> >>>>>>>> >>>>>>> >>>>>>> >>>>>>> >>>>> >>>>> >>>> >>>> >>>> -- >>>> Matt Sicker <[email protected]> >>>> >>> >>> -- >> Matt Sicker <[email protected]> >>
