Perhaps we could backport the documentation conversion? I've found it difficult
to backport documentation changes as well.
-ck
On Thu, Aug 20, 2020, at 12:00, Ralph Goers wrote:
> That is almost true. The site plugin configuration in master was modified in
> master to support asciidoc. It is easy enough to add it to release-2.x.
>
> Ralph
>
> > On Aug 20, 2020, at 7:49 AM, Matt Sicker <boa...@gmail.com> wrote:
> >
> > I don't think you need to convert the format. The maven site plugin
> > supports multiple formats (we use multiple) for generating the site.
> >
> > As for translations, I used pandoc a while back to do the initial
> > conversion from xdoc to asciidoc, but the rest was done by hand.
> >
> > On Thu, 20 Aug 2020 at 09:09, Volkan Yazıcı <volkan.yaz...@gmail.com> wrote:
> >>
> >> Dang it! Really? I have just finished the translation, ~15 minutes ago,
> >> after spending the whole day. So where/how shall I place the AsciiDoc file?
> >> Will it be processed auto-magically? Do I need to push certain knobs?
> >>
> >> On Thu, Aug 20, 2020 at 4:03 PM Apache <ralph.go...@dslextreme.com> wrote:
> >>
> >>> Don’t convert whole files. You only need to convert where there is an
> >>> existing document that is xdoc that needs to be updated.
> >>>
> >>> Ralph
> >>>
> >>>> On Aug 19, 2020, at 11:53 PM, Volkan Yazıcı <volkan.yaz...@gmail.com>
> >>> wrote:
> >>>>
> >>>> Hello,
> >>>>
> >>>> I have started cherry-picking JsonTemplateLayout from master into
> >>>> release-2.x. There I was welcomed by a big surprise: documentation infra
> >>>> between master (AsciiDoc) and release-2.x (Xdoc, Markdown, Velocity) are
> >>>> totally different. Right now I am busy with (manually?) converting
> >>>> thousands of lines of AsciiDoc to Xdoc. Though I could not make Velocity
> >>>> Template literals work. Given the following input
> >>>>
> >>>> 200 #[[{
> >>>> 201 "mdc": "${json:mdcfoo}",
> >>>> ...
> >>>> 218 }]]#
> >>>>
> >>>> "./mvnw site -DskipTests" produces the following error:
> >>>>
> >>>> [ERROR] Failed to execute goal
> >>>> org.apache.maven.plugins:maven-pdf-plugin:1.2:pdf (pdf) on project log4j:
> >>>> Error during document generation: Error whenn parsing Velocity file
> >>>> /home/vy/Projects/log4j2/target/pdf/site.tmp/xdoc/manual/layouts.xml.vm:
> >>>> Encountered ":mdcfoo}\",\n \"exception\": {\n \"exception_class\":
> >>> \""
> >>>> at line 201, column 17 of
> >>>> /home/vy/Projects/log4j2/target/pdf/site.tmp/xdoc/manual/layouts.xml.vm
> >>>> [ERROR] Was expecting one of:
> >>>> [ERROR] "}" ...
> >>>> [ERROR] <DOT> ...
> >>>>
> >>>> Any ideas on how to fix it? (I prefer to avoid replacing every occurence
> >>> of
> >>>> a $ with ${dollar}, for obvious reasons.)
> >>>>
> >>>> Kind regards.
> >>>
> >>>
> >>>
> >
> >
> >
> > --
> > Matt Sicker <boa...@gmail.com>
> >
>
>
>
