Installer Pelican sur un serveur Debian

Installer Pelican sur un serveur Debian n'est pas compliqué, et ne requiert que peu de paquets. Ce tutoriel suppose que vous avez déjà configuré votre nom de domaine et apache ou autre serveur web pour accéder à votre site via votre url. Bien évidemment, vous n'êtes pas obligé d'avoir votre propre serveur @home. Vous pouvez créer les fichiers sur votre compte local, et les uploader via ftp sur le serveur bien évidemment.

Pour l'installer, il faut commencer par installer python-pip

# apt-get install python-pip

Puis lancer l'installation de pelican

# pip install pelican

A ce stade, il ne va vous rester qu'un fichier de configuration a éditer : le fichier settings.py. Il est très important de ne pas modifier le fichier initial de pelican qui se trouve ici :

# /usr/local/lib/python2.6/dist-packages/pelican/settings.py

Par curiosité, je vous mets le fichier par défaut, mais surtout ne le modifiez pas, on va créer le notre après !

import os

_DEFAULT_THEME = os.sep.join([os.path.dirname(os.path.abspath(__file__)),
                             "themes/notmyidea"])
_DEFAULT_CONFIG = {'PATH': None,
                  'THEME': _DEFAULT_THEME,
                  'OUTPUT_PATH': 'output/',
                  'MARKUP': ('rst', 'md'),
                  'STATIC_PATHS': ['css', 'images'],
                  'FEED': 'feeds/all.atom.xml',
                  'CATEGORY_FEED': 'feeds/%s.atom.xml',
                  'SITENAME': 'A Pelican Blog',
                  'DISPLAY_PAGES_ON_MENU': True,
                  'PDF_PROCESSOR': False,
                  'DEFAULT_CATEGORY': 'misc',
                 }

def read_settings(filename):
    """Load a Python file into a dictionary.
    """
    context = _DEFAULT_CONFIG.copy()
    if filename:
        tempdict = {}
        execfile(filename, tempdict)
        for key in tempdict:
            if key.isupper():
                context[key] = tempdict[key]
    return context

De notre côté, on va s'interesser à trois variables pour commencer :

• OUTPUT_PATH ;
• SITEURL ;
• SITENAME.

La première indique le repertoire sous votre serveur ou vont être copié les fichiers html. Dans mon cas personnel, il s'agit de :

/var/www/freeculture

La seconde fait référence à l'url de votre site. Chez moi, ca donne donc :

http://freeculture.homelinux.com

Et la troisieme indique le nom de votre site qui est pour Free Culture : (Suspence ......) Free Culture.

Nous allons donc créer le fichier settings.py

OUTPUT_PATH = '/var/www/freeculture'
SITE_URL = 'http://freeculture.homelinux.com'
SITENAME = 'Free Culture'

Il ne nous reste plus qu'a créer notre premier article. Pour cela, inutile d'aller dans le répertoire ou sera créé votre blog, vous pouvez très bien le faire dans votre répertoire utilisateur, par exemple /home/user/blog au lieu d'aller dans /var/www. Les fichiers doivent être écrits en reStructuredText qui porte l'extension .rst. De plus, le nom du fichier peut être différent du nom que vous donnerez à l'article.

Commençons par créer un fichier test.rst.

Installer Pelican sur un serveur Debian
#######################################

:date: 2010-11-20 00:41
:category: Pelican
:author: Guillaume

Comment installer Pelican sur un serveur Debian

Quelques remarques s'imposent concernant la syntaxe de reStructuredText. Le titre de l'article Installer Pelican sur un serveur Debian doit être souligné sur toute sa longueur par des caractères #.

Ensuite viennent des méta-données : date, catégorie, et auteur. (A bien mettre en anglais dans le fichier).

Et en dessous, le contenu de votre article. Pour l'instant, je ne vais pas vous explique la syntaxe ReStructuredText en long, en large et en travers. Mais sachez qu'en 3 - 4 jours, on commence à bien maitriser le bestiau.

Une fois que vous avez créé votre article, faire un

$ pelican -s settings.py .

Et le logiciel s'occupera de créer les pages html dans votre répertoire destination. Vous n'avez plus qu'a allez les visiter avec votre navigateur internet.

Et voilà le travail !!!

J'espère que cette légère introduction vous à plu. Dans le prochain article, je commencerai à vous montrer comment utiliser le langage reStructuredText.