Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 22 Apr 2012 14:08:20 -0300
From:      Edson Brandi <ebrandi@fugspbr.org>
To:        freebsd-doc@freebsd.org
Subject:   Need advice to help me fix build process of translated documentation 
Message-ID:  <F1E40222-1DF2-402D-BD43-93ECE092EB0D@fugspbr.org>

next in thread | raw e-mail | index | archive | help
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/i=
mages/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@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@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/i=
mages/callouts/1.png  imagelib/callouts/1.png
/bin/cp -p =
/usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/i=
mages/callouts/2.png  imagelib/callouts/2.png
/bin/cp -p =
/usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/i=
mages/callouts/3.png  imagelib/callouts/3.png
/bin/cp -p =
/usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/i=
mages/callouts/4.png  imagelib/callouts/4.png
/bin/cp -p =
/usr/home/ebrandi/doc-br/pt_BR.ISO8859-1/books/fdp-primer/../../../share/i=
mages/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/i=
mages/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/	/\&#09;/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/i=
mages/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/	/\&#09;/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>=85</quote> aren't getting =
translated into "=85" , 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>=85</warning> , =
this was supposed to be translated into a red box where paragraphs start =
with "Aten=E7=E3o:" , for some reason my html files are missing a ":" =
(colon). =20
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/=20

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=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?F1E40222-1DF2-402D-BD43-93ECE092EB0D>