Porters Handbook section 4.4

Fri Oct 27 03:26:25 UTC 2017

Hello,

I'm still stuck building the new chapters I wrote for the Porters
Handbook. I can't seem to get the system to "find" the file noted in
my previous post:

russellh at prescott:~/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook%
make
env XML_CATALOG_FILES="file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml
 file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/share/xml/catalog.xml
 file:///usr/home/russellh/FreeBSD/doc/share/xml/catalog.xml
file:///usr/local/share/xml/catalog" /usr/local/bin/xsltproc
--xinclude --nonet --maxvars 20000 --stringparam
latestrevision.timestamp "2017-09-29 03:54:21" --stringparam
latestrevision.committer "wosch"           --stringparam
latestrevision.number "50969"
http://www.FreeBSD.org/XML/share/xml/freebsd-xhtml-chunk.xsl
book.parsed.xml
I/O error : Attempt to load network entity
http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl
warning: failed to load external entity
"http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl"
compilation error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-xhtml-chunk.xsl
line 13 element import
xsl:import : unable to load
http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl
*** Error code 5

Stop.
make: stopped in
/usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook

I opened  file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-xhtml-chunk.xsl
and found the offending line. I can see the chunk.xsl file in a
browser, I can download the file with wget. I attempted to import it
from a local file as such (including numerous variations):

<xsl:import href="file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/chunk.xsl
"/>

 which only gets me:

russellh at prescott:~/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook%
make
env XML_CATALOG_FILES="file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml
 file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/share/xml/catalog.xml
 file:///usr/home/russellh/FreeBSD/doc/share/xml/catalog.xml
file:///usr/local/share/xml/catalog" /usr/local/bin/xsltproc
--xinclude --nonet --maxvars 20000 --stringparam
latestrevision.timestamp "2017-09-29 03:54:21" --stringparam
latestrevision.committer "wosch"           --stringparam
latestrevision.number "50969"
http://www.FreeBSD.org/XML/share/xml/freebsd-xhtml-chunk.xsl
book.parsed.xml
compilation error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-xhtml-chunk.xsl
line 13 element import
xsl:import : invalid URI reference file://chunk.xsl
*** Error code 5

Stop.
make: stopped in
/usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook

I also tried placing the file locally and removing the import line,
which gave me numerous errors as such:

runtime error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-common.xsl
line 21 element call-template
The called template 'inline.monoseq' was not found.
runtime error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-common.xsl
line 21 element call-template
The called template 'inline.monoseq' was not found.
runtime error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-common.xsl
line 21 element call-template
The called template 'inline.monoseq' was not found.
runtime error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-common.xsl
line 21 element call-template
The called template 'inline.monoseq' was not found.
runtime error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-common.xsl
line 21 element call-template
The called template 'inline.monoseq' was not found.
runtime error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-common.xsl
line 21 element call-template
The called template 'inline.monoseq' was not found.
runtime error: file
file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-common.xsl
line 21 element call-template
The called template 'inline.monoseq' was not found.
no result for book.parsed.xml
*** Error code 9

So, there it sits, incomplete. If anyone can help or point me in some
direction to look, I would be appreciative.

Russ

