Re: [jakarta.ee-community] change bars for asciidoc documents?

[Wayne Beaton <wayne.beaton@xxxxxxxxxxxxxxxxxxxxxx>]

I've tried all sorts of things. None of the results are ideal. The best that we've come up with is to generate the html for the original and paste it into a Google Doc (my colleagues that run Windows use Word), then generate for the new version and paste it over top, and then use the diff tools there.

In terms of automated solutions, the best that I've come up with is to generate the HTML for both versions and use wdiff.

e.g., wdiff -i -w "<strike>" -x "</strike>" -y "<font color=\"green\">" -z "</font>" original.html latest.html > diff.html

The results are usable, but ugly when there is a lot of markup. I have had some success doing similar things with wdiff on the original Asciidoc file before generating, but the quality of the results vary depending on the amount of markup.

Adding proper diff to Asciidoctor would be a killer feature.

Wayne

On Wed, Jan 22, 2020 at 2:19 AM Bill Shannon <bill.shannon@xxxxxxxxxx> wrote:

Does anyone know what the state of the art is for adding change bars to
asciidoc documents?  I'd like to be able to take two versions of a document,
run them through a processor, and produce a third version, also in asciidoc
format, that includes change bars marking the changes from the first to the
second document.

A quick search turned up this issue against asciidoctor [1], which sounds
like the problem hasn't been solved yet.  Does anyone have better information?

This is going to be really helpful/essential when reviewing updated
specifications.  Reading the diff output of the asciidoc source code is not
really an effective approach.

Thanks!



[1] https://github.com/asciidoctor/asciidoctor/issues/1031
_______________________________________________
jakarta.ee-community mailing list
jakarta.ee-community@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-community

--

Wayne Beaton

Director of Open Source Projects | Eclipse Foundation, Inc.