AsciiDoc Website Builder est un programme écrit en Python qui vous permet d'écrire un site Web dans le texte presque ordinaire (c.-à-AsciiDoc), ainsi que quelques fichiers de configuration simples. Il existe pour résoudre mon problème de ne jamais mettre à jour mon propre site web (qui a utilisé beaucoup de PHP) parce que je ne me souvenais plus rapidement désinvolte tous les changements et la mise en forme spécifique dont je avais besoin d'ajouter de nouvelles pages.
Voici quelques caractéristiques principales de "AsciiDoc Website Builder":
· Système de modèle flexible
· Génération Blog
· Galerie d'images génération
· Génération sitemap.xml
· Toutes les fonctionnalités de délicieux AsciiDoc
Commencer:
Pour commencer à utiliser awb vous avez besoin de mettre en place au moins un site dans votre fichier de configuration utilisateur de AWB. Il est situé à ~ / .awb / awb.conf Il pourrait ressembler à ceci:
----
[Monsiteweb]
siteroot: / home / moi / monsiteweb
baseurl: http: //my.web.site
options de AsciiDoc: livre -d -b HTML4
----
Ce définit simplement un site Web connu pour AWB comme «monsiteweb". Les options sont:
siteroot ::
Le répertoire racine du site AWB. La source de AsciiDoc vit dans + siteroot / src +, et la sortie html va à + siteroot / html +.
baseurl ::
L'URL de la racine du site. Il est utilisé pour générer sitemap.xml.
options de AsciiDoc ::
Options pour être transmis à AsciiDoc. Je utilise ceci pour spécifier un fichier de html4.conf personnalisé en plus des options indiquées dans l'exemple.
Une fois que vous avez un site Web configuré et certains fichiers source écrite, délivrer simplement la commande
----
% Awb monsiteweb
----
AWB ne régénérer les fichiers HTML qui sont devenus obsolètes. Si cela ne fonctionne pas pour une raison quelconque, l'option -r peut être utilisée pour réparer.
----
% Awb -r monsiteweb
----
Cela peut se faire de ne importe où dans le système de fichiers. awb sait de son fichier de configuration où lire et écrire.
awbdir.conf
-----------
Chaque répertoire dans l'arbre source peut contenir un fichier de configuration nommé awbdir.conf. Ce fichier spécifie les options spécifiques répertoire pour être utilisés par AWB.
Section [configuration dir]
tapez ::
peut être l'un des «normale», «blog» ou «galerie». «Normale» est la valeur par défaut. La signification des types est expliquée ci-dessous.
nommer ::
Un nom descriptif du répertoire, comme indiqué dans le fil d'Ariane.
awbdir.conf section [blog]
Cette section définit les paramètres utilisés si le type de répertoire est blog.
num principaux postes ::
Le nombre de messages à afficher sur la page index.html du blog.
num récents messages ::
Le nombre de titres de poste à afficher dans la liste des "messages récents», et aussi le nombre de titres de magazines à afficher dans la liste des "magazines récents".
Section [utilisateur]
Ici vous pouvez définir ne importe quelle option vous aimez. Il peut être mentionnée dans le modèle. Ce est utile lorsque vous voulez utiliser le même modèle à travers le site, mais le changement de petites pièces de celui-ci (par exemple. Une image).
Options awbdir.conf cascade à partir d'un répertoire pour ses enfants. Ce est très pratique, que les répertoires de l'enfant ne ont besoin remplacent les options de parents qui ne se appliquent pas. La seule exception est le nom du répertoire, qui ne en cascade
Ce qui est nouveau dans cette version:.
- Cette mise à jour corrige un problème exposé par Python presse récents qui ont causé awb à l'échec tout en déterminant l'emplacement de son répertoire de configuration.
- Le correctif introduit une nouvelle depenendency, python-xdg.
Ce qui est nouveau dans la version 0.3.1:
- L'option -l a été ajouté à la liste de tous les sites .
- formatage de billet de blog a été fixé à utiliser après jour, pas mtime.
- Un problème dans sitemap horodatage a été fixé.
- La chaîne d'utilisation a été mis à jour.
- meta descriptions vides ne sont pas insérés.
- Crashing est évitée tout en obtenant le titre d'un fichier vide.
- Le manuel a été déplacé à un autre endroit.
- La commande a été ajouté.
- docstring nettoyage a été fait.
Quoi de neuf dans la version 0.3:.
- Cette version est le produit d'un grand remaniement de fin
- La série 0.3 sera le chemin à une version 1.0 stable.
Commentaires non trouvées