From owner-freebsd-doc@FreeBSD.ORG Fri Oct 13 10:48:55 2006 Return-Path: X-Original-To: freebsd-doc@freebsd.org Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C485E16A403; Fri, 13 Oct 2006 10:48:55 +0000 (UTC) (envelope-from ganbold@micom.mng.net) Received: from publicd.ub.mng.net (publicd.ub.mng.net [202.179.0.88]) by mx1.FreeBSD.org (Postfix) with ESMTP id 62DE343D69; Fri, 13 Oct 2006 10:48:49 +0000 (GMT) (envelope-from ganbold@micom.mng.net) Received: from [202.179.0.164] (helo=[192.168.0.18]) by publicd.ub.mng.net with esmtpa (Exim 4.61 (FreeBSD)) (envelope-from ) id 1GYKaq-000GoQ-3v; Fri, 13 Oct 2006 18:48:44 +0800 Message-ID: <452F6F0C.9010302@micom.mng.net> Date: Fri, 13 Oct 2006 18:48:44 +0800 From: Ganbold User-Agent: Thunderbird 1.5.0.4 (X11/20060612) MIME-Version: 1.0 To: Giorgos Keramidas References: <452C4FA7.5080902@micom.mng.net> <20061011184309.GB64381@gothmog.pc> In-Reply-To: <20061011184309.GB64381@gothmog.pc> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Cc: freebsd-doc@freebsd.org, Natsagdorj Shagdar Subject: Re: Handbook translation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Oct 2006 10:48:55 -0000 Giorgos Keramidas wrote: > On 2006-10-11 09:57, Ganbold 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