Date: Wed, 11 Oct 2017 21:20:47 -0700 From: Russell Haley <russ.haley@gmail.com> To: doc@freebsd.org Cc: freebsd-ports@freebsd.org Subject: Re: Porters Handbook section 4.4 Message-ID: <CABx9NuRk0jg0m5ysZS4Jx0pEiPEX52=Y1yP9Yf5HGu1iM33UCg@mail.gmail.com> In-Reply-To: <20171011225205.GC96685@kduck.kaduk.org> References: <CABx9NuS6ie6fVwMh68wpRmRE6MsuGDfKQgLdVVZaeL_HJrKVOg@mail.gmail.com> <7b2f2464-5c35-e24a-2047-838c1a9e96a3@FreeBSD.org> <CABx9NuTUmeSU8yYkiYpR2vGYkhTV_MiHuNJYqZvLwJ9Q97B8Zg@mail.gmail.com> <alpine.BSF.2.21.1709290857480.9561@wonkity.com> <CABx9NuQrAsEXAXXmtZePQwn_x0Q7UywA73eggQW1mtDHmFdxxg@mail.gmail.com> <CABx9NuTqYh9A06vgALA6J3fB-_%2BMc5ZvR9Y4RYF7uh_wU4FSPg@mail.gmail.com> <20171009224825.GM96685@kduck.kaduk.org> <CABx9NuTw-_VEPDEwc6TKxsNCO2TuJrNKZfdHBf1wWye2_5Rn4w@mail.gmail.com> <20171011223253.GB96685@kduck.kaduk.org> <59DE9DD4.7010707@gmail.com> <20171011225205.GC96685@kduck.kaduk.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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@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@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@freebsd.org mailing list > https://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CABx9NuRk0jg0m5ysZS4Jx0pEiPEX52=Y1yP9Yf5HGu1iM33UCg>