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

Pelican to Nikola (and tutorial)

Sat, 11 Jan 2014 00:00:00 GMT

When I was thinking of moving my blog to this new domain, I thought of using Pandoc as the converter¹. I even created pandy for that. But then I run into the "problems" (ok, I was kind of lazy) of generating RSS, listing posts with certain tags or categories (which I ended up not using), the index and archive, idealizing of using plugins, etc. and gave up.

In the beginning, I would continue using Pelican as is it's easy and customizable, even though it doesn't have Pandoc² support. But later I would be lazy to move to another system (not that I blog much, but I like Pandoc's markdown).

Acrylamid

In my searching, I found Acrylamid which looks pretty good. It's like the programmer/hacker blog generator, where you can do many things, including using template syntax inside your post. How cool is that?. It also has incremental builds, which means that it won't regenerate the whole site/blog again after a little edit, but only what it was changed.

Other cool things include:

different meta tags: you can choose between MultiMarkdown (like Pelican), YAML or rst.
the draft status is a boolean. Yay!.
you can include template syntax inside your posts and you can even use the configuration variables!
automatic summary/intro
user custom acronyms and abbreviations in a text file.
the views things that looks cool that I couldn't understand first but then I got the hang of it (they are very customizable)
colored command line output. THANK YOU!
out of the box pingbacking to other blogs and twitter posting.
info about the blog: how many published, drafts, tag usage count. Also when was last compiled, cache size...
execute shell commands in the post: like listing a directory, include another file, etc.
serve the site with a command
post-processing filters

It doesn't have categories (but by using views seems like it's posible), automatic galleries creation (but you can use template syntax inside the post, so is covered) and the theme creation it's not so automatic: you must list all the files that the theme uses inside an __init.py file.

I really wanted to use Acrylamid, even without the missing bits, but it was kind of "complicated" to set up on Windows if you wanted to use python-magic (at least I have problems with it). I skipped that part but for some kind of reason I was getting errors with the locale setting. I tested it with "Linux locale" and "Windows locale" and both threw me errors.

Nikola

Then I remembered I once stumbled upon Nikola, originally created by an Argentinian guy, so yeah, I had to try it out :P.

It does have Pandoc support; but it's not as "feature rich" (or easy customizable) as Pelican, and the documentation it's not so "complete" if you will. There are a couple of things that are not documented and you must find it in the Google Groups, GitHub or looking in the code. And also, not so feature-cool like Acrylamid. However, I think it's on a good track and it's the newest of the three.

It has cool things too:

