X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/blobdiff_plain/2eee4b0cd743865445a5023e8c10467cdc9b350e..ddf0e06b99c52ed416f19432be45b71238d0b877:/README diff --git a/README b/README index 8aa4ccd..8cd2c35 100644 --- a/README +++ b/README @@ -34,9 +34,9 @@ Build dependencies: libao 0.8.6 libasound 1.0.13 libFLAC 1.1.2 - GNU C 4.1.2 - GNU Make 3.81 - GNU Sed 4.1.5 + GNU C 4.1.2 } + GNU Make 3.81 } Non-GNU versions will NOT work + GNU Sed 4.1.5 } Python 2.4.4 (optional) GTK+ 2.8.20 (if you want the GTK+ client) GLIB 2.12.4 (if you want the GTK+ client) @@ -88,6 +88,11 @@ platform, please get in touch. --without-gtk Don't build GTK+ client (Disobedience) --without-python Don't build Python support + If configure cannot guess where your web server keeps its HTML documents and + CGI programs, you may have to tell it, for instance: + + ./configure cgiexecdir=/whatever/cgi-bin httpdir=/whatever/htdocs + See README.client for setting up a standalone client (or read the disobedience man page). @@ -98,9 +103,6 @@ platform, please get in touch. make installdirs install - The CGI interface has to be installed separately; see under 'Web Interface' - below. - NB steps 3 to 6 are covered by scripts/setup. It should work on FreeBSD, OS X and Linux and could be adapted to other platforms. @@ -227,31 +229,19 @@ You need to configure a number of things to make this work: disorder setup-guest --no-online-registration -3. Make sure that DisOrder can find its icons and stylesheet. For example in - your web server configuration: - - Alias /disorder/ /usr/local/share/disorder/static/ - - Alternatively you could use a symlink from the right location in your - document root, provided your web server is configured to follow them. - - cd /var/www - ln -s /usr/local/share/disorder/static disorder - -4. Install disorder.cgi in an appropriate location. Remember to make it - executable. Example: +3. Try it out. The url will be (something like): - install -m 755 cgi/disorder.cgi /usr/lib/cgi-bin/disorder + http://localhost/cgi-bin/disorder -5. Try it out. You should be able to perform read-only operations straight - away, and after visiting the 'Login' page to authenticate, perform other - operations like adding a track to the queue. + You should be able to perform read-only operations straight away, and after + visiting the 'Login' page to authenticate, perform other operations like + adding a track to the queue. -6. If you run into problems, always look at the appropriate error log; the +4. If you run into problems, always look at the appropriate error log; the message you see in your web browser will usually not be sufficient to diagnose the problem all by itself. -7. If you have a huge number of top level directories, then you might find +5. If you have a huge number of top level directories, then you might find that the 'Choose' page is unreasonably large. If so add the following line to /etc/disorder/options.user: label sidebar.choosewhich choosealpha