2012-06-22 5 views
7

Conservo una documentazione con git e GitHub. I file sorgente sono file TEX per Pdflatex e alcuni altri file (come figure) utilizzati per la compilazione. Questi file sono versionati. Dopo la compilazione, producono un file PDF (che spiega tutti i dettagli del mio progetto).GitHub: posso offrire l'accesso ai file compilati senza versionarli?

Non v'è alcuna necessità di versione che risulta file PDF, perché è costruito dalla fonte. Il versioning del PDF compilato sarebbe un punto di riferimento per le risorse.

Tuttavia, vorrei che le persone che controllano il mio repository GitHub possono leggere immediatamente l'ultimo PDF compilati, in modo che essi non hanno bisogno di compilare se stessi. Tale possibilità sarebbe apprezzata dalle persone che vogliono solo dare un'occhiata veloce, no?

Come può questo essere fatto con GitHub?

risposta

9

avete una pagina disponibile per il download a http://github.com/user/project/downloads. Puoi gestirlo automaticamente con il loro API se necessario.

Edit: Come notato da Thomas, il download API è stata deprecated in quanto, ed è stato sostituito da un altro flusso di lavoro chiamato "Releases". È quindi possibile allegare file binari a una versione specifica.

Drag and drop binary

4

Sì, puoi farlo. Vai alla scheda "Download" e carica il tuo file PDF. Gli altri utenti saranno in grado di vederlo.

That's the tab right there

1

Per quanto io sappia, questo non è qualcosa che può essere fatto nel modo desiderato. Immagina che qualcuno inverta il ramo a una versione precedente. Se il PDF non è versionato, cosa succede?

git è abbastanza efficiente nel modo in cui esegue il suo controllo delle versioni e, a meno che il tuo PDF non sia veramente grande, dovrebbe andar bene lasciarlo solo se lo vuoi davvero lì quando gli utenti lo scaricano.

Personalmente, vi consiglio di non includere il PDF nel ramo, e semplicemente fare uso di pagina di download di GitHub. Ti permette di creare file relativi al tuo progetto che non necessariamente vanno con la fonte. Questo è normalmente usato dagli sviluppatori per mettere su tarball delle loro build di rilascio e così via.