Re: git: 5a5db32f4a - main - Fix build after c8e8be58e580

On Thu, 7 Oct 2021 at 18:23, John Baldwin <[email protected]> wrote:

> On 10/6/21 4:59 PM, Danilo G. Baio wrote:
> > The branch main has been updated by dbaio:
> >
> > URL:
> https://cgit.FreeBSD.org/doc/commit/?id=5a5db32f4a1e3f507cdc55f92d53e63adbb4f022
> >
> > commit 5a5db32f4a1e3f507cdc55f92d53e63adbb4f022
> > Author:     Danilo G. Baio <[email protected]>
> > AuthorDate: 2021-10-06 23:57:27 +0000
> > Commit:     Danilo G. Baio <[email protected]>
> > CommitDate: 2021-10-06 23:57:27 +0000
> >
> >      Fix build after c8e8be58e580
>
> It used to be possible to use 'make' in individual books or articles to
> test
> things, and also to only build just html versions and not be required to
> build PDF.  Apparently our new system doesn't permit either of those, so I
> gave up on trying to test this pre-commit.
>
> --
> John Baldwin


> Hi John,

This is completely true, at the Doceng we are aware of this problem and we
are working on a solution. In this patch[1] each document would be handled
as an unit. What this means? This means that you can enter the folder and
execute “asciidoctor [name-of-the-document]”. Usually “asciidoctor
_index.adoc”

So, when this patch will be merged, you will have three options to build
the documents:

1. Build the complete documentation.
2. Build only the document that you touched.
3. Use a plugin in any IDE to see in realtime the changes. In my case (with
this patch[1] applied to my local) I used Visual Studio Code with this
plugin [2]

And, what can you do in the meantime? Well… you can continue using the
documentation as is. Or you can use AsciiDoctorLive[3].

Sorry for the inconvenience.

Bye! Hope this helps.

PS: I have an email to answer about recording some videos to help people to
see how to configure the tools. I’ll answer it this weekend :)

[1] https://reviews.freebsd.org/D31926
[2]
https://marketplace.visualstudio.com/items?itemName=asciidoctor.asciidoctor-vscode
[3] https://asciidoclive.com/edit/scratch/1