300 lines
14 KiB
Plaintext
300 lines
14 KiB
Plaintext
# Sample rawdog config file. Copy this into your ~/.rawdog/ directory, and edit
|
|
# it to suit your preferences.
|
|
# All paths in this file should be either absolute, or relative to your .rawdog
|
|
# directory.
|
|
# If you want to include another config file, then use "include FILENAME".
|
|
|
|
# Times in this file are specified as a value and a unit (for instance,
|
|
# "4h"). Units available are "s" (seconds), "m" (minutes), "h" (hours),
|
|
# "d" (days) and "w" (weeks). If no unit is specified, rawdog will
|
|
# assume minutes.
|
|
# Boolean (yes/no) values in this file are specified as "true" or "false".
|
|
|
|
# rawdog can be extended using plugin modules written in Python. This
|
|
# option specifies the directories to search for plugins to load. If a
|
|
# directory does not exist or cannot be read, it will be ignored. This
|
|
# option must appear before any options that are implemented by plugins.
|
|
plugindirs plugins
|
|
|
|
# Whether to split rawdog's state amongst multiple files.
|
|
# If this is turned on, rawdog will use significantly less memory, but
|
|
# will do more disk IO -- probably a good idea if you read a lot of
|
|
# feeds.
|
|
splitstate false
|
|
|
|
# The maximum number of articles to show on the generated page.
|
|
# Set this to 0 for no limit.
|
|
maxarticles 20
|
|
|
|
# The maximum age of articles to show on the generated page.
|
|
# Set this to 0 for no limit.
|
|
maxage 0
|
|
|
|
# The age after which articles will be discarded if they do not appear
|
|
# in a feed. Set this to a larger value if you want your rawdog output
|
|
# to cover more than a day's worth of articles.
|
|
expireage 1d
|
|
|
|
# The minimum number of articles from each feed to keep around in the history.
|
|
# Set this to 0 to only keep articles that were returned the last time the feed
|
|
# was fetched. (If this is set to 0, or "currentonly" below is set to true,
|
|
# then rawdog will not send the RFC3229+feed "A-IM: feed" header when making
|
|
# HTTP requests, since it can't tell from the response to such a request
|
|
# whether any articles have been removed from the feed; this makes rawdog
|
|
# slightly less bandwidth-efficient.)
|
|
keepmin 20
|
|
|
|
# Whether to only display articles that are currently included in a feed
|
|
# (useful for "planet" pages where you only want to display the current
|
|
# articles from several feeds). If this is false, rawdog will keep a
|
|
# history of older articles.
|
|
currentonly false
|
|
|
|
# Whether to divide the articles up by day, writing a "dayformat" heading
|
|
# before each set.
|
|
daysections true
|
|
|
|
# The format to write day headings in. See "man strftime" for more
|
|
# information; for example:
|
|
# %A, %d %B Wednesday, 21 January
|
|
# %Y-%m-%d 2004-01-21 (ISO 8601 format)
|
|
dayformat %A, %d %B
|
|
|
|
# Whether to divide the articles up by time, writing a "timeformat" heading
|
|
# before each set.
|
|
timesections true
|
|
|
|
# The format to write time headings in. For example:
|
|
# %H:%M 18:07 (ISO 8601 format)
|
|
# %I:%M %p 06:07 PM
|
|
timeformat %H:%M
|
|
|
|
# The format to display feed update and article times in. For example:
|
|
# %H:%M, %A, %d %B 18:07, Wednesday, 21 January
|
|
# %Y-%m-%d %H:%M 2004-01-21 18:07 (ISO 8601 format)
|
|
datetimeformat %H:%M, %A, %d %B
|
|
|
|
# The page template file to use, or "default" to use the built-in template
|
|
# (which is probably sufficient for most users). Use "rawdog -s page" to show
|
|
# the template currently in use as a starting-point for customisation.
|
|
# The following strings will be replaced in the output:
|
|
# __version__ The rawdog version in use
|
|
# __refresh__ The HTML 4 <meta http-equiv="refresh" ...> header
|
|
# __items__ The aggregated items
|
|
# __num_items__ The number of items on the page
|
|
# __feeds__ The feed list
|
|
# __num_feeds__ The number of feeds listed
|
|
# You can define additional strings using "define" in this config file; for
|
|
# example, if you say "define myname Adam Sampson", then "__myname__" will be
|
|
# replaced by "Adam Sampson" in the output.
|
|
pagetemplate template.bl4n
|
|
|
|
# Similarly, the template used for each item shown. Use "rawdog -s item" to
|
|
# show the template currently in use as a starting-point for customisation.
|
|
# The following strings will be replaced in the output:
|
|
# __title__ The item title (as an HTML link, if possible)
|
|
# __title_no_link__ The item title (as text)
|
|
# __url__ The item's URL, or the empty string if it doesn't
|
|
# have one
|
|
# __guid__ The item's GUID, or the empty string if it doesn't
|
|
# have one
|
|
# __description__ The item's descriptive text, or the empty string
|
|
# if it doesn't have a description
|
|
# __date__ The item's date as provided by the feed
|
|
# __added__ The date the article was received by rawdog
|
|
# __hash__ A hash of the article (useful for summary pages)
|
|
#
|
|
# All of the __feed_X__ strings from feeditemtemplate below will also be
|
|
# expanded here, for the feed that the article came from.
|
|
#
|
|
# You can define additional strings on a per-feed basis by using the
|
|
# "define_X" feed option; see the description of "feed" below for more
|
|
# details.
|
|
#
|
|
# Simple conditional expansion is possible by saying something like
|
|
# "__if_items__ hello __endif__"; the text between the if and endif will
|
|
# only be included if __items__ would expand to something other than
|
|
# the empty string. Ifs can be nested, and __else__ is supported.
|
|
# (This also works for the other templates, but it's most useful here.)
|
|
itemtemplate item.bl4n
|
|
|
|
# The template used to generate the feed list (__feeds__ above). Use "rawdog
|
|
# -s feedlist" to show the current template.
|
|
# The following strings will be replaced in the output:
|
|
# __feeditems__ The feed items
|
|
feedlisttemplate default
|
|
|
|
# The template used to generate each item in the feed list. Use "rawdog
|
|
# -s feeditem" to show the current template.
|
|
# The following strings will be replaced in the output:
|
|
# __feed_id__ The feed's title with non-alphanumeric characters
|
|
# (and HTML markup) removed (useful for per-feed
|
|
# styles); you can use the "id" feed option below to
|
|
# set a custom ID if you prefer
|
|
# __feed_hash__ A hash of the feed URL (useful for per-feed styles)
|
|
# __feed_title__ The feed title (as an HTML link, if possible)
|
|
# __feed_title_no_link__
|
|
# The feed title (as text)
|
|
# __feed_url__ The feed URL
|
|
# __feed_icon__ An "XML button" linking to the feed URL
|
|
# __feed_last_update__
|
|
# The time when the feed was last updated
|
|
# __feed_next_update__
|
|
# The time when the feed will next need updating
|
|
feeditemtemplate default
|
|
|
|
# Where to write the output HTML to. You should place style.css in the same
|
|
# directory. Specify this as "-" to write the HTML to stdout.
|
|
# (You will probably want to make this an absolute path, else rawdog will write
|
|
# to a file in your ~/.rawdog directory.)
|
|
outputfile /srv/http/veille/index.html
|
|
#outputfile /home/you/public_html/rawdog.html
|
|
|
|
# Whether to use a <meta http-equiv="Refresh" ...> tag in the generated
|
|
# HTML to indicate that the page should be refreshed automatically. If
|
|
# this is turned on, then the page will refresh every N minutes, where N
|
|
# is the shortest feed period value specified below.
|
|
# (This works by controlling whether the default template includes
|
|
# __refresh__; if you use a custom template, __refresh__ is always
|
|
# available.)
|
|
userefresh true
|
|
|
|
# Whether to show the list of active feeds in the generated HTML.
|
|
# (This works by controlling whether the default template includes
|
|
# __feeds__; if you use a custom template, __feeds__ is always
|
|
# available.)
|
|
showfeeds true
|
|
|
|
# The number of concurrent threads that rawdog will use when fetching
|
|
# feeds -- i.e. the number of feeds that rawdog will attempt to fetch at
|
|
# the same time. If you have a lot of feeds, setting this to be 20 or
|
|
# so will significantly speed up updates. If this is set to 1 (or
|
|
# fewer), rawdog will not start any additional threads at all.
|
|
numthreads 1
|
|
|
|
# The time that rawdog will wait before considering a feed unreachable
|
|
# when trying to connect. If you're getting lots of timeout errors and
|
|
# are on a slow connection, increase this.
|
|
# (Unlike other times in this file, this will be assumed to be in
|
|
# seconds if no unit is specified.)
|
|
timeout 30s
|
|
|
|
# Whether to ignore timeouts. If this is false, timeouts will be reported as
|
|
# errors; if this is true, rawdog will silently ignore them.
|
|
ignoretimeouts false
|
|
|
|
# Whether to show Python traceback messages. If this is true, rawdog will show
|
|
# a traceback message if an exception is thrown while fetching a feed; this is
|
|
# mostly useful for debugging rawdog or feedparser.
|
|
showtracebacks false
|
|
|
|
# Whether to display verbose status messages saying what rawdog's doing
|
|
# while it runs. Specifying -v or --verbose on the command line is
|
|
# equivalent to saying "verbose true" here.
|
|
verbose false
|
|
|
|
# Whether to attempt to fix bits of HTML that should start with a
|
|
# block-level element (such as article descriptions) by prepending "<p>"
|
|
# if they don't already start with a block-level element.
|
|
blocklevelhtml true
|
|
|
|
# Whether to attempt to turn feed-provided HTML into valid HTML.
|
|
# The most common problem that this solves is a non-closed element in an
|
|
# article causing formatting problems for the rest of the page.
|
|
# For this option to have any effect, you need to have PyTidyLib or mx.Tidy
|
|
# installed.
|
|
tidyhtml true
|
|
|
|
# Whether the articles displayed should be sorted first by the date
|
|
# provided in the feed (useful for "planet" pages, where you're
|
|
# displaying several feeds and want new articles to appear in the right
|
|
# chronological place). If this is false, then articles will first be
|
|
# sorted by the time that rawdog first saw them.
|
|
sortbyfeeddate true
|
|
|
|
# Whether to consider articles' unique IDs or GUIDs when updating rawdog's
|
|
# database. If you turn this off, then rawdog will create a new article in its
|
|
# database when it sees an updated version of an existing article in a feed.
|
|
# You probably want this turned on.
|
|
useids true
|
|
|
|
# The fields to use when detecting duplicate articles: "id" is the article's
|
|
# unique ID or GUID; "link" is the article's link. rawdog will find the first
|
|
# one of these that's present in the article, and ignore the article if it's
|
|
# seen an article before (in any feed) that had the same value. For example,
|
|
# specifying "hideduplicates id link" will first look for id/guid, then for
|
|
# link.
|
|
# Note that some feeds use the same link for all their articles; if you specify
|
|
# "link" here, you will probably want to specify the "allowduplicates" feed
|
|
# argument (see below) for those feeds.
|
|
hideduplicates id
|
|
|
|
# The period to use for new feeds added to the config file via the -a|--add
|
|
# option.
|
|
newfeedperiod 3h
|
|
|
|
# Whether rawdog should automatically update this config file (and its
|
|
# internal state) if feed URLs change (for instance, if a feed URL
|
|
# results in a permanent HTTP redirect). If this is false, then rawdog
|
|
# will ask you to make the necessary change by hand.
|
|
changeconfig true
|
|
|
|
# The feeds you want to watch, in the format "feed period url [args]".
|
|
# The period is the minimum time between updates; if less than period
|
|
# minutes have passed, "rawdog update" will skip that feed. Specifying
|
|
# a period less than 30 minutes is considered to be bad manners; it is
|
|
# suggested that you make the period as long as possible.
|
|
# Arguments are optional, and can be given in two ways: either on the end of
|
|
# the "feed" line in the form "key=value", separated by spaces, or as extra
|
|
# indented lines after the feed line.
|
|
# possible arguments are:
|
|
# id Value for the __feed_id__ value in the item
|
|
# template for items in this feed (defaults to the
|
|
# feed title with non-alphanumeric characters and
|
|
# HTML markup removed)
|
|
# user User for HTTP basic authentication
|
|
# password Password for HTTP basic authentication
|
|
# format "text" to indicate that the descriptions in this feed
|
|
# are unescaped plain text (rather than the usual HTML),
|
|
# and should be escaped and wrapped in a <pre> element
|
|
# X_proxy Proxy URL for protocol X (for instance, "http_proxy")
|
|
# proxyuser User for proxy basic authentication
|
|
# proxypassword Password for proxy basic authentication
|
|
# allowduplicates "true" to disable duplicate detection for this feed
|
|
# maxage Override the global "maxage" value for this feed
|
|
# keepmin Override the global "keepmin" value for this feed
|
|
# define_X Equivalent to "define X ..." for item templates
|
|
# when displaying items from this feed
|
|
# You can provide a default set of arguments for all feeds using
|
|
# "feeddefaults". You can specify as many feeds as you like.
|
|
# (These examples have been commented out; remove the leading "#" on each line
|
|
# to use them.)
|
|
feeddefaults
|
|
killtags true
|
|
truncate 120
|
|
# http_proxy http://proxy.example.com:3128/
|
|
#feed 1h http://example.com/feed.rss
|
|
#feed 30m http://example.com/feed2.rss id=newsfront
|
|
#feed 3h http://example.com/feed3.rss keepmin=5
|
|
#feed 3h http://example.com/secret.rss user=bob password=secret
|
|
#feed 3h http://example.com/broken.rss
|
|
# format text
|
|
# define_myclass broken
|
|
#feed 3h http://proxyfeed.example.com/proxied.rss http_proxy=http://localhost:1234/
|
|
#feed 3h http://dupsfeed.example.com/duplicated.rss allowduplicates=true
|
|
|
|
# Wallabag
|
|
feed 3h https://github.com/wallabag/wallabag/releases.atom
|
|
# Dokuwiki
|
|
feed 3h https://github.com/splitbrain/dokuwiki/releases.atom
|
|
# ArchLinux
|
|
feed 3h https://archlinux.org/feeds/news/
|
|
# rawdog
|
|
feed 3h http://offog.org/git/rawdog.atom
|
|
# SabreDaV
|
|
feed 3h https://github.com/sabre-io/dav/releases.atom
|
|
# Shaarli
|
|
feed 3h https://github.com/shaarli/Shaarli/releases.atom
|
|
# Hugo
|
|
feed 3h https://github.com/gohugoio/hugo/releases.atom
|