Informationen zu README-Dateien
You can add a README file to a repository to communicate important information about your project. A README, along with a repository license and contribution guidelines, communicates expectations for your project and helps you manage contributions.
For more information about providing guidelines for your project, see "Setting up your project for healthy contributions."
Die README-Datei ist oft das erste Element, das ein Benutzer beim Besuch Deines Repositorys sieht. README-Dateien enthalten in der Regel folgende Informationen:
- Was ist die Aufgabe des Projekts?
- Warum ist das Projekt sinnvoll?
- Wie können Benutzer am Projekt mitwirken?
- Wo erhalten Benutzer Hilfe zu Ihrem Projekt?
- Wer verwaltet das Projekt und trägt dazu bei?
Wenn Sie Ihre README-Datei im Stammverzeichnis, im Ordner docs
oder im verborgenen Verzeichnis .github
Ihres Repositorys ablegen, erkennt GitHub Enterprise Server Ihre README-Datei und stellt sie automatisch den Besuchern des Repositorys zur Verfügung.
Auto-generated table of contents for README files
For the rendered view of any Markdown file in a repository, including README files, GitHub Enterprise Server will automatically generate a table of contents based on section headings. You can view the table of contents for a README file by clicking the menu icon at the top left of the rendered page.
The auto-generated table of contents is enabled by default for all Markdown files in a repository, but you can disable this feature for your repository.
- Navigiere in GitHub Enterprise Server zur Hauptseite des Repository.
- Klicke unter Deinem Repository-Namen auf Settings (Einstellungen).
- Under "Features", deselect Table of contents.
Links zu Abschnitten in README-Dateien und auf Blob-Seiten
Du kannst direkt zu einem Abschnitt in einer gerenderten Datei verweisen, indem Du den Mauszeiger über den Abschnittstitel bewegst, um den Link sichtbar zu machen:
Relative Links und Bildpfade in README-Dateien
Du kannst relative Links und Bildpfade in Deinen gerenderten Dateien definieren, um Leser dabei zu unterstützen, in Deinem Repository zu anderen Dateien zu navigieren.
Ein relativer Link ist ein Verknüpfung, die relativ zur aktuellen Datei ist. Wenn Du beispielsweise eine README-Datei im Stammverzeichnis (root) Deines Repositorys und eine andere Datei in docs/CONTRIBUTING.md hast, könnte der relative Link zu CONTRIBUTING.md in Deiner README-Datei wie folgt aussehen:
[Beitragsrichtlinien für dieses Projekt](docs/CONTRIBUTING.md)
GitHub Enterprise Server wandelt Ihren relativen Link oder den Bildpfad automatisch anhand dessen um, auf welchem Branch Sie sich gerade befinden, damit der Link oder der Pfad immer funktioniert. Du kannst alle relativen Link-Operanden verwenden, beispielsweise ./
und ../
.
Relative Links sind für Benutzer, die Dein Repository klonen, einfacher zu verwenden. Absolute Links funktionieren möglicherweise nicht in Klons Deines Repositorys - wir empfehlen relative Links zu verwenden, um auf andere Dateien in Deinem Repository zu verweisen.