On Wed, Oct 11, 2017 at 9:20 PM, Russell Haley <russ.haley at gmail.com> wrote:
> Hi,
>
> This is a rough cut of three new chapters at the beginning of the
> book. I have left all the original content in place (I think). I
> haven't attempted to get all the markup but I seem to have worked
> through all my xml errors. Unfortunately I'm getting an error about a
> missing xsl file
> "http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl".
> I was able to manually download the file but I don't know where to put
> it yet.
>
> I'd like to get the new chapters to compile and at least take a stab
> at cleaning up the formatting before I put it on the review board.
> However, a patch file can be found here for now:
> https://github.com/RussellHaley/portershandbook .
>
> Build error:
>
> russellh at prescott:~/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook%
> make
> install /usr/home/russellh/FreeBSD/doc/share/xml/catalog-cwd.xml
> /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml
> echo '<!ENTITY base "..">' >>
> /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/autogen.ent
> env XML_CATALOG_FILES="file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml
>  file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/share/xml/catalog.xml
>  file:///usr/home/russellh/FreeBSD/doc/share/xml/catalog.xml
> file:///usr/local/share/xml/catalog" /usr/local/bin/xmllint --nonet
> --noent --valid --dropdtd --xinclude
> /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/book.xml
>> book.parsed.xml.tmp
> /bin/mv book.parsed.xml.tmp book.parsed.xml
> /usr/bin/sed 's|@@URL_RELPREFIX@@|https://www.FreeBSD.org|g' <
> book.parsed.xml > book.parsed.print.xml
> /usr/bin/sed -i '' -e 's|@@URL_RELPREFIX@@|../../../..|g'
> book.parsed.xml
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/1.png
>  imagelib/callouts/1.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/2.png
>  imagelib/callouts/2.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/3.png
>  imagelib/callouts/3.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/4.png
>  imagelib/callouts/4.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/5.png
>  imagelib/callouts/5.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/6.png
>  imagelib/callouts/6.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/7.png
>  imagelib/callouts/7.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/8.png
>  imagelib/callouts/8.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/9.png
>  imagelib/callouts/9.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/10.png
>  imagelib/callouts/10.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/11.png
>  imagelib/callouts/11.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/12.png
>  imagelib/callouts/12.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/13.png
>  imagelib/callouts/13.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/14.png
>  imagelib/callouts/14.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/15.png
>  imagelib/callouts/15.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/16.png
>  imagelib/callouts/16.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/17.png
>  imagelib/callouts/17.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/18.png
>  imagelib/callouts/18.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/19.png
>  imagelib/callouts/19.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/20.png
>  imagelib/callouts/20.png
> cp -f -p /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/../../../share/images/callouts/21.png
>  imagelib/callouts/21.png
> /bin/rm -f docbook.css
> /bin/cat /usr/home/russellh/FreeBSD/doc/share/misc/docbook.css >
> docbook.css
> env XML_CATALOG_FILES="file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook/catalog-cwd.xml
>  file:///usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/share/xml/catalog.xml
>  file:///usr/home/russellh/FreeBSD/doc/share/xml/catalog.xml
> file:///usr/local/share/xml/catalog" /usr/local/bin/xsltproc
> --xinclude --nonet --maxvars 20000 --stringparam
> latestrevision.timestamp "2017-09-29 03:54:21" --stringparam
> latestrevision.committer "wosch"          --stringparam
> latestrevision.number "50969"
> http://www.FreeBSD.org/XML/share/xml/freebsd-xhtml-chunk.xsl
> book.parsed.xml
> I/O error : Attempt to load network entity
> http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl
> warning: failed to load external entity
> "http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl"
> compilation error: file
> file:///usr/home/russellh/FreeBSD/doc/share/xml/freebsd-xhtml-chunk.xsl
> line 13 element import
> xsl:import : unable to load
> http://docbook.sourceforge.net/release/xsl-ns/current/xhtml/chunk.xsl
> *** Error code 5
>
> Stop.
> make: stopped in
> /usr/home/russellh/FreeBSD/doc/en_US.ISO8859-1/books/porters-handbook
>
>
> Cheers,
>
> Russ
>
> On Wed, Oct 11, 2017 at 3:52 PM, Benjamin Kaduk <bjk at freebsd.org> wrote:
>> On Wed, Oct 11, 2017 at 06:40:20PM -0400, Ernie Luzar wrote:
>>>
>>> Have nothing to add here, but this post peaked my interest about what
>>> your talking about.
>>>
>>> What is Phabricator?
>>
>> Phabricator is a project/software for doing code review of all sorts.
>> The FreeBSD documentation tree contains a lot of XML file, which can
>> be treated as code and subjected to pre-commit review as well.
>>
>>> What is its use in generating doc markup file for handbook changes?
>>
>> It doesn't help with converting non-marked-up text to XML form, it's
>> just a convenient place to post a draft patch and be able to make
>> line-by-line comments on it that are archived in a useful way.
>>
>> https://www.phacility.com/phabricator/ seems to be the upstream project's
>> home page.
>>
>> -Ben
>> _______________________________________________
>> 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"