[OKFN-Spain] ayuda con github

[Jorge Sanz]

Hola Alberto,

Lo que comentas se parece a una iniciativa que llevamos unos cuantos amigos
para ofrecer de forma sencilla materiales para formación en temas geo. Se
llama geotalleres(1).

En lugar de  markdown, Jekyll y la autopublicación de github usamos también
github pero escribiendo en Restructured Text para Sphinx y un servicio de
terceros llamado Real The Docs.

En esencia es casi lo mismo pero en mi opinión Jekyll está muy bien para
montar webs y sitios de noticias/blogs (yo lo uso en mi web personal), pero
Sphinx está mucho más pensado para escribir documentación.

Otro ejemplo con ese stack es un curso que tenemos Pedro-Juan y yo en el
que incluso usamos el concepto de rama de git para sacar "versiones" del
curso específicas para una edición concreta(2). De hecho ese curso está
ofrecido en geotalleres gracias al uso de submódulos de git.

Vamos que la fiesta puede ser más variada y entretenida de lo que uno se
puede imaginar a priori :-)

Mis 2 céntimos.

Saludos.

(1) https://geotalleres.readthedocs.org
(2)
https://taller-de-josm-imposm-tilemill.readthedocs.org/es/feature-cfp2014/

--
Jorge Sanz
http://jorgesanz.net

Sent from my tablet, sorry for my brevity, top posting, etc.
El 06/10/2014 18:05, "alberto abella" <alberto.abella en okfn.es> escribió:

>  Estoy testeando la plataforma de la mozilla foundation y la p2PU como
> posible plataforma para incorporar cursos online (no es un mooc), pero los
> ejemplos tienen muy buena pinta
> http://p2pu.github.io/jekyll-course-template/
>
>
> Sin embargo aquí abajo os paso las instrucciones, ¿Alguien que tenga maś
> experiencia que yo con github puede echar una mano?
>
>
> How do I use it?
>
> - Read about [github pages](http://pages.github.com/).
> - Download the files [here](
> https://github.com/p2pu/jekyll-course-template/archive/gh-pages.zip).
> - Create a new git repository on your local machine: `git init .`
> - Create and use the branch gh-pages as the default: `git checkout -b
> gh-pages`.
> - Create a new repository on [github](https://github.com).
> - Add the new repository as the origin for your repository `git remote add
> origin git en github.com:username/repositoryname.git`.
> - Copy the files into your repository.
> - Update _data/course.yml with the relevant info.
> - Update index.md with the basic info about your course.
> - Create course contents in _posts/. Have a look at the examples [here](
> https://github.com/p2pu/course-2-jekyll/tree/gh-pages/_posts).
> - File names need to start with a date and that this date will determine
> the order.
> - Add the category 'contents' to the post, otherwise it won't show up on
> your course about page.
> - Update _config.yml.
> - Update the URLs appropriately - `baseurl` will be the name of your
> repository & url should be the username.github.io/repositoryname.
> - Create a new Google Analytics account and put the site ID in _config.yml.
> - Create a new disqus account if you want to enable comments and put the
> disqus_shortname in _config.yml.
> - Push to the gh-pages branch of your github reposity: `git push origin
> gh-pages`.
>
>
>
> _______________________________________________
> okfn-sp mailing list
> okfn-sp en lists.okfn.org
> https://lists.okfn.org/mailman/listinfo/okfn-sp
> Unsubscribe: https://lists.okfn.org/mailman/options/okfn-sp
>
>
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: <http://lists.okfn.org/pipermail/okfn-sp/attachments/20141006/8855119a/attachment-0004.html>