Date: Sun, 14 Nov 2021 16:14:38 -0500 From: Jindong Li <jdpc86.li@gmail.com> To: Rocky Hotas <rockyhotas@firemail.cc> Cc: Sergio Carlavilla <carlavilla@freebsd.org>, freebsd-doc@freebsd.org Subject: Re: Use make to only build new files in the documentation Message-ID: <CAC%2BjGb%2BKVsccH1JWugKauLDNQOzhtt54dJ2E5b732aReA3Wypw@mail.gmail.com> In-Reply-To: <20211114211143.xxclm6t3lwo7vlq3@delpotro> References: <20211114183114.g6zw5zcampk2zx2s@delpotro> <CAFwocyNNPk3fCRLDrnSka8AxfQ--6ozqvwSD=ADaXKUvRJx-PQ@mail.gmail.com> <20211114211143.xxclm6t3lwo7vlq3@delpotro>
next in thread | previous in thread | raw e-mail | index | archive | help
--000000000000af020705d0c62eec Content-Type: text/plain; charset="UTF-8" hmm guys i'm kind of new to this, if I was going to apply this change (since it appears already committed?), what would I need to do? :) On Sun, Nov 14, 2021 at 4:12 PM Rocky Hotas <rockyhotas@firemail.cc> wrote: > On nov 14 19:46, Sergio Carlavilla wrote: > > > > Hi Rocky, > > > > You have two options here. > > > > First option is to build the documentation only with one language. > > For example, to build only the english language use: > > > > make run DOC_LANG="en" > > > > In the second option you can go to the folder of the modified document > and run: > > > > asciidoctor _index.adoc > > > > Let me know if this helps you. > > > > PS: In my laptop, building all the documents in English took 1'5 > > minutes. I'm using a Thinkpad X200. > > Hi! > Thank you for the suggestions. Building with English only is > significantly faster, I'm on an old `Intel(R) Core(TM)2 CPU' with 2 > cores, but it takes about less than 3 minutes to build. This is ok! > > I also tried with `asciidoctor _index.adoc', but it didn't work: > > % asciidoctor _index.adoc > asciidoctor: ERROR: _index.adoc: line 11: level 0 sections can only be > used when doctype is book > > and this occurs if _index.adoc is related to an article (for example > documentation/content/en/articles/rc-scripting) or a Handbook chapter > (a subdirectory of documentation/content/en/books/handbook). > > However, if Hugo's internal webserver is active (after a `make run'), > and I modify a _index.adoc file (and save it), it gets updated also as a > webpage, so I can instantly browse the updated contents. This is great > and may be another solution. > > Thank you! > > Rocky > > --000000000000af020705d0c62eec--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAC%2BjGb%2BKVsccH1JWugKauLDNQOzhtt54dJ2E5b732aReA3Wypw>