chronique - En ligne dans le Cloud

PROGRAMME:

Nom

chronique - Un simple compilateur de blog.

SYNOPSIS

chronique [options]

Options de chemin :

--comments Spécifie le chemin d'accès au répertoire de commentaires facultatif.
--config Spécifie un fichier de configuration à lire.
--input Spécifiez le répertoire d'entrée à utiliser.
--output Spécifie le répertoire dans lequel écrire la sortie.
--theme-dir Spécifiez le chemin d'accès aux modèles de thème.
--theme Spécifiez le thème à utiliser.
--pattern Spécifie le modèle des fichiers avec lesquels travailler.
--url-prefix Spécifiez le préfixe du blog en direct.
--sitemap-prefix Spécifiez le préfixe du plan du site.

Options d'entrée de blog :

--format Spécifiez le format de vos entrées, HTML/textile/markdown.

Commandes avant et après la construction :

--pre-build Spécifiez une commande à exécuter avant de créer le blog.
--post-build Spécifiez une commande à exécuter une fois le blog créé.
--pre-filter Une commande pour filtrer chaque entrée de blog avant la conversion HTML.
--post-filter Une commande pour filtrer chaque entrée de blog après la conversion HTML.

Options de tri :

--recent-dates-first Afficher les entrées récentes en premier dans la vue des archives.
--recent-tags-first Afficher les entrées récentes en premier dans la vue des balises.

Options de comptage :

--entry-count=N Nombre de messages à afficher sur l'index.
--rss-count=N Nombre de messages à inclure dans le flux d'index RSS.

Caractéristiques optionnelles:

--author Indiquez l'adresse e-mail de l'auteur
--comment-days Spécifiez le nombre d'âge maximum des messages pour accepter les commentaires.
--date-archive-path Inclut la date dans l'archive.
--force Force la copie des fichiers statiques du thème du blog.
--lang Spécifie la langue à utiliser pour le formatage des dates.
--lower-case En minuscules tous les noms de fichiers qui sont affichés.
--no-archive Ne crée pas de page d'archive.
--no-cache N'utilise pas les fonctionnalités optionnelles memcached, même si elles sont disponibles.
--no-calendar Ne pas utiliser le calendrier facultatif sur l'index.
--no-comments Ne permet pas la publication de commentaires.
--no-sitemap Ne génère pas de plan de site.
--no-tags Ne produit aucune page de balises.
--no-xrefs Ne produit aucune référence croisée.

Options d'aide :

--help Affiche les informations d'aide pour ce script.
--manual Lire le manuel de ce script.
--verbose Affiche des informations de débogage utiles.
--version Affiche le numéro de version et quitte.

A PROPOS

Chronicle est un outil simple pour convertir une collection de fichiers texte,
situé dans un seul répertoire, dans un blog composé d'éléments statiques
Fichiers HTML.

Il ne prend en charge que le strict minimum de fonctionnalités requises
Être utile:

* Prise en charge du marquage.

* Prise en charge RSS.

* Prise en charge des archives.

Les lacunes évidentes sont :

* Manque de support pour les commentaires instantanés.

* Manque de support pingback/trackback.

Cela dit, c'est un système robuste, stable et utile.

BLOG Format

Le format des fichiers texte que nous traitons est essentiel à la sortie
pages. Chaque entrée devrait ressembler à ceci :

Titre : Ceci est le titre de l'article du blog
Date : 2 mars 2007
Mots clés : un, deux, trois, étiquette longue

Le texte de votre entrée va ici.

REMARQUE : L'en-tête DOIT être séparé du corps de l'entrée par au moins un
une seule ligne vide.

Dans cet exemple, nous pouvons voir que l'entrée elle-même a été préfacée
avec un petit en-tête. Un en-tête d'entrée contient trois lignes facultatives,
s'ils ne sont pas présents, il existe des valeurs par défaut sensibles comme décrit
ci-dessous.

