Migration of our website and documentation is completed

[Glen Barber]

On Wed, Jan 27, 2021 at 03:19:46PM +0100, Ulrich Spörlein wrote:
> 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?

You need www/gohugo version 0.80.0_1 from ports (I do not think the
package is ready yet).

Also, I think we should turn off the 'run' target by default (included
in 'all'), as this is going to cause problems with integrating into CI.

Glen

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20210127/55195e8c/attachment.sig>