A-Qute blog (guide)

Instalar Jekyll (y Ruby) en Windows

Tue, 29 Sep 2015 00:00:00 GMT

Pequeña guía para tener una instalación de GitHub Pages en Windows, para testear Jekyll antes de "pushear" los cambios. Recomendado cuando estas haciendo un theme de un blog o creando un sitio.

Instalar Ruby

Se necesita Ruby y Ruby Dev-kit para poder instalar los "gems".

Primero descargar ruby de Ruby Installer. Al instalar, checkear la opcion de "Add Ruby executables to your PATH".

Note

Al 2016-02-09, GitHub Pages usa la versión 2.1.7; la mas cercana listada es la 2.1.8. Podes descargar el instalador de Ruby 2.1.7 en los archivos cosa de asegurarte.

Del mismo sitio, descargar el Ruby DevKit correspondiente a la versión. La descarga es un archivo descomprimible .exe. Descomprimirlo en alguna carpeta sin espacios (por ejemplo: C:\Ruby\DevKit\).

Para "unir" el devkit e instalarlo, seguir los siguientes pasos:

con la línea de comandos ir a la carpeta (cd path\carpeta\)
Ejecutar ruby dk.rb init, esto auto-detecta las instalaciones de Ruby y añade a un archivo de configuración necesario para el próximo paso.
Ejecutar ruby dk.rb install para "unir" el DevKit.

Note

Si da error de "Comando no encontrado" verificar que en el PATH este como [path\a\ruby\]bin\ (notar barra invertida final)

~~Si vas a necesitar "Syntax Highlighting" y elegiste pygments, tenés que instalar Python (para Jekyll 2 o inferior).~~

Al 2016-02-09, GitHub Pages solo acepta Rouge para "Syntax Highlighting" (escrito en Ruby).

GitHub Pages local: instalación de Jekyll y complementos

En Windows no se puede instalar el gem de GitHub Pages por que tira error al querer instalar RDiscount, porque (según cita):

(RDiscount) It uses a POSIX function that is not available under Windows, even if you adjusted most of it.

(Luis Lavena en Super User)

Info

Al 2016-02-09, GitHub Pages solo acepta kramdown; desconozco si sigue tratando de descargar RDiscount (parece que si).

Por esto, es mejor instalar bundler (gem install bundler) y usar un gemfile (llamado "Gemfile") en donde se encuentra el proyecto, listando lo de arriba con las versiones que se usan:

    source 'https://rubygems.org'

    require "json"
    require "open-uri"
    #get versions specific to github
    versions = JSON.parse(open("https://pages.github.com/versions.json").read)

    gem "jekyll", versions["jekyll"]
    gem "jekyll-coffeescript", versions["jekyll-coffeescript"]
    gem "jekyll-sass-converter", versions["jekyll-sass-converter"]
    gem "kramdown", versions["kramdown"]
    #gem "maruku", versions["maruku"] #jekyll 3.0 uses kramdown
    #gem "rdiscount", versions["rdiscount"] #we cant install it in windows
    #gem "redcarpet", versions["redcarpet"] #no support in GH pages (2016-02-09)
    #gem "pygments.rb", versions["pygments.rb"] #no support in GH pages (2016-02-09)
    gem "rouge", versions["rouge"] #for code highlighting
    #gem "RedCloth", versions["RedCloth"] #textile, no support in GH pages (2016-02-09)
    gem "liquid", versions["liquid"]
    gem "jemoji", versions["jemoji"]
    gem "jekyll-mentions", versions["jekyll-mentions"]
    gem "jekyll-redirect-from", versions["jekyll-redirect-from"]
    gem "jekyll-sitemap", versions["jekyll-sitemap"]
    gem "jekyll-feed", versions["jekyll-feed"]
    gem "jekyll-seo-tag", versions["jekyll-seo-tag"]
    #gem "ruby", versions["ruby"] #avoid problems in windows
    gem "github-pages", versions["github-pages"]
    gem "html-pipeline", versions["html-pipeline"]
    gem "sass", versions["sass"]
    gem "safe_yaml", versions["safe_yaml"]

(idea del código de jamesjoshuahill)

Se instalan los gems (con bundler) yendo al directorio con el Gemfile y ejecutar bundle install.

Puede haber problemas con el certificado de https://rubygems.org. Si no se quiere probar, instalar (eliminado rdiscount, sin documentacion) los gems con el siguiente comando (al 2015-09-28):

gem install jekyll:3.0.2 --no-rdoc --no-ri jekyll-sass-converter:1.3.0 --no-rdoc --no-ri jekyll-textile-converter:0.1.0 --no-rdoc --no-ri kramdown:1.9.0 --no-rdoc --no-ri redcarpet:3.3.3 --no-rdoc --no-ri RedCloth:4.2.9 --no-rdoc --no-ri liquid:3.0.6 --no-rdoc --no-ri rouge:1.10.1 --no-rdoc --no-ri jemoji:0.5.1 --no-rdoc --no-ri jekyll-mentions:1.0.0 --no-rdoc --no-ri jekyll-redirect-from:0.9.1 --no-rdoc --no-ri jekyll-sitemap:0.10.0 --no-rdoc --no-ri jekyll-feed:0.3.1 --no-rdoc --no-ri jekyll-gist:1.4.0 --no-rdoc --no-ri jekyll-paginate:1.1.0 --no-rdoc --no-ri github-pages-health-check:0.6.0 --no-rdoc --no-ri jekyll-coffeescript:1.0.1 --no-rdoc --no-ri jekyll-seo-tag:0.1.4 --no-rdoc --no-ri ruby:2.1.7 --no-rdoc --no-ri github-pages:45 --no-rdoc --no-ri html-pipeline:2.3.0 --no-rdoc --no-ri sass:3.4.21 --no-rdoc --no-ri safe_yaml:1.0.4 --no-rdoc --no-ri

El error de certificado es un similar a:

[!] There was an error parsing `Gemfile`: SSL_connect returned=1 
errno=0 state=SSLv3 read server certificate B: certificate verify 
failed. Bundler cannot continue.

Se soluciona de la siguiente manera:

descargar el archivo cacert.pem y guardarlo en (por ejemplo ejemplo) C:\RailsInstaller\cacert.pem.
Settear el SSL_CERT_FILE usando la línea de comandos: set SSL_CERT_FILE=C:\RailsInstaller\cacert.pem. Se puede dejar "permanente" poniendolo en el PATH.

