2012-06-22 13 views
7

Mantengo una documentación con git y GitHub. Los archivos fuente son archivos TEX para Pdflatex y algunos otros archivos (como figuras) que se utilizan para la compilación. Estos archivos están versionados. Después de la compilación, producen un archivo PDF (que explica todos los detalles de mi proyecto).GitHub: ¿puedo ofrecer acceso a archivos compilados sin versionarlos?

No es necesario versionar el archivo PDF resultante, ya que está construido desde el origen. Las versiones que compilaron en PDF serían un cúmulo de recursos.

Sin embargo, me gustaría que las personas que revisen mi repositorio de GitHub puedan leer el último PDF compilado de inmediato, para que no tengan que compilarse ellos mismos. Tal posibilidad sería apreciada por personas que solo quieren echar un vistazo rápido, ¿no es así?

¿Cómo se puede hacer esto con GitHub?

Respuesta

9

usted tiene una página de descarga disponible en http://github.com/user/project/downloads. Puede manejar esto automáticamente con su API si es necesario.

Editar: Como señaló Thomas, la API de descarga ha sido deprecated desde entonces, y ha sido sustituido por otro flujo de trabajo llamado "Releases". A continuación, puede adjuntar archivos binarios a una versión específica.

Drag and drop binary

4

Sí, puedes hacer esto. Vaya a la pestaña "Descargas" y cargue su archivo PDF. Otros usuarios podrán verlo.

That's the tab right there

1

Por lo que yo sé, esto no es algo que se puede hacer en la forma que desee. Imagina que alguien invierte la rama a una versión anterior. Si el PDF no está versionado, ¿qué le sucede?

git es bastante eficiente en la forma en que funciona su versión y, a menos que su PDF sea realmente grande, debería dejarlo en buen estado si realmente lo quiere allí cuando los usuarios lo extraigan.

Personalmente, le recomiendo que no incluya el PDF en la sucursal, y simplemente haga uso de la página de descarga de GitHub. Le permite colocar archivos relacionados con su proyecto que no necesariamente van con la fuente. Esto es utilizado normalmente por los desarrolladores para poner tarballs de sus compilaciones de lanzamiento y tal.

Cuestiones relacionadas