Need advice to help me fix build process of translated documentation

[Edson Brandi]

Hello,

I'm working to finish translation of FDP Primer to pt_BR.ISO8859-1 , translation of this book started some years ago, but it never get completed until now :(

In last week i synchronized previous translated text with all changes that version of en_US.ISO8859-1 received in last years, and at this moment i'm working with review of spelling, i expect to have this stage finished in 1 week.

But before i can send it to project using send-pr , i need some help to deal with 3 "issues" that i found and that i'm not able to find a fix myself.

#### Issue 1 ####
- When i use "make lint" i don't receive any error , and all html files are builded normally when i run "make install" (http://server04.ebrandi.eti.br/pt_BR/books/fdp-primer/) , but i receive a "Error code 1" from tidy, is this normal? My build output:

$ make lint
/usr/local/bin/nsgmls -wempty -wunclosed -s -ifreebsd.urls.relprefix.4 -D /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/books/fdp-primer -D /usr/obj/usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer -c /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/share/sgml/catalog -c /usr/home/ebrandi/doc-br/share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog -c /usr/local/share/sgml/jade/catalog -c /usr/local/share/sgml/catalog.ports /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/book.sgml
[ebrandi at server04 ~/doc-br/pt_BR.ISO8859-1/books/fdp-primer]$ sudo make clean
rm -f            imagelib/callouts/1.png imagelib/callouts/2.png imagelib/callouts/3.png imagelib/callouts/4.png imagelib/callouts/5.png /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/autogen.ent /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/share/sgml/mirrors.xml /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/share/sgml/mirrors.xml.sort /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/share/sgml/mirrors.xml.sort.tmp $([ -f HTML.manifest ] && /usr/bin/xargs < HTML.manifest)  HTML.manifest ln*.html PLIST.html-split docbook.css LEGALNOTICE.html TRADEMARKS.html book.html PLIST.html docbook.css LEGALNOTICE.html TRADEMARKS.html
rm -rf imagelib

[ebrandi at server04 ~/doc-br/pt_BR.ISO8859-1/books/fdp-primer]$ sudo make install
/bin/cp -p /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/callouts/1.png  imagelib/callouts/1.png
/bin/cp -p /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/callouts/2.png  imagelib/callouts/2.png
/bin/cp -p /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/callouts/3.png  imagelib/callouts/3.png
/bin/cp -p /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/callouts/4.png  imagelib/callouts/4.png
/bin/cp -p /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/callouts/5.png  imagelib/callouts/5.png
/bin/rm -f docbook.css
/bin/cat /usr/home/ebrandi/doc-br/share/misc/docbook.css > docbook.css
Index is disabled or no index to generate.
/usr/bin/env  /usr/local/bin/jade -V html-manifest -ioutput.html -d /usr/home/ebrandi/doc-br/share/sgml/default.dsl -ifreebsd.urls.relprefix.4 -V %generate-legalnotice-link% -V %generate-docformat-navi-link% -ioutput.html.images   -D /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/books/fdp-primer -D /usr/obj/usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer -c /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/share/sgml/catalog -c /usr/home/ebrandi/doc-br/share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog -c /usr/local/share/sgml/jade/catalog -c /usr/local/share/sgml/catalog.ports -t sgml /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/book.sgml
/usr/bin/sed -i "" -e 's/	/\	/g' $(/usr/bin/xargs < HTML.manifest)
/usr/local/bin/tidy -wrap 90 -m -raw -preserve -f /dev/null -asxml  $(/usr/bin/xargs < HTML.manifest)
*** Error code 1 (ignored)
install -C  -o root -g wheel -m 444 $(/usr/bin/xargs < HTML.manifest) /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer
install -C  -o root -g wheel -m 444 docbook.css /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer
install -C  -o root -g wheel -m 444 imagelib/callouts/1.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/2.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/3.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/4.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/5.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
Index is disabled or no index to generate.
/usr/bin/env  /usr/local/bin/jade -V nochunks -ioutput.html -d /usr/home/ebrandi/doc-br/share/sgml/default.dsl -ifreebsd.urls.relprefix.4 -V %generate-legalnotice-link% -V %generate-docformat-navi-link% -ioutput.html.images   -D /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/images/books/fdp-primer -D /usr/obj/usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer -c /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/share/sgml/catalog -c /usr/home/ebrandi/doc-br/share/sgml/catalog -c /usr/local/share/sgml/docbook/dsssl/modular/catalog -c /usr/local/share/sgml/iso8879/catalog -c /usr/local/share/sgml/jade/catalog -c /usr/local/share/sgml/catalog.ports -t sgml /usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/book.sgml > book.html ||  (/bin/rm -f book.html && false)
/usr/bin/sed -i "" -e 's/	/\	/g' book.html
/usr/local/bin/tidy -wrap 90 -m -raw -preserve -f /dev/null -asxml  book.html
*** Error code 1 (ignored)
install -C  -o root -g wheel -m 444 book.html /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer
install -C  -o root -g wheel -m 444 docbook.css /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer
install -C  -o root -g wheel -m 444 imagelib/callouts/1.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/2.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/3.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/4.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts
install -C  -o root -g wheel -m 444 imagelib/callouts/5.png  /usr/share/doc/pt_BR.ISO8859-1/books/fdp-primer/imagelib/callouts

#### Issue 2 ####
- For some strange reason sgml markup <quote>…</quote> aren't getting translated into "…" , i'm not able to find what i need do to fix this. Any advice about what i`m doing wrong?
Example of this behavior:  http://server04.ebrandi.eti.br/pt_BR/books/fdp-primer/writing-style.html , name o Jordan K. Hubbard was supposed to be between quotes, sgml file are marked correctly.

#### Issue 3 ####
- I'm also having troubles with sgml markup <warning>…</warning> , this was supposed to be translated into a red box where paragraphs start with "Atenção:" , for some reason my html files are missing a ":" (colon).  
Example of this behavior: http://server04.ebrandi.eti.br/pt_BR/books/fdp-primer/preface-notes.html

####

My SGML files are available in GitHub:

https://github.com/doc-br/doc-br/ 

and updated version of translated sgml files are in branch doc-br-2012-fdp

Any help to fix above problems will be more than welcome :)

Thks

Edson