Re: Index ready (almost) for proposed-layout of ftp.debian.org and document database
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 debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: