6.3 Debugging website and docs locally
-
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
mod_userdir, and use$HOME/public_htmlas DocumentRoot (i.e. the root directory of the web server). -
Build the online docs and website:
make WEB_TARGETS="offline online" doc make website
This will make all the language variants of the website. To save a little time, just the English version can be made with the command
make WEB_LANGS='' websiteor the English and (for example) the French withmake WEB_LANGS='fr' website. -
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 ‘.htaccess’ file, you can copy to
~/public_html/lilypond.org. Otherwise you’d better copy to~/public_html. It’s highly recommended to have your build dir and web dir on the same partition. -
Add the directory for the online documentation:
mkdir -p ~/public_html/doc/v2.19/
You may want to add also the stable documentation in
~/public_html/doc/v2.18/, extracting the contents of the html directory present in the tarball available in All. Just in case you want to test the redirects to the stable documentation. -
Copy the files with rsync:
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/