Le formatage des dates de sortie peut être modifié via l'utilisation du
B<--lang> option de ligne de commande (ou l'option correspondante "lang=french" dans le
fichier de configuration), mais la date de l'entrée elle-même doit être spécifiée dans
Anglais.

Titre : Décrit le titre du message. S'il n'est pas présent, le nom de fichier de l'entrée est utilisé
au lieu. « Sujet : » peut également être utilisé.
Objet : C'est un synonyme de 'Titre :'.
Date : La date à laquelle le message a été écrit. S'il n'est pas présent, l'heure de création du fichier est utilisée
à la place.
Publier : cet en-tête est supprimé de toutes les entrées et est utilisé par le spouleur de chronique
scripts.
Balises : toutes les balises qui doivent être associées à l'entrée, séparées par des virgules.

Le format de l'entrée est supposé être HTML, mais il existe un support
pour écrire vos entrées aux formats textile et démarque.

Le format des entrées est spécifié via l'argument B<--format>, ou
via un paramètre "format: foo" dans votre fichier chroniclerc.

Le format des entrées est supposé global ; c'est toutes tes entrées
sera supposé être dans le même format. Cependant, vous pouvez ajouter un
"format: foo" pseudo-en-tête à des entrées spécifiques si vous souhaitez écrire
entrées spécifiques dans un format différent.

Pour permettre une flexibilité dans le traitement des entrées, chaque entrée de blog sera
passer par le script de filtre B
qui permet de modifier cette manipulation en un seul endroit. Cette
le script permet de mettre à jour les entrées via des filtres avant et après
la conversion en HTML. Pour plus de détails, veuillez consulter la page de manuel de
ce script.

CONFIGURATION

La configuration du logiciel est minimale, et généralement effectuée
via les arguments de la ligne de commande. Cependant, il est possible de sauvegarder les paramètres
soit dans le fichier global /etc/chroniclerc soit dans le fichier par utilisateur ~/.chroniquerc
fichier.

Si vous le souhaitez, vous pouvez transmettre le nom d'un autre fichier de configuration à
le script avec le drapeau B<--config>. Celui-ci sera lu après le
les deux fichiers précédents et peut écraser tous les paramètres présents.

Le fichier de configuration contient des lignes comme celles-ci :

entrée = /accueil/moi/blog

sortie = /var/www/blog

format = démarque

Les clés inconnues sont ignorées.

EN OPTION MISE EN CACHE

Pour accélérer la reconstruction d'un grand blog, le compilateur peut utiliser un
Démon Memcached, s'il est installé et disponible.

Pour l'installer, sous un système Debian GNU/Linux, veuillez exécuter :

apt-get update
apt-get installer memcached libcache-memcached-perl

Vous pouvez désactiver ce comportement de mise en cache avec --no-cache, et voir le
effet avec --verbose.

EN OPTION CALENDRIER

Si le module 'HTML::CalendarMonthSimple' est disponible, chaque blog
contiennent une simple vue mensuelle du mois en cours sur l'index.

Pour désactiver cela, appelez le programme avec '--no-calendar'.

EN OPTION COMMENTER

Inclus avec le code de la chronique, vous devriez trouver le fichier
cgi-bin/commentaires.cgi.

Ce fichier est conçu pour écrire les commentaires soumis à la section locale
système de fichiers de votre serveur Web. Si vous l'installez et modifiez le
chemin au début du script, vous devriez pouvoir inclure
commentaires sur votre blog.

Bref, il y a trois choses à faire :

Installez le script CGI et modifiez le chemin au début.
Copiez les commentaires de sortie sur la source de votre blog local.
Exécutez à nouveau ce script avec --comments=./path/to/comments

Cela devrait inclure les commentaires dans la sortie statique. Suite
des instructions explicites sont fournies dans le fichier 'COMMENTS'
inclus dans la distribution.

Utiliser la chronique en ligne en utilisant les services onworks.net