Travis ist ein Tool um Repos automatisiert zu "builden". Falls im gewählten Repo ein neuer Tag erstellt wird, dann wird der Build (PDF-File) unter deinem Namen im Projekt released.
Beispiel für einen Automatischen PDF-Build mit Travis.
Die Bedingungen für die Erstellung eines neuen Release können im .travis.yml
angepasst werden. Dafür brauchst du einen Account in Travis-CI, und einen Token, mit welchem Travis sich bei GitHub authentifizieren und somit die Builds releasen kann.
- Travis anmelden
- Github-Projekt auf der Profilseite suchen und aktivieren (
https://travis-ci.org/profile/USERNAME
) - Github Token erstellen: creating-a-personal-access-token
- Token mit
GITHUB_RELEASE_TOKEN
bennen- Rechte:
public_repo
,repo_deployment
- Rechte:
- Token lokal sicher abspeichern
- Token in Travis-CI im Projekt (
https://travis-ci.org/HSR-Stud/PROJECTNAME/settings
) als Environment Variable hinzufügen- ACHTUNG: Der Token darf im Display Log nicht angezeigt werden:
Display value in build log
mussOFF
sein!! - Name der Variable muss wieder
GITHUB_RELEASE_TOKEN
sein
- ACHTUNG: Der Token darf im Display Log nicht angezeigt werden:
- Travis als Submodul einfügen
git submodule add https://github.com/HSR-Stud/Travis Travis
.travis.yml
in die oberste Ebene des Repos kopieren.- Das neue
.travis.yml
bearbeiten.- Unter
script
undfile
den aktuellen Dokumentnamen einfügen. bibtex
auskommentieren, falls es nicht benötigt wird.
- Unter
- Im Projekt auf den Build Status klicken (rechts neben dem Projektnamen)
- Branch auswählen
- Statt "Image URL" "Markdown" auswählen
- Text kopieren
- In Readme eintragen
- Committen