Re: Adds a site search to website and improves doc search (issue4894053)

[Phil Holmes]

----- Original Message ----- 
From: "Graham Percival" <address@hidden>
To: "Janek Warchoł" <address@hidden>
Cc: <address@hidden>; <address@hidden>; 
<address@hidden>; <address@hidden>
Sent: Tuesday, August 23, 2011 12:47 AM
Subject: Re: Adds a site search to website and improves doc search 
(issue4894053)


> On Mon, Aug 22, 2011 at 11:06:04PM +0200, Janek Warchoł wrote:
> > Phil, could you compile the website with your changes and host it
> > somewhere? (or tell me how to do this properly)
>
> Partial instructions are buried in
> http://code.google.com/p/lilypond/issues/detail?id=1663
> It would be nice if those instructions could migrate to the CG.

How about this (in a new section - Building the website locally)

Building the website locally

Start by making the binary files with make (typical time - 10
minutes)

Run make website (takes a minute or so).

This creates a number of files, starting with:

lilypond-git/build/out-website/index.html

Following many of the links from this page do work, but there
are no images visible and no stylesheet is loaded, so much of
the formatting is wrong.  However, if you simply want to read
a text change you've made, this can be used.  It also has no
links to the other language versions.  For this reason, it is
better to use:

lilypond-git/build/out-website/website/index.html

for browsing changed text.  This still has no images or
stylesheet, but does include the other language pages.  Note
that links to any of the user/developer documentation will be
broken.

To compile the documentation run make doc.  This typically
takes a couple of hours or so.

After this has been run, we get a number more copies of
index.html, including:

/lilypond-git/build/out-www/offline-
root/Documentation/web/index.html

This is the one that is correctly formatted with all the
pictures, style sheets, etc.

--
Phil Holmes