Migration of our website and documentation is completed

[Ulrich Spörlein]

On Tue, 2021-01-26 at 00:51:46 +0100, Sergio Carlavilla wrote:
>Happy hacking, please let the Doc WG know if you have any issue and
>suggestion. Also, keeping FreeBSD the best document is everyone's
>responsibility.

Hi, thanks for all the work. I'm trying to see why the Cirrus CI runs 
have failed and noticed the changed build instructions and have some 
more questions.

1. The "copy" of shared is clearly a bug, right? If anything this should 
be sym-linked and you should commit that symlink to git to avoid that 
bootstrap setup.

2. Using the instructions and packages still doesn't work for Cirrus, a 
run is here: https://cirrus-ci.com/task/6022204498378752 and it bails 
out with:

cd documentation && make move-shared && make generate
cp -R ../shared ./shared
---------------------------------------------------------------
Building the documentation
---------------------------------------------------------------
/usr/local/bin/python3.7 ./tools/books-toc-parts-creator.py -l en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr
/usr/local/bin/python3.7 ./tools/books-toc-creator.py -l en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr
/usr/local/bin/python3.7 ./tools/books-toc-figures-creator.py -l en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr
/usr/local/bin/python3.7 ./tools/books-toc-tables-creator.py -l en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr
/usr/local/bin/python3.7 ./tools/books-toc-examples-creator.py -l en,es,pt-br,de,ja,zh-cn,zh-tw,ru,el,hu,it,mn,nl,pl,fr
/usr/local/bin/hugo --minify
Start building sites …
ERROR 2021/01/27 14:10:57 Unsupported asciidoctor extension was passed in. Extension `../shared/lib/man-macro.rb` ignored.
ERROR 2021/01/27 14:10:57 Unsupported asciidoctor extension was passed in. Extension `../shared/lib/inter-document-references-macro.rb` ignored.
ERROR 2021/01/27 14:10:57 Unsupported asciidoctor extension was passed in. Extension `../shared/lib/sectnumoffset-treeprocessor.rb` ignored.
ERROR 2021/01/27 14:10:57 Unsupported asciidoctor extension was passed in. Extension `../shared/lib/packages-macro.rb` ignored.
...


What's missing here?
Cheers
Uli