A-Qute blog (windows)

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. ↩

Windows 7: Arreglar los iconos en Explorer

Thu, 12 Dec 2013 00:00:00 GMT

Con esta era de usar programitas varios para sincronizar, otros para control de código, y otros que no puedo recordar ahora; es necesario tener los overlay icons en Windows Explorer:

Personalmente se me desaparecían y, aunque limpiara la cache de los programas, nunca aparecían. Hay algunos que podes vivir sin ellos, pero otros no. Capaz instalaste un programa y te desplazó los de otro.

¿Pero cuál es el problema? Que los genios de Microsoft limitan la cantidad de iconos que se pueden usar a unos meros 11 iconos totales para el usuario. WHAT THE HELL.

Para arreglar el tema hay que pasar por el registro. Entrá al bonito regedit y navegá hasta HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers\. Antes de tocar mano, hacete un backup del .reg.

La idea es que de los 30 que debes tener, solo elegis los 11 mas importantes. ¿Cómo decidis la importancia? renombrandolos, porque Windows los elige por orden alfabético. Poneles números adelante o "z", "x", "y", esas letras que no se usan. Yo prioricé algunos de TortoiseSVN, un par de Dropbox, y el resto como sea el orden.

Una vez que estás feliz, reiniciá el explorer.exe: Administrador de tareas > matar explorer¹. Después lo inicias en Nueva tarea (o si queres desloguearte y loguearte, si queres reiniciar también, pero no hace falta).

Fuente: oliverpearmain: Dropbox and TortoiseSVN icons overlays in harmony

Kill, kill, kill! ↩

Templates en Zim Wiki

Fri, 15 Jul 2011 00:00:00 GMT

Zim es un programa de wiki de escritorio multiplataforma. En los foros decian que iban a presentar templates para las páginas por namespaces. Desconozco si las últimas versiones ya lo traen, pero en la versión para Windows no está.

Nota: es un template para toooodas las paginas nuevas, no por namespace.

Buscar donde se instaló el programa, e ir a: data\templates\wiki. Ahi hay un archivo de texto con el nombre Default.txt. Ese es el archivo a modificar para que cada vez que pongas "Crear una nueva pagina" salga con ese template.

En esta parte de la página oficial tenes un poco mas sobre el tema de los templates como variables y sintaxis.

XAMPP: Status Check Failure [3]

Tue, 31 May 2011 00:00:00 GMT

Un día, al actualizar XAMPP (el cliente de desarrollo que uso), empezó a tirar un "Status Check Failure [3]" al iniciar. Era medio molesto el mensaje por más que los servicios siguieran andando.

Busqué vaias soluciones, algunas decian que era el puerto ocupado y que lo usaba Skype. Skype no tengo. Otros decian que era el instalador, que no funcionaba con Windows 7 64 bits, pero aún descargando el archivo comprimido daba el mismo problema.

La solución fue algo asi:

Ir a las Variables del entorno (Equipo > propiedades > configuración avanzada)
Agregar al path a XAMPP (ejemplo: %SystemDrive%\xampp)
Buscan el acceso directo del xampp-control-panel.exe y van a sus propiedades.
Borren lo que dice en Iniciar en...

Fuente: Resolver el error explicado con imágenes en portugués

Lanzar aplicaciones desde Ejecutar

Sat, 18 Jul 2009 00:00:00 GMT

Hace un par de semanas/meses instalé nuevamente Launchy. Al poco tiempo (minutos) lo saqué. Me pareció no-muy-de-mi-gusto teniendo las aplicaciones que tenía corriendo en ese momento.

Pocos minutos después, me acordé de que había visto por algún lado hacer lo que hace Launchy (lanzador de aplicaciones) con la ventana de Ejecutar.

Hay que ir a Mi PC > propiedades > Sistema > Opciones avanzadas. Abajo hay un botón que dice Variables de entorno, entramos ahí.

Se abre una ventanita. Abajo, en Variables del Sistema, buscamos Path y damos click en Modificar

Sale otro Pop Up, y modificamos el valor de la variable. Lo único que hay que hacer es ir hasta el final, agregar ; (punto y coma) seguido de la ruta en donde se encuentran los shorcuts/atajos/accesos directos.

Aceptar, aceptar, aceptar. Listo! ahora Win + r, el nombre del shortcut .. et voilà!

UPDATE

Le dí otra oportunidad al Launchy. Me gustó, no consume tanto (o sí, dependiendo el gusto de cada uno).

Comments

Luxiano says:

July 19, 2009 at 1:53 pm

Yo también usaba Launchy hasta que lo saqué (también tengo poca RAM ¬¬)… y empecé a usar Ejecutar :D

PD: si, que tierna, no? jaja :P
A.Q. says:

July 19, 2009 at 7:28 pm

También tenes menos de 1 GB de RAM? Hagamos un club para que no se nos rían en la cara… :P
Luxiano says:

July 19, 2009 at 9:19 pm

Tengo 512 :( buaaa

El club para cuando quieras :P
A.Q. says:

July 20, 2009 at 2:27 pm

Yo tengo un poco mas 700 (grafica integrada)

Y… Ahora! pero ponele vos el nombre :P
Luxiano says:

July 20, 2009 at 2:43 pm

Yo tengo una placa de video con 64MB… :(

Nombre del club… subRAM? :P
A.Q. says:

July 20, 2009 at 3:16 pm

Luxiano y yo, A.Q., somos los dos primeros miembros del club subRAM. El único requisito es tener menos de 1GB de tal en estos tiempos (2009).

Si quieres unirte, no dudes en dejar un mensaje en este post.
Luxiano says:

July 20, 2009 at 9:49 pm

Un día de estos se hace la página :D
A.Q. says:

July 21, 2009 at 2:17 pm

:D