Mercurial > bins

comparison doc/usage_httpd.xml @ 0:a84c32f131df 1.1.29

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Import vendor version
author Peter Gervai <grin@grin.hu>
date Wed, 15 Oct 2008 23:28:56 +0200
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:a84c32f131df
1 <?xml version="1.0" encoding="LATIN1" ?>
2 <!DOCTYPE webpage PUBLIC "-//Norman Walsh//DTD Website V2.2//EN"
3 "http://docbook.sourceforge.net/release/website/2.2/website.dtd" [
4 <!NOTATION XML SYSTEM "xml">
5 <!ENTITY usage_desc_xml SYSTEM "usage_desc_xml.xml" NDATA XML>
6 ]>
7 <!-- $Id: usage_httpd.xml,v 1.2 2005/08/21 20:12:33 jerome Exp $ -->
8 <webpage id="usage_httpd">
9 <config param="rcsdate" value="$Date: 2005/08/21 20:12:33 $"/>
10
11 <head>
12 <title>Web server configuration</title>
13 <keywords>SAUTRET, BINS, album, gallery, photos, EXIF</keywords>
14 </head>
15
16
17 <webtoc/>
18 <section>
19 <title>Apache Configuration</title>
20
21 <section>
22 <title>Encoding</title>
23
24 <para>The <filename>bins</filename> program will create
25 automatically an <filename>.htaccess</filename> in the root
26 directory of your album if the <literal>createHtaccess</literal>
27 parameter is set to 1. This <filename>.htaccess</filename> is to
28 be used by the <ulink url="http://httpd.apache.org/">Apache HTTP
29 server</ulink> to set the correct encoding of the HTTP header
30 according the html pages of the album.</para> <para>To allow
31 Apache to use the <filename>.htaccess</filename> file, the
32 following directive must be present in the
33 <literal>Directory</literal> or <literal>VirtualHost</literal>
34 of the Apache httpd configuration file&nbsp;:
35 </para>
36 <programlisting>
37 AllowOverride All
38 </programlisting>
39 </section>
40 <section>
41 <title>Using BINS with PHP</title>
42
43 <para>If you want that the .html extension file to be
44 interpreted by PHP, you have to edit the
45 <filename>.htacces</filename> file described in Encoding section
46 and add the following lines&nbsp;:
47 </para>
48 <programlisting>
49 AddHandler server-parsed .html
50 AddType application/x-httpd-php .php .html
51 </programlisting>
52 <para>
53 Thanks to Gilles Foucault for this Tip
54 </para>
55 </section>
56 <section>
57 <title id="usage_httpd.compression">Compression</title>
58 <para>
59 To reduce size of HTML and Javascript files you can enable
60 compression on the web server. This is specially useful for
61 the search engine because the
62 <filename>search_data.js</filename> file, containing all the
63 search data, can be very big on important album, but it
64 compress very well.
65 </para>
66 <para>
67 To enable compression on Apache 2, you have to enable
68 <literal>mod_deflate</literal>. Then, in your virtual host configuration, add the following directives:
69 </para>
70 <programlisting>
71 <![CDATA[
72 <IfModule mod_deflate.c>
73 # Compression
74 AddOutputFilterByType DEFLATE text/html text/plain \
75 text/xml text/css text/javascript application/x-javascript
76
77 # Netscape 4.x has some problems...
78 BrowserMatch ^Mozilla/4 gzip-only-text/html
79
80 # Netscape 4.06-4.08 have some more problems
81 BrowserMatch ^Mozilla/4\.0[678] no-gzip
82
83 # MSIE masquerades as Netscape, but it is fine
84 #BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
85
86 # NOTE: Due to a bug in mod_setenvif up to Apache 2.0.48
87 # the above regex won't work. You can use the following
88 # workaround to get the desired effect:
89 BrowserMatch \bMSI[E] !no-gzip !gzip-only-text/html
90
91 # To see how compression perform
92 DeflateFilterNote Input instream
93 DeflateFilterNote Output outstream
94 DeflateFilterNote Ratio ratio
95 LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
96 CustomLog /var/log/apache2/deflate.log deflate
97 </IfModule>
98 ]]>
99 </programlisting>
100 <para>
101 See the <ulink
102 url="http://httpd.apache.org/docs/2.0/mod/mod_deflate.html">Apache
103 documentation</ulink> for more details.
104 </para>
105 </section>
106 </section>
107 </webpage>