Date: Thu, 7 Oct 2021 20:27:00 +0200 From: Sergio Carlavilla <carlavilla@freebsd.org> To: John Baldwin <jhb@freebsd.org> Cc: "Danilo G. Baio" <dbaio@freebsd.org>, dev-commits-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: git: 5a5db32f4a - main - Fix build after c8e8be58e580 Message-ID: <CAFwocyPs1FV1_YoRPafw2pMXRR7E2174UZhoWm4D7KYc9aFtpA@mail.gmail.com> In-Reply-To: <0595c299-55ed-17c4-74ac-16a804541473@FreeBSD.org> References: <202110062359.196NxFqS079143@gitrepo.freebsd.org> <0595c299-55ed-17c4-74ac-16a804541473@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--0000000000003ddb8d05cdc769fa Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Thu, 7 Oct 2021 at 18:23, John Baldwin <jhb@freebsd.org> 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=3D5a5db32f4a1e3f507cdc55f92d53e63= adbb4f022 > > > > commit 5a5db32f4a1e3f507cdc55f92d53e63adbb4f022 > > Author: Danilo G. Baio <dbaio@FreeBSD.org> > > AuthorDate: 2021-10-06 23:57:27 +0000 > > Commit: Danilo G. Baio <dbaio@FreeBSD.org> > > 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 =E2=80=9Casciidoctor [name-of-the-document]=E2=80=9D. Usually =E2= =80=9Casciidoctor _index.adoc=E2=80=9D 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=E2=80=A6 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=E2=80=99ll answer it this weekend :) [1] https://reviews.freebsd.org/D31926 [2] https://marketplace.visualstudio.com/items?itemName=3Dasciidoctor.asciidoct= or-vscode [3] https://asciidoclive.com/edit/scratch/1 --0000000000003ddb8d05cdc769fa--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAFwocyPs1FV1_YoRPafw2pMXRR7E2174UZhoWm4D7KYc9aFtpA>