Fügen Sie Bilder zu README.md auf GitHub hinzu

Können Sie auch relative Pfade verwenden, wie

![Alt text](relative/path/to/img.jpg?raw=true "Title")

InformationsquelleAutor der Antwort resultsway

Können Sie auch Bilder hinzufügen, mit einfachen HTML-tags:

<p align="center">
  <img src="your_relative_path_here" width="350"/>
  <img src="your_relative_path_here_number_2_large_name" width="350"/>
</p>

InformationsquelleAutor der Antwort Evin1_

Viele Lösungen gepostet sind unvollständig oder nicht nach meinem Geschmack.

• Einem externen CDN wie imgur fügt ein weiteres Werkzeug um die Kette. Meh.
• Erstellen einen dummy-Problem in den issue tracker ist ein hack. Es schafft Unordnung und verwirrt den Benutzer. Es ist ein Schmerz zu migrieren diese Lösung zu einer Gabel, oder aus dem GitHub.
• Mit den gh-pages-branch-URLs dadurch spröde. Eine andere person an dem Projekt arbeitet die Aufrechterhaltung der gh-Seite können nicht wissen, etwas ist, das außerhalb hängt der Pfad zu diesen Bildern. Die gh-pages branch hat ein bestimmtes Verhalten auf GitHub, die nicht notwendig für das hosting CDN-Bilder.
• Tracking-Vermögenswerte in version control ist eine gute Sache. Wie ein Projekt wächst und sich verändert, es ist eine mehr nachhaltige Weise zu verwalten und verfolgen von änderungen durch mehrere Benutzer.
• Wenn ein Bild für einen bestimmten revision der software, kann es wünschenswert sein, eine Verknüpfung mit einem unwandelbaren Bild. So, wenn das Bild später aktualisiert, um änderungen an der software, wer Lesen, dass die revision der readme-Datei finden Sie das richtige Bild.

Meine bevorzugte Lösung, inspiriert durch diese gist, ist die Verwendung eines Vermögenswerte Zweig mit permalinks bestimmten Revisionen.

git checkout --orphan assets
git reset --hard
cp /path/to/cat.png .
git add .
git commit -m 'Added cat picture'
git push -u origin assets
git rev-parse HEAD  # Print the SHA, which is needed below.

Konstruieren einen "permalink" auf diese Version des Bildes, und wickeln Sie es in Markdown:

