Date: Sun, 31 Dec 2017 23:36:38 -0800 From: Eitan Adler <lists@eitanadler.com> To: Russell Haley <russ.haley@gmail.com> Cc: "freebsd-doc@freebsd.org" <doc@freebsd.org> Subject: Re: Books not building on fresh checkout Message-ID: <CAF6rxgns%2BXHTn=s1c7QkgvhaQax%2Bd-kLjmJJ=C75srMLwEyZag@mail.gmail.com> In-Reply-To: <CABx9NuSHEh26se4i92aiVPBVoy7f-Q2xCGwS1jNX_QT2epGfhg@mail.gmail.com> References: <CABx9NuQq3kxccoHjK=5C9Pax1paahNcW5jdKsPxvcL-jj2=Bgw@mail.gmail.com> <CAF6rxgk16ThSw8FsERTNk%2B-PDaVfvSbS_zaN9Lj9wNRdYYri=A@mail.gmail.com> <CABx9NuSmvs_Kux6c9uZoX6D13c%2BUxgPyUbeDNbqvMR90hbj8qA@mail.gmail.com> <CAF6rxg=gOMXO8dWtR_NVawdMMjXLRa8uMttoY7Amt9w1TkeNLw@mail.gmail.com> <CABx9NuSHEh26se4i92aiVPBVoy7f-Q2xCGwS1jNX_QT2epGfhg@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On 31 December 2017 at 19:31, Russell Haley <russ.haley@gmail.com> wrote: > On Sun, Dec 31, 2017 at 12:00 AM, Eitan Adler <lists@eitanadler.com> wrote: >> On 30 December 2017 at 23:57, Russell Haley <russ.haley@gmail.com> wrote: >>> On Sat, Dec 30, 2017 at 11:39 PM, Eitan Adler <lists@eitanadler.com> wrote: >>>> On 30 December 2017 at 23:36, Russell Haley <russ.haley@gmail.com> wrote: >>>>> Hi, >>>>> >>>>> I'm getting a build error on a fresh checkout. My base directory is >>>>> ~/freebsd. This is the same error that stumped me some months back. >>>>> Any advice would be grand. As follows: >>>>> >>>>> mkdir docs; svn co https://svn.freebsd.org/doc/head/ docs/ >>>> >>>> do you have the 'docproj' package installed? >>> >>> No I did not (but will shortly). Thank you! >> >> I would also encourage you to read the documentation primer. Available >> here: https://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer >> >> >> >> -- >> Eitan Adler > > Hello, Section 7.7.1 discusses using General Entities to reference > other chapters in the book. The section uses an example listing > chapter1.xml, chapter2.xml and chapter3.xml. An introductory section > explained that the books are now organized using a directory per > chapter and the files are now simply called chapter.xml. > > Does the above dichotomy mean the section should use an example of > chapter1/chapter.xml like below? I think that specific section is supposed to be an example. Take a look at en_US.ISO8859-1/books/handbook/book.xml and books/handbook/chapters.ent for how to add a chapter. What you intending to contribute? Are you trying to write specific new content or generally want to learn how the system works. Both are fine, but might have differing approaches for what to do next. -- Eitan Adler
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAF6rxgns%2BXHTn=s1c7QkgvhaQax%2Bd-kLjmJJ=C75srMLwEyZag>