From owner-freebsd-doc Fri Aug 4 13:44:11 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mail.ruhr.de (in-ruhr2.ruhr.de [141.39.224.60]) by hub.freebsd.org (Postfix) with SMTP id 69EEC37B75B for ; Fri, 4 Aug 2000 13:44:05 -0700 (PDT) (envelope-from ue@nathan.ruhr.de) Received: (qmail 81516 invoked by alias); 4 Aug 2000 20:45:16 -0000 Received: (from ue@localhost) by nathan.ruhr.de (8.9.3/8.9.3) id WAA41879 for doc@FreeBSD.ORG; Fri, 4 Aug 2000 22:41:33 +0200 (CEST) (envelope-from ue) Date: Fri, 4 Aug 2000 22:41:33 +0200 From: Udo Erdelhoff To: doc@FreeBSD.ORG Subject: Re: FreeBSD tutorials Message-ID: <20000804224132.D36173@nathan.ruhr.de> References: <20000730115017.J20013@dragon.nuxi.com> <20000730220222.G33949@nathan.ruhr.de> <20000730134504.N20013@dragon.nuxi.com> <20000731193318.K33949@nathan.ruhr.de> <20000803235658.A75716@catkin.nothing-going-on.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.4i In-Reply-To: <20000803235658.A75716@catkin.nothing-going-on.org>; from nik@FreeBSD.ORG on Thu, Aug 03, 2000 at 11:56:58PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Nik, On Thu, Aug 03, 2000 at 11:56:58PM +0100, Nik Clayton wrote: > On Mon, Jul 31, 2000 at 07:33:18PM +0200, Udo Erdelhoff wrote: > > [seperate download page] > > Several people have said this. I'm still accepting complete submissions from > anyone that wants to do the work. Remember you have to cater for half a > dozen languages, and another half dozen output formats. 6 languages x 6 formats x 10 documents = 360 links. Too many for a single page. In other words, we will need seperate pages per language. We can't use tables or we will confuse the lynx users. Ergo: Lists of lists. > At this point I'll settle for ASCII mockups, as long as people can show > they're feasible. ASCII-mockup with embedded HTML, everything in {} is a comment, everything in [] is ripped from the original page. 1) Opening page (www.freebsd.org/tutorials/index.html) [Here lie assorted documents on various aspects of FreeBSD, FreeBSD software, and hardware]. The language of these documents is english; the format is split-html (i.e. a single html page per chapter). If you'd prefer a different language and/or a different format, please chosse one of the links at the bottom of this page. The doc distribution contains many of these documents. If you have choosen to include this distribution while you were installing FreeBSD, you will find them in /usr/share/doc. {The language needs some fixes by a natural speaker. Sorry for the mess} [If you have comments or would like to contribute a document, please contact us at freebsd-doc@FreeBSD.org.] {List of documents, links to the split html versions, without the "also available as" links} If you would prefer to download or view one of these documents in another format and or another language, please choose one of the following links. English Deutsch Francaise { the spelling is probably wrong, I eat french fries, I can't speak the language} [... other languages deleted...] ---------------------------------------------------------------------- 2) A language specific page. Proposed URL: http://www.freebsd.org/tutorials/download-"english".html {Everything in "" is a variable text, depending on the language} {The various translations teams may want to translate the following text} Welcome to the FreeBSD Documentation Project's download page for "english" documents. The available documents are listed below. Due to a lack of time, resources and willing helpers, some combinations of documents and formats may not be available in this language. If you'd like to support the FreeBSD Documentation Project, contact us "by mail". {The localized pages should contain links to the mailing list of the translation teams instead of freebsd-doc} The doc distribution contains many of these documents. If you have choosen to include this distribution while you were installing FreeBSD, you will find them in /usr/share/doc. * For People New to Both FreeBSD and Unix + tarball of split html + postscript [...] * An introduction to the MH mail software [...] If you would prefer to download or view one of these documents in another language, please choose one of the following links. English Deutsch Francaise { the spelling is probably wrong, I eat french fries, I can't speak the language} [... other languages deleted...] ---------------------------------------------------------------------- A demo of the HTML source to implement the lists of lists can be found at: http://www.ruhr.de/home/nathan/test.html. The image links you to W3C's validation service. If you think that this format could be used, I'll whip up a complete set of demonstration pages over the next weekend. This weekend is already filled up :-> It should be possible to create these webpages with a script or two if the machine with the script can access the various download directories and if there's a deterministic and uniform way to determine if a given combination of document, language and format can be downloaded. /s/Udo PS: Speaking of scripts - what's the final verdict about ports/20168? Port, tools dir or toss? -- "Finish the following setence: All power corrupts, absolute power..." "...is even more fun." "Correct." To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message