diff --git a/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml b/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml index 3b1cfee227..e95a3ca560 100644 --- a/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml +++ b/en_US.ISO8859-1/books/fdp-primer/the-website/chapter.xml @@ -1,202 +1,153 @@ The Website - - Preparation - - Use a disk with sufficient free space. A full copy of - the documentation and web site files takes over 700 MB. - Allowing a full gigabyte provides some breathing room. This - space will hold the XML tools, the documentation tree, temporary - build space and the installed web pages. - - - Make sure the documentation ports are updated to the - latest version. See - the - Handbook section on ports for more - information. - - - - Using <command>svn</command> - - svn is needed to check out the - documentation and web site files from the - doc Subversion repository. - svn can be installed with &man.pkg.add.1; - or from the &os; Ports Collection by running: - - &prompt.root; cd /usr/ports/devel/subversion -&prompt.root; make install clean - - To check out the source files for the &os; web site and - the rest of the documentation, run: - - &prompt.user; svn checkout https://svn0.us-east.FreeBSD.org/doc/head/ ~/doc - - svn0.us-east.FreeBSD.org - is a public SVN server. Select the closest - mirror and verify the mirror server certificate from the list - of - Subversion - mirror sites. - - After the checkout completes, the current version of the - &os; documentation, including the web site files, will be - present in - ~/doc. - - - Build the Web Pages Having obtained the documentation and web site source files, the web site can be built. In this example, the build directory is ~/doc and all the required files are already in place. The web site is built from the en_US.ISO8859-1/htdocs subdirectory of the document tree directory, ~/doc in this example. Change to the build directory and start the build by executing make all. &prompt.user; cd ~/doc/en_US.ISO8859-1/htdocs &prompt.user; make all The web site build uses the INDEX from the Ports Collection and may fail if that file or /usr/ports is not present. The simplest approach is to install the Ports Collection. Install the Web Pages Run make install, setting DESTDIR to the target directory for the web site files. The files will be installed in $DESTDIR/data, which is expected to be the web server's document root. This installation is run as the root user because the permissions on the web server directory will not allow files to be installed by an unprivileged user. In this example, the web site files were built by user jru in their home directory, /usr/home/jru/doc. &prompt.root; cd /home/jru/doc/en_US.ISO8859-1/htdocs &prompt.root; env DESTDIR=/usr/local/www make install The install process will not delete any old or outdated files that existed previously in the same directory. If a new copy of the site is built and installed every day, this command will find and delete all files that have not been updated in three days. &prompt.root; find /usr/local/www 3 Environment Variables ENGLISH_ONLY If set and not empty, only the English documents will be built or installed. All translations will be ignored. E.g.: &prompt.root; make ENGLISH_ONLY=YES all install To unset the variable and build all pages, including translations, set ENGLISH_ONLY to an empty value: &prompt.root; make ENGLISH_ONLY="" all install clean WEB_ONLY If set and not empty, only the HTML pages from the en_US.ISO8859-1/htdocs directory will be built or installed. All other directories within en_US.ISO8859-1 (Handbook, FAQ, Tutorials) will be ignored. E.g.: &prompt.root; make WEB_ONLY=YES all install WEB_LANG If set, build or install only for the languages specified by this variable inside the ~/doc directory. All other languages except English will be ignored. E.g.: &prompt.root; make WEB_LANG="el_GR.ISO8859-7 es_ES.ISO8859-1 hu_HU.ISO8859-2 nl_NL.ISO8859-1" all install WEB_ONLY, WEB_LANG, and ENGLISH_ONLY are &man.make.1; variables and can be set in /etc/make.conf, Makefile.inc, as environment variables on the command line, or in dot files.