=====================================
Pelican
=====================================
Appunti allo sviluppo per Pelican

  :Author: Andrea Manni
  :Copyright: GFDL
  :Version: 0.1

Questi appunti sono ad uso privato.

.. sectnum::

.. contents:: Indice degli argomenti
.. |date| date::

Generato il |date| con: http://docutils.sourceforge.net/rst.html

Virtual env
=============

Per una installazione 'pulita' mainstream in un virtual enviroment::

    mkdir site
    cd site/
    virtualenv env
    . env/bin/activate
    easy_install flask
    mkdir templates static


Se per attviare un env si usa::

        . env/bin/activate
        source env/bin/activate

Per disattivarlo::
        
        deactivate


Requirements list
------------------
Per generare una list they requirements del virtual env (o del sistema operativo senza il ``-E`` o se non si e' attviato il virtual env)::

        pip -E env/ packages_list

        # Esempio
        Django==1.2.3
        Flask==0.8
        Jinja2==2.5.5
        MarkupSafe==0.9.2
        PIL==1.1.7
        Pygments==1.3.1
        Sphinx==0.6.6
        Werkzeug==0.8.2
        chardet==2.0.1
        distribute==0.6.10
        docutils==0.7
        iotop==0.4
        lxml==2.2.8
        pysqlite==1.0.1
        virtualenv==1.4.9
        wsgiref==0.1.2



Per installare i pacchetti in base alla lista generata::

        pip -E env/ install -r packages_list


Immagini
===============

Di default c'e' un path per /images che tira a content/images . Si puo' creare un nuovo path con una direttiva ``STATIC_PATHS = ['images', 'pdf'] nel file di configurazone.

I file CSS dei templates invece hanno i loro simboli::

	   <link rel="stylesheet" href="{{ SITEURL }}/theme/css/{{ CSS_FILE }}" type="text/css" /> 


Aggiornare pagine e servire in locale
========================================


make html e make serve