debian/changelog: release package version 0.4-1

Gbp-Dch: ignore

debian/control: bump Standards-Version to 3.9.6

debian/copyright: update copyright years

debian/control: depend on php-xml-serializer

tweeper now uses php-xml-serializer to convert JSON to XML for sites
that provide the information in JSON, like Instagram.com.

debian/control: update the package description

Use the more generic description used upstream.

Merge tag 'v0.4' into debian

Release v0.4

NEWS: add release notes for the v0.4 release

rss_converter_instagram.com.xsl: use the username when there is no full name

rss_converter_instagram.com.xsl: improve channel description

Some users have a biography, some users only have an external URL, some
users have both and some have neither.

Make the channel description a little smarter trying to handle these
case.

rss_converter_facebook.com.xsl: fix channel title, link and description

It looks like using the meta elements does not work anymore.

TODO: support for images on Twitter.com can be improved

tweeper.1.asciidoc: update the copyright years

tweeper.1.asciidoc: document how to use the PHP built-in web server

README: improve wording in a paragraph

tweeper.1.asciidoc: describe what tweeper is in a more generic way

README: describe what tweeper is in a more generic way

Since tweeper does not support only Twitter.com but also other social
websites, give a more general idea of what it can be used for.

rss_converter_instagram.com.xsl: show the user name in the titles

This makes it easier to see who created the item when different
Instagram feeds are grouped into a directory.

tweeper: avoid a reference to $argv in non-cli mode

$argv is not defined in non-cli mode, so protect its usage behind an
is_cli() check.

For instance, this avoids a message in the PHP built-in web server, when
usage() gets called:

  PHP Notice:  Undefined variable: argv in .../tweeper.php on line 357

tweeper: make is_cli() stricter

Assume that tweeper is running from an actual command line only when
php_sapi_name() matches _exactly_ the string "cli".

This makes it possible to use tweeper in a browser using the PHP
built-in web server, for which php_sapi_name() returns "cli-server".

TODO: remove item about duplicated RSS items

Now all the generated feeds use the <guid/> element to uniquely identify
items.

TODO: remove item about Instagram videos

Even if tweeper does not show the video itself in the RSS item content
it at least tells the user that the content is a video, so consider this
done.

rss_converter_instagram.com.xsl: add a label if the content is a video

rss_converter_instagram.com.xsl: fix enclosure generation

rss_converter_instagram.com.xsl: ellipsize titles

rss_converter_instagram.com.xsl: use the image caption as the item content

Instagram has reintroduced serving the image caption in the json data,
so use it; it is way nicer than the stats tweeper was showing before.

rss_converter_instagram.com.xsl: use better name for the image variable

Add support for Facebook.com public pages

tweeper.php: support host-specific methods for preprocessing the HTML data

Some sites serve mangled HTML code, so a mechanism to clean it up before
loading it as XML is needed.

For instance, facebook.com puts come content inside HTML comments, and
these must be stripped in order to make the content available to the
HTML parser when loading the data into a DOMDocument.

tweeper.php: strip the leading "www." from hosts

This makes tweeper more forgiving when it is passed URLs either with or
without the "www" subdomain for the same host.

tweeper.php: make error about missing stylesheet more explicit

rss_converter_instagram.com.xsl: update to new json format

The new Instagram homepage provides json data in a format different than
before, update the xsl to support it.

Unfortunately the data in the new format does not provide the
descriptions of the items, so use some placeholder values (URL, comments
count, likes count) to present at least something.

rss_converter_twitter.com.xsl: update XPath of tweet content

Using the role attribute to differentiate between original tweets and
quoted tweet, as introduced in commit 4c2e986, does not work anymore,
but the fact that original tweets are <li></li> elements while quoted
tweets are <div></div> elements can be used instead.

rss_converter_twitter.com.xsl: improve matching the permalink

Extract the permalink using the @data-permalink-path attribute, this
works for withheld tweets too preventing them from having all the same
guid.

rss_converter_twitter.com.xsl: restrict tweet matching

With new style retweets the quoted text is also matched by
[@data-item-type='tweet'] but then the content is not handled, resulting
in empty items in the RSS feed.

Checking also for @role='listitem' allows to pick up only top-level
tweets.

tweeper.php: make date handling functions a little more robust

Provide at least _some_ error checking and a fall-back value for invalid
dates.

tweeper.php: factor out an is_cli() function

README: mention the supported sites in the README file

tweeper.1.asciidoc: mention the supported sites in the man page

TODO: update some entries

The new Dilbert.com site does not have a different /fast version, so no
point in mentioning it.

Mention possible support for Instagram videos.

Add support for converting Instagram user timelines to RSS

tweeper.php: add infrastructure for sites using json data

Some websites provide the timelines as json data and convert that to
html in the client.

Supporting these sites will be done by defining host specific methods to
extract the json data to pass to json_to_xml().

tweeper.php: fix validation when generating enclosure elements

The RSS specification says that the enclosure element url must be http.
See http://sourceforge.net/p/feedvalidator/bugs/72/

So follow the specification, for now. If feedvalidator decides to relax
this requirement this hack will be removed.

tweeper.php: factor out an html_to_xml() function from the tweep() method

Split the operation to get some xml out of the web page, this in
preparation for adding some more flexibility about what can be converted
to xml for a subsequent transformation.

tweeper.php: move loading the stylesheet into the Tweeper class

Let the Tweeper class load the stylesheet, specifically when the tweep()
method is called.

This way the same Tweeper object can be reused to convert different URLs
from different websites.

rss_converter_twitter.com.xsl: use ProfileHeaderCard as channel description

Strip trailing newlines

