Menambahkan gambar ke README.md di GitHub
Baru-baru ini saya bergabung dengan GitHub. Aku host beberapa proyek di sana.
Saya harus menyertakan beberapa gambar dalam File README. Saya don't tahu bagaimana untuk melakukan itu.
Aku mencari tentang ini, tapi semua aku punya adalah beberapa link yang memberitahu saya untuk "tuan rumah gambar di web dan menentukan path gambar di README.md file".
Apakah ada cara untuk melakukan hal ini tanpa hosting gambar pada pihak ketiga layanan web hosting?
1657
28
Coba ini penurunan harga:
Saya pikir anda dapat link secara langsung untuk baku versi gambar jika itu's disimpan dalam repositori anda. yaitu
Edit: hanya melihat komentar menghubungkan ke artikel yang menyarankan menggunakan gh-halaman. Juga, link relatif dapat menjadi ide yang lebih baik dari absolute Url yang saya posting di atas.
Anda juga dapat menggunakan path relatif seperti
berikut adalah detil video youTube menjelaskan hal ini secara detail:
https://www.youtube.com/watch?v=nvPOUdz5PL4
It's jauh lebih sederhana dari itu.
Hanya meng-upload gambar anda ke repositori akar, dan link ke file tanpa jalan, seperti:
Anda juga dapat menambahkan gambar dengan sederhana tag HTML:
Banyak diposting solusi yang tidak lengkap atau tidak sesuai dengan selera saya.
Pilihan saya solusi, terinspirasi oleh ini gist, adalah dengan menggunakan aset cabang dengan permalinks untuk revisi tertentu.
Membangun "permalink" ini revisi dari gambar, dan membungkusnya dalam Penurunan harga:
![Kucing](https://raw.githubusercontent.com/{user}/{repo}/{} sha/cat.png)
misalnya
![Cat](https://raw.githubusercontent.com/paulmelnikow/zsh-startup-timer/3923c60fc66d4223ccf063d169ccf2ff167b1270/cat.png)
Untuk selalu menampilkan gambar terbaru yang ada pada aktiva cabang, gunakan
aset
di tempat sha:![Kucing](https://raw.githubusercontent.com/{user}/{repo}/aset/cat.png)
Melakukan gambar anda (gambar.png) dalam sebuah folder (myFolder) dan tambahkan baris berikut di README.md:
![Opsional Teks](../master/myFolder/gambar.png)
Membuat masalah mengenai menambahkan gambar
Tambahkan gambar dengan drag dan drop atau dengan file chooser
Kemudian copy sumber gambar
Sekarang tambahkan
![tag alt](http://url/to/img.png)
untuk anda README.md fileSelesai!
Atau anda dapat menggunakan beberapa image hosting situs seperti
imgur
dan mendapatkan itu's url dan tambahkan di README.md file atau anda bisa menggunakan beberapa file statis hosting juga.Contoh masalah
Hanya menambahkan
<img>
tag untuk anda README.md dengan relatif src untuk repositori anda. Jika anda're tidak menggunakan relatif src, pastikan server mendukung CORS.Ia bekerja karena GitHub dukungan inline-html
Mengamati di sini
Berikut ini:
Contoh:
Ini akan terlihat seperti berikut:
Saya membuat sebuah penyihir kecil yang memungkinkan anda untuk membuat dan menyesuaikan sederhana galeri gambar untuk repositori GitHub's readme: Lihat ReadmeGalleryCreatorForGitHub.
Wizard mengambil keuntungan dari fakta bahwa GitHub memungkinkan tag img untuk terjadi
README.md
. Juga, wizard membuat penggunaan populer trik meng-upload gambar ke GitHub dengan drag'n'menjatuhkan mereka dalam masalah daerah (seperti yang sudah disebutkan di salah satu dari jawaban di thread ini).Gunakan tabel untuk berdiri keluar, hal ini akan memberikan pesona tersendiri untuk itu
Tabel Sintaks:
Terpisah masing-masing kolom sel dengan simbol
|
dan header tabel (baris Pertama) dengan 2 baris dengan
---
| col 1 | col 2 |
|------------|-------------|
| gambar 1 | gambar 2 |
output
Sekarang hanya menempatkan
<img src="url/relativePath">
pada gambar 1 dan gambar 2 jika anda menggunakan dua gambarCatatan: jika menggunakan beberapa gambar hanya mencakup lebih kolom, anda dapat menggunakan lebar dan tinggi atribut untuk membuatnya terlihat mudah dibaca.
Contoh
| col 1 | col 2 |
|------------|-------------|
|
<img src="https://media.wired.com/photos/5926db217034dc5f91becd6b/master/w_582,c_limit/so-logo-s.jpg" width="250">
|<img src="https://mk0jobadderjftub56m0.kinstacdn.com/wp-content/uploads/stackoverflow.com-300.jpg" width="250">
|Jarak tidak masalah
Gambar Output
dibantu oleh : adam-p
Anda dapat link ke gambar dalam proyek anda dari README.md (atau eksternal) dengan menggunakan alternatif github link CDN.
URL akan terlihat seperti ini:
Saya memiliki sebuah gambar SVG di proyek saya, dan ketika saya referensi di Python dokumentasi proyek, itu tidak membuat.
Proyek link
Berikut ini adalah proyek yang link ke file (tidak membuat seperti gambar):
https://github.com/jongracecox/anybadge/blob/master/examples/awesomeness.svg
Contoh gambar tertanam:
Baku link
Berikut ini adalah BAKU link ke file (masih tidak membuat seperti gambar):
https://raw.githubusercontent.com/jongracecox/anybadge/master/examples/awesomeness.svg
Contoh gambar tertanam:
CDN link
Menggunakan CDN link, saya dapat link ke file menggunakan (menjadikan sebagai gambar):
https://cdn.rawgit.com/jongracecox/anybadge/master/examples/awesomeness.svg
Contoh gambar tertanam:
Ini adalah bagaimana saya dapat menggunakan gambar dari proyek saya di kedua saya
README.md
file, dan di PyPi proyek reStructredText doucmentation ([di sini](https://pypi.python.org/pypi?name=anybadge&versi=1.2.0rc4& action=display))Dalam kasus saya saya menggunakan imgur dan gunakan link langsung cara ini.
Saya telah memecahkan masalah ini. Anda hanya perlu merujuk ke orang lain's file readme.
Pada awalnya,anda harus meng-upload file gambar ke github kode perpustakaan ! Kemudian referensi langsung ke alamat dari file gambar .
Biasanya saya meng-host gambar di situs ini anda dapat link ke setiap host gambar. Hanya melemparkan ini di readme. Bekerja untuk
.rst
file, tidak yakin tentang.md
Anda hanya dapat melakukan:
Maka anda hanya dapat referensi itu di
README
file seperti:![diagram](diagram.png)
Dalam kasus anda perlu untuk meng-upload beberapa gambar untuk dokumentasi, pendekatan yang baik adalah dengan menggunakan git-lfs. Yakin bahwa anda telah menginstal git-lfs ikuti langkah-langkah berikut:
git lfs .png git lfs .svg git lfs .gif git lfs .jpg git lfs *.jpeg
doc
. Pada GNU/Linux dan Unix berbasis sistem ini dapat dilakukan melalui:cd project_folder mkdir doc git add doc
Copy paste gambar ke folder doc. Setelah itu tambahkan mereka melalui
git add
perintah.Commit dan push.
Gambar yang tersedia secara publik di url berikut:
https://media.githubusercontent.com/media/^github_username^/^repo^/^cabang^/^image_location di repo^
Dimana:
^github_username^
adalah username di github (anda dapat menemukannya di halaman profil)^repo_name^
adalah nama repositori^cabang^
adalah repositori cabang di mana gambar upload^image_location di repo^
adalah lokasi termasuk folder tempat gambar disimpan.Anda juga dapat meng-upload gambar terlebih dahulu kemudian mengunjungi lokasi dalam proyek-proyek github page dan menavigasi melalui sampai anda menemukan gambar kemudian tekan tombol
download
dan kemudian copy-paste url dari browser's address bar.Lihat ini dari proyek saya sebagai referensi.
Kemudian anda dapat menggunakan url untuk memasukkan mereka menggunakan markdown syntax yang disebutkan di atas:
Misalnya: Mari kita misalkan kita menggunakan ini photo Maka anda dapat menggunakan markdown syntax:
Dalam kasus saya saya ingin menunjukkan print screen pada
Github
tapi jugaNPM
. Meskipun menggunakan path relatif masih bekerja dalamGithub
, itu bukan't bekerja di luar itu. Pada dasarnya, bahkan jika saya mendorong saya untuk proyekNPM
juga (yang hanya menggunakan yang samareadme.md
, gambar itu tidak pernah menunjukkan.Saya mencoba beberapa cara, pada akhirnya ini adalah apa yang bekerja untuk saya:
![Preview](https://raw.githubusercontent.com/username/project/master/image-path/image.png)
Sekarang saya melihat gambar saya dengan benar pada
NPM
atau di mana pun yang saya bisa menerbitkan paket saya.HANYA INI BEKERJA!!
mengambil peduli tentang anda nama file besar di tag dan menempatkan file PNG inroot, dan link ke file tanpa path: