Sommaire
Présentation d'identi.ca
Si vous ne le savez pas encore, identi.ca est un site qui permet aux utilisateurs de faire du microblogging. Ce phénomène très à la mode depuis quelques temps, se caractérise simplement par des envois de messages de moins de 140 caractères à périodes fréquentes (ou non) sur un site. Chaque utilisateur donne son "statut", et les autres utilisateurs commentent, font de même, etc.
Le très célèbre twitter en est l'un des outils principal. Cependant le code n'est pas libre, et les messages des utilisateurs non plus. Voilà pourquoi la communauté du libre a sorti son outil libre, promettant également des billets libres : Laconica.
Identi.ca est donc un site utilisant l'outil Laconica.
Sur la présente page nous allons vous montrer l'installation, la configuration, puis l'utilisation d'un plugin permettant d'afficher son statut identi.ca sur votre page Web.
Installation
L'installation débute par le téléchargement du plugin identi.ca pour Nanoblogger.
wget ftp://portedesetoiles.homelinux.com/scripts/nanoblogger/plugins/identica.sh
Elle se termine très simplement par un déplacement de ce script dans le dossier plugin de votre joueb/weblog :
mv identica.sh /chemin/vers/mon/nanoblog/plugins/
Veillez à bien modifier le chemin vers votre nanoblog, afin de choisir le bon dossier !
Configuration
Fichier de configuration
La configuration est très simple, procédez comme vous le feriez normalement en éditant le fichier de configuration :
nb -b /chemin/vers/mon/nanoblog/plugins configure
Puis ajoutez les lignes suivantes à la fin de votre fichier de configuration :
# --- Identi.ca plugin settings ---
#IDENTICA_CMD="curl" # progam used to retrieve identi.ca status
#IDENTICA_OPTS="-s" # some options of the IDENTICA_CMD program
#IDENTICA_URL="http://identi.ca/api/users/show" # url for having the last status
#IDENTICA_FORMAT="xml" # format used on identi.ca
#IDENTICA_LINK="http://identi.ca/$IDENTICA_USER"
IDENTICA_USER="blanko" # your id on identi.ca
IDENTICA_TITLE="identi.ca status" # title to display on your homepage (or some else)
Listons, par ordre, l'ensemble des variables et leur fonction :
- IDENTICA_CMD : commande utilisée pour récupérer la page web contenant les informations de votre statut
- IDENTICA_OPTS : liste des paramètres pour ladite commande (en l'occurrence le -s permet d'agir en mode silencieux : aucune sortie)
- IDENTICA_URL : adresse de la page à récupérer
- IDENTICA_FORMAT : format du fichier (peut être en XML, JSON, ou tout autre format utilisé par le service appelé)
- IDENTICA_LINK : Lien direct vers la page contenant l'ensemble de vos statut. Ceci n'est qu'à effet d'affichage
- IDENTICA_USER : Votre pseudonyme sur le service appelé. Dans le cas de l'auteur de la présente page : blanko
- IDENTICA_TITLE : Titre à afficher pour introduire votre statut sur votre page d'accueil
Sauvez le fichier de conf et sortez (sous vim [Echap],[:],[x]).
Fichier de template
Désormais les variables et le script prêt, il vous faut choisir l'emplacement où le statut s'affichera ! Pour cela nous vous proposons de modifier le fichier templates/main_index.htm, et d'ajouter le code suivant :
<div class="sidetitle">
$IDENTICA_TITLE
</div>
<div class="side">
$IDENTICA_BADGE
</div>
Ceci permet d'insérer un titre, puis le contenu du badge.
Qu'est ce que le badge ?
Le badge est un élément constitué, au départ, de :
- Votre statut
- Un lien permettant d'afficher la page de l'ensemble de vos statuts
Le badge est personnalisable, comme nous le verrons ultérieurement.
Utilisation
Que faire ensuite ?
Compilation
Rien de plus simple pour utiliser le plugin, il suffit tout simplement de recompiler votre nanoblog. Si vous avez édité la page principale comme conseillé ci - avant, il vous suffit simplement de faire :
nb -b /chemin/vers/votre/nanoblog/ update main
Et le tour est joué !
Tâches cron
Il se peut que vous trouviez ça embêtant de toujours recompiler votre nanoblog pour afficher l'état de votre compte identi.ca. Pour pallier à ce problème, vous pourriez par exemple réactualiser la page de votre nanoblog par exemple ! Pour cela, utilisez les tâches cron de votre serveur. Si vous ne possédez pas de tâches cron où n'y avez pas accès, contactez l'administrateur de votre serveur.
Nous allons donc simplement faire :
crontab -e
Puis nous remplissons par :
00 9 * * * /usr/share/nanoblogger/nb -b /chemin/vers/votre/nanoblog/ update main >&/dev/null
Remplacez /usr/share/nanoblogger/nb par l'adresse asbolue vers votre script nanoblogger. Donnez aussi l'adresse absolue vers votre Nanoblog.
À noter que la dernière chose de la ligne, permet simplement de rediriger la sortie vers /dev/null.
PS : Il se peut que vous rencontriez des problèmes avec la compilation, et n'avez plus de message du jour (fortune), faites un tour dans notre rubrique Problèmes, notamment sur le problème qu'on rencontre en mettant la compilation de notre nanoblog dans une tâche cron
Personnaliser le badge
Peut être voudriez vous changer un peu l'apparence du badge, ajouter des images, du texte, etc.
Pour cela, rien de plus simple, changez seulement la ligne suivante dans le fichier identica.sh :
IDENTICA_BADGE="$IDENTICA_STATUS<br /><a href=\"$IDENTICA_LINK#content\" title=\"Display $IDENTICA_USER identica status\">$IDENTICA_USER</a>"
En par exemple ceci :
IDENTICA_BADGE="$IDENTICA_STATUS<br /><a href=\"$IDENTICA_LINK#content\" title=\"Visiter la page des status de $IDENTICA_USER\">Voir les autres statuts de $IDENTICA_USER</a>"
Il suffit simplement d'ajouter du HTML dans le contenu de la variable, et si possible d'autres variables, notamment la plus importante à vos yeux : IDENTICA_STATUS !
Liens utiles
- Afficher son statut identi.ca sous forme d'un badge javascript(JS) avec le dernier statut de l'ensemble de nos amis
- Afficher l'ensemble de nos statuts identi.ca sous forme d'un badge javascript(JS)
