From: Graham Percival <graham@percival-music.ca>
Date: Sun, 17 Oct 2010 19:04:09 +0000 (+0100)
Subject: Doc: CG: debugging web and docs locally.
X-Git-Tag: release/2.13.36-1~6
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=71aea07e4c3ff911e32f41cd1119d293959abb27;p=lilypond.git

Doc: CG: debugging web and docs locally.
---

diff --git a/Documentation/contributor/website-work.itexi b/Documentation/contributor/website-work.itexi
index 4921da3a54..4f9856dd13 100644
--- a/Documentation/contributor/website-work.itexi
+++ b/Documentation/contributor/website-work.itexi
@@ -5,6 +5,7 @@
 @menu
 * Introduction to website work::
 * Uploading and security::
+* Debugging website and docs locally::
 * Translating the website::
 @end menu
 
@@ -193,6 +194,40 @@ Some information about the website is stored in
 shared with people without trusted access to the server.
 
 
+@node Debugging website and docs locally
+@section Debugging website and docs locally
+
+@itemize
+@item
+Install apache2, or any other http server.  These instructions
+assume that you also enable @code{mod_userdir}, and use
+@code{$HOME/public_html} as the location.
+
+@item
+Build the online docs and website:
+
+@example
+make WEB_TARGETS="offline online" doc
+make website
+@end example
+
+
+@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/} a symlink if
+necessary)
+
+@example
+mv out-website/website/ $HOME/public_html
+mv $HOME/public_html/website/pictures $HOME/public_html/
+mkdir -p $HOME/public_html/doc/v2.13/
+mv out-www/online-root/* $HOME/public_html/doc/v2.13/
+@end example
+
+@end itemize
+
+
 @node Translating the website
 @section Translating the website