doc/en/internal/mirror.sgml
Hiroki Sato cfd9e12239 www cleanup mega commit:
- Move includes.nav*.sgml to share/sgml/navibar.ent and
   <lang>/share/sgml/nabibar.l10n.ent.

 - Move includes.sgml and includes.xsl to
   share/sgml/common.ent, share/sgml/header.ent, <lang>/share/sgml/l10n.ent,
   and <lang>?share/sgml/header.l10n.ent.

 - Move most of XSLT libraries to share/sgml/*.xsl and
   <lang>/share/sgml/*.xsl.

 - Move news.xml and other *.xml files for the similar purpose
   to share/sgml/*.xml and <lang>/share/sgml/*.xml.

 - Switch to use a custom DTD for HTML document.  Now we use
   "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension", which is
   HTML 4.01 + some entities previously pulled via
   "<!ENTITY % includes SYSTEM "includes.sgml"> %includes;" line.
   The location of entity file will be resolved by using catalog file.

 - Add DOCTYPE declearation to XML documents.  This makes the followings
   possible:

   * Use of &foo; entities for SGML in an XML file instead of defining
     {$foo} as the same content.

   * &symbolic; entities for Latin characters.

 - Duplicated information between SGML and XML, or English and
   translated doc, has been removed as much as possible.
2006-08-19 21:20:54 +00:00

66 lines
2 KiB
Text

<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "..">
<!ENTITY date "$FreeBSD: www/en/internal/mirror.sgml,v 1.23 2006/02/22 13:28:14 joel Exp $">
<!ENTITY title "Mirroring the FreeBSD Web Pages">
<!ENTITY % navinclude.docs "INCLUDE">
]>
<html>
&header;
<p>You can (and are encouraged to) mirror the FreeBSD web pages
<tt>www.FreeBSD.org</tt>.
To do this, you need to obtain and install
a program called <em>cvsup</em> on your web server.
<a href="&url.doc.base;/books/handbook/cvsup.html#CVSUP-INSTALL">CVSup</a> is a software package for
distributing and updating collections of files across a network.</p>
<h2>Installing CVSup</h2>
<p>You can build and install it from source by the following commands:</p>
<pre>
# cd /usr/ports/net/cvsup-without-gui
# make all install clean
</pre>
<p>However, installing precompiled package from the FreeBSD
<a href="&url.doc.base;/books/handbook/packages-using.html">packages
collection</a> may be much easier.
Refer to the chapter mentioned for the details.</p>
<h2>Running CVSup</h2>
<p>If you keep your mirrored FreeBSD web pages in the directory
<tt>/usr/FreeBSD-mirror</tt> and are owned by the user `fred', then
run the following command as user `fred':</p>
<pre>
$ cvsup supfile-www
</pre>
The file <tt>supfile-www</tt> contain:
<pre>
*default host=cvsup.FreeBSD.org
*default prefix=/usr/FreeBSD-mirror
*default base=/usr/local/etc/cvsup
www release=current delete use-rel-suffix compress
</pre>
<p>This will mirror the FreeBSD web pages into
<tt>/usr/FreeBSD-mirror</tt>. You can install this into fred's
crontab, so that it runs once a day. The pages on www.FreeBSD.org are
updated daily at about 4:30am California time.</p>
<h2>More Information on CVSup</h2>
See the <a href="&url.doc.base;/books/handbook/synching.html#CVSUP">CVSup introduction</a> in the
handbook.
<p><a href="internal.html">FreeBSD Internal Home</a></p>
&footer;
</body>
</html>