También se puede hacer por proyecto:

Guardar el archivo cacert.pem en el proyecto.

A list item with a code block:

ENV['SSL_CERT_FILE'] = File.expand_path(File.dirname(__FILE__)) + "/config/cacert.pem"

Correr Jekyll

Seguramente va a tirar un error de encoding, estilo:

jekyll 2.4.0 | Error:  incompatible character encodings: CP850 and UTF-8

para solucionarlo ejecutar en la línea de comandos chcp 65001 antes de ejecutar Jekyll.

En la carpeta donde se tiene los archivos:

Si se usó el fix de OpenSSL, hay que usar bundler: bundle exec jekyll serve
Si no: jekyll serve

Abrir en http://127.0.0.1:4000/

Fuentes:

Cambios --------- #. 2016-02-09 actualización a GitHub Pages usando Jekyll 3

De Pelican a Nikola (tutorial)

Sat, 11 Jan 2014 00:00:00 GMT

Cuando pensaba en mover mi blog a este nuevo dominio, pensé en usar Pandoc como conversor¹; incluso creé pandy para eso. Pero después tuve los "problemas" (ok, estaba vaga) de RSS, categorias, tags, index, etc. y lo dejé.

En un principio pensé en seguir usando Pelican ya que es fácil y personalizable aunque no tuviera soporte para Pandoc². Pero mas tarde me daría vagancia pasarme a otro sistema (no que postee mucho, pero me encanta el markdown de Pandoc).

Acrylamid

En mis búsquedas encontré Acrylamid que se ve bastante bien. Es como el blog generator de programadores/hackers, donde podés hacer varias cosas. También tiene incremental builds así no regenera todo desde cero.

Otras cosas incluyen:

diferentes meta tags: MultiMarkdown (como Pelican), YAML o rst.
los borradores se activan con booleans. Yay!.
podés incluir sintaxis de templates en los posts e incluso usar las variables de configuración.
summary/intro automático
acrónimos y abreviaciones de usuario en un archivo de texto.
los views que se ven copados y personalizables.
output de linea de comandos con color. GRACIAS!
trae para hacer pingback a otros blogs y postear a twitter.
información del blog: cuántos posts publicados, cuántos borradores, uso de tags. También cuando se compiló por última vez, tamaño de cache...
ejecutar comandos de shell en un post: como listar una carpeta, incluir otro archivo, etc.
mostrar el sitio con un comando
filtros de post-processing

No tiene categorias (pero se pueden usar vistas), galerias automáticas (pero se puede usar sintaxis de templates en un post, asi que está cubierto) y la creación de themes no es tan automática: tenés que listar todos los archivos que usa tu theme en un archivo __init.py.

Quería usar Acrylamid, pero era medio "complicado" para setearlo en Windows si querías usar python-magic (tuve problemas con eso). Salteé esa parte, pero me seguía dando error con los locales.

Nikola

Después recordé que una vez me había cruzado con Nikola, originalmente creado por un argentino, asi que tenía que probarlo :P.

No es tan feature-rich (o de fácil personalización) que Pelican, y la documentación tampoco es tan "completa": hay un par de cosas que se encuentran en los Google Groups, GitHub o mirando en el código. Tampoco no es tan feature-cool como Acrylamid. De todas formas, creo que va en buen camino y es el mas nuevo de los tres.

Tiene cosas copadas:

incremental builds (como Acryamid)
creación de galerías automáticas
categorias (como Pelican)
creación de themes fácil (como Pelican)
mostrar el sitio con un comando y tiene "Live" re-rendering
posts "retirados" (asi no tener 404 errors)
redirecciones (por si no podes usar .htaccess)
deploy commands (ejecutar varios comandos y no tener que hacer un simple script)
filtros de post-processing
soporte para internalización (la interfaz del sitio/blog puede estar en varios idiomas)
posts/páginas protegidos con contraseña.
"programar" posts/páginas
Soporte a gran selección de (3rd party) sistemas de comentarios y AnnotateIt.
Extensiones para reStructuredText (si usas eso).
Suporte para Twitter cards
soporte para raw post/página (mostrar el código del post en texto plano)

Los drafts se aplican como un "tag" en el metadata de tags y se publican por default. No tiene soporte de color en el output de la línea de comandos (pero se está viendo) y lo de "mostrar el código del post y copialo" está habilitado por default.

La mudanza

Instalar Nikola

Se descarga Nikola e instala. Por default, usa Mako como template engine, pero tiene soporte para Jinja2. Se puede leer las dependencias en la documentación y si queres podes pip install -r requirements.txt o requirements-full.txt para toda la cosa.

Si estás en Windows, debés descargar e instalar las versiones compiladas de lxml y pillow. Podés buscarlos en sus PyPI o ir a http://www.lfd.uci.edu/~gohlke/pythonlibs/. Acordate de descargar e instalar dependiendo a tu versión y arquitectura de Python (32 o 64 bits).

Iniciar

Para iniciar o crear un blog con las opciones default y estructura de carpetas, ejecutar nikola init path/to/mysite o, si queres algo de contenido, nikola init --demo path/to/mysite.

Convertir metadata

Pelican usa el estilo de metadata de Multimarkdown mientras que Nikola usas algo similar: el mismo sintaxis pero con .. al frente.

Un ejemplo sería:

Title: nice title! :D      # Pelican
.. title: nice title! :D   # Nikola

Lo podés hacer a mano o descargar mi script de python. También mueve el estatus de "draft" al tag de Nikola, y el "summary" de Pelican al "description" de Nikola (activado por default).

Note

Nikola no tiene/ve el meta key "modified" internamente, pero se puede tener como uno personalizado. Solo se accede diferente en los themes.

Traducciones

Si tenes posts o páginas traducidas tenés que prestar atención: los sistemas entre los generadores son distintos. En Pelican tenés el mismo slug o título en los posts, y diferentes nombres de archivos (creo); Nikola usa los nombres de archivos.

La facilidad de esto depende de tu setup, pero tenes que terminar con algo como: nicefile.md para el post en el idioma default, y nicefile.md.es (contenido en español) para el traducido.

Lo bueno de esto es que no duplicas el meta. Por ejemplo, creas el meta key "tags" en el idioma default pero no lo especficas en el traducido. Así al actualizar, lo haces solo en el "master" o "padre" y el "hijo" solo lo copia.

