perlanetp - Online nel cloud

PROGRAMMA:

NOME

perlanet - interfaccia a riga di comando per Perlanet.pm

SINOSSI

$ perlanet

Or

$ file_config perlanet

DESCRIZIONE

"perlanet" è un programma a riga di comando per l'aggregazione di feed web (sia Atom che RSS) e
pubblicare una nuova pagina web e un nuovo feed web contenente i risultati di tale aggregazione.

COMANDO LINE ARGOMENTI

"perlanet" accetta un argomento opzionale della riga di comando, che è il nome di una configurazione
file da utilizzare. Se non viene fornito alcun nome file, il programma cerca un file chiamato "perlanetrc"
nella directory corrente.

CONFIGURAZIONE RISORSE

"perlanet" richiede un file di configurazione che contenga i dettagli di quali feed
aggregato e cosa fare con i risultati dell'aggregazione. Per impostazione predefinita, appare "perlanet".
per un file chiamato "perlanetrc" nella directory corrente, ma questo nome può essere sovrascritto
passando il nome di un file diverso quando si chiama il programma.

Il file di configurazione è in formato YAML. YAML è un semplice formato di file basato su testo. Vedere
<http://yaml.org/> per ulteriori dettagli.

Configurazione Opzioni
Il file di configurazione può contenere le seguenti opzioni.

titolo
Il titolo della pagina e del feed Web risultanti. Questa opzione è obbligatoria.

descrizione
La descrizione della pagina e del feed web risultanti. Questa opzione è obbligatoria.

URL Un URL che verrà associato alla pagina e al feed Web risultanti. Questo di solito
essere l'indirizzo dove verrà pubblicata la pagina web. Questa opzione è obbligatoria.

autore
Il nome e l'indirizzo email dell'autore del contenuto aggregato. Questo articolo ne ha due
elementi secondari: uno ciascuno per il nome e l'indirizzo e-mail. Questa opzione è obbligatoria.

agente
Questa voce facoltativa definisce la stringa dell'agente che perlanet utilizzerà durante la richiesta
dati provenienti da siti web. È il nome del programma che i proprietari dei siti vedranno nel loro file
registri di accesso al sito web. Anche se è facoltativo, è fortemente consigliato
fornire un valore per questa opzione di configurazione e che il valore utilizzato includa il contatto
dettagli in modo che i proprietari del sito web possano contattarti in caso di dubbi
sul tuo utilizzo del loro sito.

voci
Il numero massimo di voci da includere nel contenuto aggregato. Questa opzione è
obbligatorio.

voci_per_feed
Il valore "voci" sopra definisce il numero totale di voci nell'output aggregato
foraggio. Il valore definisce il numero di voci da prendere da ciascuno di
i tuoi feed di origine. Ad esempio, se è impostato su 1, ci sarà una sola voce
da ogni feed nel tuo output. Se questo valore è 0 (o mancante), tutti i valori da
vengono utilizzati tutti i feed di origine.

opml
Il sistema può facoltativamente creare un file OPML contenente i dettagli dei feed che
vengono aggregati. Questa opzione facoltativa controlla se questo file lo è o meno
creato. Se esiste, dovrebbe essere il nome del file OPML da creare. Se uno
Viene creato il file OPML, quindi le opzioni "feed" (descritte di seguito) saranno tutte
richiedono una sotto-opzione "web".

pagina
Questa opzione obbligatoria contiene i dettagli della pagina web da creare. Ci sono
due opzioni secondarie: "file" fornisce il nome del file da creare e "template" fornisce
il nome di un modello di Template Toolkit che verrà elaborato per creare
questa vita. Consulta la sezione "Modello di output" per maggiori dettagli su questo modello e
il sito web <http://tt2.org/> per ulteriori informazioni sul Template Toolkit.

alimentare
Questa opzione obbligatoria contiene i dettagli del feed web da creare. Ci sono
due opzioni secondarie: "file" fornisce il nome del file da creare e "format" fornisce
il formato dell'output (attualmente 'Atom' o 'RSS').

