mirror of
https://github.com/scm-manager/scm-manager.git
synced 2025-12-22 00:09:47 +01:00
89548d45bd
Add search for files to the sources view. The search is only for finding file paths. It does not search any file metadata nor the content. Results get a rating, where file names are rated higher than file paths. The results are sorted by the score and the first 50 results are displayed. Co-authored-by: Eduard Heimbuch <eduard.heimbuch@cloudogu.com>
83 lines
5.0 KiB
Markdown
83 lines
5.0 KiB
Markdown
---
|
|
title: Repository
|
|
subtitle: Code
|
|
displayToc: true
|
|
---
|
|
Die Sektion "Code" enthält sämtliche Informationen, die sich auf den Code bzw. Inhalt des Repository beziehen. Oben auf der Seite befindet sich ein Aktionsbalken über den innerhalb der Code-Sektion navigiert werden kann.
|
|
|
|
### Sources
|
|
Die Übersicht der Sources zeigt die Dateien und Ordner in dem Repository an. Wenn Branches existieren, werden die Sources für den ausgewählten Branch angezeigt.
|
|
|
|
Es gibt unter dem Aktionsbalken eine Breadcrumbs Navigation, die den Pfad der angezeigten Dateien darstellt. Durch Klicken auf die einzelnen Pfad-Bestandteile, kann man sich durch die Dateistruktur des Repository (zurück-)navigieren.
|
|
|
|
|
|
|
|
#### Verlinkungen
|
|
|
|
Über den Button auf der linken Seite der Breadcrumbs Navigation kann ein permanenter Link
|
|
zum aktuellen Pfad in die Zwischenablage kopiert werden.
|
|
|
|
#### Dateinamen Suche
|
|
|
|
Die Dateinamen Suche kann über das Such Icon neben dem Dateipfad geöffnet werden.
|
|
Die Suche bezieht sich ausschließlich auf den Dateipfad und nicht auf Dateiinhalte.
|
|
Bei der Suche werden Treffer im Dateinamen höher gewertet als Suchtreffer im Dateipfad.
|
|
Sobald mehr als ein Zeichen eingegeben wurde, startet die Suche automatisch und zeigt die Ergebnisse unterhalb des Textfeldes an.
|
|
|
|
|
|
|
|
### Changesets
|
|
Die Übersicht der Changesets/Commits zeigt die Änderungshistorie je Branch an. Jeder Listeneintrag stellt einen Commit dar.
|
|
|
|
Über den Details-Button kann man sich den Inhalt / die Änderungen dieses Changesets ansehen.
|
|
|
|
Der Schlüssel Icon zeigt an, ob ein Changeset signiert wurde. Um die Signatur zu validieren, können die Benutzer ihre öffentlichen Schlüssel (Public Keys) im SCM-Manager hinterlegen. Ein grüner Schlüssel bedeutet die Signatur konnte erfolgreich gegen einen hinterlegten öffentlichen Schlüssel im SCM-Manager verifiziert werden. Ein grauer Schlüssel heißt, dass die Signatur zu keinem Schlüssel im SCM-Manager passt. Und ein roter Schlüssel warnt vor einer ungültigen (möglicherweise gefälschten) Signatur.
|
|
|
|
Über den Sources-Button gelangt man zur Sources-Übersicht und es wird der Datenstand zum Zeitpunkt nach diesem Commit angezeigt.
|
|
|
|
|
|
|
|
### Changeset Details
|
|
Auf der Detailseite eines Changesets sieht man zusätzlich zu den Metadaten (z. B. Mitwirkende und Parent-Changeset) des Changesets sämtliche Änderungen, die in diesem Changeset enthalten sind.
|
|
Die Mitwirkenden können zu einer detaillierten Tabelle aufklappt werden und enthalten den Autor, die Co-Autoren, den Committer und den Signierer des Changesets.
|
|
Die Diffs werden dabei im bekannten Format je Datei inklusive Syntax-Highlighting angezeigt.
|
|
Die Diffs können durch Klicken auf den blauen Balken schrittweise oder vollständig erweitert werden.
|
|
|
|
Falls sich Commit Links im Format "namespace/name@commitId" in der Changeset Beschreibung befinden, werden die zu relativen SCM-Manager Links erweitert.
|
|
Beispielsweise wird der Text hitchhiker/HeartOfGold@1a2b3c4 zu einem Link zu dem Commit 1a2b3c4 im Repository hitchhiker/HeartOfGold umgewandelt.
|
|
|
|
|
|
|
|
#### Tags
|
|
|
|
Alle Tags eines Changesets werden in der oberen rechten Ecke der Detailseite angezeigt.
|
|
|
|
|
|
|
|
#### Tags erstellen
|
|
|
|
Neue Tags für ein Changeset können direkt in dessen Übersichtsseite erstellt werden.
|
|
Es muss lediglich ein gewünschter Name angegeben werden, welcher die gleichen Formatierungsbeschränkungen wie Branches erfüllt.
|
|
|
|
|
|
|
|
### Datei Details
|
|
Nach einem Klick auf eine Datei in den Sources landet man in der Detailansicht der Datei. Dabei sind je nach Dateiformat unterschiedliche Ansichten zu sehen:
|
|
|
|
- Bild-Datei: Bild wird gerendert angezeigt.
|
|
- Markdown-Datei: Markdown wird gerendert dargestellt. Die Ansicht kann auf eine nicht gerenderte Textansicht umgeschaltet werden. Im gerenderten Markdown können ebenfalls Commit Links wie bei den Changeset Details verwendet werden.
|
|
- Text-basierte Datei: Der Text wird angezeigt. Falls verfügbar mit Syntax-Highlighting.
|
|
- Nicht unterstützte Formate: Ein Download-Button wird angezeigt.
|
|
|
|
|
|
|
|
### Datei Annotate
|
|
Ergänzt jede Codezeile mit entsprechenden Informationen, wann und von welchem Autor diese zuletzt geändert wurde. Mit einem Hover auf der linken Seite erscheint ein Popover mit Changeset und weiteren Informationen.
|
|
|
|
|
|
|
|
### Datei Historie
|
|
Bei der Datei Details Ansicht kann man über einen Switch oben rechts auf die Historien-Ansicht wechseln. Dort werden die Commits aufgelistet, die diese Datei verändert haben.
|
|
|
|
|