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

[lilypond]

Comment #24 on issue 1663 by percival.music.ca: Images missing on web site
http://code.google.com/p/lilypond/issues/detail?id=1663

first: when I follow the link in comment 1, I do not see pictures.  I think  
that's the final test of whether this is done or not?

second: I took a longer look at 6.2, and it is much less clear than I  
thought it was.  My apologies.

Relative to your choices in comment 19, I would say to use option 2a: the  
build system already copies the pictures and css, but in a relatively  
fragile manner (which was never intended to work for the big-html website  
anyway).

The hints on this page:
http://lilypond.org/doc/v2.15/Documentation/contributor/uploading-and-security
are:
"""
   Upload latest pictures/ and ly-examples/ (local script):
   Note: You may need to change a number of items in the below script.
   ...
   rsync -a $PICS address@hidden:lilypond/media/pictures
   rsync -a $EXAMPLES address@hidden:lilypond/media/ly-examples
"""

(rsync is a command that copies files, generally to a remote system but it  
can also be used locally.  This puts pictures and examples in the  
$HOME/lilypond/media/.../ directories on lilypond.org, but you could use a  
similar command to put them in your own home directory)

"""
   Build the website:
   ...
   make -f website.make WEBSITE_ONLY_BUILD=1 website
"""

the official website is not built with:
  make website
alone, but instead with that WEBSITE_ONLY_BUILD=1 option.

At the very top of make/website.make you see:
################################################################
#####  SECURITY -- check these values for lilypond.org #########
################################################################

ifeq ($(WEBSITE_ONLY_BUILD),1)
  ### for lilypond.org
  ...
  EXAMPLES=$(HOME)/lilypond/media/ly-examples
  PICTURES=$(HOME)/lilypond/media/pictures
else
  ### for normal git
  ...
  # I assume this is run from top-build-dir
  EXAMPLES=Documentation/web/ly-examples/out-www
  PICTURES=Documentation/pictures/out-www
endif

website.make also contains:
website-pictures:
        mkdir -p $(OUT)/website/pictures
        if [ -d $(PICTURES) ]; \
        then \
                cp $(PICTURES)/* $(OUT)/website/pictures ; \
                ln -sf website/pictures $(OUT)/pictures  ;\
        fi

website-examples:
        mkdir -p $(OUT)/website/ly-examples
        if [ -d $(EXAMPLES) ]; \
        then \
                cp $(EXAMPLES)/* $(OUT)/website/ly-examples ; \
        fi


website: website-texinfo website-css website-pictures website-examples  
web-post




in sum, if you create $HOME/lilypond/media/pictures  
$HOME/lilypond/media/ly-examples directories, copy the relevant files into  
those, and run
  make -f ../make/website.make WEBSITE_ONLY_BUILD=1 website
then you should see exactly the same thing as you do on lilypond.org

I think the next step is to do this to make sure that I haven't forgotten  
or glossed over any other steps, and then to make sure that this is clear  
on 6.2.  Then you can test future changes to the website with the same  
mechanism that we use to create lilypond.org.