Este repositorio contiene el código para generar la web estática http://procedimientoslibres.es. Para la generación se utiliza Pyll: https://github.com/arthurk/pyll Pyll es un generador de webs estáticas. Usted escribe plantillas de jinja2 o archivos en formato rst (restructured text) y pyll los transforma en archivos html listos para ser servidos desde un servidor web. Instalación =========== Es muy recomendable hacer uso de virtualenvwrapper [1] y trabajar sobre entornos virtuales para Python: Creamos un entorno virtual específico para pyll: $ mkvirtualenv --no-site-packages pyll Instalamos pyll: $ pip install https://github.com/arthurk/pyll/archive/master.tar.gz Instalamos las fuentes de procedimientoslibres.es: $ git clone https://github.com/jdelacueva/web-procedimientoslibres.es.git Sitúese en el directorio de las fuentes y ejecute el comando pyll: $ cd web-procedimientoslibres.es $ pyll Se generará el directorio _output donde encontrará el código de la web estática. Para consultarlo, es útil ejecutar un servidor local $ pyll --server Podrá acceder a la web en http://localhost:8000/ Incorporación de un nuevo procedimiento ======================================= El trabajo para modificar la web lo hemos de hacer en los archivos situados en el directorio web-procedimientoslibres.es/_input. Para incorporar un nuevo procedimiento deberemos tener en cuenta las siguientes cuestiones: 1. Modificar la portada de la web. Se trata del archivo _input/index.html donde deberá escribir el nombre del procedimiento y enlazarlo. 2. Crear un directorio con el nombre del archivo dentro del directorio _input/procedimientos. El nombre elegido del directorio corresponderá a la url de la web. Así, por ejemplo, si el directorio creado se denomina suspension-desahucio, la URL de acceso será http://example.com/procedimientos/suspension-desahucio. En la elección del nombre del directorio no utilice espacios, mayúsculas, caracteres acentuados o con diéresis ni letras tales como ñ, ç. 3. Utilice como guía los archivos situados en otros directorios de _input/procedimientos para crear los archivos de su procedimiento. Tenga en cuenta que cada archivo será transformado en una página web. 4. Las primeras líneas de cada archivo contienen metadatos. Existen algunos definidos, como 'template:' o 'date:' pero puede utilizar cualquiera que tenga por conveniente para su uso en la plantilla jinja2. Por ejemplo, si utiliza 'autor:fulano', en la plantilla utilizada puede usar el campo {{ page.autor }} que será sustituida por el valor 'fulano'. 5. Deberá crear una plantilla para el menú del procedimiento dentro del directorio _templates. Esta plantilla debe ser la utilizada en los metadatos de los archivos del nuevo directorio. [1] http://pypi.python.org/pypi/virtualenvwrapper