Problems following FDT Primer

[driesm.michiels at gmail.com]

Hi doc team!

As a follow-up question, could we possibly addapt the textproj/docproj metaport to include these new dependencies?
I would put a diff in phabricator myself, but I am unsure how many of the current dependencies are actually needed in the port.
I hope we can get rid of the git dependency, as I would like to have git-lite installed but they conflict ...

Dries

PS: sorry for top posting.

> -----Original Message-----
> From: owner-freebsd-doc at freebsd.org <owner-freebsd-doc at freebsd.org> On
> Behalf Of Sergio Carlavilla
> Sent: Sunday, 31 January 2021 22:46
> To: Dennis Friedrichsen <dennis.r.friedrichsen at gmail.com>
> Cc: freebsd-doc at freebsd.org
> Subject: Re: Problems following FDT Primer
> 
> On Sun, 31 Jan 2021 at 22:35, Dennis Friedrichsen <
> dennis.r.friedrichsen at 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 in 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 at 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 …
> >
> > *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 at freebsd.org mailing list
> > https://lists.freebsd.org/mailman/listinfo/freebsd-doc
> > To unsubscribe, send any mail to "freebsd-doc-unsubscribe at 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’ll add a warning about this.
> 
> Bye!
> 
> [1] https://docs.freebsd.org/en/books/handbook/ports/#pkgng-intro
> _______________________________________________
> freebsd-doc at freebsd.org mailing list
> https://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"