dir_cache
Se fornisci un nome di directory in questa opzione, perlanet utilizzerà la cache
funzionalità di URI::Fetch. Ciò significa che i feed web verranno scaricati solo quando
cambiare.

feed
Questa opzione obbligatoria fornisce i dettagli dei feed web da aggregare. Ogni articolo su
l'elenco prevede una sub-opzione obbligatoria e due sub-opzioni facoltative. L'obbligatorio
l'opzione secondaria è "url" che fornisce l'URL del feed. La sottoopzione facoltativa "titolo"
fornisce un titolo che verrà anteposto a tutti i titoli delle voci presi da quel feed.
Se non viene fornito alcun titolo, il titolo verrà preso dal titolo del feed. L'opzionale
L'opzione secondaria "web" fornisce l'URL di un sito web associato al feed (spesso l'indirizzo di
il sito web da cui proviene il feed). Questo può essere usato per creare un elenco di
siti aggregati. La sottoopzione "web" diventa obbligatoria se si sta creando un OPML
file.

Esempio Configurazione Compila il
titolo: test del pianeta
descrizione: Un pianeta di prova
URL: http://planet.example.com/
autore:
nome: Dave Croce
e-mail: [email protected]
voci: 20
opml: opml.xml
pagina:
file: indice.html
modello: indice.tt
alimentazione:
file: atom.xml
formato: Atomo
cache_dir: /tmp/feeds
feed:
-URL: http://blog.dave.org.uk/atom.xml
titolo: Blog di Dave
web: http://blog.dave.org.uk/
-URL: http://use.perl.org/~davorg/journal/rss
titolo: Diario use.perl di Dave
web: http://use.perl.org/~davorg/journal/
-URL: http://www.oreillynet.com/pub/feed/31?au=2607
titolo: Dave su O'Reillynet
web: http://www.oreillynet.com/pub/au/2607

Uscita Modello
La pagina Web viene creata da un modello Template Toolkit. Questo modello viene passato due
variabili.

alimentare
Questo è l'oggetto XML::Feed utilizzato per creare il feed aggregato. Vedere
la documentazione XML::Feed per i dettagli dei dati contenuti in questo oggetto.

cfg Questo è il contenuto del file di configurazione, convertito in un hash Perl (nidificato).

Esempio Uscita Modello
Questo è un modello semplice che utilizza la variabile "feed" per visualizzare i dettagli del file
feed aggregati.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transizionale//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<htmlxmlns="http://www.w3.org/1999/xhtml">



[% feed.title %]


[% feed.titolo | html%]
[% feed.descrizione | html%]
[% FOREACH voce IN feed.entries %]
[% entry.title | html%]
[% voce.contenuto.corpo %]
[% SE voce.autore O voce.emesso %]
Pubblicato[% IF entry.author %] da [% entry.author | html; FINE %]
[% IF voce.emesso %] il [% voce.emesso | html; FINE %]
[% FINE %]
[% FINE %]

[% feed.autore | html %] / [% feed.modificato | html %]



In futuro, il wiki di Perlanet all'indirizzo <http://wiki.github.com/davorg/perlanet> conterrà
un ricettario di idee utili da includere nel modello di output.

SUPPORTO

Esiste una mailing list che funge sia da luogo di discussione per gli sviluppatori
mantenere e migliorare Perlanet e anche per consentire agli utenti di ottenere supporto. Puoi iscriverti a
questo elenco su <http://lists.mag-sol.com/mailman/listinfo/perlanet>

Per segnalare bug in Perlanet, utilizzare il tracker delle richieste CPAN. Puoi utilizzare il file
pagina web all'indirizzo <http://rt.cpan.org/Public/Bug/Report.html?Queue=Perlanet> o inviare un'e-mail a
[email protected].

Utilizza perlanetp online utilizzando i servizi onworks.net