neysx 06/11/03 16:53:07 Modified: doc-tipsntricks.xml Log: #153938 We do not use/support axkit anymore
Revision Changes Path 1.21 xml/htdocs/proj/en/gdp/doc/doc-tipsntricks.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gdp/doc/doc-tipsntricks.xml?rev=1.21&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gdp/doc/doc-tipsntricks.xml?rev=1.21&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gdp/doc/doc-tipsntricks.xml?r1=1.20&r2=1.21 Index: doc-tipsntricks.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/doc-tipsntricks.xml,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- doc-tipsntricks.xml 21 Jul 2006 04:38:47 -0000 1.20 +++ doc-tipsntricks.xml 3 Nov 2006 16:53:07 -0000 1.21 @@ -1,16 +1,16 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/doc-tipsntricks.xml,v 1.20 2006/07/21 04:38:47 rane Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gdp/doc/doc-tipsntricks.xml,v 1.21 2006/11/03 16:53:07 neysx Exp $ --> <guide link="/proj/en/gdp/doc/doc-tipsntricks.xml"> <title>Documentation Development Tips & Tricks</title> <author title="Author"> - <mail link="[EMAIL PROTECTED]">Sven Vermeulen</mail> + <mail link="[EMAIL PROTECTED]">Xavier Neys</mail> </author> -<author title="Editor"> - <mail link="[EMAIL PROTECTED]">Xavier Neys</mail> +<author title="Author"> + <mail link="[EMAIL PROTECTED]">Sven Vermeulen</mail> </author> <abstract> @@ -20,8 +20,8 @@ <license/> -<version>0.25</version> -<date>2006-07-20</date> +<version>0.26</version> +<date>2006-11-03</date> <chapter> <title>Setting up your local environment</title> @@ -254,139 +254,6 @@ </chapter> <chapter> -<title>Using an axkit setup</title> -<section> -<body> - -<note> -This chapter is not actively maintained and is kept only for historical -purposes as long as one of our web servers is still using an axkit setup. -You might want to consider trying out <c>gorg</c>. -</note> - -<p> -Some doc developers prefer to use an axkit setup similar to the one running on -<uri>http://www.gentoo.org</uri>. Here are a few pointers to help you setup a -similar configuration. -</p> - -<warn> -It seems that axkit is very sensitive to the versions of the packages it uses, -especially libxml2. The configuration described below is known to work. Any -other combination of packages might break. -</warn> - -<p> -First, install the required packages: -</p> - -<pre caption="emerging specific versions on required packages"> -<comment>(Test if packages are available to portage)</comment> -# <i>emerge -vp =dev-libs/libxml2-2.6.17 =dev-libs/libxslt-1.1.12 \ -=dev-perl/AxKit-1.6.1 =dev-perl/XML-XPath-1.13 =dev-perl/XML-LibXML-1.58 \ -=dev-perl/XML-LibXSLT-1.57 =dev-perl/XML-Parser-2.34 =net-www/apache-1.3.33</i> - -These are the packages that I would merge, in order: - -Calculating dependencies ...done! -[ebuild R ] dev-libs/libxml2-2.x.17 -debug -ipv6 +python +readline 0 kB -[ebuild R ] dev-libs/libxslt-1.1.12 +crypt +python 0 kB -[ebuild R ] dev-perl/AxKit-1.6.1 +gnome 0 kB -[ebuild R ] dev-perl/XML-XPath-1.13 0 kB -[ebuild R ] dev-perl/XML-LibXML-1.58 0 kB -[ebuild R ] dev-perl/XML-LibXSLT-1.57 0 kB -[ebuild R ] dev-perl/XML-Parser-2.34 0 kB -[ebuild R ] net-www/apache-1.3.33 +pam 0 kB - -<comment>(Install packages)</comment> -# <i>emerge =dev-libs/libxml2-2.6.17 =dev-libs/libxslt-1.1.12 \ -=dev-perl/AxKit-1.6.1 =dev-perl/XML-XPath-1.13 =dev-perl/XML-LibXML-1.58 \ -=dev-perl/XML-LibXSLT-1.57 =dev-perl/XML-Parser-2.34 =net-www/apache-1.3.33</i> -</pre> - -<p> -Then, edit the following config files: -</p> - -<pre caption="/etc/apache/conf/commonapache.conf"> -<comment>(Inside)</comment> -<IfModule mod_dir.c> - <comment>(Add index.xml to the list)</comment> - DirectoryIndex index.xml index.html index.php index.php3 index.shtml index.cgi index.pl index.htm Default.htm default.htm -</IfModule> - -<comment>(Add the following lines)</comment> -<IfDefine PERL> - LoadModule perl_module extramodules/libperl.so -# AddModule mod_perl.c - PerlModule AxKit - SetHandler perl-script - PerlHandler Apache::AxKit::StyleChooser::PathInfo AxKit - AddHandler axkit .xml .xsp - AxAddPlugin Apache::AxKit::StyleChooser::QueryString - AxAddXSPTaglib AxKit::XSP::Util - AxAddXSPTaglib AxKit::XSP::IfParam - AxAddXSPTaglib AxKit::XSP::Param - AxAddStyleMap application/x-xsp Apache::AxKit::Language::XSP - AxAddStyleMap text/xsl Apache::AxKit::Language::LibXSLT - <AxStyleName "#default"> - AxAddProcessor text/xsl /xsl/guide.xsl - </AxStyleName> - <AxStyleName printable> - AxAddProcessor text/xsl /xsl/guide-print.xsl - </AxStyleName> -</IfDefine> - -<comment>(Inside)</comment> -<IfModule mod_alias.c> - Alias /icons/ /var/www/localhost/icons/ -<comment>(Comment out the following line)</comment> - #Alias /doc /usr/share/doc -</pre> - -<pre caption="/etc/conf.d/apache"> -<comment>(Add -D PERL to the list of options)</comment> -APACHE_OPTS="-D PERL" -</pre> - -<p> -Then, copy the documentation files including the DTDs and stylesheets to -<path>/var/www/localhost/htdocs/</path>. You need the <path>css/</path>, -<path>doc/</path>, <path>dtd/</path>, <path>images/</path> and -<path>xsl/</path> directories. Gentoo developers can copy from or symlink to -their CVS local copy. Other contributors will need to download the files from -our <uri link="http://sources.gentoo.org/gentoo/xml/htdocs/";>viewCVS</uri> -interface. -</p> - -<p> -All there is left to do is start your apache server with: -</p> - -<pre caption="Launching apache"> -# <i>/etc/init.d/apache start</i> -# <comment>(Add it to your runlevel if you want to start it automatically at boot time)</comment> -# <i>rc-update add apache default</i> -</pre> - -<p> -Point now your browser to <uri>http://your_server/doc/en/</uri> or simply -<uri>http://localhost/doc/en/</uri> if you installed axkit on your workstation. -You can check <path>/var/log/apache/access_log</path> for accesses and -<path>/var/log/apache/error_log</path> for errors. -</p> - -<note> -Mozilla users might need to set <c>keyword.enabled</c> to <c>false</c> in their -<uri>about:config</uri> page when using localhost. -</note> - -</body> -</section> - -</chapter> - -<chapter> <title>Frequently Asked Questions</title> <section> <title>How do I convert a file to UTF-8?</title> -- [email protected] mailing list
