search

LinuxCabal / dir-foss

Un directorio de las organizaciones relacionadas con el FOSS; en México.
Other
4 stars 8 forks source link

Subir el PDF más actual para poder referirlo #11

Open dualbus opened 9 years ago

dualbus commented 9 years ago

Saludos,

Cuando refiero al proyecto de dir-foss, me resulta extraño mandar a la gente a un repositorio con código, en vez de referirlos a un PDF generado con los contenidos más actuales.

Este issue es para solicitar su opinión al respecto (de subir el PDF). Y también, para mejorar la accesibilidad, subir una versión en HTML, que es un formato estándar.

alvarezp commented 9 years ago

Supongo que estaría interesante hacer una propuesta por medio de gh-pages.

renich commented 9 years ago

@dualbus entiendo lo que dices, pero, la neta, cómo que un FOSSerit@ no sabe usar make? No merece ser FOSSerit@ de ser así ;)

Creo que no es mala idea lo de poner el PDF. He visto que algunos cheatsheets lo hacen. Estaría bien ver si github lo puede hacer por nosotros. Algún post-receive hook?

Lo de la versión HTML se me hace innecesario. Si revisas los archivos en src, te va a mostrar los renders por parte de github. A lo mejor no el main, pero si cada archivo individual.

Cómo la base ball?

dualbus commented 9 years ago

Concuerdo con que las personas que quieran colaborar con dir-foss deberán ser capaces de poder correr un git, un make, etc. Sin embargo, creo que hay más personas que podrían estar interesadas en dir-foss, y no necesariamente mandar cambios. Por ejemplo, si estoy predicando la palabra del FOSS con alguien que quizá no es muy técnico, puedo referirlo a una página web con el directorio. No espero que todos los que están interesados en FOSS sean capaces de usar make.

Sobre lo de poner el PDF, no sé si se pueda como menciona @alvarezp , con gh-pages, lo revisaré.

Y el HTML, yo honestamente prefiero HTML a PDF. HTML es más ligero, funciona en más dispositivos por default, y lo puedo navegar desde clientes de texto (yo paso la mayoría del tiempo en w3m, y tener que verlo en PDF me causa problemas :-P). Y si, podria ver el src de los archivos, pero si navegas github con w3m, veras lo que digo (github apesta en ese sentido).

alvarezp commented 9 years ago

Si no es en gh-pages, ¿dónde se publicaría, @dualbus?

renich commented 9 years ago

Creo que podemos dejar de ignorar pdf/ y con eso se resuelve el dilema.

En cuanto al HTML, sigo renuente a ponerlo aquí; en el repo. Creo, sinceramente, que se renderiza mucho mejor el rst en github que otra cosa.

@dualbus probé verlo en elinks y, si descartas el menú y la madre de github, pues ahí está la info. No es bonita, pero, la neta, en e-links, nada es bonito. Entiendo tu preocupación....

@dualbus pudieras hacer una prueba en tu repo y mandar el link, para ver la diferencia al generar HTML?

alvarezp commented 9 years ago

Dejar de ignorar el pdf/ es como subir un ELF construido con Make a Github. Preferiría algún modo distinto.

renich commented 9 years ago

@alvarezp si, no me gusta mucho subir binarios pero he visto que lo hacen con los cheatsheets y demás. Está abierto a propuestas y sugerencias.

Si hace falta un servidor, yo puedo poner uno. Si prefieren usar Google Drive o algún tipo de object storage como mega.co.nz o algo así, por mí, no hay bronca.

alvarezp commented 9 years ago

En este momento yo lo he publicado en http://alvarezp.github.io/dir-foss/pdf/directorio.pdf

Mi branch gh-pages está en https://github.com/alvarezp/dir-foss/tree/gh-pages por si quieren revisarlo.

dualbus commented 9 years ago

Gracias @alvarezp!

Entonces, si entiendo el flujo, esto se haría así:

  1. Crear una rama gh-pages para LinuxCabal/dir-foss (sin contenido)
  2. Generar el PDF de las fuentes actuales, y ponerlo en esa rama (el PDF sería el único contenido).
  3. Empujar con: git push origin gh-pages

Para evitar el trabajo manual de actualización, podríamos usar este script:

http://dualbus.sdf.org/s/99badc58

Yo lo estoy usando ya junto con un cron para publicar una vez al día en:

http://dualbus.github.io/dir-foss/pdf/directorio.pdf

Solo es cuestión de adaptar el script un poco. Yo uso virtualenv para instalar rst2pdf, porque no tengo acceso root al server de los cron, así que eso se puede modificar, y también los valores para $upstream y $publish. El resto creo que debe funcionar sin problemas.

renich commented 9 years ago

@alvarezp y se podrá hacer un pull request de las gh-pages?

De ser así, se puede automatizar fácil; por cierto gracias @dualbus por el script.

renich commented 9 years ago

Ok, ya hice un pull de @alvarezp a la rama gh-pages. Limpié todo (para remover lo que no necesitamos) y, ahora, solo restaría automatizar la generación del PDF. Creo que pudiera ser que hubiera algún hook o algo; habrá que investigar.

alvarezp commented 9 years ago

@renich Un hook a tu master se me haría muy buena idea, pero tengo la duda de si Github lo ejecutará cuando tú hagas un merge a un PR por la interfaz Web. Posiblemente tenga que ser algo que se realice a mano. :-(

dualbus commented 9 years ago

Github tiene algo llamado web-hooks: https://developer.github.com/webhooks/

En esencia, cuando ocurre un evento, Github te lo notifica a un webserver que tú configures. Puede ser un script que capte el webhook y genere el deploy.