Installation

En premier lieu, il vous faut un serveur HTTP avec support du PHP. Vous pouvez par exemple utiliser Lighttpd comme décrit dans mon guide Installer Lighttpd et PHP 5 sur Debian 4.0 Etch.

Nous installons en plus les modules nécessaires au bon fonctionnement de Tiny Tiny RSS :

/usr/bin/apt-get install php5-mysql php5-xmlrpc mysql-client-5.0

Vous devez ensuite télécharger la dernière version de Tiny Tiny RSS. Pour ce faire, renseignez la version que vous souhaitez télécharger :

VERSION=1.2.25

Et lancez le téléchargement :

/usr/bin/wget http://tt-rss.org/download/tt-rss-$VERSION.tar.gz \
    --output-document=/tmp/tt-rss-$VERSION.tar.gz

Une fois le téléchargement terminé, décompressez le fichier à l'emplacement adéquat :

/bin/tar --directory=/opt -xzf /tmp/tt-rss-$VERSION.tar.gz

Et renommez le dossier ainsi créé :

/bin/mv /opt/tt-rss-$VERSION /opt/tt-rss

Et nous créons un lien symbolique dans le dossier /var/www:

/bin/ln -s /opt/tt-rss /var/www/

Une fois ceci fait, vous pouvez supprimer l'archive téléchargée :

/bin/rm /tmp/tt-rss-$VERSION.tar.gz

Configuration

Nous devons maintenant configurer Tiny Tiny RSS. En premier lieu, nous créons le fichier de configuration :

/bin/cp /opt/tt-rss/config.php-dist /opt/tt-rss/config.php

Une fois ceci fait, nous créons la base de données que va utiliser Tiny Tiny RSS. Pour ce faire, je vous conseille de suivre mon guide MySQL sur Debian 4.0 Etch.

Attention : Si vous avez suivi mon guide, vous pouvez passer ces lignes de commandes, sinon, remplacer les informations en gras par celles correspondant à votre base de données MySQL :

MYSQL_DB=TTRSS_DATABASE
MYSQL_USERNAME=ttrss_username
MYSQL_USERPWD=ttrss_password

Une fois la base de donnée créée, vous devez créer les tables. Cela se fait par la commande :

/usr/bin/mysql --user=$MYSQL_USERNAME --password=$MYSQL_USERPWD $MYSQL_DB \
    < /opt/tt-rss/schema/ttrss_schema_mysql.sql

Il vous faut maintenant modifier la configuration de Tiny Tiny RSS. Cela se fait par les lignes de commandes suivantes :

/bin/sed -i \
    -e "s/\(define('DB_TYPE', \).*/\1'mysql');/" \
    -e "s/\(define('DB_NAME', \).*/\1'$MYSQL_DB');/" \
    -e "s/\(define('DB_USER', \).*/\1'$MYSQL_USERNAME');/" \
    -e "s/\(define('DB_PASS', \).*/\1'$MYSQL_USERPWD');/" \
    /opt/tt-rss/config.php

Votre installation de Tiny Tiny RSS devrait maintenant être disponible depuis l'URL :

• http://localhost/tt-rss

Libre à vous d'apporter les améliorations nécessaires à cette configuration.

Mise à jour régulière des flux

Il est souhaitable que vos flux soient mis à jour même si vous ne vous connectez pas régulièrement à Tiny Tiny RSS. Pour ce faire, installez la ligne de commande PHP :

/usr/bin/apt-get install php5-cli

Modifiez la configuration de façon à ce que la mise à jour des flux par un démon soit possible :

/bin/sed -i \
    -e "s/\(define('ENABLE_UPDATE_DAEMON', \).*/\1true);/" \
    /opt/tt-rss/config.php

Et changez l'emplacement des fichiers verrou :

/bin/sed -i \
    -e "s/\(define('LOCK_DIRECTORY', \).*/\1'\/var\/run\/tt-rss');/" \
    /opt/tt-rss/config.php

Créez le dossier destiné à contenir les fichiers lock :

/bin/mkdir /var/run/tt-rss

Téléchargez le fichier de configuration du script init.d de Tiny Tiny RSS :

/usr/bin/wget http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-tiny-tiny-rss-sur-debian-4-0-etch/tt-rss-default \
    --output-document=/etc/default/tt-rss

Téléchargez le script init.d de Tiny Tiny RSS :

