From owner-freebsd-doc@freebsd.org Sun Jan 31 21:45:51 2021 Return-Path: Delivered-To: freebsd-doc@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 29FC04E8B9F for ; Sun, 31 Jan 2021 21:45:51 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4DTPlM0gWjz4k51 for ; Sun, 31 Jan 2021 21:45:51 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-lf1-f42.google.com (mail-lf1-f42.google.com [209.85.167.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) (Authenticated sender: carlavilla) by smtp.freebsd.org (Postfix) with ESMTPSA id 048AE7001 for ; Sun, 31 Jan 2021 21:45:51 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-lf1-f42.google.com with SMTP id i187so20112416lfd.4 for ; Sun, 31 Jan 2021 13:45:50 -0800 (PST) X-Gm-Message-State: AOAM5312IbXIVBJMg6v8KfmDZqD5d4zAUcyXw+rZYNAZB2qduJ8EWlRr 3cCPCDBTQ1Gb1AnLJZhlbPLsoOeZmY8eSV4ubS8= X-Google-Smtp-Source: ABdhPJx5Y6tPOMw+MLUNVuTEeY65/9wLfBBAnPmJsjWNu4mbSvJ9k9taIdJ8ZoHg7kuToicYfbUF39EDNyStWf1ZwMM= X-Received: by 2002:a19:6b13:: with SMTP id d19mr7536420lfa.74.1612129549523; Sun, 31 Jan 2021 13:45:49 -0800 (PST) MIME-Version: 1.0 References: In-Reply-To: From: Sergio Carlavilla Date: Sun, 31 Jan 2021 22:45:38 +0100 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: Problems following FDT Primer To: Dennis Friedrichsen Cc: freebsd-doc@freebsd.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Content-Filtered-By: Mailman/MimeDel 2.1.34 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 31 Jan 2021 21:45:51 -0000 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