-Run "webdvd URL" where URL is the URL for the page that is to be the
-top menu of the DVD. It will automatically follow links to other
-pages and to video files, rendering each page. You must be careful
-not to link to pages that you do not want to appear on the disc, such
-as normal web sites.
-
-By default, webdvd uses a frame size of 720x576, which is suitable for
-PAL DVDs. If you wish to produce NTSC DVDs you must override this
-by adding the option "-geometry 720x480".
-
-This will create the following files (with NNNNNN replaced with each
-successive page number):
-
-- webdvd.dvdauthor: This is an XML file to be passed to dvdauthor.
-- page_NNNNNN.spumux: These are XML files to be passed to spumux.
-- page_NNNNNN_back.png: This is a static image of the page, which
- becomes the menu background.
-- page_NNNNNN_links.png: This is an image of the change in appearance
- of each link when the pointer is over it.
-
-Currently, you must run commands along the following lines to produce
-a complete DVD image:
-
-for spumux in page_??????.spumux; do
- page=$(basename $spumux .spumux)
- pngtopnm ${page}_back.png \
- | ppmtoy4m -v0 -n 1 -F 25:1 -A 59:54 -I p -S 420_mpeg2 \
- | mpeg2enc -v0 -f 8 -a 2 -o /dev/stdout \
- | mplex -v0 -f 8 -o /dev/stdout /dev/stdin \
- | spumux -v0 -m dvd $spumux > ${page}.vob
-done
-rm -rf dvd-temp
-dvdauthor -o dvd-temp -x webdvd.dvdauthor
-mkisofs -dvd-video dvd-temp >dvd.iso
-rm -rf dvd-temp
-
-Adjust the name of the temporary directory (here "dvd-temp") and the
-output file ("dvd.iso") as you please.
-
-If you are using NTSC video, you will need to change the ppmtoy4m
-parameters. Use "-F 30000:1001 -A 10:11" instead of "-F 25:1 -A 59:54".
+Design your DVD menus as a series of HTML pages linking to each other
+and to MPEG-1/2 videos that are suitable for use on a DVD. You must
+be careful not to link to pages that you do not want to appear on the
+disc, such as normal web sites. Also note the limitations listed
+below.
+
+Linking to video
+
+You can link directly to local MPEG video files whose names end in
+".vob". If you wish to combine multiple files into a single video
+sequence ("title" in DVD terminology) or to add chapter marks to a
+video sequence, create a text file whose name ends in ".voblist" and
+containg <vob> elements as described in the dvdauthor manual page, and
+link to that. Note that these list files are currently included
+directly in the control file that WebDVD passes to dvdauthor, which
+means that file names in them will be resolved relative to the current
+directory rather than the directory containing the list file. This is
+probably a bug.
+
+You can link to a title and begin playback at the beginning of a
+specific chapter by adding "#" and then the chapter number to the end
+of the URL.
+
+Video standards
+
+By default, webdvd generates PAL/SECAM video. If you wish to produce
+NTSC DVDs you can override this by adding the option "--video-std ntsc"
+to the following commands.
+
+Preview
+
+To get a rough preview of the menus, run "webdvd --preview menu-url"
+where menu-url is the URL or filename of the first page to show.
+Currently videos cannot be displayed in this preview mode.
+
+Processing
+
+To create a DVD filesystem, run "webdvd menu-url output-dir" where
+menu-url is the URL or filename of the top menu page and output-dir is
+the directory in which to create the filesystem (which should be
+either nonexistent or empty). WebDVD will automatically follow links
+to the other pages and to the video files.
+
+If this is successful you can then use mkisofs to create a DVD image
+from the output directory. Alternately you can write this directory
+directly to a writable DVD with growisofs or with mkisofs piped to a
+suitable version of cdrecord.
+
+Example
+-------
+
+A live example set of menus can currently be found at
+<http://womble.decadentplace.org.uk/software/debconf5-dvd/menus/main.html>.
+Note that this has large background images that will take some time to
+load.