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_html as 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='' website or the English and (for example) the French with make 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 (web)All section ‘All’ in General Information. 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/

This document was generated by gub on July 13, 2020 using texi2html 1.82.