samidare(1) [debian man page]
SAMIDARE(1) User Commands SAMIDARE(1) NAME
samidare - web page update checker SYNOPSIS
samidare [OPTION]... [URL]... DESCRIPTION
Samidare checks web page updates. It takes a list of URLs in a configuration file, config.yml, and checks last update time of them. A HTML file, latest.html, is generated to show the updates. OPTIONS
--help show help message. -v, --verbose specify verbose mode. -n, --no-check don't check web. output generation only. -f, --force force check (avoid timing control mechanism) -o, --output=filename specify output html filename. --output-lirs=filename specify output lirs filename. -T, --template=filename specify template filename. -t, --timing show check time of pages. --dump-config dump flatten configuration. --dump-status dump status. If URLs is specified, the status of specified pages are shown. --dump-template-data dump data for expand template. The "data" variable in template file refer this. --dump-filenames dumps locally stored filenames of pages specified by URLs. --dump-filenames2 dumps locally stored recent two filenames of pages specified by URLs. --remove-entry remove entry of pages specified by URLs. --diff-content show difference of recent two files of specified URLs. USAGE
samidare is configured by "config.yml" and "t.latest.html" by default. samidare generates "latest.html" and "sites.lirs.gz" samidare uses "status.rm" and "tmp" to record status of pages. "config.yml" is a configuration file in YAML format. See EXAMPLES section for its content. "t.latest.html" is a template file. In the file, "data" variable can be used. See the document of htree library for template directives. So you can run samidare as follows. % cd $HOME % mkdir samidare % cd samidare % vi config.yml % vi t.latest.html # optional % samidare % w3m latest.html # view the result If you want to publish the result, use symbolic link to latest.html and sites.lirs.gz as follows. % mkdir public_html % mkdir public_html/samidare % cd public_html/samidare % ln -s ../../samidare/latest.html . % ln -s ../../samidare/sites.lirs.gz . EXAMPLES
The configuration file is described in YAML format. The simplest configuration is list of URLs as follows. - http://www.example.org/blog/ - http://www.example.net/ FILES
"config.yml" and "t.latest.html" is configuration file. "latest.html" and "sites.lirs.gz" is output. "status.rm" and "tmp" is used by samidare internally. SECURITY
samidare stores pages in tmp directory. If it is published via your web server, XSS (cross site scripting) is possible. So the directory should not be published. AUTHOR
Tanaka Akira SEE ALSO
htree samidare 0.7 July 2008 SAMIDARE(1)
Check Out this Related Man Page
CFGET(1) User Commands CFGET(1) NAME
cfget - get values from a config file SYNOPSIS
cfget [options] section/key cfget [options] --dump=STYLE [section/key [section/key...]] cfget [options] --template=STYLE [infile [outfile]] DESCRIPTION
Get values from a config file. cfget is a simple tool to read values from configuration files. It is useful, for example, to create configurable shellscripts or make- files. It can also be configured to support virtual configuration values that, if not present in the config file, are automatically computed from the existing values. This makes it convenient, for example, to get a "duration" value from a configuration file that only contains a "start date" and an "end date". OPTIONS
--version show program's version number and exit -h, --help show this help message and exit -q, --quiet quiet mode: only output fatal errors -v, --verbose verbose mode --debug verbose mode -C file, --cfg=file config file to read; the option can be given more than once to read more than one file. If missing, read a colon separated list from the CFGET_CFG env variable. -P file, --plugin=file list of plugin files or directories to load. The option can be given more than once to read more than one file. If missing, read a colon separated list from the CFGET_PLUGINS env variable. -d name, --dump=name dump the contents of the database using the given style. Use '--dump=list' for a list of available styles. If one or more paths are provided in the command line, dump only those paths, otherwise dump all. -t name, --template=name read a template file, expand template placeholders using the configuration data and output the result. Use '--template=list' for a list of available styles. -f name, --format=name use a custom configuration file format (default: ini). Use '--format=list' for a list of available formats. The CFGET_FORMAT envi- ronment value, if defined, can be used to provide a different default value. -r path, --root=path restrict all work to values under the given path EXAMPLES
# Get a key from a config file cfget -C file.ini general/name # More can be specified, they will be searched in order cfget -C general.ini -C local.ini general/name # Use a plugin to add virtual entries cfget -C file.ini --plugin=virtual.py general/name # A plugin can also a directory containing .py files # and plugins can also be specified more than once cfget -C file.ini --plugin=virtual.py --plugin=virtual/ general/name # In a shellscript, you may want to use environment variables if you # invoke cfget many times: #!/bin/sh CFGET_CFG=general.ini:local.ini CFGET_PLUGINS=virtual.py:virtual/ START=`cfget general/start` END=`cfget general/end` DURATION=`cfget general/duration` # Quick way to copy all config values to the environment eval `cfget --dump=exports -C file.ini` # Autoconf-style template substitution cfget --template=autoconf -C file.ini script.in script # Curly braces substitude literally cfget -C file.ini "general/start_{general/type}" # One can use simple expressions cfget -C file.ini "general/start + general/duration" cfget -C file.ini "round(general/age / 2)" AUTHOR
cfget has been written by Enrico Zini <enrico@enricozini.org>. cfget 0.15 July 2010 CFGET(1)