Si no queres tener metadata duplicada en los archivos, y después de que renombraste y convertiste los archivos, podes correr este script de python para eliminarlos. Recordá que solo es opcional (o por lo menos no rompió mi setup).

Rutas de imágenes

La sintaxis también es diferente pero se puede hacer facilmente con search and replace. Podés usar lo que quieras, como grep. Si estas en Windows, recomiendo grepWin si queres algo con GUI. Esto es depende de como tengas los archivos pero yo hice algo asi:

Sintaxis markdown:

Search (|filename|../../images/
Replace (/images/

HTML:

Search <img src="../../static/images/
Replace <img src="../images/

Links entre posts

Otra vez, es diferente en los sistemas y puede ser o muy fácil o muy dificil dependiendo de tu organización: Pelican usa los nombres de archivos para linkear contenido, mientras que Nikola usa el slug del post.

Si tenes el nombre de archivo como el slug (o muy similar) podes usar search and replace, como:

Search: $\|filename\|(.+)\.md$
Replace: (link://slug/$1)

Recomiendo hacerlo seguido de las imágenes, y tenes que checkear (posiblemente a mano) después.

Sintaxis de Plugins

No usé muchos plugins que usaran sintaxis en mis posts, solo uno: interlinks. Esto fue fácil de hacer con search and replace.

Otras cosas de Nikola

Localización en Windows

Si vas a usar la internalización en Windows, tenes que configurar los LOCALES como (ejemplo):

LOCALES = {'en' : 'English_United States', 'es' : 'Spanish_Argentina'}

No importa tu idioma en Windows, funciona tanto en (Windows) inglés como español.

Linkear internamente

Para linkear a otro post, tag, archivo, etc.

galeria: link://gallery/gallery_name
index de tags: link://tag_index
página de tag: link://tag/tagname
RSS de tag: link://tag_rss/tagname
index del blog: link://index
página [NUMERO] de index: link://index/NUMERO
archivo por año: link://archive/
posts de [AÑO] link://archive/AÑO
feed del blog: link://rss
otro post: link://slug/the-nice-slug

Pandoc

Como Pandoc usa la extensión para reconocer el input, tenes que configurar esa extensión en COMPILERS en la configuración. Si no se encuentra, usa Markdown como default.

Mientras que funcionó para mi usando markdown, no lo hizo con otros, como Mediawiki. No sé por qué.

Carpetas y subcarpetas de posts

Nikola mantiene la estructura de carpetas y subcarpetas. Si tenés file_g.txt dentro de carpeta_abc, esta estructura se mantiene en el output. Puede ser bueno si lo queres usar como categorías en el output. No hay manera de configurarlo.

En Pelican podés tener varias subcarpetas y organizalos como vos quieras, y el output se puede configurar (por default, por fecha) como quieras.

Testeando

Inicialmente los posts van en una carpeta posts en el root y las páginas en story. La carpeta de imágenes podría en files. Todo esto se puede configurar.

Después de configurar el conf.py, que esta muy bien comentado, se puede probar.

Crear el site con nikola build. Después se puede abrir los archivos al navegador o usar un local server con: nikola serve y yendo a http://127.0.0.1:8000.

Porque odio abrir un HTML block y el markdown de adentro no se parsea. Sé que dice en la referencia de markdown pero hey: es 2014 y necesito eso. Pero igual me encanta los admonition en Python-Markdown ↩
Que ahora veo que no es tan dificil implementarlo. Oh, well. ↩

GitHub Pages para proyectos

Wed, 01 Jan 2014 00:00:00 GMT

Pasos simples para crear un GitHub Pages para proyectos/por repo (y no para usuario u organización) además de cositas varias.

Los pasos estan tanto para CLI como para GitHub for Windows (TortoiseGit es "similar" a Git CLI) y orientado para principiantes en esto de Git, que buscan facilidad y no tanto "lío" o "vueltas". Aunque si estas cómodo con SVN podes usarlo (ver clientes en GitHub).

Abreviaciones y otros vocabularios:

git CLI: El Git que usas en una terminal/linea de comandos.
GW: GitHub for Windows.
Tortoise: TortoiseGit.
Server: Donde se "hostean" las cosas (como GitHub). En Git esto no existe, pero asi se entiende mejor para los principiantes (repositorio remoto).; "Central server" si venis desde SVN.
repo: Para hacerla más fácil, mirar "repo" como "repositorio principal/remoto" o "server" (ver definición).
origin: Así se denomina al "repositorio remoto" original y por convención el repositorio centralizado 'primario'.
c-p: commit seguido de push

Programas para Windows

En un principio, tener Git en Windows era mucho lio (porque fue creado por y para Linux) pero ahora hay varias opciones. Usualmente, si vas a usar solo GitHub, se recomienda GW. Pero si queres usar Git para otras cosas (como crear "servers" localmente y jugar ahi) recomiendo TortoiseGit + msysgit (git CLI) en lugar de GW:

te sirve para varias cosas y no solo para GitHub ("lee" el protocolo github://)
no tenes que pelear con el PATH por si queres usar git CLI (se instala en %appdata% y no podes añadir solo bin\)
msysgit viene con "git Bash"; una CLI re linda con colores que además te muestra en qué branch estas; ademas de personalizarla con .bashrc.

Crear repositorio

En GitHub, crear un repositorio con el nombre que se quiera. Podes iniciar sesión e ir a https://github.com/repositories/new o apretando en el "librito".

"Activar" GitHub Pages

Se activa magicamente creando un branch llamado gh-pages.

Desde web es apretando en branch master; en GW es apretando arriba donde dice master. Buscar gh-pages y apretar opción de crear (create branch). Con CLI sería (previamente clonado, mirar abajo):

$ git checkout --orphan gh-pages    # branch local

Info

El --orphan crea un branch separado del resto del repo (sin parents). Se crea primero localmente, después se manda al origin (pasos mas abajo).

Pasarlo al desktop (para trabajar)

Desde GitHub apretar Clone in desktop (que lo tomará GW o Tortoise) o desde CLI:

$ git clone https://github.com/user/repo_lindo.git

Preparar branch gh-pages

Cambiar a gh-pages. En CLI, si se usó el comando anterior (git checkout --orphan gh-pages) se cambia automáticamente, sino git checkout -b gh-pages para cambiar y crear un branch local llamado "gh-pages".

Info

Al cambiar branches, Windows Explorer "refresca" la carpeta donde está con el contenido del branch seleccionado.

Eliminar todos los archivos que aparezcan (porque son del master y no los queremos) y hacemos c-p.

$ git rm -rf .                      # eliminamos todo
$ git commit -m "Iniciar gh-pages"
$ git push -u origin gh-pages       # mandamos branch al origin

gh-pages como default y eliminar master

Esto es opcional, depende de tu workflow o idea de uso. Si solo se va a usar gh-pages, se puede usar como default y eliminar el branch master.

Para ponerlo como default (y no usar el master), en GitHub, ir a settings > (settings >) Default branch y seleccionar gh-pages.

Para eliminar el master hay que tener el gh-pages como default. Después ir al listado de branches y apretar en Delete branch. Con CLI:

$ git branch -d master     # eliminar local
$ git push origin :master  # eliminar de repo

It's alive! (Archivo de prueba y subida)

Crear un index.html, lo añadimos y hacemos c-p.

$ git add .                   # añade todo
$ git commit -am "Primer commit a pages"
$ git push origin gh-pages

(el -a es abreviatura de add)

Esperar unos minutos y ver si se subió el index en: http://user.github.io/projectName/

Dominio propio

Como seguramente no vas a querer entrar a http://user.github.io/projectName/ porque es muy largo o queda poco profecional, GitHub permite ponerle un dominio/subdominio.

Solo basta con poner un archivo CNAME que contiene el dominio/subdominio que se quiera usar, en el root de gh-pages y cambiar los DNS del dominio en el host/registrar:

Con un root domain (www.example.com): crear un nuevo A record con la IP a 204.232.175.78.
Con un subdominio (sub.example.com): crear un CNAME record que apunte al subdmonio del usuario en GitHub (user.github.io). Esto deja que los DNS se adjusten automáticamente al IP de GitHub; se puede usar un A record pero no se adjusta automáticamente.

404 pages! (Todos amamos los error pages)

También es fácil: poner un 404.html en el root de gh-pages y listo (no te olvides de agregarlo y c-p).

Cambios

2014-01-02 Reescrito para ser mas explicativo.

Box: acceder por WebDAV

Sun, 04 Aug 2013 00:00:00 GMT

Acceder por WebDAV a servicios de sincronización para verlos en tu explorador de archivos sin tener que instalar el cliente -> esperar a que inicie -> indexe -> haga la sincronización solo para sacar un archivo¹, es priceless².

Me aventuré con esto por que quería hacer un proyecto donde necesitaba un FTP. Ultimamente (o siempre fue así), no te dan la opción de hacerte cuenta de FTP, solo creando un sitio. Not interested. No tengo un server/computadora (es un pendiente) para hacerla server e instalarle FileZilla. Damnit. Me acordé de los servicios de sincronización/host de donde tengo cuenta y me aventuré.

Elegí Box. Pensaba subir los archivos por web, ya que la sincronización es media-media en ese servicio, pero recordé que SugarSync tiene el "SugarSync Drive", donde podes acceder a tu cuenta con el explorador de archivos. Me puse a buscar si Box tenía la mismo o similar.

Tiene para acceder por FTP, pero solo en cuentas pagas. Después leí sobre WebDAV. Intenté configurarlo y, luego de pelear por bastante tiempo, acá está cómo hacerlo en Windows (7).

Windows Explorer

En "Equipo" (el viejo "Mi PC"), ir a Conectar a unidad de red

Seleccionar el disco (que no importa mucho parece), tildar Conectar de nuevo al iniciar sesión. Clickear en Conectarse a sitio web para usarlo como almacén...

En la ventana que aparece, seleccionar Elegir una ubicación de red personalizada

Ahora lo divertido y lo que me dió dolores de cabeza: la dirección.

Se puede poner:

Para toda la carpeta/cuenta: https://dav.box.com
Para carpeta especifica: https://dav.box.com/dav/CARPETITA

Sale la ventana de log in. Poner nombre de usuario/e-mail de Box y la contraseña.

Opcional, en la siguiente pantalla renombrar ahora la etiqueta:

Y listo, asi queda:

Si no te funciona, podes usar CarotDAV (que es para "unir" varios servicios en un mismo programa portable), el famoso Total Commander o BitKinex.

BitKinex

Descargar BitKinex. Instalar normalmente, pero recomiendo (por que leí) destildar el "I want to configure data source now" por que parece que no hace nada).

Una vez iniciado (si, aparece asi chiquito por alguna razón), buscar en la lista el Http/WebDAV, right click > New > Http/WebDAV e ingresar nombre.

Poner datos similares de los de arriba: dav.box.com, seleccionar SSL. Poner usuario y contraseña en el apartado de abajo:

También lei (opcional) que se puede poner un path al Site map (no se para qué, no noté diferencia). Se configura yendo a Site Map (debajo de donde estas ahora/Server) y agregando/modificando el path con /dav, eligiendo Directory WebDAV-compliant

Y listo, solo falta hacerle doble click a la conexión y tenes los datos:

Fuente: Box zendesk

por que la gente, a veces, lo usa como servicio de hosting (además del de sincronizar) ↩
literalmente. Actualmente, los sistemas opertivos lo traen de fábrica (mas, menos o nulo buggeados) ↩

Dynamic to Static (Wordpress a Pelican)

Tue, 22 Jan 2013 00:00:00 GMT

Por qué:

Because I can
Cada vez me llevo peor con Wordpress
Soy blogger casual, no necesito florecitas que cambian de color según el estado de ánimo de un animal en Samoa.
Todos los posts los escribo en markdown, que los conviertos en html para pegarlos en Wordpress. No me tengo que olvidar si tiene imagénes y subirlas (y cambiar las rutas).
Puedo juguetear mas con el css y html (porque uso/aba wordpress.com)
Soy de ir en contra de la corriente (?)
Quiero llegar a los 10 items
Odio que haya que descargar 10 mb de javascript para el dashboard de Wordpress + otros 50mb para la cosas internas (relacionado con el punto 2)
estoy aprendiendo python
ya llegué

Presentación

Teniendo Wordpress hosteado/.com gratuito, no tengo mucha libertad para ciertas cosas. Pasé de wordpress.org a wordpress.com para evitar el tema de las actualizaciones seguidas, spam, seguridad y eso.

Todo iba bien, hasta que los de Wordpress decidieron abrirse mas como CMS que como sistema de blogging. Lo entiendo, es natural. Bien. No me gusta. No se si porque yo asocio Wordpress con blog y no un CMS completo a lo Joomla! o Drupal, o porque si las cosas en el backend estan mal organizadas para ser CMS/orientadas a blog, o si es mi conexión que no me deja disfrutar al máximo o qué.

Por temas de conexión y que el editor de Wordpress apesta¹, añadido a tener una wiki en localhost y encariñarme con los LML, escribía los posts en markdown (que antes no me caía bien, hasta que empecé a usar Pandoc), los pasaba a HTML, hacia search & replace para las imágenes (aunque se puede obviar si se suben primero las imágenes), y recien ahí lo pasaba a Wordpress. No es lo mas cómodo del mundo, pero servía.

Por alguna razón que ahora no recuerdo, empecé a buscar (o encontré de casualidad) scripts que pasan .txts con LML a html. Eso me hizo pensar: "hey, capaz me puede servir". Después de descartar un par que no me servían (estan apuntados a los usuarios de Linux y para usarlos en Windows era mucho lio), me decanté por Pelican.

Pelican es un script de Python que toma archivos de texto con markdown, reStructuredText o AsciiDoc, los pasa por un theme, y te genera un blog estático/html. Puro y duro, a la vieja escuela. Con categorias, tags, rss, páginas. Vamos, lo básico para un blog.

Yo lo estoy hosteando en Dropbox, después de decidir que subir las cosas por FTP era bastante molesto ²/las únicas razones por la que quiería un host apache era por el .htaccess (el rewrite) para hacer magia pero no valía mucho hacer eso para mi humilde blog. También lo podes hostear en GitHub si ya tenes cuenta ahi y no te molesta hacer commits. CAPAZ que algun día lo pase ahi (tengo como pendiente GitHub).

Si solo te interesa hacer la parte de archivos de texto en Dropbox SIN generar html y demas, tenes opciones como Calepin y scriptogr.am

Instalación en Windows

Porque en Linux este tipo de cosas es mas fácil.

Por ahora, Pelican corre bajo Python 2.7, hay un fork para que ande en Python 3 pero no lo pude hacer andar (tampoco probé mucho).

Nota: yo explico como hacer esto manualmente, pero se puede instalar con pip.

instalación normal de Python
bajar los source files de Pelican y extraerlos
abrir el command line/consola en la carpeta anterior y:
```
python setup.py intstall
```
Si te pide el setuptools: http://pypi.python.org/pypi/setuptools/ o pip install setuptools

Esperar que se haga el chirimbolo.
como quiero usar Markdown, lo instalo para python (de la misma manera que lo anterior)
Y el pygments para el syntax highlighting

Configuración

Se crea un config.py para las configuración siguiendo las variables en los docs (o usas como base las que ya te vienen en el archivo)

Si usas Markdown, vas a querer usar los markdown extra

Andando

Crear un post con el metadata correspondiente. El básico es el titulo, y si estas en Windows necesitas poner si o si la fecha.

Ir a la carpeta root de tu Pelican, abrir una linea de comandos y poner: [Python_path]\Scripts\pelican.exe input/ -s config.py

Nota: para probar, podes obviar la parte de configuración.

Nota 2: si se corre en la carpeta del contenido, para el path se puede usar . (punto)

Yo lo puse en un script/bat cosa de no escribir eso todo el tiempo.

Themes

Para los themes/templates, Pelican usa Jinja2. Nunca usé un template engine, siempre lo tildan de complicados y demas, pero este anduvo bien. Es fácil, tan fácil como crear vos un mini-template "engine" en php.

Podes crear los tuyos, podes bajar otros manualmente o usar la linea de comandos

Migración Wordpress -> Pelican

Posts y páginas

Pelican tiene un conversor. Como yo lo necesité para Wordpress, me voy a centrar en ese. Necesitas:

BeautifulSoup-3.2.1 (las 4.x no funcionan)
Pandoc (amo pandoc)
el export de Wordpress (.xml)

Una vez que tenes eso, corres (cambiar "markdown" por el formato que quieras):

[Python_path]\Scripts\pelican-import --wpfile -o [path_output] [path_wordpress.xml] -m markdown

Imágenes

Como paso de wordpress.com a Pelican, tengo que descargar las imágenes de alguna forma. Se puede mediante cositas guay como PageNest y similares, pero es mucho lio pensar un regex solo para descargarlas.

Ya que tenemos el .xml del export, podemos instalar un Wordpress en localhost (o hosteado en otra parte para hacer pruebas). Como tengo un Wordpress en localhost que hace años que no lo uso, tuve que eliminar todas las cosas que tenia antes (en phpmyadmin > eliminar el contenido de las tablas/truncate), actualizarlo + actualizar base de datos + actualizar/instalar el plugin de import (que no viene como funcionalidad/core por alguna razón).

Una vez hecho eso, se va a tools > import > wordpress > seleccionar archivo > linkear los autores > importar > esperar.

Y se espera.

Varios minutos.

Hasta que esté.

Ya con las imágenes en nuestro poder y procesadas/eliminar las duplicadas, hay que ponerlas en la carpeta input de pelican (en images o como la llamaste). Aca se ve si se quieren poner de alguna estructura en especial o no.

Pro tip para las imagenes duplicadas:

primero eliminar las -thumb
las demás tienen este nombre: [nombre orig]-300x225.jpg (donde el numero de tamaño + extension cambian). Esto se puede eliminar facilmente con un script que tengas a mano, o sino con buscadores estilo Everything poniendo: [path a las imagenes]\ *-*x*

Ahora solo queda hacer un search & replace para cambiar la url del estilo http://[username].files.wordpress.com/[año]/[mes] a tu estructura actual.

Categorías y tags

Ojito con las categorias. Primero: al hacer un sistema simple, no tiene jerarquia de categorias como Wordpress. Fijate como manejas eso. Segundo: solo acepta una categoria por post. Si estas cosas te molestan, podes optar por usar directamente tags.

Comentarios

Al pasar a Pelican, no sabia si incluir comentarios. Mi blog es personal, no tiene muchos o directamente no tiene, pero siempre quise eso de "che, yo resolví eso de otra forma: tal tal tal. Dejo el comentario por si a alguien le sirve", asique opté por usar Disqus (por que es el único que conozco y no tengo muchos comentarios, por eso ni me molesté en buscar alternativas).

Si queres transferir los comentarios: Disqus tiene una opción de traer los de Wordpress, pero requiere un plugin (o sea, me jodo). Yo hice copy & paste del html (para hacer algo manual viste, sino era todo automatizado) y los pegué en la entrada correspondiente.

Tips:

Conviene desactivar la opcion de conversión de caritas/emoticones ( :D, :) ) a imágenes. A no ser que quieras que se referencien al viejo blog o hacer trabajo extra para eliminarlas/pasarlas a texto.
Hacete un regex para sacar el link al comentario cuando se clickea en la fecha (yo lo hice, mas que nada, porque tomaba la dirección localhost). Usé este: <a href="http://localhost/wordpress/\?p=\d.+comment-\d.+">\n(.+)</a>

Pros y Cons

Como todo, hay pros y contras por cada sistema.

Wordpress, pros:

es Wordpress
si lo hosteas, tenes libertad absoluta
es un buen sistema de blogging
es popular

Contras:

es Wordpress
editor de posts feo/lento
seguridad (normal)
Le falta un par de cosas, como poner footnotes facilmente³

Pelican, pros:

puedo escribir en markdown, y usar los markdown extentions (que lo hacen mas copado/completo). Al escribir en puro texto, puedo elegir el editor que yo quiera: Notepad++, Sublime Text ⁴, o hacerme la cool y abrir un precesador de texto completo de una suite ofimatica, el Wordpad, o algun editor designado para Markdown.
para actualizarlo es rapido: escribis, pones el archivo en la carpeta de input, corres el script y listo. Nada de andar loggeandote > click en nuevo post > esperar a que cargue > titulo > esperar que genere el slug > escribir > seleccionar categoria y tags > publicar
tenes un "backup"/raw de tus posts, faciles de transportar o convertir a otro formato.
no tenes que lidear con un WYSIWYG. Para ciertas cosas esta bueno, pero muchas veces te obstaculizan al escribir el contenido.
es estático = 0 preocupaciones por la seguridad. Solo te preocupas por el del host.
es muy facil escribir posts multilenguajes. Esto es para un usuario específico y básicamente es lo mismo que Wordpress (crear un post nuevo), pero por alguna razón se me hace mas simple: los posts solo deben tener el mismo slug y la diferenciación del idioma. Acá hay un ejemplo reciente cuando tuve problemas con android y la bateria.
Puedo/se me hace mas fácil, linkear a otros posts que escribi anteriormente

Contras:

No tenes los stats, pero eso se puede cambiar por google analytics.
No tenes la facilidad de que los lectores califiquen un post, si lo quieren compartir, etc. No me molesta porque no lo uso pero capaz que alguno diga que es indispensable.
No tenes la gran disponibilidad de themes hechos (aunque puede ser bueno, hay varios que parecen hechos en front page)
No tenes la gran disponibilidad de plugins hechos (hay repetidos, hay muertos, hay de todo. Pero tampoco le quiero meter uno que agregue una carita al titulo del blog dependiendo si se encontraron nuevos fósiles).
Es python, todos sabemos como son los errores/debug de python (si sos principiante).
Genera contenido estático, nada de comentarios ni base de datos para no se que cosa. Los tenes que agregar vos y con Javascript o algún workaround.

Procon (no se como ponerla): Te tiene que gustar escribir, y por escribir me refiero a escribir variables y demas, tanto del sistema específico (Pelican) y del LML que elegiste. Capaz que a los programadores esto seria un pro, pero para el resto de los mortales seria una contra (a no ser que crees un template).

Conclusión

Esta mudanza la hice para probar cosas nuevas, solo actualizo el blog una vez al mes/cada 3-6 meses y ni tengo host propio. No es que este todos los dias escribiendo un post, o cada semana; tengo mis periodos de "ay si, hoy escribo y oh! ay mira escribi uno la semana pasada. Me siento re blogger" y de "ah mira, hace 6 meses que no escribo... qué se le va a hacer, no?".

Pero cada vez que SI actualizaba, odiaba profundamente el paso a Wordpress. Esta bien, si, podes ponerle un plugin para que tome la sintaxis markdown y todo eso, recordá que yo estoy/aba en wordpress.com y no pienso/aba instalar Wordpress en el host. Ya lo hice una vez y no me gustó, por eso me pasé a .com.

La actualización por medio de este sistema⁵ es muy cómodo, solo pongo el post terminado en la carpeta (o lo creo ahi directamente), corro el script y listo. Solo tengo que tener Dropbox corriendo para que actualice. Si quiero hacerlo aun mas simple, puedo usar los servicios nombrados más arriba y solo poner el txt en Dropbox y listo. Sitio actualizado. También es muy rápido generar los .html, con mi blogcito ni tarda 5 segundos (y eso que linkeo a otros posts).

Por que no un host cualquiera/FTP? Por que tenia que hacer un paso "extra" y sincronizar a FTP o anotarme a otro servicio para que haga un sync/backup de carpeta X de dropbox a carpeta X del host⁶.

No digo que me vaya a quedar con este sistema, capaz que algun dia diga "para que quiero gastar X espacio en mi disco/dropbox si con wordpress.com no me preocupo" o "hago mucho lio para lo que actualizo", etc., elimino las cosas, hago un par de cambios por alli y por allá y listo, vuelvo a wordpress.com, quien sabe. Solo quiero probar.

y por alguna razón, ya no hay tantos offline blogging systems como Raven o Windows Live Writer. Creo que Wordpress habia puesto la opción de actualizar por e-mail, pero nunca la probé. Debe ser un dolor si queres poner imágenes ↩
en realidad no, podes crearte una cuenta en mybackupbox y que se sincronice/backup-ee automáticamente a un FTP. Esto abre la posibilidad de usar cosas como base de datos y php. ↩
una vez que los usas, no podes parar. Son adictivos. ↩
Que ahora me cae mejor. Te instalas el package control y tenes infinidad de plugins. Mas o menos le tomas la mano en la parte de configuración (puro texto) y lo dejas (casi) como quieras. Solo me falta buscar algo simple para que el editor se haga de dos columnas y pase el archivo activo a la otra "vista", sin presionar 10 teclas por acción. ↩
txt -> pelican -> dropbox ↩
ahora que lo pienso, capaz que se pueda poner el sitio en FTP como disco en red (o como se llame) en Windows. Lo hice una vez para pasar cosas al celular. Ahi puedo hacer las cosas directamente y me ahorraría unos pasos. ↩

Tutorial: save GPS location to text with Tasker

Mon, 26 Nov 2012 00:00:00 GMT

Background information

I always wanted a way to say "Hey GPS, see this spot here? the one you're indicating, can you pin it with text so I can retrieve it later?". All the ways I've found required to install apps. I'm fine with that but a) install 5MB or more just to get that functionality? I didn't want to change my notes app nor have another one; b) install 5MB or more in my low memory android phone just to get that? no thank you.

Time went by, forgot about it as I'm not needing it right now (but it's nice to have). Installed ICS on my LG Optimus One, expanded the memory/A2SD, and somehow I found/tried Tasker. Yes, that program that it's very cool, everyone recommends it, posts the same common examples that you don't need but you want to use it anyway. Yes, that one. There are many alternatives, and even free with some limitations. But (people say) they are not as complete as Tasker.

