Date: Fri, 13 Oct 2006 18:48:44 +0800 From: Ganbold <ganbold@micom.mng.net> To: Giorgos Keramidas <keramida@freebsd.org> Cc: freebsd-doc@freebsd.org, Natsagdorj Shagdar <natsag2000@yahoo.com> Subject: Re: Handbook translation Message-ID: <452F6F0C.9010302@micom.mng.net> In-Reply-To: <20061011184309.GB64381@gothmog.pc> References: <452C4FA7.5080902@micom.mng.net> <20061011184309.GB64381@gothmog.pc>
next in thread | previous in thread | raw e-mail | index | archive | help
Giorgos Keramidas wrote:
> On 2006-10-11 09:57, Ganbold <ganbold@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@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?452F6F0C.9010302>