Date: Tue, 10 Jul 2001 14:57:57 +0100 From: Nik Clayton <nik@freebsd.org> To: Nik Clayton <nik@freebsd.org> Cc: Dima Dorfman <dima@unixfreak.org>, doc@freebsd.org Subject: Re: State of the Handbook Message-ID: <20010710145757.J16152@clan.nothing-going-on.org> In-Reply-To: <20010710135753.G16152@clan.nothing-going-on.org>; from nik@freebsd.org on Tue, Jul 10, 2001 at 01:57:53PM %2B0100 References: <20010710114034.E16152@clan.nothing-going-on.org> <20010710113247.A2B863E28@bazooka.unixfreak.org> <20010710135753.G16152@clan.nothing-going-on.org>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --]
On Tue, Jul 10, 2001 at 01:57:53PM +0100, Nik Clayton wrote:
> On Tue, Jul 10, 2001 at 04:32:47AM -0700, Dima Dorfman wrote:
> > Nik Clayton <nik@freebsd.org> writes:
> > > 2. Supplement the ASCII art with images.
> > >
> > > Something else on WRS' todo list, although it doesn't prevent anyone
> > > else with an artistic bent from picking some of the existing ASCII art
> > > and producing images for it as well. WRS expect to have this done by
> > > the end of August.
> >
> > Do we have a mechanism so that we can keep the ASCII art and display
> > it where necessary? I.e., I'd rather not see the ASCII art thrown
> > away; not everybody wants to start a graphics-capable browser to read
> > the docs (I know I don't).
>
> Yes we do. See section 4.2.6 of the primer.
>
> We've previously talked about adding another format to the set that's
> generated; html-no-images (or similar). That's trivial to generate
> (since we already generate it in order to produce the plain text version
> of the docs).
>
> However, it brings up an additional issue -- currently, the output formats
> are all produced in the 'current' directory. This works OK for the
> formats that we have, since none of them have filenames that 'collide'
> with one another.
>
> It won't work with a hypothetical 'html-no-images' format. The likes of
> 'book.html' is perfectly legitimate in this format, which would collide
> with the files generated by the 'html' format. It's also feasible that
> people would want an 'html-split-no-images' format as well, the output
> files for which would collide with the output from the 'html-split'
> format.
Looks like I forgot to finish this before sending :-)
I'm thinking that perhaps we should have an output directory (that defaults
to ${.curdir}) and that the output is placed in subdirectories of this,
according to the format, ${.curdir}/html/book.html, ${.curdir}/ps/book.ps,
${.curdir}/html-split-no-images/index.html, and so on.
Maybe make the directory names all caps, or have a leading '_', or
something, so that they cluster at the beginning of ls(1) output. . .
N
--
FreeBSD: The Power to Serve http://www.freebsd.org/
FreeBSD Documentation Project http://www.freebsd.org/docproj/
--- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 ---
[-- Attachment #2 --]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.0.6 (FreeBSD)
Comment: For info see http://www.gnupg.org
iEYEARECAAYFAjtLCeQACgkQk6gHZCw343XK6QCfSCbX4y0Pfa6YuDGz2XOBQhAf
gF0AoIYCB3vOvCkNjwy2bbALjMdOOauf
=Jsch
-----END PGP SIGNATURE-----
home |
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010710145757.J16152>