Tasker task

Go to the task tab and add a new one:

Task: Location to Txt

Actions for the task:

File > Write file. File: choose which one to open/create. Text: %DATE %TIME - %LOC - %TEXTHERE . Check "Append" and "Add newline"
(optional). Alert > Flash. Text: Pinned! . This creates the info box that you always see (the black one).

Go to the Scene tab and create a new one.

Scene:

The necessary things are: the TextEdit (to input a description, you can skip this if you only want to save the coordinates. If that's the case, you don't even need the scene) and the button. You can add a text element that shows the coordinates and an image, because images bring life to the UI.

If you decided to include the text that shows the coordinates, enter the properties and in Text add %LOC

In the TextEdit properties, in the Text Changed tab, add a variable (variable > variable set). Name: %HERETEXT To: %new\_val

The button, in the Tap tab.

Task > Perform Task. Name: Location to Txt.
Scene > Destroy scene. (pick the scene you're creating. It should be defaulted).

Save the changes and go back to the Task tab.

Task: Pin Here

Misc. > GPS > on
Scene > Show Scene. Name: (Pick the scene you've previously created). Display As: Activity, Full Window (or play and find one that you like). Check "Show exit button" (optional) and "continue task immediately"
Task > wait. MS: 100. Everything else to 0. This is to show the keyboard. You can skip this (and the next) if you don't mind clicking the text box to type.
Input > Soft keyboard

Homescreen

The only thing that is left is the shortcut/widget!

Create a widget > task. Pick Pin Here

Here, here! touch me!

Tap and you get this!

When you tap "save" it saves and shows the black info popup boxy-box. Here is an example of what the text file could look like:

When you open the link, it shows the waypoint/spot in the map (seems to only work with Google Maps, unless you change the format, that way it also works with OsmAnd - from all the maps I've tested-).

Bugs

Nobody likes bugs but it's Android. If you choose to show the keyboard when the scene it's shown, it won't close automatically; you must close it yourself (back button). It's not the script fault nor Tasker's, but Android's and how it handles things (according to the developer). Remember that we created a "wait" action? that was to bypass the "bug" opening the keyboard. This might be necessary for you or not. This depends on the phone/tablet.

Conseguir RSS de los canales/channels de YouTube

Fri, 28 Sep 2012 00:00:00 GMT

Me quejé por Twitter de que ~~YouTube~~ Google habia toqueteado algo en YouTube que rompió el código de los podcasts managers (en mi caso gPodder). En todo los pios de twits, alguien salto con cómo había hecho para tener las suscripciones de YouTube en RSS. Yo pensaba que era algo sabido, pero se ve que no (aunque aparece en la ayuda de YouTube.. o asi hace un par de años).

Si queres suscribirte al canal de un usuario y no queres hacerte/usar una cuenta de YouTube para eso, simplemente pones esta url (cambiando el nombre de usuario):

http://www.youtube.com/rss/user/USERNAME/videos.rss

Eso te redirecciona a:

http://gdata.youtube.com/feeds/base/users/USERNAME/uploads?orderby=updated&alt=rss&client=ytapi-youtube-rss-redirect&v=2

Ya que estamos, si te queres suscribir a un tag especifico (este no lo probé pero lo tengo a mano)

http://www.youtube.com/rss/tag/YOURTAGHERE.rss

Sebs says:

October 9, 2012 at 7:01 pm

cofcofAlguienreportándosecofcof :P

Thanks! ^^

Leer ePUB en Kindle 3

Fri, 30 Dec 2011 00:00:00 GMT

El otro día andaba buscando si era posible leer ePUBs en el Kindle y, si era asi, cómo leerlos. Sólo por curiosidad.

Jailbreak

Primero hacerle Jailbreak bajando el archivo.

Descomprimirlo. Buscar el update_*_install*.bin, donde * es dependiendo del Kindle y firmware que tenga (en el post y dentro del comprimido dice cómo) y pasarlo al root del kindle.

Liberar/eject el Kindle y apretar HOME > MENU > Settings > MENU > Update Your Kindle.

Launchpad

Descargar este archivo y descomprimirlo.

Pasar el update_launchpad_0.0.1c_*_install.bin (donde * es la version del Kindle que tengas) al root del kindle.

Liberar/eject el Kindle y apretar HOME > MENU > Settings > MENU > Update Your Kindle.

Después de esto, hay dos lectores que se les puede instalar: el fbKindle y Cool Reader. Cada uno tiene sus pro y contras. De las de "usabilidad" uno (fbKindle) acepta links y muestra el furigana como se tendria que mostrar cuando un navegador no los puede interpretar (inline) pero no muestra bien las tablas, ademas de que parece que no se desarrolla mas. El otro (Cool Reader) no acepta links, el furigana los muestra con line breaks, muestra bien las tablas y parece que todavia se desarolla. Aca sólo "muestro" como se instala el Cool Reader. (el otro es casi lo mismo)

Cool Reader 3

Los formatos que Cool Reader 3 lee son: fb2, txt, html, rtf, chm, epub, mobi. Se creó (y su "principal objetivo") para leer los fb2, por eso los epub (y seguro HTML y chm) no los lee "tan bien".

Descargar el archivo y descomprimirlo.

Copiar las carpetas cr3 y qtKindle en el root del kindle. Copiar el archivo de launchpad\cr3.ini a la carpeta del root launchpad

Liberar/eject el Kindle. Rapidamente apretar (en el home) Shift Shift Espacio, aparece un “success!” abajo a la izquierda, y apretar Shift C R, aparece el “success!” y carga el programa.

Para abrir los archivos, se aprieta la tecla Menu o apretar s.

Hotkeys básicas:

Alt Back - Sale del programa
Alt Shift - Collapse \ deploy Cool Reader
En el dialogo de preferencias: Home - guarda las opciones, Back - sale sin guardar

Comments

hookdump says:

February 9, 2012 at 1:02 pm

o.O Esto funca?
Usualmente soy un freak que jailbreakea/upgradea firmware en todos los dispositivos, desde el iPhone hasta la licuadora(?).

PERO… El kindle… el kindle para mi es sagrado.

Así que pregunto: ¿Esto es inocente e inocuo?, ¿no podría destruir mi kindle por toda la eternidad?, ¿probaste hacer esto?
A.Q. says:

February 10, 2012 at 11:25 am

Si,si, funca. Por eso lo subi

Es inocente. Es un programa que se activa como dice ahi arriba. Podes salir y volver al library reader thing del kindle tranquilamente, apretando las teclitas de ahi/por el menu.

Todo lo que escribo esta probado, a no ser que se diga lo contrario
Pingback: Epub | TagHall

Windows 7: Themes personalizados y Aero Glass

Sat, 13 Feb 2010 00:00:00 GMT

Tenés Windows 7 Home Basic (o similar), seguro que te aburriste del theme/tema baby blue que trae por defecto que no se puede cambiar. No esperes más y cambialo ya.

Themes personalizados

Desactivar el UAC: (Panel de Control > Cambiar Configuración de Control del Usuario. O buscar UAC en la cajita de búsqueda del menú inicio o panel de control). Lo que hay que hacer es desactivarlo o ponerlo en la segunda barrita (contando desde abajo).
Instalar el UxStyle Core¹: Leer los Términos de Servicio y si se está de acuerdo, siguiente. Si no se está de acuerdo, igual.
Opcional: Poner la configuración de UAC como se tenia anteriormente
Descargar e instalar los temas. Éstos van en C:\Windows\Resources\Themes
Cambiarlos en Panel de Control > Cambiar Combinación de colores y elegir el que más te guste. Acá hay un problemita, capaz que es mío, los themes tienen el mismo nombre (Windows 7 Standard/Basic) asi que no queda otra que ir clickeando y ver como queda en la muestra :)

Fuente: Seven forums: enabling custom themes

Mejor theme manager

Como viene con Windows 7 Home Basic (yendo por Panel de Control > Cambiar Combinación de colores):

Al instalar themes, te repite el nombre "Windows 7 Standard/Basic" varias veces. Instalando Personalization Panel (como administrador) tenes un mejor theme manager:

Ademas de que:

Podes cambiar el wallpaper en Windows 7 Starter
Te deja cambiar el color de las ventanas en Windows 7 Home Basic
Tiene asociaciones de archivos *.theme, *.msstyles y *.themepack. Basicamente permite hacer doble click sobre el theme y te salta el programa para que eligas.
Dependiendo del theme, podes tener cierta transparencia:

Aero (Transparencias y mas)

Siempre y cuando tu compu lo permita, podes activar el Aero instalando el Aero Patch. Esto te da:

Aero Glass y coloración
soporte full de themes incluyendo RSS y Slideshow
Aero peak, shake y WinFlip 3D (y los efectitos cuando minimizas la ventana)
Soporte de themes de terceros (con lo que parece no necesitar el UxStyle Core, but you tell me)
El theme manager de los "Windows 7 polenta":

e incluso te da la opción en el menú contextual, que antes no estaba:

Instalas normalmente (como administrador) y se aplica el patch. No tiene forma grafica de avisarte que terminó (teoricamente se reinicia el sistema solo), asique esperá unos segundos (como 10, o cuando parece que no esta procesando nada) y reiniciá (REINICIÁ, no cierres y entres de nuevo a la sesión, que no funciona). Para desinstalar, volves a correr el patch.

Transparencia "full" (Soft7):

También podes usar totalmente opaco (+1 Dark):

O miti y miti (mini'em all, alien 1):

Existen parches, pero todos saben que es un 50% de que anden/no pase nada y 50% de que se arruine algo y tener que, a veces, reinstalar el sistema operativo. Este programita es un servicio (lo pueden encontrar en el Administrador de tareas > servicios, se llama UnsignedThemes.exe) que ocupa un poquito de memoria y "es un poco más seguro" (para el sistema) que los parches. El proceso "engaña" a Windows en pensar que todos los temas estan firmados y asi poder usar los personalizados. ↩

Crear Javadoc

Tue, 24 Nov 2009 00:00:00 GMT

Un Javadoc es un generador de documentación para API en HTML. Para los demás mortales: esa información que sale al escribir algun nombre de una variable/objeto/método seguido de un punto, seleccionando después el método que se quiere.

Estaba buscando por ahí cómo hacer eso pero con mis propios métodos/atributos/variables/objetos porque vamos, poner nombres super descriptivos y recontra super largos no da, pones cortos que más o menos te guien pero después de unos días ni sabes que hacen por ser algunos parecidos.

Un poquitito de búsqueda dió este resultado, cual lo transcribo y le pongo un par de imágenes para guiarlos ademas de un par de ejemplos.

Localizar lo que se quiere que tenga una explicación, yo voy a usar un método pero puede ser una variable/objeto. Situarse sobre el nombre de tal. Comenzar un comentario (/**) y den enter. Puede ser que les ponga algo por default, como los parámetros de un método. Acá se se escribe lo que se quiere, pongo algo de ejemplo:

/**
* Hola que tal, soy una explicacion
* @since 1.0
* @param pl vector que se separa
* @param direccion no me acuerdo para que era
*/

Nótese que al poner @ se despliegan un par opciones, pero no creo que se necesiten mucho.

Ahora van a x lugar, empiezan a tipear y:

Qué lindo no? Ahora no tienen que estar adivinando qué hace, qué retorna (si es true-false para hacer algo que no tiene que ver con verdadero-falso).

Para los atributos/variables es lo mismo. No sé para qué puede servir pero si le pones nombres genéricos del estilo "a", "b", "foo1", "foo2", "foodos" y por el estilo, sirve.