X-Git-Url: https://git.phdru.name/?a=blobdiff_plain;f=docs%2Fcommand_line.rst;h=e7421435d057888d960c3f2fdbecad65c44462a7;hb=HEAD;hp=4bde53d9f3b354636c10df9afaa7026ccdee9870;hpb=2d76928b93c208d27f942b9a9eb649df1d5b2192;p=m_librarian.git diff --git a/docs/command_line.rst b/docs/command_line.rst index 4bde53d..e742143 100644 --- a/docs/command_line.rst +++ b/docs/command_line.rst @@ -146,8 +146,10 @@ Options:: --gid gid Search by genre’s id -l, --lang lang Search by language --lid lid Search by language’s id + --filters Use filters from config -P, --path path Path to the directory with the library archives + --download-to [path] Download directory -F, --format format Format of the downloaded file name --get Download exactly one book --get-many N Download at most this many books @@ -169,6 +171,25 @@ section `[library]`, key `path`:: The option is useful for multiple databases (global option `-D`). +Option `--filters` turns on using filters from config. Currently there +are two kind of filters: filters on languages and filter on flag +`deleted`. They are defined in the config file the following way:: + + [filters] + lang = en ru + deleted = 0 + +`lang` filters is a list of language codes separated by a space. +`deleted` is a 0/1 flag; 0 hides deleted books from search. + +Option `--download-to` provides the path to the download directory. +By default the script downloads books to the current directory. +If the option is used without `path` argument the path is extracted from +configuration file, section `[download]`, key `path`:: + + [download] + path = /tmp + Option `--get` allows to download a book from the library to a local file. The option allows to download exactly one book. The simplest way to use it is via option `--id`. The file is downloaded into the current @@ -265,8 +286,11 @@ Options:: -p, --port port HTTP port to listen to -Run a web server. If a port is given listen on the given port. Else -choose a random port. Start a browser (or open a new window of a running -browser) pointing it to the server. +Run a web server. If a port is given listens on the given port else +chooses a random port. Starts a browser (or open a new window of a +running browser) pointing it to the server. + +If the program is already running the second instance detects the first +one, starts a browser pointing to running instance and exits. .. vim: set tw=72 :