rss_converter_pump.io.xsl: make the feed validate with feedvalidator.org

Make the pump.io feed validate with http://feedvalidator.org and also
improve compatibility by providing a guid and by excluding the weird
xmlns:php namespace in the output.

rss_converter_dilbert.com.xsl: make the feed validate with feedvalidator.org

Make the Dilbert.com feed validate with http://feedvalidator.org and also
improve compatibility by providing a guid and by excluding the weird
xmlns:php namespace in the output.

rss_converter_dilbert.com.xsl: fixes for the new dilbert.com

Make the stylesheet work again with the new dilbert.com website.

rss_converter_howtoons.com.xsl: make the feed validate with feedvalidator.org

Make the Howtoons.com feed validate with http://feedvalidator.org and
also improve compatibility by providing a guid and by excluding the
weird xmlns:php namespace in the output.

rss_converter_twitter.com.xsl: improve the naming of some variables

Use item-content and item-permalink instead of tweet-text and
tweet-link, this way other stylesheets can use the same names resulting
in more consistency.

rss_converter_twitter.com.xsl: rename twitterBaseURL to BaseURL

This way the same notation is used in all the stylesheets.

rss_converter_twitter.com.xsl: make the feed validate with feedvalidator.org

Make the Twitter feed validate with http://feedvalidator.org and also
improve compatibility by providing a guid and by excluding the weird
xmlns:php namespace in the output.

debian/changelog: release package version 0.3-1

Git-Dch: ignore

debian/control: mention that Howtoons.com is now supported

debian/patches: remove all patches, all have been applied upstream

debian/copyright: update contact info and copyright years

debian/changelog: prepare for package version 0.3-1

Git-Dch: ignore

Merge tag 'v0.3' into debian

Release v0.3

NEWS: add release notes for the v0.3 release

Update email address and copyright years

Add a stylesheet for Howtoons.com

rss_converter_twitter.com.xsl: fix getting the profile picture

Some more values are added tot he class attribute so the old equality
check does not work anymore.

Use a contains() check, this is more future proof and allows also to
support both the classic and the new profile pages.

rss_converter_twitter.com.xsl: support the new Twitter profile page

Adjust the XPath expressions to support both the classic and the new
profile pages.

rss_converter_*.xsl: specify xml:base

Some feed readers expand relative URLs in items by extracting the base
URL from the enclosing <link/> element, however this is not a globally
accepted practice.

Specifying xml:base is useful to cover other ways in which relative URLs
are expanded, see:
  https://cyber.law.harvard.edu/rss/relativeURI.html
  http://www.w3.org/TR/xmlbase/#resolution

debian/changelog: prepare for package version 0.2-3

Git-Dch: ignore

debian/control: cosmetics remove trailing spaces

debian/control: add missing run-time dependencies

Prevent two fatal errors which happen when needed components are not
installed.

Without php5-curl:

  PHP Fatal error:  Call to undefined function curl_init() in
  /usr/share/php/tweeper/tweeper.php on line 52

Without php5-xsl:

  PHP Fatal error:  Class 'XSLTProcessor' not found in
  /usr/share/php/tweeper/tweeper.php on line 33

Closes: #738201
Thanks: Anton Nesterov

debian/patches: add a patch to support "audio/ogg" enclosures

debian/control: update Maintainer email address

tweeper.php: support generating enclosure for "audio/ogg"

debian/changelog: refresh changelog for 0.2-2

Git-Dch: ignore

debian/patches: add a patch to fix the list items in the man page

tweeper.1.asciidoc: reword some list items

Remove the unneeded "as", it is in the list preamble already.

debian/control: reword some list items in the long description

Drop unneeded "as", it was in the preamble of the item list already.

debian/control: suggest libapache2-mod-php5 or php5-cgi

To give hints that tweeper can be used also from a web server.

Remove the auto-generated ChangeLog

It is not that useful once we have a nice NEWS file; and the latter can
even be used as upstream changelog in packages.

debian/changelog: update for 0.2-2

Git-Dch: ignore

debian/docs: package also the README and TODO files

debian/rules: install the NEWS file as the upstream changelog

debian/changelog: prepare for 0.2-2

Git-Dch: ignore

debian/patches: add a fix to the man page from upstream

debian/control: specify the debian package branch in Vcs-Git

This is what is suggested in
http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-VCS-fields

debian/rules: use $(CURDIR) instead of $$(pwd)

Avoid invoking the shell when make already has the needed information.

debian/control: bump Standards-Version to 3.9.5

debian/gbp.conf: explicitly disable pristine-tar

This fixes build when users have pristine-tar set to True in the global
configuration file.

Thanks: gregor herrmann <gregoa@debian.org>

tweeper.1.asciidoc: mention a way to use tweeper from a web server

Makefile: fix typo s/INTALLATION/INSTALLATION/

Thanks-to: gregor herrmann <gregoa@debian.org>

Add initial debian packaging bits

Changelog, NEWS: prepare for the v0.2 release

tweeper.1.asciidoc: small fixes to the man page

tweeper.1.asciidoc: add a missing semicolon

Add a ChangeLog file

Add a NEWS file

Add a Makefile rule to generate a Changelog file

Add a man page

Add a Makefile to simplify installation and packaging

Add a wrapper script intended to be called as an executable

Add also an INSTALL file which explains how to set up tweeper globally
on the filesystem.

Write error messages on STDERR and return saner values in CLI mode

The previous use of die() was not very useful in CLI mode as the script
was always returning 0.

Fix that and also write error messages to the appropriate output stream.

Note the use of 'php://output' as error stream for non CLI mode, this
ensures that error messages would be readable in the browser window.

TODO: add more info about checking UTF output