Handbook translation

[Ganbold]

Giorgos Keramidas wrote:
> On 2006-10-11 09:57, Ganbold <ganbold at micom.mng.net> wrote:
>   
>> Hi,
>> I and my other colleagues are thinking to work on Mongolian translation 
>> of FreeBSD handbook.
>>     
>
> Cool :)
>
>   
>> So in this regard we have some questions:
>>
>> o What is the correct way to begin translation of FreeBSD handbook to
>>   other languages?
>>     
>
> o   One of the most useful things will be a 'mirror' or 'branch' of the
>     doc/ tree in a repository where you can collaborate with others,
>     prepare your changes, integrate them with the rest of the doc/ tree.
>
>     For one-person teams, like me working on doc/el_GR.ISO8859-7/ this
>     is not so important, since I can always rebase my own work on recent
>     doc/ snapshots.
>
> o   The next important thing will be a doc/FOO subdirectory where you
>     keep your work.  Pick a name that matches the existing scheme, and
>     stick to it.
>
> o   If you don't already have a doc-committer in your team, it will also
>     be nice to find someone who can review your changes, and push them
>     to our CVS tree.  I don't know Mongolian, so I can't do this but
>     other people from freebsd-doc may be able to help
>
>   
>> Are there any steps? Is there any docs/references which explains this?
>>     
>
> The `fdp-primer' book is a good starting point.  It contains a lot of
> useful information about how to work with the doc/ tree, what tools we
> use, and other stuff which is constantly updated.
>
>   
>> Which is preferable method? To work on clear text or work with sgml files?
>>     
>
> Ideally, it would be nice if you worked with SGML files, in a format
> that can be committed directly to our CVS tree.
>
> Having a repository with your work as a 'branch' of doc/ will make
> things much much easier if you go this way.
>
>   
>> I appreciate if somebody can give us some advices and recommendations.
>>     
>
> The best advice I can give you is:
>
>     * Set up a repository for your own work
>
>     * Start hacking the doc/mn_XXX/ tree already :)
>
>   
Thanks, Giorgos.

We have already set up repo.  I'm on RELENG_6.

# uname -an
FreeBSD daemon.micom.mng.net 6.2-PRERELEASE FreeBSD 6.2-PRERELEASE #6: 
Mon Sep 18 12:56:04 ULAST 2006     
root at daemon.micom.mng.net:/usr/obj/usr/src/sys/GDAEMON  i386

According to FDP-Primer I set env variables before checking sgml file. I 
have already installed  textproc/docproj.

setenv SGML_ROOT /usr/local/share/sgml
setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES 
${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES /usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES 
/usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES

However I see errors when I try to check original en_US documents:

daemon#pwd
/usr/doc/en_US.ISO8859-1
daemon# cd books/handbook/
daemon#
daemon# nsgmls -s colophon.sgml
nsgmls:colophon.sgml:7:0:E: no document type declaration; will parse 
without validation
nsgmls:colophon.sgml:18:26:E: general entity "tex" not defined and no 
default entity
daemon# nsgmls -s book.sgml
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:54:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-amsa.gml" (No such file or directory)
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:61:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-amsb.gml" (No such file or directory)
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:68:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-amsc.gml" (No such file or directory)
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:75:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-amsn.gml" (No such file or directory)
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:82:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-amso.gml" (No such file or directory)
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:89:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-amsr.gml" (No such file or directory)
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:96:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-box.gml" (No such file or directory)
nsgmls:/usr/local/share/sgml/docbook/4.1/dbcent.mod:103:0:E: cannot open 
"/usr/local/share/sgml/docbook/4.1/iso-cyr1.gml" (No such file or directory)

Am I missing something?

thanks,

Ganbold