Created
February 26, 2017 21:34
-
-
Save ekaitz-zarraga/f4f085e20d40e83e9e6db4b6be78f73c to your computer and use it in GitHub Desktop.
droWMark example https://pfctelepathy.wordpress.com/2017/02/26/drowmark-postea-en-wordpress-desde-vim/
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
[wordpress] | |
# Title of your blog post here | |
# Example: title = My cool blog post in here | |
title = droWMark, postea en Wordpress desde Vim | |
# The status you want for your blog post here. Options are: | |
# draft, published, pending, private | |
# Example: status = published | |
status = draft | |
# The categories of your blog post. Comma separated. | |
# Example: categories = Category One, Cat Two | |
categories = Scrips, Herramientas | |
# The tags of your blog post. Comma separated. | |
# Example: tags = tag one, tag two | |
tags = vim, wordpress, plugin, python, fastanddirty | |
# The URL of your blog. | |
# ('https://' and 'xmlrpc.php' will be added automatically) | |
# Example: url = mycoolblog.wordpress.com | |
url = pfctelepathy.wordpress.com | |
# [OPTIONAL] Thumbnail image. | |
# URL or Relative Path to the post file. If path, it will be automatically | |
# uploaded. | |
# Example: thumbnail = images/thumb.jpg | |
thumbnail = drowmark.png | |
--- | |
Hola hijos, | |
Hoy vengo a contaros una cosa loca que he estado desarrollando para mí durante | |
el último año en ratos libres. | |
Hace tiempo que salió su primera versión pero no lo publiqué porque no saqué | |
tiempo y porque me daba un poco de vergüenza porque era muy cutre, pero ahora | |
que tengo más tiempo (ya os contaré por qué) me he decidido a añadirle unas | |
funcionalidades nuevas y estoy contento. | |
Vengo a presentaros [**droWMark**](http://github.com/ekaitz-zarraga/drowmark), | |
un plugin para Vim que sirve para postear a Wordpress desde el editor, | |
escribiendo en Markdown (con sabor a Pandoc). Por si os lo preguntabais, sí, | |
llevo como un año posteando en este foro directamente desde Vim. | |
Hasta hace muy poquito el plugin no soportaba la subida de imágenes, pero | |
tampoco lo necesitaba porque pocas veces añado imágenes a los posts. :) | |
Os cuento un poco cómo funciona por debajo y si queréis más información os | |
leeis la documentación del plugin, que es bastante clara. Para leerla con | |
entrar en la carpeta `doc` en el repo es suficiente pero mola más que os lo | |
instaléis (usad Vundle o algo por favor) y hagáis `:help drowmark`. | |
El plugin se separa en dos partes, una en *VimL* (o *VimScript*) y otra en | |
*Python*. | |
La parte en *VimL* se encarga de gestionar todo lo relacionado con Vim y llamar | |
a la parte de Python. Hace las siguientes cosas: | |
- Syntax highlighting de los ficheros especiales que utilizo. Son una mezcla de | |
Markdown con un poco de INI[^1] en la cabecera ([aunque no por mucho | |
tiempo](https://github.com/ekaitz-zarraga/droWMark/issues/4)). | |
- La documentación del plugin, para poder hacer `:help drowmark` y esas cosas. | |
- Define el nuevo tipo de fichero WP. Para esto necesita detectar el tipo de | |
fichero y marcarlo bien. De esto se encarga `ftdetect`. | |
- Gestionar el post de plantilla para que se pueda hacer `:NewWordPress` y te | |
prepare el archivo. Simplemente se guarda un fichero de referencia que se | |
escribe en el búfer actual al llamar al comando. Fácil. | |
- Llama al script de python de forma ordenada pidiéndole los credenciales al | |
usuario. Mientras escribes la contraseña no muestra nada en la pantalla, pero | |
no está muy fino y si te equivocas y borras no funciona. Si leéis el código | |
entenderéis por qué. | |
La parte de python es todo lo relacionado con Wordpress y la funcionalidad que | |
se quería ofrecer. Así puede separarse y usarse sola o migrarse a otros | |
editores. Tengo pendiente migrar a Emacs pero necesito la ayuda de mi divertida | |
[hermana Emacsera](https://ondahostil.wordpress.com/) para eso. La parte de | |
Python hace lo siguiente [por el | |
momento](https://github.com/ekaitz-zarraga/droWMark/issues/5). | |
- Captura las opciones puestas en la cabecera INI y construye un blogpost con | |
ellas. | |
- Convierte el MarkDown a HTML usando `panflute`. En las versiones anteriores | |
lo hacía con `pypandoc`. | |
- Durante la conversión (esto es la novedad de la versión 1.1) busca todas las | |
imágenes en el texto y las sube si son ficheros locales cambiando la URL para | |
que referencia al recién subido archivo. Lo mismo ocurre con el campo | |
`thumbnail` de la cabecera. | |
- Postea el documento convertido. | |
Y eso es todo. | |
Fijaos que esta entrada tiene un thumbnail (o imagen destacada) y una imagen | |
aquí debajo. Están únicamente puestas para demostrar que puedo. | |
 | |
No os toméis este Plugin como la mejor manera de hacer las cosas, sólo quiero | |
que veáis que cuando nos apetece cambiar nuestro *workflow* con un poco de | |
esfuerzo podemos conseguirlo. No hace falta volverse muy loco. | |
Si leéis el código fuente veréis que es un script de Python muy corto y | |
bastante cutre. A veces merece la pena programar agresivo si el programa cumple | |
con lo que debe. | |
Ahora mismo estoy en ese proceso de ir convirtiéndolo en un programa razonable, | |
pero, de momento, es un poco mierda porque funciona y para mí es suficiente. Si | |
empezamos grande a veces nos aburrimos antes de terminar. Mejor empezar pequeño | |
y cuando la cosa dé unos frutos recuperar la motivación para poder crecer. | |
¡Espero que os mole y lo probéis! | |
Comentarios y críticas, en la sección de abajo. | |
Un abrazo. | |
[^1]: INI son los ficheros como la configuración de Git, [hice un parser de esto | |
en C hace un tiempo](https://pfctelepathy.wordpress.com/2016/06/24/parsear-archivos-ini-en-c/) |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment