On Mon, May 20, 2002 at 09:43:58AM +0200, Javier Fern�ndez-Sanguino Pe�a wrote: > On Sun, May 19, 2002 at 02:16:04AM +0200, Denis Barbier wrote: > > > I did not have time to finish, and will work tomorrow on following items: > > > * divide by languages (i.e. put English files under en/, etc) > > > * fix broken links > > > * adapt Javier's index > > > > These changes are in, it now looks pretty good from my point of view > > (indices are only available in English and French). > > I would like to add the FAQ and a link to the Installation Manual. > > These pages could then fit on CD#1. > > > Umm.. That *is* pretty good.
Thanks :) I have resurrected your project/ subdirectory to help adding other parts (e.g. FAQ) if needed. http://people.debian.org/~barbier/doc-debian-intro/ > However, you do not generate the index automatically. I'm going to try to > have a new index.pl ready that you can (through command line switches) tell > which sections to include. But is there a reason to generate index files? There is no list of languages or similar features, so it is essentially static. Moreover, how do your script support i18n? I was thinking of adding index.wml somewhere under webwml/english/ and request for translations. Thus translators could be aware of changes in English index file as with any other file. > > Scripts are available under > > http://people.debian.org/~barbier/doc-debian-intro/ > > Put all the files in a directory, edit make.sh and change cvsdir to point > > to webwml root directory, then run > > ./make.sh; ./install.sh > > and all HTML files should go under www/ directory. > > > > IMHO this could probably make it as a documentation-only patch to > debian-cd. In any case I would also add txt files, generated with the > scripts I made. Txt files should indeed be generated. Raphael Hertzog told me that the current way of dealing with these documents (i.e. by downloading them from f.d.o/debian/doc/) is mostly historical, an alternative way may be to * include these documents in a package * push this package into woody Of course, these decisions are out of his control. But IMO it is worth trying this solution, we could then have documentation on CD#1 and fix other issues later. Josip, if we put these HTML and TXT files online, is there a chance you incorporate them into your doc-debian package? We could then try to convince ajt to let it enter woody in order for these docs (and their translations) to go into CD#1. Denis -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
