From owner-freebsd-doc@FreeBSD.ORG Sat Mar 7 03:23:28 2009 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A876710656BF for ; Sat, 7 Mar 2009 03:23:28 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from poseidon.ceid.upatras.gr (poseidon.ceid.upatras.gr [150.140.141.169]) by mx1.freebsd.org (Postfix) with ESMTP id 229908FC1F for ; Sat, 7 Mar 2009 03:23:28 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from mail.ceid.upatras.gr (unknown [10.1.0.143]) by poseidon.ceid.upatras.gr (Postfix) with ESMTP id C1E6EEB5392; Sat, 7 Mar 2009 04:51:12 +0200 (EET) Received: from localhost (europa.ceid.upatras.gr [127.0.0.1]) by mail.ceid.upatras.gr (Postfix) with ESMTP id 7BC9745088; Sat, 7 Mar 2009 04:51:12 +0200 (EET) X-Virus-Scanned: amavisd-new at ceid.upatras.gr Received: from mail.ceid.upatras.gr ([127.0.0.1]) by localhost (europa.ceid.upatras.gr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id FjRnriTLCY+W; Sat, 7 Mar 2009 04:51:12 +0200 (EET) Received: from kobe.laptop (adsl158-175.kln.forthnet.gr [62.1.61.175]) by mail.ceid.upatras.gr (Postfix) with ESMTP id 18F6C4503F; Sat, 7 Mar 2009 04:51:12 +0200 (EET) Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id n272pBsq008259; Sat, 7 Mar 2009 04:51:11 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id n272pA7Z008239; Sat, 7 Mar 2009 04:51:10 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Michael References: <3FA2B513-2BCB-4791-9EA3-A9DB9D215A10@gmail.com> Date: Sat, 07 Mar 2009 04:51:10 +0200 In-Reply-To: <3FA2B513-2BCB-4791-9EA3-A9DB9D215A10@gmail.com> (Michael's message of "Thu, 5 Mar 2009 19:02:25 +0800") Message-ID: <87sklqyrj5.fsf@kobe.laptop> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.91 (berkeley-unix) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: doc@freebsd.org Subject: Re: about HTML-book maker X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 07 Mar 2009 03:23:29 -0000 On Thu, 5 Mar 2009 19:02:25 +0800, Michael wrote: > Dear FreeBSD handbook managers, > > I set up a blog about my stories about using FreeBSD to share my > experience. But editing posts is my biggest problem. I'd like to make > a HTML book page like the handbook of FreeBSD. How could you make so > nice HTML book page? Using software? What is it? Hi Michael, If all you are looking for is a blog-like web application, then the build infrastructure of our documentation may not be the best thing for you. Our online documentation contains *static* HTML pages, so there is no support for some of the more advanced features of blog software, like comments, trackback links, user authentication for recurring visitors, page view statistics, and so on. With that in mind, and if you really *do* want to use something like our documentation build tools, I agree with what Manolis wrote: On Thu, 05 Mar 2009 15:18:29 +0200, Manolis Kiagias wrote: > Hello Michael, > > Indeed, we are using some tools to create the handbook. We are glad > you like the results ;) > > Generally you would need to install the textproc/docproj-jadetex port > > For details on using this, please read the fdp-primer here: > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ > > Generally, it would be much easier if you start by installing the > software and using it to compile the FreeBSD documentation first. > You can then easily pick up a ready e.g. article and use it as a > stub to create your own. This is not really a difficult process. > > I'll be glad to help you on your first steps, just email me directly > with your questions. One of the most important details about the build tools of our online documentation is that they are freely available online. You can copy and reuse the build tools directly from our CVS repository. All the `Makefile' files in the source of the `doc/' tree are easily accessible online through: http://cvsweb.FreeBSD.org/doc/ Setting up a personal site that uses a similar build toolchain is not very difficult, but it does take a certain level of familiarity with the BSD make(1) utility. As Manolis pointed out, one of the ways to get acquainted with the way the doc/ build system works is to try and hack together a small article of your own and attach it to the normal build of the FreeBSD documentation. Once you get past that obstacle, you can start reading about the files in `doc/share/mk' and other `doc/share' sub-directories. This will let you know how to customize the look and feel of the site; the shared images used in article and book pages; the trademarks, logos and other repeatedly occurring text parts; and so on... As Manolis wrote, if you have questions about how our `doc/' build works, you can either email personally one of the people who can help, or you can email the freebsd-doc mailing list asking any questions you have come up with. Even more importantly, if you start using our documentation build tools and you like what you see, you are more than welcome to join the FreeBSD documentation team and help us improve, extend, or write entirely new parts of the FreeBSD documentation. We can always use as much help as we can get :-) HTH, Giorgos