Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 31 Dec 2017 19:31:37 -0800
From:      Russell Haley <russ.haley@gmail.com>
To:        Eitan Adler <lists@eitanadler.com>
Cc:        "freebsd-doc@freebsd.org" <doc@freebsd.org>
Subject:   Re: Books not building on fresh checkout
Message-ID:  <CABx9NuSHEh26se4i92aiVPBVoy7f-Q2xCGwS1jNX_QT2epGfhg@mail.gmail.com>
In-Reply-To: <CAF6rxg=gOMXO8dWtR_NVawdMMjXLRa8uMttoY7Amt9w1TkeNLw@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>

next in thread | previous in thread | raw e-mail | index | archive | help
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?

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [
<!ENTITY chapter.1 SYSTEM "chapter1/chapter.xml">
<!ENTITY chapter.2 SYSTEM "chapter2/chapter.xml">
<!ENTITY chapter.3 SYSTEM "chapter3/chapter.xml">
<!-- And so forth -->
]>

Thanks,

Russ



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