Agregare news cu Planet - scurt ghid de instalare

Planet este un agregator de news (feed reader) cu particularitatile sale, spre deosebire de Liferea care este o aplicatie desktop sau Google Reader care necesita login, acesta poate rula ca un site web public, deci are un avantajul de a putea fi folosit pentru a agrega surse de stiri ale unei comunitati (bloguri). Bineinteles ca poate fi instalat local si rulat pentru uz personal.

Cerinte intitiale

Pentru a rula Planet aveti nevoie de un server web (Apache, dar tinind cont ca se vor servi pagini statice, orice server este suficient), Python 2.x (aplicatia este scrisa in Python, deci e nevoie de interpretor) si posibilitatea de a programa activitati (cron) pentru a rula la intervale regulate. Toate acestea sint disponibile intr-o instalare standard de server Linux dar pot exista pe orice alt sistem de operare cu versiune de server.

Instalare

Instalarea e simpla: se descarca tarball-ul de pe site-ul oficial (cea mai noua versiune stabila, dar se poate folosi si un nightly build) si se dezarhiveaza undeva in afara directoarelor accesibile serverului web (din motive de securitate nu e indicat sa puneti binare sau fisiere de configurare in zona accesibila public).
Nota: daca nu stiti ce inseamna "tarball", puteti descarca si dezarhiva versiunea .zip.

Configurare

Vom folosi un exemplu existent caruia ii vom ajusta citiva parametrii, mergem in directorul examples si copiem subdirectorul fancy iar apoi il redenumim pentru a il putea identifica, aici i-am spus ro-ooo:

In interiorul acestui director se gasesc doua fisiere: config.ini, fisierul de configurare, si index.html.tmpl, sablonul (template) pentru index.html. Vom edita config.ini, prezint modificarile esentiale:

Prima data trebuie trecute informatii genrale despre pagina: nume, adresa, proprietar, date de contact:

Dupa care se ajusteaza locatia sabloanelor:

Si a locatiei unde trebuie salvata pagina html (aceasta trebuie sa fie in zona accesibila serverului web, va fi publica si trebuie sa corespunda URL-ului declarat anterior):

Denumirea directorului mai trebuie ajustata si la directiva pentru configurarea numarului de zile pentru care un articol este afisat:

Si cel mai important, lista de fluxuri (feeds) pentru fiecare sursa, incluzind URL, nume, imagine (hachergotchi):



Nu ne mai ramine decit sa pregatim directorul unde se vor gasi fisierele html, xml si css (puteti folosi ca baza de plecare exemplul din examples/output:

Si imagini - iconuri si hackergotchi (puteti citi un articol precedent despre crearea de hackergotchi cu GIMP si Inkscape):

Asta a fost tot!

Rulare
Mai ramine sa rulam aplicatia pentru a genera fisierele html si xml cu o linie de comanda de genul (inlocuiti /path/to/file cu locatia reala):

/usr/bin/python /path/to/file/planet.py /path/to/file/examples/ro-ooo/config.ini

Puneti comanda in cron pentru a fi rulata regulat, de exemplu la fiecare ora.

Finisari
Pentru a modifica aspectul sau asezarea paginii puteti edita fisierele planet.css (style sheet) si index.html.tmlp (sablon).

Dupa numai citeva minute de lucru avem functional planet.ro-ooo.org.