X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~mdw/git/disorder/blobdiff_plain/8f9616f198b617214724183e32d598339c3bbbc4..1b20de5ae43e6aa4350c0b6b3d2d7a5edcd431b2:/templates/help.html diff --git a/templates/help.html b/templates/help.html index 37e0004..8e298ef 100644 --- a/templates/help.html +++ b/templates/help.html @@ -25,20 +25,21 @@ USA
@include{topbar}@ -All screens in the DisOrder web interface have a set of hyperlinks at the top. You can use these to visit the various screens described below. Note that if you are not logged in some - of these will be greyed out.
+ of these will be greyed out. The link for the currently active + screen is highlighted.Each track has a button next to it. For the - currently playing track this can be used to stop playing the - track before it has finished. For a track in the queue it - removes the track from the queue.
+Each track has a + button next to it. For the currently playing track this can be + used to stop playing the track before it has finished; this is + called “scratching”. For a track in the queue it + removes the track from the queue.
-Depending on the server configuration, you may be able to do - this for any track, or only for tracks you submitted or that were - randomly picked. See the "restrict" option in disorder_config(5) for more - details.
+If you are not logged in, or if your user has limited rights, + you may only be able to scratch or remove certain tracks (for + instance, those you picked yourself).
-Artist and album names are hyperlinks to the relevant locations - in the Choose screen (see below).
+Artist and album names are hyperlinks to the relevant locations + in the Choose screen (see below).
If you are not logged in, or if your user has limited rights, + you may only be able to move certain tracks (for instance, those + you picked yourself), and may not be able to adjust the volume, + random play setting, etc.
The number of tracks remembered is controlled by the server - configuration. See the "history" option in disorder_config(5) for more - details.
+ configuration. See the history + option in disorder_config(5) for + more details.The time tracks are remembered for is controlled by the server - configuration. See the "noticed_history" option in noticed_history option in disorder_config(5) for more details.
- | This button can be used to edit the details for a + | This button can be used to edit the details for a track; see Editing Preferences below. | |
- | This button plays all the tracks in a directory, + | + | This button plays all the tracks in a directory, in order. This is used to efficiently play a whole album. |
This screen has two forms: choose, which give + href="@url@?action=choose">choose, which give you all the top-level directories at once, and choosealpha, + href="@url@?action=choosealpha">choosealpha, which breaks them down by initial letter.
+This screen will may not be available if you are not logged in + or if your user has limited rights.
+This screen, reached from Choose or Recent, is used to edit a track's preferences.
+ href="#recent">Recent, is used to edit a track's preferences. + Note that if you are not logged in, or your user has limited + rights, you may not be able to edit track preferences.The form can be used to - edit artist, album and title fields for the track as displayed, or - to set the tags for a track, or to enable or disable random play + edit artist, album and title fields for the track as displayed; or + to set the tags or weight for a track; or to enable or disable random play for the track.
Tags are separated by commas and can contain any other printing characters (including spaces). Leading and trailing spaces are not significant.
-Random play for any given track is enabled by default, but you - can use this screen to disable it for undesirable tracks.
+Weights determine how likely a track is to be picked at + random. Tracks with higher weights are more likely to be picked. + The default weight is 90000 and the maximum is 2147483647.
+ +By default, any track can be picked for random play. The check + box at the bottom can be used to selectivel enable or disable it + for individual tracks.
It is possible to limit results to tracks with a particular tag, by using tag:TAG among the search terms.
-Some keywords, known as "stopwords", are excluded from the search, and - will never match. See the "stopword" option in disorder_config(5) for further - details about this.
+Some keywords, known as “stopwords”, are excluded + from the search, and will never match. See the stopword option in disorder_config(5) for + further details about this.
+ +This screen will may not be available if you are not logged in + or if your user has limited rights.
The user the server runs as is determined by the user - directive in the configuration file. The README recommends using - jukebox for this purpose but it could be different - locally.
+The user the server runs as is determined by the user directive in the configuration + file. The README recommends using jukebox for this purpose + but it could be different locally.