diff --git a/README.rst b/README.rst index 94fb0be8e..b2a893355 100644 --- a/README.rst +++ b/README.rst @@ -2,17 +2,19 @@ Este es el repositorio de los contenidos de la Wiki de Python Argentina | http://wiki.python.org.ar/ + Podés editar los contenidos (incluso agregar páginas) y proponer un pull request, que se sincronizará automáticamente con la wiki una vez que sea mezclado. -Antes de clonar el repo, asegurate de tener instalado [Git LFS](https://git-lfs.github.com/) - Pueden ver como colaborar en la página de `Cómo colaborar -`__ +`__ Cómo buildear las páginas ========================= +El contenido de la wiki está escrito en `Markdown `__ o `reStructeredText `__ y se +transforma a `HTML` con `nikola `__, un generador de sitios estáticos escrito en python. + .. code-block:: console pip install -U pip @@ -20,14 +22,3 @@ Cómo buildear las páginas nikola build nikola serve - -Cómo buildear la imagen de docker -================================= - -.. code-block:: console - - docker build --no-cache --tag tzulberti/wiki -f Dockerfile . - - -Se necesita el `--no-cache` para que la parte de clonar el repo de la -wiki no use un cache sino que se haga todo el tiempo. diff --git a/pages/colaborandoenelwiki.rst b/pages/colaborandoenelwiki.rst index 148a8da5f..123e89637 100644 --- a/pages/colaborandoenelwiki.rst +++ b/pages/colaborandoenelwiki.rst @@ -39,6 +39,10 @@ Hay dos formas de proponer mejoras: En cualquier caso, siempre es necesario que se creen una cuenta en `GitHub `_ + +Los contenidos de la wiki pueden ser escritos en `Markdown `__ o en `reStructeredText`. +`Markdown` es muy sencillo de aprender y utilizar pero tiene una sintaxis limitada a diferencia de `reStructeredText` que permite una mayor configurabilidad. + Si no saben mucho de reStructuredText, estos son algunos links que les pueden ayudar: