Instalar Docpad

Este blog estaba hecho con Docpad.

Recién comienzo a utilizarlo y ya lo amo, así que dejo una guía rápida para comenzar a usarlo.

Instalar docpad

sudo pacman -S nodejs nodejs-less

En Parabola GNU/Linux python es python3.
Docpad necesita utilizar python2, así que ejecutamos:

sudo npm config set python `which python2`

Esto evitará que se muestre el error:

Python executable "python" is v3.4.3, which is not supported by gyp.

Ahora podemos instalar docpad usando el gestor de paquetes de node.js.

sudo npm install -g docpad

Se necesita sudo para hacer una instalación global (-g) en /usr/lib/node_modules/docpad/.

Comenzar un proyecto

Sólo se requiere generar una carpeta y correr docpad dentro de ella:

mkdir <project-dir>
cd <project-dir>
docpad run

El instalador nos pedirá entonces:

  • Aceptar la licencia de uso,
  • Suscribirnos a la lista de correo (o no),
  • Elegir un esqueleto.

Esqueletos

Los esqueletos son páginas ya hechas que podemos modificar para no empezar de cero.

Yo elegí sin esqueleto porque

Nunca me gustó hacer algo de la manera sencilla si podía hacerse bocarriba.

parafraseando Neuromante – William Gibson

(Además, no me gustaron los esqueletos que probé.)

Instalar módulos

Docpad hace todo por medio de programas pequeños y dedicados a una sola cosa.

Lo que ya se puede hacer con docpad está en un módulo, y lo que todavía no se puede hacer con docpad estará en un módulo.

Para instalarlos se utiliza:

docpad install <módulo>

Este sitio utiliza eco, marked y yamljs. Hay una lista más completa aquí

Estructura de archivos

Lo que está dentro de la carpeta src (lo que editamos) formará el contenido de out (lo que publicamos).

Dentro de src hay otras 3 carpetas:

  • files (o static): donde va lo que no cambia,
  • layouts: archivos que sirven de esqueleto y sobre los que se escriben los
  • documents (o render): contenidos que se procesarán según los

Nombres de archivos

El final del nombre del archivo indica cómo se va a transformar y en qué orden.

Por ejemplo, el archivo prueba.html.md.eco se procesará primero por el plugin eco, luego por el plugin marked (md) y finalmente quedará como html.

Para cada paso es necesario tener un plugin y saber usarlo.

Para publicar archivos

Algunos plugins (por ejemplo rss) requieren la siguiente configuración: En docpad.coffee:

templateData:  # Informacion del sitio web
    site:
        url: "http://website.com"
        title: "Título del sitio web."
        description: """
            Esta descripción aparecerá en Google y otros buscadores.
            """
        keywords: """
            aquí, van, palabras, clave, para, optimización, de, búsqueda
            """

Más información

https://docpad.org/docs/begin

Tags// ,
More Reading
Newer// La mafia
Older// No saber