wake-up-neo.com

Bilder in ein GitHub Wiki (Gollum) Repository einbetten?

Die Github-Wikis werden von einem separaten Git-Repository und dann vom Hauptprojekt-Repository unterstützt.

In diesem Beitrag des Github-Teams klingt es so, als ob Sie in der Lage sein sollten, auf die im Wiki-Repository gespeicherten Bilder im Wiki-Markup zu verlinken.

Bilder und Ordner

Sie können jetzt auf Bilder verweisen, die im Git-Repository gehostet werden.

Ich habe das Repository meines Wikis ausgecheckt und darin einen Ressourcenordner und ein Image eingefügt. Meine Frage lautet: Wie gehe ich mit diesem Bild um? 

Ist das überhaupt möglich oder habe ich etwas falsch verstanden?

githubwikigollum-wiki
78
James McMahon

Um relative Pfade zu verwenden, gehen Sie folgendermaßen vor:

[[foo.jpg]]

Weitere Informationen finden Sie auf der Seite der demo-Wikis zu images .

52
Benjamin Oakes

Für Betrachter, die Bilder in einem Github-Wiki anzeigen möchten, habe ich die folgende Methode gefunden:

  • Gehen Sie zur Registerkarte "Git Access" auf der Wiki-Seite Ihres Repositorys und rufen Sie den SSH-Pfad auf, der wie folgt lauten sollte: [email protected]: USER/REPO.wiki.git wobei USER Ihr Kontoname und REPO der Name ist Repository-Name.

  • Verwenden Sie auf Ihrem lokalen Computer das Git-Befehlszeilentool, das Sie in Ihr lokales Verzeichnis Ihrer Wahl kopieren möchten, und rufen Sie das Repository über ab

    git-Klon [email protected]: USER/REPO.wiki.git

  • Erstellen Sie nun in diesem Repository ein Image-Verzeichnis. Ich werde es "Images" nennen und alle gewünschten Images in das Verzeichnis einfügen

  • Und dann schiebe dein Wiki-Git-Verzeichnis nach Github

  • Sie können die Bilder auf der Registerkarte "Seiten" nicht physisch sehen, aber wenn Sie einfach auf die Bilder in einem lokalen Link verweisen, sollten Sie sie sehen können. Beispiel mit Markdown unten:

    ![Alt attribute text Here](images/YOURIMAGE.ext)

  • Sie können das Bild auch selbst als Link einbetten, indem Sie es wie folgt weiter einschließen:

    [![Alt attribute text Here](images/YOURIMAGE.ext)](http://Yoursite.com)

Sie können auch Unterverzeichnisse zu Ihrer lokalen Kopie hinzufügen, um das Wiki besser zu organisieren, da die Registerkarte "Seiten" sie einfach auflistet. Beachten Sie jedoch, dass auf der Registerkarte "Seiten" das Verzeichnis auch dann nicht aufgeführt wird, wenn das neue Verzeichnis verschoben wird.

94
Ryan Q

Keine der Antworten scheint zu funktionieren, wenn Sie ein Bild in readme.md hinzufügen. Ich habe jedoch eine Lösung:

Wenn die URL des Bildes lautet:

https://github.com/Username/Repository-Name/blob/master/Directory-Inside-Repository/image.png

Wenn Sie blob durch raw ersetzen, erhalten Sie die URL des Rohbilds:

https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png

Jetzt haben Sie das Bild mit normalem Markdown eingebettet:

![Image Alt](https://github.com/Username/Repository-Name/raw/master/Directory-Inside-Repository/image.png)

UPDATE: GitHub liefert ab sofort auch Rohbilder aus einer anderen Subdomäne raw.github.com. Sie können also auch Folgendes verwenden:

https://raw.github.com/Username/Repository-Name/master/Directory-Inside-Repository/image.png

BEISPIEL: https://raw.github.com/Automattic/liveblog/master/screenshot-1.png

30
its_me

Relative Pfadarbeit für mich so:

homepage des Wikis:

![text](wiki/images/someimage.png)

unterseite des Wikis:

![text](images/someimage.png)

Beachten Sie, dass bei einer Vorschau das Bild nicht angezeigt wird. Ich hatte es gespeichert.

24
Werner

Wenn Sie ein Bild schnell per Drag & Drop hochladen möchten, können Sie Folgendes ausführen (wenn auch hackish):

Erstellen Sie ein Dummy-Problem. Drag & Drop dein Bild dort hin; Kopieren Sie den hochgeladenen Markdown-Bildcode in Ihr Wiki.

Nachdem Sie das Problem einmal erstellt haben, können Sie es beliebig oft verwenden.

Ich hoffe, dies hilft jedem, der eine schnelle Lösung sucht, ohne dass das Image im Repo gespeichert werden muss. 

14
tiby

Hier ist eine praktische Möglichkeit, dies zu tun:

  • Gehen Sie zu jedem Problem auf Github
  • Im Kommentarbereich können Sie Dateien anhängen, indem Sie das Bild per Drag & Drop auswählen oder auswählen
  • Kopieren Sie den Code/Link, der im Textbereich angezeigt wird 
  • Fügen Sie es in das Wiki ein
  • Gewinn!

Sie müssen nicht einmal ein Problem erstellen oder ändern, verglichen mit der @ tiby-Lösung!

7
Jacob Yiendedoi

Herausgefunden.

Die URL wird wie folgt formatiert

https://raw.github.com/wiki/username/project/pathtoimage/imagename.extension

pathtoimage ist optional

6
James McMahon

James 'URL-Format hat bei mir nicht funktioniert, vielleicht wurde es geändert. Ich habe benutzt:

https://github.com/username/project/wiki/pathtoimage/image.extension

Wobei pathtoimage optional ist.

5
Ninjakannon

Schließlich wurden die Bilder mit der von nerdwin beschriebenen Methode in das Repository aufgenommen und mit ![test](test.jpg) im Wiki angezeigt.

2
rupweb

Der folgende Abschlag verweist auf ein Bild in Ihrem GitHub repo aus Ihrem entsprechenden GitHub wiki.

![My Alt Text](../blob/master/Path/ToAsset/In/Repo.png?raw=true)

Das obige Beispiel setzt voraus, dass Sie in Ihrem Repo die folgende Dateistruktur haben

  • Pfad
    • ToAssets
      • Im
        • Repo.png

Für ein reales Beispiel, wenn ich dieses Bild in Github aus dem entsprechenden Wiki referenzieren wollte, würde ich diesen Abschlag verwenden

![Azure App Settings](../blob/master/TrelloWorld/TrelloWorld.Server/Assets/Azure_AppSettings.png?raw=true)

Vorbehalte

  1. Fall zählt
  2. Wenn Sie sich auf der speziellen Startseite des Wikis befinden, müssen Sie nicht mit ../ aufsteigen. In meinem obigen Beispiel wäre der richtige Link 

Für die Homepage:

![Azure App Settings](blob/master/TrelloWorld/TrelloWorld.Server/Assets/Azure_AppSettings.png?raw=true)
1
Josh

Verwenden Sie den relativen Pfad

das Wiki befindet sich unter [repositoryname]/wiki

Die Dateien im Repository befinden sich unter [repositoryname]/raw/master/[file path in repository].

Verwenden Sie also einfach den relativen Pfad: ../raw/master/[file path in repository]

1
Samuel P

Ich füge sowohl Bilder als auch PDFs in meine Wikis ein. Ich klone das Wiki und füge ein images- und ein files-Verzeichnis hinzu. Dann benutze ich die folgende Markierung, um Bild-Links einzubetten und Dateilinks hinzuzufügen:

Bilder:

[[/images/path/to/image.ext|ALT TEXT]]

Der führende Schrägstrich ist nicht erforderlich, wenn sich alle Wiki-Seiten auf der Root-Ebene befinden. Ich verwende jedoch Unterverzeichnisse, und ein absoluter Pfad wird korrekt aufgelöst und hält die Dinge einfach.

Dateien:

[link text](files/path/to/file.ext "ALT TEXT")

Beachten Sie, dass kein führender Schrägstrich für den Wiki-Pfad files als Link in diesem Format korrekt aufgelöst werden kann.

Ich habe dies in einer GitHub Gist dokumentiert.

1
Subfuzion

Verwenden Sie zum Einbetten einer externen Bildminiatur den folgenden Code: ![Image](<external link to the image>)

0
delta24

Der Kommentar von @ Drew Noakes zur ursprünglichen Frage hat es für mich getan

Die Syntax für das Bild, das ich anzeigen wollte:

[[/images/imageName.png]]

Dieses Bild wurde nur beim Umbenennen angezeigt:

wikiPage.md --> wikiPage.wiki

Die folgende Ordnerstruktur wurde im Wiki-Repository verwendet:

repository.wiki
   |--wikiPage.wiki
   |--images
        |--imageName.png

ABER:

Die Syntax in .wiki unterscheidet sich von .md-Dateien.

0
rocksteady