/usr/bin/wget http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-tiny-tiny-rss-sur-debian-4-0-etch/tt-rss-initd \
    --output-document=/etc/init.d/tt-rss

Et rendez le exécutable :

/bin/chmod +x /etc/init.d/tt-rss

Vous pouvez maintenant lancer le script de mise à jour avec la commande :

/etc/init.d/tt-rss start

et l'arrêter avec :

/etc/init.d/tt-rss stop

Si vous souhaitez que cette commande soit lancée au démarrage de votre ordinateur, exécutez la commande :

/usr/sbin/update-rc.d tt-rss defaults

De plus, le démon de mise à jour n'étant pas très stable et ayant tendance à planter régulièrement, il est recommandé de créer un script cron pour le redémarrer si nécessaire :

/bin/echo '#!/bin/sh
# Start tt-rss udpate daemon if necessary :

if [ -x /etc/init.d/tt-rss ]; then
        /etc/init.d/tt-rss start
fi'  | /usr/bin/tee /etc/cron.hourly/tt-rss
/bin/chmod +x /etc/cron.hourly/tt-rss

Le démon ne sera lancé que s'il n'est pas démarrer, grâce à la vérification de la présence d'un fichier verrou. Ce script cron ne pose donc aucun problème.

Utiliser SimplePie à la place de Magpie pour parser les fichiers RSS

SimplePie est un parseur de flux RSS plus puissant que Magpie. Cependant il lui faut utiliser curl afin de pouvoir lire les flux en HTTPS ou ceux nécessitant un mot de passe.

Commencez par installer l'extension curl de php :

/usr/bin/apt-get install php5-curl

Et configurez Tiny Tiny RSS pour utiliser SimplePie :

/bin/sed -i \
    -e "s/\(define('ENABLE_SIMPLEPIE', \).*/\1true);/" \
    /opt/tt-rss/config.php

Remarque : N'oubliez pas de redémarrer votre serveur Web.

Si SimplePie ne vous convient pas, vous pouvez utiliser la ligne de commande suivante pour revenir à Magpie :

/bin/sed -i \
    -e "s/\(define('ENABLE_SIMPLEPIE', \).*/\1false);/" \
    /opt/tt-rss/config.php

Mise en place d'une page d'identification

Pour mettre en place une page d'identification, en premier lieu, activez le mode multi-utilisateurs :

/bin/sed -i \
    -e "s/\(define('SINGLE_USER_MODE', \).*/\1false);/" \
    /opt/tt-rss/config.php

Vous pouvez alors utiliser les informations suivantes pour vous connecter à Tiny Tiny RSS :

• Identifiant : admin
• Mot de passe : password

Activer le support expérimental des traductions

Si vous souhaitez utiliser Tiny Tiny RSS en français, il est souhaitable d'activer ce support. Cependant, il est encore en développement et peut créer des problèmes. Personnellement, chez moi, ca semble fonctionner correctement. Pour activer le support des traduction, exécutez la ligne de commande suivante :

/bin/sed -i \
    -e "s/\(define('ENABLE_TRANSLATIONS', \).*/\1true);/" \
    /opt/tt-rss/config.php

Modifier l'emplacement de stockage des icônes des flux

Par défaut, les icônes des flux sont cachées dans le dossier icons. Si vous souhaitez modifier ce comportement (par exemple parceque Tiny Tiny RSS est installé sur une partition en lecture seule), voici la procédure à suivre.

En premier lieu, créez le dossier destiné à contenir les icônes :

/bin/mkdir --parent /var/lib/tt-rss/icons

Modifiez ses permissions :

/bin/chown -R www-data:www-data /var/lib/tt-rss/icons

Ensuite, supprimez dossier icons de Tiny Tiny RSS :

/bin/rm -r /opt/tt-rss/icons

Et remplacez le par un lien symbolique vers votre nouveau dossier d'icônes :

/bin/ln -s /var/lib/tt-rss/icons /opt/tt-rss/icons

Si vous le souhaitez, vous pouvez aussi modifier la configuration de Tiny Tiny RSS :

/bin/sed -i \
    -e "s/\(define('ICONS_DIR', \).*/\1'\/var\/lib\/tt-rss\/icons');/" \
    /opt/tt-rss/config.php

Tiny Tiny RSS derrière mod_proxy