![Cat](https://raw.githubusercontent.com/{user}/{repo}/{sha}/cat.png)

z.B.

![Cat](https://raw.githubusercontent.com/paulmelnikow/zsh-startup-timer/3923c60fc66d4223ccf063d169ccf2ff167b1270/cat.png)

Immer anzeigen, das neueste Bild auf die Vermögens-Zweig verwenden assets anstelle des sha:

![Cat](https://raw.githubusercontent.com/{user}/{repo}/assets/cat.png)

InformationsquelleAutor der Antwort paulmelnikow

• Erstellen Sie eine Frage in Bezug auf das hinzufügen von Bildern
• Fügen Sie das Bild per drag-and-drop oder Dateiauswahl-Dialog

• Dann kopieren Bildquelle

• Fügen Sie nun ![alt tag](http://url/to/img.png) zu deiner README.md-Datei

Getan!

Alternativ können Sie ein Bild-hosting-Website wie imgur und erhalten Sie die url und fügen Sie es in Ihre README.md-Datei, oder Sie können einige statische Datei-hosting zu.

Beispiel-Ausgabe

InformationsquelleAutor der Antwort abe312

Brauche ich, um einige Bilder in meiner README-Datei. Ich weiß nicht, wie
tun.

Habe ich ein kleines Assistenten, mit dem Sie zum erstellen und anpassen von einfachen Bild-Galerien für Ihre GitHub-repository readme: Siehe ReadmeGalleryCreatorForGitHub.

Den Assistenten nutzt die Tatsache, dass GitHub ermöglicht die img-tags auftreten in der README.md. Auch der Assistent macht Gebrauch von dem beliebten trick, der das hochladen von Bildern auf GitHub per drag ' N ' 'dropping Ihnen in der Ausgabe-Bereich (wie bereits erwähnt in einer der Antworten in diesem thread).

InformationsquelleAutor der Antwort B12Toaster

In meinem Fall nutze ich imgur und nutzen Sie den direkten link auf diese Weise.

![img](http://i.imgur.com/yourfilename.png)

InformationsquelleAutor der Antwort Kegham K.

In den Fall, Sie brauchen, um ein paar Bilder hochladen für die Dokumentation, einen schönen Ansatz ist die Verwendung von git-lfs. Asuming, die Sie installiert haben die git-lfs gehen Sie folgendermaßen vor:

1. Intialize git lfs für Ihr jedes Bild-Typ:

   git lfs *.png
   git lfs *.svg
   git lfs *.gif
   git lfs *.jpg
   git lfs *.jpeg
   

2. Erstellen Sie einen Ordner, als image-Standort, zB. doc. Auf GNU/Linux-und Unix-basierten Systemen kann dies über:

   cd project_folder
   mkdir doc
   git add doc
   

3. Kopieren einfügen alle Bilder in Dok-Ordner. Anschließend fügen Sie Sie über git add Befehl.

4. Commit und push.

5. Die Bilder sind öffentlich verfügbar in der folgenden url:

   https://media.githubusercontent.com/media/^github_username^/^repo - ^/^Zweig^/^image_location in der repo -^

Wo:
* ^github_username^ ist der username bei github (Sie finden es in der Profil-Seite)
* ^repo_name^ ist der repository-name
* ^branch^ ist die repository-Zweig, bei dem das Bild hochgeladen wird
* ^image_location in the repo^ ist die Lage, einschließlich der Ordner, der das Bild gespeichert ist.

Auch Sie können laden Sie zuerst das Bild, dann besuchen Sie die Lage in Ihren Projekten github-Seite und navigieren Sie durch, bis Sie finden das Bild, drücken Sie dann die download - Taste und dann copy-paste die url aus der Adressleiste des Browsers.

Aussehen diese von meinem Projekt als Referenz.

Dann können Sie die url, um Sie mit Hilfe der markdown-syntax oben erwähnt:

![some alternate text that describes the image](^github generated url from git lfs^)

ZB: nehmen wir an wir verwenden dieses Foto Dann können Sie mit der markdown-syntax:

![In what order to compile the files](https://media.githubusercontent.com/media/pc-magas/myFirstEnclave/master/doc/SGX%20Compile%20workflow.png)

InformationsquelleAutor der Antwort Dimitrios Desyllas

Können Sie einen link auf Bilder in Ihr Projekt aus der README-Datei.md (oder extern) mit den alternativen github CDN-link.

Wird die URL wie folgt Aussehen:

https://cdn.rawgit.com/<USER>/<REPO>/<BRANCH>/<PATH>/<TO>/<FILE>

Ich habe ein SVG-Bild in mein Projekt, und wenn ich mich auf Sie in meinem Python-Projekt-Dokumentation, die es nicht machen.

Projekt link

Ist hier der Projekt-link auf die Datei (nicht dargestellt wie ein Bild):

https://github.com/jongracecox/anybadge/blob/master/examples/awesomeness.svg

Beispiel eingebettete Bild:

Raw link

Hier ist der ROH-link zu der Datei (noch nicht gerendert als Bild):

https://raw.githubusercontent.com/jongracecox/anybadge/master/examples/awesomeness.svg

Beispiel eingebettete Bild:

CDN link

Mit den CDN-link, ich kann den link auf die Datei mit (macht so ein Bild):

https://cdn.rawgit.com/jongracecox/anybadge/master/examples/awesomeness.svg

Beispiel eingebettete Bild:

Dies ist, wie ich in der Lage bin, Bilder von meinem Projekt in meinen beiden README.md - Datei, und in meinem PyPi Projekt reStructredText doucmentation (hier)

InformationsquelleAutor der Antwort JGC

NEUESTEN

Wikis können die Darstellung von PNG -, JPEG-oder GIF-Bilder

Jetzt können Sie verwenden:

[[https://github.com/username/repository/blob/master/img/octocat.png|alt=octocat]]

-ODER-

Gehen Sie folgendermaßen vor:

1. Auf GitHub, navigieren Sie zu der Hauptseite des repository.

2. Unter Ihrem repository-Namen, klicken Sie auf Wiki.

3. Mithilfe der wiki-Seitenleiste navigieren Sie zu der Seite, die Sie ändern möchten, und klicken Sie dann auf Bearbeiten.

4. Auf der wiki-Symbolleiste, klicken Sie auf Bild.

5. In der "Bild Einfügen" Dialogfeld, geben Sie die Bild-URL und alt-text (was von Suchmaschinen und Screenreader).
6. Klicken Sie auf OK.

Finden Docs.

InformationsquelleAutor der Antwort Lal Krishna