2012-12-17 20:28:20 +00:00
|
|
|
|
DOSAGE(1) DOSAGE(1)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
2013-03-25 18:46:48 +00:00
|
|
|
|
dosage - a comic strip downloader and archiver
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
dosage [options] module...
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
dosage is an application designed to keep a local mirror of
|
|
|
|
|
specific web comics and other picture-based content, such as
|
|
|
|
|
Picture Of The Day sites, with a variety of options for updat‐
|
|
|
|
|
ing and maintaining collections.
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
-b PATH, --basepath=PATH
|
|
|
|
|
Specifies a base path to put comic subdirectories. The
|
|
|
|
|
default is Comics.
|
|
|
|
|
|
|
|
|
|
--baseurl=PATH
|
2013-03-11 16:33:59 +00:00
|
|
|
|
Specifies the base URL for output handlers. The default
|
|
|
|
|
is a local file URI.
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
-a, --all
|
|
|
|
|
Traverses all available strips backwards from the cur‐
|
|
|
|
|
rent one. This can be useful you want a full collection
|
|
|
|
|
of a new comic strip, or update an existing one where
|
|
|
|
|
files are missing. Catchups can start at a specific
|
|
|
|
|
strip by using the index syntax, see the INDEX SYNTAX
|
|
|
|
|
and SPECIAL SYNTAX sections for more information. This
|
|
|
|
|
is useful when you missed some days and want only to
|
2013-02-07 19:48:21 +00:00
|
|
|
|
download the missing files.
|
|
|
|
|
|
|
|
|
|
-c, --continue
|
|
|
|
|
Same as --all, but stop at the first existing image
|
|
|
|
|
file. Useful for cron jobs that are not executed every
|
|
|
|
|
day.
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
-h, --help
|
|
|
|
|
Output brief help information.
|
|
|
|
|
|
|
|
|
|
-l, --list
|
|
|
|
|
List available comic modules in multi-column fashion.
|
|
|
|
|
|
|
|
|
|
--singlelist
|
|
|
|
|
List available comic modules in single-column fashion.
|
|
|
|
|
|
|
|
|
|
-m MODULE, --modulehelp=MODULE
|
|
|
|
|
Output module-specific help for MODULE.
|
|
|
|
|
|
|
|
|
|
-o OUTPUT, --output=OUTPUT
|
|
|
|
|
OUTPUT may be any one of the following:
|
|
|
|
|
|
2013-02-07 19:48:21 +00:00
|
|
|
|
html - Writes out an HTML file linking to the strips
|
|
|
|
|
actually downloaded in the current run, named by date
|
|
|
|
|
(ala dailystrips). The files can be found in the html
|
2012-12-17 20:28:20 +00:00
|
|
|
|
directory of your Comics directory.
|
|
|
|
|
|
2013-02-07 19:48:21 +00:00
|
|
|
|
rss - Writes out an RSS feed detailing what strips were
|
|
|
|
|
downloaded in the last 24 hours. The feed can be found
|
2012-12-17 20:28:20 +00:00
|
|
|
|
in Comics/dailydose.xml.
|
2013-03-26 16:35:26 +00:00
|
|
|
|
|
|
|
|
|
json - Write a JSON file with all download infos (URLs,
|
|
|
|
|
images). Can be used with other scripts, eg. order-sym‐
|
|
|
|
|
links.py to add symbolic links.
|
2013-03-11 16:33:59 +00:00
|
|
|
|
This option can be given multiple times.
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
-t, --timestamps
|
|
|
|
|
Print timestamps for all output at any level.
|
|
|
|
|
|
|
|
|
|
-v, --verbose
|
|
|
|
|
Increase the output level by one with each occurence.
|
|
|
|
|
|
|
|
|
|
-V, --version
|
2013-04-09 21:40:35 +00:00
|
|
|
|
Display the version number.
|
|
|
|
|
|
|
|
|
|
--vote Vote for the selected comics to tell others that you
|
|
|
|
|
like them. The sum of all votes for a comic will be
|
|
|
|
|
displayed at the comic index pages at http://wum‐
|
|
|
|
|
mel.github.io/dosage/comic-index.html module At least
|
|
|
|
|
one valid module must be specified. A list of valid mod‐
|
|
|
|
|
ules can be found by passing the -l option. Multiple
|
|
|
|
|
module arguments can be specified on the command line.
|
|
|
|
|
Module names are case insensitive, and it is sufficient
|
|
|
|
|
to specify a unique substring of the module name.
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
INDEX SYNTAX
|
2013-04-09 21:40:35 +00:00
|
|
|
|
Instead of starting at the latest comic strip, an index lets
|
|
|
|
|
dosage start at a certain strip. The index can be specified by
|
2012-12-17 20:28:20 +00:00
|
|
|
|
appending a colon : and the index name after the module. Multi‐
|
|
|
|
|
ple comma-spearated indices can also be specified.
|
|
|
|
|
|
2013-04-09 21:40:35 +00:00
|
|
|
|
The index name itself usually is the part of the comic strip
|
|
|
|
|
URL that identifiess a strip, eg. a number or a date. The
|
|
|
|
|
expected format is documented when using the --modulehelp
|
2012-12-17 20:28:20 +00:00
|
|
|
|
option.
|
|
|
|
|
|
|
|
|
|
SPECIAL SYNTAX
|
2013-04-09 21:40:35 +00:00
|
|
|
|
@ This expands to mean all the comics currently in your
|
2012-12-17 20:28:20 +00:00
|
|
|
|
Comics directory. All other specified comic module names
|
|
|
|
|
will be ignored.
|
|
|
|
|
|
|
|
|
|
@@ This expands to mean all the comics available to Dosage.
|
|
|
|
|
|
|
|
|
|
INDEX SYNTAX can not be used with SPECIAL SYNTAX.
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
|
Retrieve all Mega Tokyo comics:
|
|
|
|
|
dosage -a megatokyo
|
|
|
|
|
|
|
|
|
|
Retrieve the current comic of Cyanide and Happiness:
|
|
|
|
|
dosage cyanideandhappiness
|
|
|
|
|
|
2013-04-09 21:40:35 +00:00
|
|
|
|
Retrieve the current strip of all comics in your Comics direc‐
|
2012-12-17 20:28:20 +00:00
|
|
|
|
tory:
|
|
|
|
|
dosage @
|
|
|
|
|
|
2013-04-09 17:33:50 +00:00
|
|
|
|
Vote for the comics in your Comics directory:
|
|
|
|
|
dosage --vote @
|
|
|
|
|
|
2013-04-09 21:40:35 +00:00
|
|
|
|
Retrieve the current strip of every comic that there is a mod‐
|
2012-12-17 20:28:20 +00:00
|
|
|
|
ule for:
|
|
|
|
|
dosage @@
|
|
|
|
|
|
|
|
|
|
Retrieve the Penny Arcade strip for a given index:
|
|
|
|
|
dosage pennyarcade:2004-07-22
|
2013-01-24 06:53:34 +00:00
|
|
|
|
|
2013-04-09 21:40:35 +00:00
|
|
|
|
Retrieve Calvin and Hobbes strips from a given index going
|
2013-01-24 06:53:34 +00:00
|
|
|
|
backwards to the beginning.
|
2013-03-06 19:00:30 +00:00
|
|
|
|
dosage -a calvinandhobbes:2012/07/22
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
ENVIRONMENT
|
|
|
|
|
HTTP_PROXY
|
2013-04-09 21:40:35 +00:00
|
|
|
|
dosage will use the specified HTTP proxy when download‐
|
2013-03-26 16:35:26 +00:00
|
|
|
|
ing URL contents.
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
NOTES
|
2013-03-26 16:35:26 +00:00
|
|
|
|
Should retrieval fail on any given strip dosage will attempt to
|
2013-04-09 21:40:35 +00:00
|
|
|
|
retry. However the retry information is only outputted in the
|
2013-03-26 16:35:26 +00:00
|
|
|
|
second and successive output levels.
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
2013-04-09 21:40:35 +00:00
|
|
|
|
At the time of writing, a complete Dosage collection weighs in
|
2012-12-17 20:28:20 +00:00
|
|
|
|
at around 3.0GB.
|
|
|
|
|
|
|
|
|
|
RETURN VALUE
|
|
|
|
|
The return value greater than zero when
|
|
|
|
|
|
|
|
|
|
· a program error occurred.
|
|
|
|
|
|
|
|
|
|
· comics could not be found or downloaded
|
|
|
|
|
|
|
|
|
|
· the program run was aborted with Ctrl-C
|
|
|
|
|
|
|
|
|
|
Else the return value is zero.
|
|
|
|
|
|
|
|
|
|
BUGS
|
2013-04-09 21:40:35 +00:00
|
|
|
|
Users can report or view bugs, patches or feature suggestions
|
2012-12-17 20:28:20 +00:00
|
|
|
|
at https://github.com/wummel/dosage/issues
|
|
|
|
|
|
|
|
|
|
AUTHORS
|
2013-04-09 21:40:35 +00:00
|
|
|
|
Jonathan Jacobs, Tristan Seligmann, Bastian Kleineidam <bas‐
|
2013-03-26 16:35:26 +00:00
|
|
|
|
tian.kleineidam@web.de>
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
COPYRIGHT
|
|
|
|
|
Copyright © 2004-2005 Tristan Seligmann and Jonathan Jacobs
|
2014-01-05 15:50:57 +00:00
|
|
|
|
Copyright © 2012-2014 Bastian Kleineidam
|
2012-12-17 20:28:20 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DOSAGE(1)
|