Si vous utilisez Apache pour regrouper vos différents sites sur un même port, ou pour toute autre raison, il est nécessaire de modifier légèrement Tiny Tiny RSS. Ceci ce fait avec la ligne de commande suivante :

/bin/sed -i -e '/\?>/i\
\t$_SERVER["HTTP_HOST"] = "rss.domain.com";\
\t$_SERVER["SERVER_NAME"] = "rss.domain.com";\
\t$_SERVER["REQUEST_URI"] = "/" . basename($_SERVER["REQUEST_URI"]);' /opt/tt-rss/config.php

Remplacez les valeurs en gras par celles qui correspondent à votre configuration.

Mise à jour de Tiny Tiny RSS

Si une nouvelle version est sortie, et que vous souhaitez mettre à jour votre installation de Tiny Tiny RSS, voici la procédure à suivre. En premier lieu, installez les outils nécessaires :

/usr/bin/apt-get install patch

Placez-vous dans le répertoire de votre installation de Tiny Tiny RSS :

cd /opt/tt-rss

Créez un fichier de différence pour préserver votre configuration :

/usr/bin/diff -Nru config.php-dist config.php > /tmp/tt-rss-config-diff.patch

Renseignez le numéro de la nouvelle version de Tiny Tiny RSS :

VERSION=1.2.25

Et lancez le téléchargement :

/usr/bin/wget http://tt-rss.org/download/tt-rss-$VERSION.tar.gz \
    --output-document=/tmp/tt-rss-$VERSION.tar.gz

Une fois le téléchargement terminé, décompressez le fichier à l'emplacement adéquat :

/bin/tar --directory=/opt -xzf /tmp/tt-rss-$VERSION.tar.gz

Créez le fichier de configuration :

/bin/cp /opt/tt-rss-$VERSION/config.php-dist /opt/tt-rss-$VERSION/config.php

Et patchez le afin de récupèrer votre configuration :

patch --directory=/opt/tt-rss-$VERSION --strip=0 < /tmp/tt-rss-config-diff.patch

Sauvegardez votre ancienne installation de Tiny Tiny RSS :

/bin/mv /opt/tt-rss /opt/tt-rss.old

Et mettez en place la nouvelle version :

/bin/mv /opt/tt-rss-$VERSION /opt/tt-rss

Enfin, nous récupérons le dossier icons de notre installation précédente:

/bin/rm -r /opt/tt-rss/icons
/bin/cp -a /opt/tt-rss.old/icons /opt/tt-rss/

Identifiez-vous en tant qu'admin pour mettre à jour la base de données si nécessaire. Vérifiez que tout fonctionne correctement. Une fois ceci fait, redémarrez le démon de mise à jour des flux:

/etc/init.d/tt-rss restart

Vous pouvez supprimer l'archive téléchargée et la sauvegarde de l'ancienne installation :

/bin/rm /tmp/tt-rss-$VERSION.tar.gz
/bin/rm -r /opt/tt-rss.old

Paramètrer votre compte utilisateur

Voici les options que j'ai activé pour avoir un compte utilisateur adapté à mes besoins :

• Purger les articles plus vieux que le nombre de jours donné (0 pour ne jamais purger) : 0 (je désactive la suppression des articles trop vieux)
• Utiliser les catégories de flux : Yes (J'active la gestion des flux par catégories)
• Activer la barre de recherche : Yes (J'active la possibilité de rechercher dans le contenu des flux)
• Demander confirmation pour marquer un flux comme lu : No (Je désactive la confirmation lorsque je veux marquer l'ensemble d'un flux comme lu)
• Éliminer les étiquettes non sûres des articles : No (Je désactive la simplification du code source HTML des articles des flux. C'est moins sécurisé, mais ca permet de conserver les balises <code>)
  

Intégration dans Mozilla Firefox

• Vous pouvez utiliser Tiny Tiny RSS comme gestionnaire de flux dans Mozilla Firefox. Cela se configure à partir de vos préférences de flux.
• Vous pouvez installer un plugin qui vérifie la présence de nouveaux articles régulièrement : Tiny Tiny RSS Notifier.

Remerciements

• Merci aux développeurs de Tiny Tiny RSS (tout particulièrement à fox qui porte ce projet à bout de bras).
• Merci à Mdrolo qui a inscrit le flux de ce site dans son Tiny Tiny RSS et me l'a ainsi fait découvrir.