Subir el PDF más actual para poder referirlo

[dualbus]

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]

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

[renich]

@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]

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]

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

[renich]

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]

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

[renich]

@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]

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]

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]

@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]

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]

@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]

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.