Re: Debian documentation
On Mon, Jun 24, 2002 at 03:49:05PM +0700, Rahmat M. Samik-Ibrahim wrote:
> Osamu Aoki wrote:
>
> > On Fri, Jun 21, 2002 at 08:48:39AM +0700, Rahmat M. Samik-Ibrahim wrote:
> >> On Wed, Jun 19, 2002 at 11:27:01PM -0700, Osamu Aoki wrote:
> >>> I think "Debian specific documents" needs to be better organized for
> >>> woody+1 in /usr/share/doc/DEBIAN/, just like HOWTO and RFC.
> >> It would be nice, if it is split based on language. BTW, my
> >> interest is to make an automated compressed tarball
> >> (10-30 Mbytes) that have everything I need, offline.
>
> >> See also http://debid.vLSM.org as an idea.
> > I did not understand the merit well??
> > You mean tar-ball of html and pdf files? Or source files?
>
> Basically, it would be nice if the document directory is categorized
> based on language and file types. For example, at the top level would be
> like "doc.en", "doc.ca", "doc.cs", "doc.ja", "doc.zh-hk", "doc.zh-tw", etc.
> Then, there will be "file types" directories like "html", "pdf", "XML",
> "etc".
>
> As I have written before, I am interested to make html tarballs of
> one type of language only (english html). See also:
> http://bebas.vLSM.org/v05/Linux/debid.tar.bz2
>
> It would be simpler to extract, if they are categorized as suggested above.
> Sure, I can (and currently use) filters. But to filter Chinese, I currently
> have to filter:
> *.zh-cn.html, *.zh-cn.info, *.zh-cn.txt,
> *-zh-cn.html, *-zh-cn.info, *-zh-cn.txt,
> *.zh-hk.html, *.zh-hk.info, *.zh-hk.txt,
> *-zh-hk.html, *-zh-hk.info, *-zh-hk.txt,
> *.zh-tw.html, *.zh-tw.info, *.zh-tw.txt,
> *-zh-tw.html, *-zh-tw.info, *-zh-tw.txt,
> *.zh_TW.html, *.zh_TW.info, *.zh_TW.txt,
> *-zh_TW.html, *-zh_TW.info, *-zh_TW.txt,
> *.zh_tw.html, *.zh_tw.info, *.zh_tw.txt,
> *-zh_tw.html, *-zh_tw.info, *-zh_tw.txt,
I think they should drop document into as:
/usr/share/doc/Debian/$(MANUAL)/index.zh-{tw,hk,cn}.html
Must be at one location to be used by apache auto language
select.
/usr/share/doc/Debian/zh_{TW,HK,CN}/$(MANUAL).txt
/usr/share/doc/Debian/zh_{TW,HK,CN}/$(MANUAL).info*
(I want to do wiythout info if it is not a problem.)
/usr/share/doc/Debian/zh_{TW,HK,CN}/$(MANUAL).ps
/usr/share/doc/Debian/zh_{TW,HK,CN}/$(MANUAL).pdf
/usr/share/doc/Debian/$(MANUAL).tar.gz (Just source file,
unified source at DDP so all languages are in one source. Goes
nice with po-debiandoc transition too.)
This is what I am doing after hearing everyone in this discussion. (I
only have en, fr, and it, so easier.
> > *.deb files already do equivalent things for the packaged documents.
> > DEB format is nothing but "ar" and "tar" combind. :)
>
> But, they are sometimes less upto date :^).
So let DDP publish daily from CVS.
DDP server needs patch installed to handle ps and PDF.
--
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki @ Cupertino CA USA
See "User's Guide": http://www.debian.org/doc/manuals/users-guide/
See "Debian reference": http://www.debian.org/doc/manuals/debian-reference/
"Debian reference" Project at: http://qref.sf.net
I welcome your constructive criticisms and corrections.
--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: