Notas rápidas de una mudanza

Hace unos días abría este espacio prometiendo migrar contenidos y tratar de que se vea un poco más bonito.

Este post incluye algunas notas sobre lo que he hecho hasta el momento.

Github ♥ Nikola

Este blog que estás leyendo está hospedado en Github Pages , el servicio de hosting gratuito de contenido estático que ofrece Github.

A diferencia de cuando se usa Gh-pages para proyectos, donde se sirve el contenido del branch gh-page del proyecto en cuestión, para usar gh-pages por usuario hay que crear un repo llamado <username>.github.com (donde <username> es el tuyo) y lo que sirve en http://<username>.github.com es directamente el branch master (referencia)

Por este motivo creé otro branch (que sin mucha imaginación denominé writing ) donde tengo todo el mi "proyecto" hecho con Nikola

Allí escribo, intento mejorar mi theme, y corro nikola build.

El branch master es el de deploy y sirve todo lo que haya en la carpeta output/ del branch writing. Para hacer esto hay que ir a master, borrar todo y leer desde el árbol del otro branch con read-tree

git checkout master
git rm *    # sólo la primera vez
git read-tree writing:output
git commit -m 'deploying last build'
git push

Migrando desde Spip

Uno de los motivos que me llevaron a migrar desde Spip es que el markup que usa es ad hoc y muy feo. Algo así

{{{ Un intertítulo }}}

Esto es {{negrita}} y este [mi twitter->http://twitter.com/tin_nqn_]

Hasta ahí no se ve tan mal, pero es muy limitado cuando se trata de mostrar código, necesario en todo blog mas o menos técnico.

Para migrar esquivé la idea de convertir el markup de spip y opté por un scrapping, limpieza y conversión a restructuredText usando el mágico Pandoc (y la ayuda de PyQuery)

El script que hice está acá . No es perfecto, pero está lo importante: contenidos, imágenes, adjuntos, convertido a restructuredText bastante decente que mejoraré poco a poco a mano.

Estilos

Es mentira que a los ñoños no nos gustan las cosas (los blogs, entre otras) que se ven bonitos. Sucede, en realidad, que la mayoría de las veces no venimos con esa habilidad y el esfuerzo que nos implica intentarlo preferimos ponerlo en otra cosa. No gusta, pero no es lo más importante.

No obstante, yo quiero que este espacio sea lindo y legible. Y como hay muchos otros ñoños con sitios lindos y legibles que son tan amables de compartir sus estilos (y existe bootstrap, claro) voy a ir intentándolo, incrementalmente.

Por ahora tomé ideas y CSS de stevelosh.com [1] y de la documentación de Flask [2] basado en el theme Readable de bootswatch.com

Disqus

El blog viejo usaba Disqus, con un plugin que hice hace algun tiempo. Para migrar los comentarios utilicé el método de subir un CSV con el formato que genera el mismo script de migración:

URL_POST_X_OLD, URL_POST_X_NEW
URL_POST_Y_OLD, URL_POST_Y_NEW

En cuestión de minutos los (pocos) comentarios estaban migrados.

Redirección

Como mantuve el slug de los viejos artículos, una redirección 301 via .htaccess redirige del viejo blog al nuevo:

# nqnwebs.com blog rules
RewriteCond %{HTTP_HOST} ^nqnwebs [nc]
RewriteRule ^blog[/]?$ http://mgaitan.github.com/ [R=301]
RewriteRule ^blog/article/(.*)$ http://mgaitan.github.com/posts/$1.html [R=301]

¿Cómo se va viendo?

[1] https://bitbucket.org/sjl/stevelosh/src/6432040d5154/LICENSE?at=default
[2] https://github.com/mitsuhiko/flask-sphinx-themes/blob/master/LICENSE

El código de este artículo está disponible en github. ¿Encontraste un error? Por favor, enviame un pull request.

Comentarios

Comments powered by Disqus