Re: Issue 1663 in lilypond: Images missing on web site

[lilypond]

Comment #19 on issue 1663 by address@hidden: Images missing on  
web site
http://code.google.com/p/lilypond/issues/detail?id=1663

Belay comment 17.  I think I must have been looking at a page built with  
make docs.  An update:

The web index is in:

file:///home/phil/lilypond-git/build/out-website/index.html

Pictures are referenced as:

<img src="pictures/double-lily-modified3.png" alt="LilyPond logo">

They were:

<img src="../pictures/double-lily-modified3.png" alt="LilyPond logo">

 - so we have lost the ../pictures, as expected.

On both the versions I'm looking at (one built from a git tree of at least  
a week ago, and one from yesterday) there are no actual pictures visible in  
the browser.  Actually, that's not surprising.  The only instances  
of "double-lily-modified3.png" are in:
  lilypond-git/Documentation/pictures (i.e. the source)
  lilypond-git/build/Documentation/pictures/out-www (the website created by  
make doc)
  lilypond-git/build/out-www/offline-root/Documentation/pictures (the final  
website created by make doc and with the links fixed up)

If the make website-built website were to reference these, 1) we would  
always need to make doc before make website, which rather spoils the point  
of a slimmed-down make website; 2) we would need to change the links in the  
website-built html to something like ../Documentation/pictures/out-www,  
which is rather too specific and out-of-tree.

I think we have 3 options (here presented in my order of preference)

1. Document the fact that make website contains no images (it also has no  
css, etc.)
2. Write a script that copies the relevant pictures to a  
out-website/pictures directory and ensure the html links are fixed up  
correctly.
3. Write a script that fixes the links in out-website to point at the  
Documentation directory and document that you must run make doc before make  
website.

What do you think?