Structure du point de vue administrateur

Configuration

Un fichier conf.yaml doit contenir la configuration globale du site:

ADMIN_URL: /publy/
SITE_PATH: /home/web/wilk/flibuste.net/www/
CACHE_PATH: /home/web/wilk/flibuste.net/tmppubly/
SITE_URL: http://flibuste.net
LOCK: -
USERS:
 webmaster:
    password: sha hexdigest
    access: webmaster
 auteur:
    password: sha hexdigest
    access: author
RST:
 input_encoding: latin-1
 output_encoding: latin-1
 error_encoding: latin-1
 error_encoding_error_handler: replace
 output_encoding_error_handler: replace
 language_code: fr
 attribution: none
 trim_footnote_reference_space: 1
 footnote_references: superscript
 traceback: +

ADMIN_URL désigne l'url par lequel on accède à la partie administration

SITE_PATH désigne le répertoire physique du site

CACHE_PATH désigne un répertoire temporaire dans lequel seront stockés les fichiers html des rst. (pour ne pas avoir à les regénérer à chaque fois)

SITE_URL désigne l'url absolue du site

USERS désigne la liste des utilisateurs (autant que souhaités)

ACCESS author (pour ne pas voir les fichiers templates et css) ou webmaster (pour tout voir)

PASSWORD à obtenir avec hexdigest

Note

Pour obtenir un mot de passe, lancez la commande suivante avec votre mot de passe à la place de 'password'

python -c "import sha; print sha.new('password').hexdigest()"

RST désigne la liste des options à indiquer à docutils.

Ligne de commande

Il est possible de lancer la génération en lançant publy.py dans le répertoire où se trouve le fichier de configuration, ou en indiquant le répertoire comme argument.

Les options sont les suivantes

--force-html regénère à partir des templates
--force-rst regénère à partir des fichiers rst

Interface WEB

Dans le répertoire où se trouve le fichier de configuration :

Fichier .htaccess:

ErrorDocument 502 /publy/auto.py
RewriteEngine On
RewriteRule ^.*publy$ /publy/ [R,L]
RewriteCond %{REQUEST_URI} !auto.py$
RewriteRule (.*) http://localhost:6510/$1 [P]

(prendre un numéro de port libre quelconque, pas nécessairement 6510)

Fichier auto.py:

#!/usr/bin/python2.2
from flibuste.weby.server import run_server
run_server(autostart = True, autostop = 3600,
          debug = True,
          port = 6510,
          single_page = "flibuste.publy.webadmin")

l'interface sera accessible en allant sur http://localhost/6510

Le serveur va démarrer automatiquement sur le port 6510. Il est possible de le lancer et de l'arrêter à la main à l'aide d'options en ligne de commande:

./auto.py start
./auto.py restart
./auto.py stop