cronaca - Online nel Cloud

PROGRAMMA:

NOME

cronaca - Un semplice compilatore di blog.

SINOSSI

cronaca [opzioni]

Opzioni del percorso:

--comments Specifica il percorso della directory dei commenti facoltativa.
--config Specifica un file di configurazione da leggere.
--input Specifica la directory di input da utilizzare.
--output Specifica la directory in cui scrivere l'output.
--theme-dir Specifica il percorso dei modelli del tema.
--theme Specifica il tema da usare.
--pattern Specifica il modello di file con cui lavorare.
--url-prefix Specifica il prefisso per il live blog.
--sitemap-prefix Specifica il prefisso per la mappa del sito.

Opzioni per le voci del blog:

--format Specifica il formato delle voci, HTML/tessuto/markdown.

Comandi pre e post-compilazione:

--pre-build Specifica un comando da eseguire prima di creare il blog.
--post-build Specifica un comando da eseguire una volta che il blog è stato creato.
--pre-filter Un comando per filtrare ogni post di blog prima della conversione HTML.
--post-filter Un comando per filtrare ogni post di blog dopo la conversione HTML.

Opzioni di ordinamento:

--recent-dates-first Mostra prima le voci recenti nella vista archivio.
--recent-tags-first Mostra prima le voci recenti nella vista tag.

Opzioni di conteggio:

--entry-count=N Numero di post da mostrare nell'indice.
--rss-count=N Numero di post da includere nel feed dell'indice RSS.

Caratteristiche opzionali:

--author Specifica l'indirizzo email dell'autore
--comment-days Specifica il numero di età massima dei post per accettare commenti.
--date-archive-path Include la data nell'archivio.
--force Forza la copia dei file statici dal tema del blog.
--lang Specifica la lingua da utilizzare per la formattazione delle date.
--lower-case Minuscolo tutti i nomi di file che vengono emessi.
--no-archive Non crea una pagina di archivio.
--no-cache Non usa le funzionalità facoltative di memcached, anche se disponibili.
--no-calendar Non usa il calendario opzionale sull'indice.
--no-comments Non consente la pubblicazione di commenti.
--no-sitemap Non genera una mappa del sito.
--no-tags Non produce pagine di tag.
--no-xrefs Non produce riferimenti incrociati.

Opzioni di aiuto:

--help Mostra le informazioni di aiuto per questo script.
--manual Leggi il manuale di questo script.
--verbose Mostra informazioni utili per il debug.
--version Mostra il numero di versione ed esce.

CHI SIAMO

Chronicle è un semplice strumento per convertire una raccolta di file di testo,
situato all'interno di una singola directory, in un blog composto da statico
File HTML.

Supporta solo il minimo indispensabile di funzionalità richieste
per essere utile:

* Supporto per l'etichettatura.

* Supporto RSS.

* Supporto per l'archivio.

Le carenze evidenti sono:

* Mancanza di supporto per i commenti istantanei.

* Mancanza di supporto pingback/trackback.

Detto questo è un sistema robusto, stabile e utile.

BLOG FORMATO

Il formato dei file di testo che elaboriamo è fondamentale per l'output
pagine. Ogni voce dovrebbe essere simile a questa:

Titolo: questo è il titolo del post sul blog
Data: 2 marzo 2007
Tag: uno, due, tre, tag lungo

Il testo della tua voce va qui.

NOTA: L'intestazione DEVE essere separata dal corpo della voce di almeno a
singola riga vuota.

In questo esempio possiamo vedere che la voce stessa è stata preceduta
con una piccola testata. L'intestazione di una voce contiene tre righe facoltative,
se questi non sono presenti, ci sono impostazioni predefinite sensate come descritto
qua sotto.

La formattazione delle date di output può essere modificata tramite l'uso del
B<--lang> opzione della riga di comando (o l'opzione corrispondente "lang=francese" nel
file di configurazione), ma la data della voce stessa dovrebbe essere specificata in
Inglese.

Titolo: descrive il titolo del post. Se non è presente viene utilizzato il nome del file della voce
Invece. È possibile utilizzare anche "Oggetto:".
Oggetto: questo è un sinonimo di 'Titolo:'.
Data: la data in cui è stato scritto il post. Se non presente viene utilizzata l'ora di creazione del file
anziché.
Pubblica: questa intestazione viene rimossa da tutte le voci e viene utilizzata dallo spooler di cronaca
script.
Tag: tutti i tag che dovrebbero essere associati alla voce, separati da virgole.

Si presume che il formato della voce sia HTML, tuttavia c'è supporto
per scrivere le tue voci sia in formato tessile che markdown.

Il formato delle voci è specificato tramite l'argomento B<--format>, oppure
tramite un'impostazione "format: foo" nel tuo file Chroniclerc.

Si presume che il formato delle voci sia globale; queste sono tutte le tue voci
si presume che siano nello stesso formato. Tuttavia puoi aggiungere un
pseudo intestazione "format: foo" a voci specifiche se si desidera scrivere
voci specifiche in un formato diverso.

Per consentire flessibilità nella gestione delle voci, ogni post sul blog sarà
essere passato attraverso lo script del filtro B
che consente di modificare questa gestione in un'unica posizione. Questo
lo script consente di aggiornare le voci tramite filtri sia prima che dopo
la conversione in HTML. Per ulteriori dettagli si prega di consultare la manpage per
quella sceneggiatura.

CONFIGURAZIONE

La configurazione del software è minima e generalmente eseguita
tramite gli argomenti della riga di comando. Tuttavia è possibile salvare le impostazioni
nel file global /etc/chroniclerc o nel file per-user ~/.cronista
file.

Se lo desideri puoi passare il nome di un altro file di configurazione a
lo script con il flag B<--config>. Questo verrà letto dopo il
due file precedenti e può sovrascrivere qualsiasi impostazione presente.

Il file di configurazione contiene righe come queste:

input = /casa/me/blog

output = /var/www/blog

formato = sconto

Le chiavi sconosciute vengono ignorate.

OPTIONAL CACHING

Per velocizzare la ricostruzione di un blog di grandi dimensioni il compilatore può utilizzare un local
Demone Memcached, se installato e disponibile.

Per installarlo, su un sistema Debian GNU/Linux eseguire:

apt-get update
apt-get installa memcached libcache-memcached-perl

Puoi disabilitare questo comportamento di memorizzazione nella cache con --no-cache e vedere il
effetto con --verbose.

OPTIONAL CALENDARIO

Se il modulo 'HTML::CalendarMonthSimple' è disponibile, ogni blog lo farà
contengono una semplice visualizzazione mensile del mese corrente sull'indice.

Per disabilitarlo, invoca il programma con '--no-calendar'.

OPTIONAL COMMENTANDO

Incluso con il codice della cronaca dovresti trovare il file
cgi-bin/commenti.cgi.

Questo file è progettato per scrivere commenti inviati al locale
filesystem del tuo server web. Se lo installi e modifichi il
percorso all'inizio dello script che dovresti essere in grado di includere
commenti nel tuo blog.

In breve ci sono tre cose che devi fare:

Installa lo script CGI e modifica il percorso all'inizio.
Copia i commenti di output nella fonte del tuo blog locale.
Esegui di nuovo questo script con --comments=./path/to/comments

Questo dovrebbe includere i commenti nell'output statico. Di più
istruzioni esplicite sono fornite all'interno del file 'COMMENTS'
inclusi nella distribuzione.

Usa la cronaca online utilizzando i servizi onworks.net