Skip site navigation (1)Skip section navigation (2) 
Date:      Tue, 17 Nov 1998 17:06:56 +0100
From:      Wolfram Schneider <wosch@cs.tu-berlin.de>
To:        doc@FreeBSD.ORG
Subject:   Build and update the FreeBSD WEb Pages from the sources
Message-ID:  <19981117170656.A9599@caramba.cs.tu-berlin.de>
index | next in thread | raw e-mail 

This document describe how to build and update the FreeBSD Web pages
from the source tree by hand. 

by Wolfram Schneider, November 1998.

1. Preperation
2. Build the Web Pages from scratch
3. Install the web pages into your web server
4. Update the Web pages.
5. Automatically build and update

1. Preperation

Install the meta-port port `docproj-1.0`. The "meta-port" for the
FreeBSD Documentation Project contain alls ports which you need to
build the web pages and DocBook documents. 

NOTE: make sure your documentation ports are up to date! When in
doubt, delete the old ports by hand before installing the port
docproj-1.0!  For example, we currently depend on jade-1.2 and if you
have installed jade-1.1, please do

	$ pkg_delete jade-1.1

before installing the port docproj-1.0.


Setup a CVS repository. You need the directories www and doc in the
CVS tree (plus the CVSROOT of course).  See the CVSup introduction
http://www.freebsd.org/handbook/cvsup.html how to get the subdirs
www (collection www) and doc (collection doc-all).

Set the environment variable CVSROOT to your CVS repository, e.g.
if your CVS repository lives in /home/ncvs 

[for bourne shell users]
	$ CVSROOT=/home/ncvs; export CVSROOT

[for csh shell users]
	% setenv CVSROOT /home/ncvs


2. Build the Web Pages from scratch

a) Go to into a temp directory with at least 50 MB free space
	$ cd /usr/tmp/webuild

b) Checkout the SGML files from the CVS tree
	$ cvs -R co web doc

c) Goto in the directory web and build all symbolic links
	$ cd web
	$ make links

d) Goto in the sub directory 'en' and build all pages
	[in this example you are in the directory /usr/tmp/webuild/web]
	$ cd en
	$ make 


3. Install the web pages into your web server
	
a) Call make install in the 'en' subdirectory
	[in this example you are in the directory /usr/tmp/webuild/web/en]
	$ make install DESTDIR=/usr/local/www
   	
	This comand install the web page into the directory
	/usr/local/www/data
	
Congratulation: You are done!!!


4. Update the Web pages.

a) Go to into your temp directory
	$ cd /usr/tmp/webuild

b) Update the pages from the CVS Repository. The cvs tool will update the
   pages, add new and delete old pages and directories.

	$ cvs -R update -dP
	
c) Goto in the directory 'web/en' and build all pages
	[in this example you are in the directory /usr/tmp/webuild]
	$ cd web/en
	$ make

d) Install the web pages. See section 3)
   	Note: the install process does not delete outdated pages from
	your web server. You must do this by hand! You can check for
	old pages with the command:

	[in this example /usr/local/www/data is the data directory 
	 of your web server]
	$ find /usr/local/www/data ctime -1


5. Automatically build and update

The FreeBSD webmaster wrote a shell script which do the build and
update automatically by a cron job. The script also update the full
text search engine at www.freebsd.org.

-- 
Wolfram Schneider <wosch@freebsd.org> http://freebsd.org/~w/ 

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19981117170656.A9599>