Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 31 Jan 2021 22:45:38 +0100
From:      Sergio Carlavilla <carlavilla@freebsd.org>
To:        Dennis Friedrichsen <dennis.r.friedrichsen@gmail.com>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: Problems following FDT Primer
Message-ID:  <CAFwocyMqfyzBWxV4cBrUgukgyWyBwWgOJO6NqmpqOoP0vF0NUA@mail.gmail.com>
In-Reply-To: <CAAvGEZMs_TJzPyUaj8NAQ6MnuvPWqv5_trD1JF09YQ4nONzuiw@mail.gmail.com>
References:  <CAAvGEZMs_TJzPyUaj8NAQ6MnuvPWqv5_trD1JF09YQ4nONzuiw@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, 31 Jan 2021 at 22:35, Dennis Friedrichsen <
dennis.r.friedrichsen@gmail.com> wrote:

> Hello,
>
> I am interested in becoming involved in submitting fixes for
> documentation.  Long-time user and I've written a couple PRs in the past.
>
> I'm trying to follow the setup instructions here:
> https://docs.freebsd.org/en/books/fdp-primer/
> (specifically the Quick Start)
>
> I have a FreeBSD 12.2 fresh install.  I installed the required packages i=
n
> step 1. (Also did the optional packages in step 2).  I ran the git clone.
> Then I tried to build the documentation and ran into this error:
>
> ------------------------
>
> denny@freebsd12dot2doc:~/src/freebsd/doc/documentation % make
>
> ---------------------------------------------------------------
>
> 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 =E2=80=A6
>
> *ERROR* 2021/01/31 09:27:23 Unsupported asciidoctor extension was passed
> in. Extension `../shared/lib/man-macro.rb` ignored.
>
> ------------------
>
> Any help or nudge in the right direction is appreciated.  Not sure if I'm
> doing something wrong or maybe just missing a package.
>
> Thank you,
> Dennis
>
> --
> Dennis R. Friedrichsen
> _______________________________________________
> freebsd-doc@freebsd.org mailing list
> https://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
>
Hi Dennis,

Thanks for your interest in the documentation.

You need to use the latest repos and install the last version of Hugo.

To use the latest repos follow this guide[1], the section 4.4.2

Tomorrow I=E2=80=99ll add a warning about this.

Bye!

[1] https://docs.freebsd.org/en/books/handbook/ports/#pkgng-intro



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAFwocyMqfyzBWxV4cBrUgukgyWyBwWgOJO6NqmpqOoP0vF0NUA>