[pyar] Como editar la wiki de PyAr con tu editor preferido y otras perlitas

[Martín Gaitán]

Hola de nuevo, soy el que quiere que la wiki de PyAr quede buenísima (y de
paso, que les guste Waliki :D) . queria contarles de algunas features o
tips para motivar a más gente a colaborar y hacer "docencia" desde la wiki.

editar la wiki desde tu editor
------------------------------------

Como saben, Waliki guarda cada pagina en un archivo .rst (o .md para
markdown, pero eso no lo usamos) y *toda la wiki* es un repositorio git,
que lo sincronizamos acá:

https://github.com/PyAr/wiki

Waliki tiene un feature [1] que permite que cuando hay un push (directo o
via el merge de un pull request), github le avise para que haga pull y
actualice los cambios que encuentra.

De esta manera, pueden contribuir a la wiki usando su editor preferido:

1) Clonan el repo de la dirección de arriba
2) Hacen todos los cambios que quieran en la wiki usando vim, sublime o lo
editor que ustedes quieran.
 (no hace falta que sea un commit por página como hace el editor web)
3) proponen un pull request
4) cuando ese PR se mezcla, github le avisa a la web de pyar y
automaticamente se actualiza la wiki.


Espero que eso l en s motive a contribuir!


Resaltado de código
--------------------------

Para resaltar codigo hay que usar  ".. code-block::  python" (o el lenguaje
que corresponda, en vez del canónico "::" (que es como quedaron todos los
ejemplos migrados automaticamente). Como ejemplo pueden ver.
http://python.org.ar/wiki/Recetario/Gui/Gtk/HolaMundo

usa pygments

Embed content
--------------------

Basado en un aporte de Roberto Alsina, le agregué una directiva al
restructuredtext de waliki llamada embed (análoga a "media" de nikola), que
sirve para inscrutar cualquier cosa inscrustable dando sólo la url .

Por ejemplo, un video de youtube, un tuit especifico, o en general,
cualquier cosa que soporte http://noembed.com/

.. embed:: <url al recurso incrustable>

por ejemplo http://python.org.ar/wiki/Recursos

abrazo!



[1] http://waliki.readthedocs.org/en/latest/git.html#the-pull-webhook
















-- 
mgaitan.github.io
textosypretextos.com.ar <http://textosyprextextos.com.ar>
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: <http://listas.python.org.ar/pipermail/pyar/attachments/20150402/31fe4ef0/attachment.html>