diff --git a/.bzrignore b/.bzrignore index 1d1886c..a8f0629 100644 --- a/.bzrignore +++ b/.bzrignore @@ -1,3 +1,4 @@ *.tmplc .DS_Store cache +*.pluginc diff --git a/THANKS b/THANKS index c6ab616..eb7c72f 100644 --- a/THANKS +++ b/THANKS @@ -13,6 +13,10 @@ Morten Frederiksen - Support WordPress LinkManager OPML Harry Fuecks - default item date to feed date Antonio Cavedoni - Django templates Morten Frederiksen - expungeCache +Lenny Domnitser - Coral CDN support for URLs with non-standard ports +Amit Chakradeo - Allow read-only files to be overwritten +Matt Brubeck - fix new_channel +Aristotle Pagaltzis - ensure byline_author filter doesn't drop foreign markup This codebase represents a radical refactoring of Planet 2.0, which lists the following contributors: diff --git a/docs/config.html b/docs/config.html index abb3f19..4a08ed7 100644 --- a/docs/config.html +++ b/docs/config.html @@ -68,6 +68,9 @@ can be found
filters
+can be founditems_per_page
on a per template basis, but at the current time Planet Venus doesn't
implement this.
+Filters can be defined on a per-template basis, and will be used to post-process the output of the template.
[
filter]
Sections which are listed in [planet] filters
are
diff --git a/docs/etiquette.html b/docs/etiquette.html
new file mode 100644
index 0000000..a567e77
--- /dev/null
+++ b/docs/etiquette.html
@@ -0,0 +1,48 @@
+
+
+
You would think that people who publish syndication feeds do it with the +intent to be syndicated. But the truth is that we live in a world where +deep linking can +cause people to complain. Nothing is safe. But that doesn’t +stop us from doing links.
+ +These concerns tend to increase when you profit, either directly via ads or +indirectly via search engine rankings, from the content of others.
+ +While there are no hard and fast rules that apply here, here’s are a +few things you can do to mitigate the concern:
+ +++
- robots.txt:
+- +
User-agent: *
+Disallow: /- index.html:
+- +
<meta name="robots" content="noindex,nofollow"/>
- atom.xml:
+- +
+
<feed xmlns:indexing="urn:atom-extension:indexing" indexing:index="no">
<access:restriction xmlns:access="http://www.bloglines.com/about/specs/fac-1.0" relationship="deny"/>
Ensure that all copyright and licensing information is propagated to the +combined feed(s) that you produce.
Add no advertising. Consider filtering out ads, lest you +be accused of using someone’s content to help your friends profit.
Most importantly, if anyone does object to their content being included, +quickly and without any complaint, remove them.
Filters are simple Unix pipes. Input comes in stdin
,
-parameters come from the config file, and output goes to stdout
.
-Anything written to stderr
is logged as an ERROR message. If no
-stdout
is produced, the entry is not written to the cache or
-processed further; in fact, if the entry had previously been written to the cache, it will be removed.
Filters and plugins are simple Unix pipes. Input comes in
+stdin
, parameters come from the config file, and output goes to
+stdout
. Anything written to stderr
is logged as an
+ERROR message. If no stdout
is produced, the entry is not written
+to the cache or processed further; in fact, if the entry had previously been
+written to the cache, it will be removed.
Input to a filter is a aggressively +
There are two types of filters supported by Venus, input and template.
+Input to an input filter is a aggressively normalized entry. For example, if a feed is RSS 1.0 with 10 items, the filter will be called ten times, each with a single Atom 1.0 entry, with all textConstructs expressed as XHTML, and everything encoded as UTF-8.
+Input to a template filter will be the output produced by the template.
You will find a small set of example filters in the filters directory. The
Notes
-
[planet]
section of your config.ini
+will be invoked on all feeds. Filters listed in individual
+[feed]
sections will only be invoked on those feeds.
+Filters listed in [template]
sections will be invoked on the
+output of that template.[planet]
section of your config.ini
-will be invoked on all feeds. Filters listed in individual
-[feed]
sections will only be invoked on those feeds..py
invokes
python. .xslt
involkes XSLT. .sed
and
.tmpl
(a.k.a. htmltmp) are also options. Other languages, like
perl or ruby or class/jar (java), aren't supported at the moment, but these
would be easy to add.>
),
+then the output stream is
+teed; one branch flows
+through the specified filter and the output is planced into the named file; the
+other unmodified branch continues onto the next filter, if any.
+One use case for this function is to use
+xhtml2html to produce both an XHTML and
+an HTML output stream from one source.os.abort()
can't be recovered
+from.