In D30176#719940, @fel1x.mintchoco.development_gmail.com wrote:

In D30176#719268, @carlavilla wrote:

if no other member of the Doceng has a problem. It remains valid.
I am preparing a patch related to compilation. Give me a couple more days and I'll take a look at this patch.

Thank you, after this patch is applied, I will work on changing Makefiles that can be compiled on mac and Linux without making links

I see no problem in adding some guidance, e.g., installing bmake for non-BSDs system users. Though, IMHO, It would be better to have people using directly FreeBSD to do FreeBSD related work.

• s/without/with only comments
• Add a check before building books TOC.

Update to last tree revision.
Add many inputs from Ceri.

In D30718#691165, @ceri wrote:

default language cannot be disabled at this moment.
https://github.com/gohugoio/hugo/issues/6377

And that just feels like another reason I don’t like Hugo. It seems to bring only problems for us. Also for the list…

Add support for stylesheets.

In D30718#690992, @dbaio wrote:

This is nice to test/build a single document, only issue is that it won't use our template/css.
Just to know, these html's will be used where?

Seems fine.

In D30331#686215, @dbaio wrote:

I think for now is better skip pdf for articles/pgpkeys, it seems the issue is not the includes but its content.

See here:
https://github.com/asciidoctor/asciidoctor-pdf/issues/941

$ wc -l documentation/static/pgpkeys/*.key
      [...]
      66 documentation/static/pgpkeys/zi.key
      43 documentation/static/pgpkeys/zml.key
     100 documentation/static/pgpkeys/zont.key
   94964 total

Without articles/pgpkeys:

$ cd documentation
$ time make DOC_LANG="en" pdf
...
make DOC_LANG="en" pdf  218.75s user 3.15s system 99% cpu 3:41.94 total

Just articles/pgpkeys:

 $ time /usr/local/bin/ruby27 \
/usr/local/bin/asciidoctor-pdf \
-r ./shared/lib/man-macro.rb \
-r ./shared/lib/man-macro.rb \
-r ./shared/lib/git-macro.rb \
-r ./shared/lib/packages-macro.rb \
-r ./shared/lib/inter-document-references-macro.rb \
-r ./shared/lib/sectnumoffset-treeprocessor.rb \
--doctype=article -a skip-front-matter \
-a pdf-theme=default-with-fallback-font \
-o /usr/home/dbaio/FreeBSD/git/doc/documentation/public/en/articles/pgpkeys/article.pdf \
/usr/home/dbaio/FreeBSD/git/doc/documentation/content/en/articles/pgpkeys/_index.adoc
/usr/local/bin/ruby27 /usr/local/bin/asciidoctor-pdf -r  -r  -r  -r  -r  -r    3575.63s user 3.02s system 99% cpu 59:39.77 total

In D30331#686215, @dbaio wrote:

I've updated docs tree and applied this patch and I'm getting this error when not setting a language:

$ cd documentation
$ time make pdf
...
asciidoctor: ERROR: _index.adoc: line 50: include file not found: /usr/home/dbaio/FreeBSD/git/doc/documentation/shared/jp/mailing-lists.adoc
asciidoctor: ERROR: _index.adoc: line 51: include file not found: /usr/home/dbaio/FreeBSD/git/doc/documentation/shared/jp/teams.adoc
asciidoctor: ERROR: _index.adoc: line 52: include file not found: /usr/home/dbaio/FreeBSD/git/doc/documentation/shared/jp/urls.adoc
asciidoctor: ERROR: _index.adoc: line 72: include file not found: /usr/home/dbaio/FreeBSD/git/doc/documentation/content/ja/books/design-44bsd/{chapters-path}toc-figures.adoc
asciidoctor: ERROR: _index.adoc: line 74: include file not found: /usr/home/dbaio/FreeBSD/git/doc/documentation/content/ja/books/design-44bsd/{chapters-path}toc-tables.adoc
asciidoctor: WARNING: image to embed not found or not readable: /usr/home/dbaio/FreeBSD/git/doc/documentation/content/ja/books/design-44bsd/fig1.png
asciidoctor: WARNING: image to embed not found or not readable: /usr/home/dbaio/FreeBSD/git/doc/documentation/content/ja/books/design-44bsd/fig2.png
...
/usr/local/bin/asciidoctor-pdf  -r ./shared/lib/man-macro.rb  -r ./shared/lib/man-macro.rb  -r ./shared/lib/git-macro.rb  -r ./shared/lib/packages-macro.rb  -r ./shared/lib/inter-document-references-macro.rb  -r ./shared/lib/sectnumoffset-treeprocessor.rb  --doctype=book  -a skip-front-matter  -a pdf-theme=default-with-fallback-font  -o /usr/home/dbaio/FreeBSD/git/doc/documentation/public/zh-tw/books/porters-handbook/book.pdf  /usr/home/dbaio/FreeBSD/git/doc/documentation/content/zh-tw/books/porters-handbook/_index.adoc
asciidoctor: ERROR: failed to parse formatted text: It will have <code>MASTER_SITES</code> set to &#8220;<a href="https://gitlab.example.com&#8221" class="bare">https://gitlab.example.com&#8221</a>; and <code>WRKSRC</code> to <code>${WRKDIR}/bar-9c1669ce60c3f4f5eb43df874d7314483fb3f8a6-9c1669ce60c3f4f5eb43df874d7314483fb3f8a6</code>.
/usr/local/bin/asciidoctor-pdf  -r ./shared/lib/man-macro.rb  -r ./shared/lib/man-macro.rb  -r ./shared/lib/git-macro.rb  -r ./shared/lib/packages-macro.rb  -r ./shared/lib/inter-document-references-macro.rb  -r ./shared/lib/sectnumoffset-treeprocessor.rb  --doctype=book  -a skip-front-matter  -a pdf-theme=default-with-fallback-font  -o /usr/home/dbaio/FreeBSD/git/doc/documentation/public/ru/books/arch-handbook/book.pdf  /usr/home/dbaio/FreeBSD/git/doc/documentation/content/ru/books/arch-handbook/_index.adoc
asciidoctor: FAILED: input file /usr/home/dbaio/FreeBSD/git/doc/documentation/content/ru/books/arch-handbook/_index.adoc is missing
*** Error code 1

Stop.
make: stopped in /usr/home/dbaio/FreeBSD/git/doc/documentation
make pdf  4669.69s user 18.28s system 99% cpu 1:18:10.78 total

• Add installation of static/articles/* files in articles target
• Put tests of doc existence in pdf-*-targets

In D30331#683208, @ceri wrote:

One other note: the pgpkeys article takes about two hours to build on my (admittedly single-CPU 2GB RAM) machine - is that common and do we need to work around that somehow?

Small style fixes.

Built docs are now saved in matching public/lang/articles|books/ directory. Clean targets updated as well.

Seems fine IMHO.

• Switch to other theme to allow CJK and other fonts to be embedded. Our default theme is less good than the one provided by asciidoctor-pdf.
• Updates with Ceri's comments. I still have to save the pdf to a better suited directory.