[TRANSLATION: xml/quick-start-pkg.en.xml] new file

I don't reproduce it here, since you'll find it in the cvs tree, just 
issue a:

cvs update -dP

in the xml directory.

I'll give you here the whole process, since it will be an example of 
how to do it entirely:

To make it in your language:

1 - Save quick-start-pkg.en.xml to quick-start-pkg.xx.xml where xx is 
your language code

2 - Change the 3 rd line to reflect your language xx instead of en in 
lang="en"

3 - Translate it (pretty obvious)

4 - Change the Makefile to add your language on the line LANGUAGES = en 
xx

5 - Change the navigation bar in doc

Copy the line:

   "doc/quick-start-pkg/index.php?phpLang=en", "Packaging Tutorial",

you'll find into xml/web/doc/nav.en.inc into xml/web/doc/nac.xx.inc at 
the same place, change the language: phpLang=xx and translate Packaging 
Tutorial into your language.

6 - Check misspelling

Return to xml/quick-start-pkg/. Execute:

make clean
make && make install

Move to xml/web/doc/quick-start-pkg/
Add to cvs all the files with xx in the extension, here it is:

cvs add example.xx.php header.xx.inc howtostart.xx.php index.xx.php 
quick-start-pkg.xx.html

Move to xml/scripts/installer/dmg/doc/quick-start-pkg/
Add to cvs all the files with xx in the extension, here it is:

cvs add quick-start-pkg.xx.html

If you don't have access to Apache on your system, open:

xml/web/doc/quick-start-pkg/quick-start-pkg.fr.html

in your web browser, click on the page, ctrl-a to select all, ctrl-c to 
copy, open TextEdit, ctrl-v to paste the whole page, then ctrl: to 
check spelling. Of course, you can do it under X11, but the 
spellchecker under Mac OS X is better.

Read carefully the page in TextEdit, notice all misspelling you find in 
the page both with the check speller or with your eyes, and report them 
in the xml file. Best way to do it is to have the xml file and the text 
file open simultaneously in their respective editor and correct the xml 
file word by word.

If you have access to Apache, merely copy the doc directory you'll find 
inside xml/doc inside your local Apache and load the php file. This 
way, you can also have an idea how the page will be viewed on Fink web 
site; otherwise the process is the same, except that you'll have to 
deal with each page. Better to view the misspelling, since you have to 
read a shorter text.

  7 - Clean your tree

Move to xml/quick-start-pkg, execute:

make clean

8 - Add the new file to cvs

Move to xml/quick-start-pkg and execute:

cvs add quick-start-pkg.xx.xml

9 - Commit the file

cvs ci -m "Adding quick-start-pkg.xx.xml" quick-start-pkg.xx.xml

10 - Make the html, php, etc... files

make && make install

11- Commit the whole tree

Move to xml

cvs ci -m "Adding quick-start-pkg.xx.xml"

Note: since you've added to cvs all the new files in xml/web/doc and 
scripts/installer/dmg/... during step 7, you don't have to add anything 
else here.

12 - Activate the change on the Fink web site

Open a new terminal window (not necessary, but handy if you have to 
redo the process).
Type:

ssh [email protected]

Enter your passphrase when asked for.

Then execute:

cd /home/groups/f/fi/fink/htdocs
./update.sh

Wait till it is finished, but no more, since you'll block the access to 
others:

Then execute:

exit

13 - Check the result on the Fink web site

14 - Correct any glitches if they exist (i.e. file not added to cvs, 
commit omitted, misspelling, etc...)


Hopefully I did not miss something.

For brand new doc, i.e. when documents and directory do not exist at 
all, same except that you have to create also the directories (in xml, 
web/doc eventually and scripts) and add them via cvs add.

Michèle
<http://micmacfr.homeunix.org>