issue 4829: add all languages for content negotiation in .htaccess (issue 296070043 by address@hidden)

[fedelogy]

Reviewers: ,

Message:
In the CG instructions I preferred rsync over mv, because otherwise any
following compilation will have to start from scratch.


Description:
issue 4829: add all languages for content negotiation in .htaccess

Improve also the instructions in the CG manual on debugging the
website locally.

Please review this at https://codereview.appspot.com/296070043/

Affected files (+40, -11 lines):
  M Documentation/contributor/website-work.itexi
  M Documentation/web/server/lilypond.org.htaccess


Index: Documentation/contributor/website-work.itexi
diff --git a/Documentation/contributor/website-work.itexi  
b/Documentation/contributor/website-work.itexi
index  
d719843b53e3e1e0d58b9c1b326b47cdb24d44b7..588d705f1b4facfbd11797a6122b95aae935d2b4  
100644
--- a/Documentation/contributor/website-work.itexi
+++ b/Documentation/contributor/website-work.itexi
@@ -291,9 +291,11 @@ shared with people without trusted access to the  
server.

 @itemize
 @item
-Install apache2, or any other http server.  These instructions
+Install Apache (you can use version 2, but keep in mind that the server
+hosting lilypond.org runs version 1.3).  These instructions
 assume that you also enable @code{mod_userdir}, and use
address@hidden/public_html/lilypond.org} as the location.
address@hidden/public_html} as DocumentRoot (i.e. the root directory of
+the web server).

 @item
 Build the online docs and website:
@@ -309,15 +311,33 @@ command @code{make WEB_LANGS='' website} or the  
English and (for
 example) the French with @code{make WEB_LANGS='fr' website}.

 @item
-Move the built stuff into those directories.  It's highly
-recommended to have your build dir and www dir on the same
-partition.  (make @code{$HOME/public_html/lilypond.org} a symlink
-if necessary)
+Choose the web directory where to copy the built stuff.
+If you already have other web projects in your DocumentRoot and don't
+need to test the @file{.htaccess} file, you can copy to
address@hidden/public_html/lilypond.org}.  Otherwise you'd better copy
+to @code{~/public_html}.
+It's highly recommended to have your build dir and web dir on the
+same partition.
+
address@hidden
+Add the directory for the online documentation:
+
address@hidden
+mkdir -p ~/public_html/doc/v2.19/
address@hidden example
+
+You may want to add also the stable documentation in
address@hidden/public_html/doc/v2.18/}, extracting the contents of the html
+directory present in the tarball available in @rweb{All}. Just in case
+you want to test the redirects to the stable documentation.
+
address@hidden
+Copy the files with rsync:

 @example
-mv out-website/website $HOME/public_html/lilypond.org/
-mkdir -p $HOME/public_html/lilypond.org/doc/v2.19/
-mv out-www/online-root/* $HOME/public_html/lilypond.org/doc/v2.19/
+rsync -av --delete out-website/website ~/public_html/
+cp out-website/.htaccess ~/public_html
+rsync -av --delete out-www/online-root/ ~/public_html/doc/v2.19/
 @end example

 @end itemize
Index: Documentation/web/server/lilypond.org.htaccess
diff --git a/Documentation/web/server/lilypond.org.htaccess  
b/Documentation/web/server/lilypond.org.htaccess
index  
9060d0709a207f6b810c251b1781405e5757f437..d6bc37fb5936ebfd6ffefd80f5b8027664e26d09  
100644
--- a/Documentation/web/server/lilypond.org.htaccess
+++ b/Documentation/web/server/lilypond.org.htaccess
@@ -130,9 +130,18 @@ AddCharset utf-8 .fr
 AddCharset utf-8 .nl
 AddCharset utf-8 .txt

-# fix broken auto language selection for Hungarian
+# Add extensions for language negotiation
+# See: https://www.w3.org/International/questions/qa-apache-lang-neg
+AddLanguage ca .ca
+AddLanguage cs .cs
+AddLanguage de .de
+AddLanguage es .es
+AddLanguage fr .fr
 AddLanguage hu .hu
-
+AddLanguage it .it
+AddLanguage ja .ja
+AddLanguage nl .nl
+AddLanguage zh .zh


 # FIXME: separate this from the main "root" .htaccess material