I’m in the process of doing that now.
Ralph
> On Aug 20, 2020, at 9:15 AM, Carter Kozak <cko...@ckozak.net> wrote:
>
> 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>
>>>
>>
>>
>>
