Although they seem to take it seriously I doubt that the solution will work seamlessly with the site plugin. Since AsciiDoctor is not interacting with Doxia in the way Doxia modules are supposed to, and since their proposals so far show no indication they plan to address that, I have to assume their plan is to create templates or css that emulate the default maven site theme. However, that would require that they also provide emulation for other maven site themes to be complete. Since we have customized our theme with definitions in the site.css, those would also have to be modified to match whatever AsciiDoctor does.
In short, I am not optimistic of a favorable outcome. 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]> >>