incremental builds (like Acryamid)
automatic gallery creation
categories (like Pelican)
easy themable (like Pelican)
serve the site with a command and it has "Live" re-rendering
retired posts (so no 404 errors)
redirections (in case you can't use .htaccess)
deploy commands (a bunch of commands to run, so you don't have to script it)
post-processing filters
internationalization support (the site/blog interface can be in many languages)
password protected posts/pages
"Schedule" posts/pages
Wide range of (3rd party) comment systems and AnnotateIt support.
reStructuredText Extensions (if you use that).
Support for Twitter cards
raw post/page support (to show the source in text)

The draft state is applied in the "tag" metadata instead of a separate one, and they are deployed by default; it has no color support for the command line (but I think it's in the talks) and the "show source of the post and copy it" it's enabled by default.

The moving

Install Nikola

You start first by getting Nikola and installing it. By default, it uses Mako as the template engine, but it has support for Jinja2. You can read about the dependencies in the documentation page and if you want, you can use pip install -r requirements.txt or requirements-full.txt for the whole thing.

If you are running Windows, you must download and install the compiled versions of lxml and pillow. You can check in their PyPI pages or you can go to http://www.lfd.uci.edu/~gohlke/pythonlibs/ and get them there. Remember to download and install according to your Python version and architecture (32 or 64 bits).

Initiate

To initiate or create an empty site with the default settings and folder structures, run either nikola init path/to/mysite or, if you want some demo content, nikola init --demo path/to/mysite.

Convert metadata

Pelican uses the Multimarkdown style of metadata while Nikola uses something similar: the same syntax but with .. in front.

An example would be:

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

You can do that by hand or download my python script to take care of that. It also moves "draft" status to Nikola's tag, and Pelican's summary to Nikola's description (activated by default).

Note

Nikola doesn't have/see the "modified" meta key internally, but you can have it like a custom key. You just access it differently in the themes.

Translations

If you have posts or pages translations you must pay attention: Nikola handles the translations differently from Pelican. While in Pelican you only set the same slug or title in the posts, and have different file names (I think); Nikola relies on the file names.

The easiness of this depends on your setup, but you must end up with something like: nicefile.md for the post in default language, and nicefile.md.es (spanish content) for the translated file.

The cool thing of this is that you don't have to duplicate the meta tags. For example, you just create the "tags" meta key in the default language but don't specify it in the translated one. So when you update, you do only in the "master" or "parent" file and the "child" just copies it.

If you don't feel like having duplicated metadata between files, and after you renamed and converted them, you can run this python script to delete them. Remember this is optional (or at least it didn't break my setup).

Images paths

The syntax on this is also different but it can be easily done with search and replace. You can use whatever you want, like grep. If you are on Windows, I recommend grepWin if you want something with a GUI. This changes from setup to setup, but my settings were:

For markdown syntax:

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

And for HTML:

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

Links between posts

Again, this is totally different between the systems and it's going to be very easy or really difficult depending on your setup: Pelican uses the filenames for linking content while Nikola uses the slug of the post.

If you have the filename like the slug (or very similar) you can search and replace again. Like:

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

I recommend doing it after the images, and you must check the links afterwards.

Plugins syntax

I didn't use many plugins that used syntax in my posts, just only one: interlinks. This was easilly done with search and replace.

Other Nikola stuff

Locale in Windows

If you are going to use the internationalization in Windows, you must configurate your LOCALES as (example):

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

It doesn't matter your Windows language setting, I think it only accepts english locales (I tested it with Windows in Spanish and it worked).

Linking internally

If you want to link to another post, tag, archive, etc.:

gallery: link://gallery/gallery_name
tags index: link://tag_index
tag's page: link://tag/tagname
tag's RSS feed: link://tag_rss/tagname
blog's index page: link://index
index [NUMBER] page: link://index/NUMBER
per-year archive: link://archive/
posts of [YEAR] link://archive/YEAR
blog's feed: link://rss
other post: link://slug/the-nice-slug

Pandoc

As Pandoc uses the extension to recognize the input, you must configurate that extension in the COMPILERS option in the configuration file. If it's not found, it uses Markdown as default.

While it worked for me using markdown, it didn't exactly work with some others, like Mediawiki. I don't know why.

Posts folder and subfolders

Nikola preserves the folder structure of the posts in the subfolders. If you have file_g.txt inside folder_abc, that structure is kept in the output. It can be good if you want to use it as categories in the output. There is no way to configurate it in the configuration.

In Pelican you can have many subfolders and sort of categorize your posts as you wish, and the output is configurated (by default, by date) as you want.

Testing

Initially your posts go to a posts folder in your root and the pages in story. The images folder would go to files. You can configurate all of this in the configuration file.

After configurating your conf.py, which is very well commented, you can try it.

Build the site with nikola build. Then you can drag and drop pages to a browser or use the serve command: nikola serve and pointing your browser to http://127.0.0.1:8000

Because I hate opening an HTML block tag and the markdown inside is not parsed. I know, it's said in the markdown reference, but hey: it's 2014 and I need that. But I still love the admonition implementation in Python-Markdown ↩
Which now I see it looks pretty easy to implement. Oh well. ↩

GitHub Pages for projects

Wed, 01 Jan 2014 00:00:00 GMT

Simple steps to create GitHub Pages for projects/per repo (not user nor organization) plus some other stuff.

The steps are for CLI and for GitHub for Windows (TortoiseGit is "similar" to Git CLI) and Git beginners oriented, who search for easiness and not so much fuss. However, if you're confortable using SVN, you can use it (see clients in GitHub).

Abbreviations and vocabulary:

git CLI: Git used in a terminal/command line.
GW: GitHub for Windows.
Tortoise: TortoiseGit.
Server: Where things are "hosted" (like GitHub). This doesn't exist in Git, but this is how beginners can understand better (remote repository).; "Central server" if you're comming from SVN.
repo: To make things easier, take "repo" like "principal or remote repository" or "server" (see definition).
origin: This is how you name the original "remote repository" and by convention the 'primary' cetralized repository.
c-p: commit followed by push

Programs for Windows

In the beginning, having Git in Windows was hard (because it was created by and for Linux) but now there are many options. Usually, if you are only going to use GitHub, GW is recommended. However, if you want to use Git for other things (like creating "servers" locally to play or test) I recommend TortoiseGit + msysgit (git CLI) instead:

you can use it for other things and not only for GitHub ("reads" the github:// protocol)
you don't have to mess around with the PATH if you want to use git CLI (it installs in %appdata% and you can't only include bin\)
msysgit comes with "git Bash"; a cool CLI with colors that shows in which branch you're in; what is more, you can customize it with .bashrc.

Create repository

In GitHub, create a repository with the desired name. You can log in and go to https://github.com/repositories/new o clicking in the "book".

"Activate" GitHub Pages

It automatically activates when you create a branch called gh-pages.

From web click in branch master; in GW click in master at the top. Search for gh-pages and press create branch. With CLI would be (previously cloned, look below):

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

Info

--orphan creates a branch separated from the rest of the repo (without parents). First, the branch is created locally and then sent to origin (steps below).

Get it in desktop (to work with it)

From GitHub click in Clone in desktop (that GW or Tortoise will recieve) or from CLI:

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

Prepare gh-pages branch

Switch to gh-pages. In CLI, if you used the above command (git checkout --orphan gh-pages) it switches automatically, otherwise git checkout -b gh-pages to switch and create a local branch called "gh-pages".

Info

When switching branches, Windows Explorer "refreshes" the folder with the content of the selected branch.

Delete all the files (because they're from master and we don't want them) and we c-p.

$ git rm -rf .                      # delete everything
$ git commit -m "Initiating gh-pages"
$ git push -u origin gh-pages       # send branch to origin

gh-pages as default and delete master

This is optional, depends on your workflow or usage idea. If you're only going to use gh-pages, you can use it as default and delete the master branch.

To make it default (and not use master), in GitHub, go to settings > (settings >) Default branch and select gh-pages.

To delete master you must have gh-pages as default. Then, go to the branches listing and click in Delete branch. With CLI:

$ git branch -d master     # delete local
$ git push origin :master  # delete from repo

It's alive! (Testing file and upload)

Create an index.html, add it and c-p.

$ git add .                   # adds all
$ git commit -am "First commit to pages"
$ git push origin gh-pages

(-a is an abbreviation of add)

Wait a couple of minutes and check if index is uploaded in: http://user.github.io/projectName/

Custom domain

As you probably don't want to enter to http://user.github.io/projectName/ because is too long or it's kind of unprofessional, GitHub allows you to assign a custom domain/subdomain to it.

You only need to create a CNAME file which has the domain/subdomain that you want to use, in the root of gh-pages and change the DNS in host/registrar:

With a root domain (www.example.com): create a new A record with the IP to 204.232.175.78.
With a subdomain (sub.example.com): create a CNAME record that points to GitHub user subdomain (user.github.io). This allows the DNS to adjust automatically to GitHub's IP; you can use a A record but it won't update automatically.

404 pages! (Everyone loves error pages)

It's easy too: create a 404.html in gh-pages's root and done (don't forget to add and c-p).

Changes

2014-01-02 Rewritten to be more explanatory.

Box: WebDAV access

Sun, 04 Aug 2013 00:00:00 GMT

To access to syncing servicies via WebDAV, and see them in a file manager without installing the client -> wait to load -> index -> do the sync dance just to get one file¹, it's priceless².

I decided to do this because I wanted to do something that needed a FTP. Lately (or always was like that), you can't create a FTP account only, you must create a web site first. Not interested. I don't have a server/computer (proyect pending) acting as a server and install FileZilla. Damnit. I remembered the sync servicies that I have an account with and jumped into using them.

I chose Box. I thought into uploading the files via the web interface, given that the synchronization is a bit bad, but I realized that SugarSync has the "SugarSync Drive" feature, that allows you to access your file through a file manager. I started to search if Box had something similar.

It has FTP access but only for paid accounts. Then I read about WebDAV. Tried to configurate it and, after struggling for minutes, here is how to do it in Windows (7)

Windows Explorer

In "Computer" (the old "My PC"), go to Map network drive

Select the drive (doesn't matter apparently), check Reconnect at logon. Click on Connect to a Web site that you use to store...

In the new popup window, select Choose a custom network location

Now the fun part that gave me headaches: the address.

You can input:

For the whole folder/account: https://dav.box.com
For specific folder: https://dav.box.com/dav/FOLDER

New popup window for log in. Enter the Box user/e-mail and password.

Optional, in the next window rename the folder:

And here is the hardwork done:

If this doesn't work for you, you can use CarotDAV (to view al the servicies in one portable program), the famous Total Commander or BitKinex.

BitKinex

Download BitKinex. Install normally, but I recommend (because I read somewhere) uncheck the "I want to configure data source now" option (apparently does nothing)

Once initiated (yes, it looks very small for some reason), look for Http/WebDAV, right click > New > Http/WebDAV and enter a name.

The address is similar to above: dav.box.com, select SSL. Enter user and password:

I also read (optional) that you can include a path in the Site map (don't know why, didn't noticed a difference). You configurate it going to Site Map (under where you're now/Server) and adding/modifyng the path with /dav, picking Directory WebDAV-compliant

And done, you just doble click it to connect:

Source: Box zendesk

The mayority of people use the servicies as file hosting ↩
literally. Nowadays, the operative systems have the feature built-in (more, less or not bugged) ↩

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! ^^

Read ePUB in Kindle 3

Fri, 30 Dec 2011 00:00:00 GMT

The other day I was looking if there was a possibility to read ePUBs in Kindle, and if yes, how to. Just for fun.

Jailbreak

First you have to jailbreak downloading the file.

Unzip it. Find update_*_install*.bin where * is your kindle and firmware version. And copy it to (your kindle's) root.

Eject Kindle and press HOME > MENU > Settings > MENU > Update Your Kindle.

Launchpad

Download this file and unzip it.

Copy update_launchpad_0.0.1c_*_install.bin where * is your kindle and firmware version. And copy it to (your kindle's) root.

Eject Kindle and press HOME > MENU > Settings > MENU > Update Your Kindle.

After this, there 2 readers that you can install: fbKindle and Cool Reader. Each one has its pros and cons. In terms of "usabillity", one (fbKindle) allows links and shows furigana as when a browser can't interpret them (inline) but doesn't show tables propertly. However, I think it's not developed anymore. The other one (Cool Reader) doesn't allow links, furigana it's shown with line breaks, does show tables propertly and it seems that it's still developed. Here I show how to install Cool Reader (the other one is almost the same)

Cool Reader 3

The formats read by the Cool Reader are fb2, txt, html, rtf, chm, epub, mobi. It was created (and it's "main objective") for reading fb2, that's why ePUB (and surely HTML and chm) are not read "propertly".

Download the file and unzip it.

Copy folders cr3 and qtKindle to Kindle's root. Copy file from launchpad\cr3.ini to the launchpad folder (root).

Eject Kindle. Quickly press (in home) Shift Shift Space, a "success!" message it's shown on the bottom left corner. Press Shift C R, a "success!" message appears and the program loads.

To open files, you must press Menu key or press S

Basic Hotkeys:

Alt Back - Exit program
Alt Shift - Collapse \ deploy Cool Reader
In preferences dialogue: Home - saves options, Back - quit without saving

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.