Generar blogs estáticos con BashBlog

git clone https://github.com/cfenollosa/bashblog.git

También puedes descargarlo desde aquí:

bashblog.zip

Dentro la carpeta bashblog encontraremos el script bb.sh, debes copiarlo en la carpeta en dónde va a ser servido tu blog. En mi caso al instalar Apache2 en Debian GNU/Linux 8 este ya me asigna una carpeta específica por defecto en la ubicación /var/www/html. Como cada usuario utiliza una configuración determinada a su fin, queda en ustedes la configuración del servidor.

Una buena práctica sería editar las líneas referentes a la raíz de nuestro sitio (DocumentRoot) además de las directivas de configuración del directorio raíz de la Web local <Directory /var/www/>.

Sin embargo a fines didácticos para no alterar mi configuración inicial solo he configurado un enlace simbólico (symlink) para servir mi carpeta —en este caso blog—:

## En /home/mi_usuario/  Reemplaza 'mi_usuario' por tu usuario

mkdir blog

## Dentro de ella copio el script bb.sh

cd bashblog & cp bb.sh /home/mi_usuario/blog

Ahora resta configurar mi carpeta pública (blog) para postear los artículos.

cd /var/www/html
sudo ln -s /home/mi_usuario/blog blog

De aquí en adelante cada vez que apunte a la dirección http://localhost/blog o dirección del server p. ej.: http://192.168.x.x/blog, se mostrará el contenido HTML estático generado por bb.sh, es decir mi página Web.

Ya contamos con el script bb.sh dentro de nuestra carpeta servida (blog), es momento de crear nuestro primer post. Desde un terminal ejecutamos:

./bb.sh post

o

./bb.sh post nombre_archivo  ## Si se continúa la edición de 
				un archivo en borrador (draft)

Es probable que la primera vez se queje de que no tenemos definido un editor de texto. Cuando hacemos uso de este comando automáticamente inicia el EDITOR que tengamos configurado como variable para bb.sh.

"Please set your $EDITOR environment variable"

Esto se resuelve de forma muy sencilla:

## Reemplaza vim por tu editor favorito

export EDITOR=vim

Luego al ejecutar nuevamente ./bb.sh post ya podemos editar nuestro post. De forma predeterminada despliega las siguientes líneas:

Title on this line

The rest of the text file is a **Markdown** blog post. 
The process will continue as soon as you exit your editor.

Tags: keep-this-tag-format, tags-are-optional, 
beware-with-underscores-in-markdown, example

Simplemente como se indica, reemplazar la primera línea por el título del post —este será finalmente el nombre del archivo— y el resto del texto sustituirlo por nuestro contenido en formato Markdown —aquí tienes información al respecto—, también la categorías en caso de utilizarlas. El proceso continuará tan pronto como salgamos del editor, este nos ofrece tres opciones:

• Postear la entrada.
• Editar nuevamente el contenido.
• Guardarlo como borrador.

To preview the entry, open http://example.com/blog/title-on-this-line.html 
in your browser [P]ost this entry, [E]dit again, [D]raft for later? (p/E/d) _

Por defecto bb.sh está configurado para trabajar en Markdown —el original de John Gruber—. El script busca automáticamente el ejecutable Markdown.pl en nuestro sistema, si no está instalado y vamos a utilizar Markdown seguiremos estos pasos.

Descargamos el archivo Markdown.pl y lo copiamos en la carpeta apropiada:

Markdown_1.0.1.zip

unzip Markdown_1.0.1.zip & cd Markdown_1.0.1 
sudo cp Markdown.pl /usr/local/bin

En caso de no instalar Markdown.pl —o simplemente no usar este lenguaje de marcas—, lo indicamos mediante la opción -html y la edición del post se hará en formato HTML:

./bb.sh post -html

Ahora nuestro archivo de edición se verá así:

Title on this line

<p>The rest of the text file is an <b>html</b> blog post. 
The process will continue as soon as you exit your editor.</p>

<p>Tags: keep-this-tag-format, tags-are-optional, example</p>

Esta herramienta es muy configurable, algunos cambios podrían ser:

• Título del blog.
• Descripción del título o sitio Web.
• Cantidad de artículos que se mostrarán en la página principal.
• Configuración de:
  • Email
  • Autor
  • Twitter
  • Disqus
  • Cabecera y pie de página
  • Etc.

Esta acción se puede realizar de dos formas:

1. Crear un archivo .config y editar las variables necesarias.
2. Editar directamente el archivo bb.sh.

Si optamos por la 1ra. opción debemos tener en cuenta la sintaxis variable_nombre=»valor» —el signo igual (=) no debe tener espacios alrededor—. Hay que tener en cuenta que las configuraciones en el archivo .config tienen precedencia sobre el archivo bb.sh

Un ejemplo simple de ambos casos podría ser este:

De forma predeterminada bb.sh no corta las líneas de texto en la página principal, los artículos se mostrarán completos. Si queremos que solo sea visible un extracto del artículo debemos utilizar la etiqueta <hr> en HTML, y 3 o más guiones - - - en Markdown, algo similar a lo que ocurre con la etiqueta more.