AddThis Social Bookmark Button

luni, noiembrie 19, 2007

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.

[planet tarball]


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:
[planet create directory]

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:
[planet config owner]

Dupa care se ajusteaza locatia sabloanelor:
[planet config template]

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):
[planet config output]

Denumirea directorului mai trebuie ajustata si la directiva pentru configurarea numarului de zile pentru care un articol este afisat:
[planet config days]

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



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:
[planet www]

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

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.

Niciun comentariu: