Solusi yang tepat untuk ini adalah dengan menggunakan referensi relatif, per jawaban ini stackoverflow.com/a/11916467/1633251 (lihat komentar dengan tautan ke dokumen github baru tentang cara melakukan ini). Jawaban singkatnya adalah menggunakan[Read more words!](docs/more_words.md)
David H
2
Sebagian besar solusi mengusulkan untuk menunjuk ke repo itu sendiri. Bagaimana jika Anda ingin menghindari binari dalam repo (bahkan di cabang terpisah, seperti yang diusulkan) dan Anda ingin menyimpannya di tempat eksternal? Adakah praktik yang baik? Sebuah inti mungkin (IDK jika inti dapat berupa biner atau hanya teks)? membuat repo "myproject-asset" lain untuk proyek "myproject"? Adakah tempat gambar populer eksternal yang mirip dengan standar de-facto youtube untuk mengunggah video?
GitHub merekomendasikan Anda menggunakan tautan relatif dengan ?raw=trueparameter untuk memastikan titik reposisi bercabang dengan benar.
The raw=trueparameter yang ada untuk memastikan gambar yang link ke, akan diberikan seperti. Itu berarti bahwa hanya gambar yang akan ditautkan, bukan seluruh antarmuka GitHub untuk file tersebut. Lihat komentar ini untuk lebih jelasnya.
Yah, saya menambahkan dokumen resmi pada tautan relatif, tetapi saya tidak dapat menemukan beberapa repo yang menggunakannya, jika Anda memiliki saran, saya akan dengan senang hati membantu karena seluruh poinnya adalah membantu lebih banyak orang, tidak tinggal dalam ruang lingkup (kesalahan saya di sini).
Ketika Anda mengatakan /relative/path/to/img.jpg, bukankah itu jalur absolut karena garis miring utama?
jww
1
@kelvin, raw=trueparameternya ada untuk membuat gambar yang ditunjuk jalur GitHub, bukan antarmuka GitHub. Coba dan lihat perbedaannya: github.com/altercation/solarized/blob/master/img/… vs github.com/altercation/solarized/blob/master/img/… . URL pertama akan menampilkan antarmuka GitHub dan gambar, sedangkan URL kedua hanya menampilkan gambar. Tautan relatif masih berguna saat kloning / forking repo, jadi ya Anda harus menggunakan jalur relatif dengan parameter itu, tetapi mereka adalah dua konsep yang berbeda.
Paul
70
Meskipun sudah ada jawaban yang diterima, saya ingin menambahkan cara lain untuk mengunggah gambar ke readme di GitHub.
Anda perlu membuat masalah di repo Anda
Seret dan lepas di area komentar gambar Anda
Setelah tautan untuk gambar dibuat, masukkan ke readme Anda
Saya tertarik berapa lama gambar ini dimuat akan hidup. Apakah github melakukan pembersihan beberapa gambar? Seperti, "jika gambar ini tidak dirujuk dari masalah github, saya dapat menghapusnya dengan aman" ...
artin
1
@Artin mungkin hanya ketika masalah dihapus sepenuhnya. Masalah tertutup bertahan selamanya karena mereka memainkan peran yang sangat penting dalam dokumentasi dan debugging
andrhamm
55
Saya menemukan bahwa jalur ke gambar di repo saya tidak cukup, saya harus menautkan ke gambar di raw.github.comsubdomain.
Format URL https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}
Contoh penurunan harga ![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)
Downvoting ini karena komentar @sorens pada jawaban yang diterima. Adalah buruk untuk menentukan bak mandi absolut karena itu tidak akan bekerja dengan baik pada repositori bercabang. (Atau jika Anda mengganti nama repo, atau jika github mengubah nama domain, dll.)
Linus Unnebäck
7
@ LinusUnnebäck: Ada satu alasan bagus untuk menggunakan path absolut imho: Jika readme.md digunakan di tempat lain juga, misalnya, sebagai halaman utama Doxygen. Tautan relatif tidak akan berfungsi saat itu.
Ela782
1
@ Ela782 meskipun, pada catatan lebih lanjut, itu seharusnya tidak menjadi masalah untuk perangkat lunak yang merobek file README khusus dari GitHub ; perangkat lunak tersebut harus tahu untuk menyelesaikan URL relatif dengan benar. npm tidak , misalnya.
Mark Amery
cara menautkan ke gambar di raw.github.comsubdomain? tempat mengunggah file gambar?
Saif
@Saif raw.github.com hanyalah cerminan dari apa yang dilakukan pada repositori github Anda. Cukup komit gambar ke repositori Anda dan ikuti format URL yang ditentukan.
-1 untuk alasan yang diberikan oleh @ shaobin0604; dokumen resmi merekomendasikan penggunaan tautan relatif ketika menautkan ke file dalam repo Anda sendiri, sehingga tautan tersebut menunjuk ke tempat yang tepat ketika bercabang dua.
Mark Amery
17
Sintaks markdown untuk menampilkan gambar memang:
![image](https://{url})
TAPI: Bagaimana cara menyediakannya url?
Anda mungkin tidak ingin mengacaukan repo Anda dengan tangkapan layar, itu tidak ada hubungannya dengan kode
Anda mungkin tidak ingin berurusan dengan kerumitan membuat gambar Anda tersedia di web ... (unggah ke server ...).
Jadi ... Anda dapat menggunakan trik luar biasa ini untuk menjadikan github meng-host file gambar Anda. TDLR:
buat masalah pada daftar masalah repo Anda
seret dan lepas tangkapan layar Anda tentang masalah ini
salin kode penurunan harga yang baru saja dibuat github agar Anda dapat menampilkan gambar Anda
tempel di readme Anda (atau di mana pun Anda inginkan)
Tambahkan gambar dengan drag and drop atau dengan pemilih file
Kemudian salin sumber gambar
Sekarang tambahkan ![Screenshot](http://url/to/img.png)ke file README.md Anda
Selesai!
Atau Anda dapat menggunakan beberapa situs hosting gambar seperti imgurdan mendapatkan url dan menambahkannya dalam file README.md Anda atau Anda dapat menggunakan beberapa hosting file statis juga.
Pertama, buat direktori (folder) di root repo lokal Anda yang akan berisi yang screenshotsingin Anda tambahkan. Sebut nama direktori ini screenshots. Tempatkan gambar (JPEG, PNG, GIF, `dll) yang ingin Anda tambahkan ke direktori ini.
Kedua, Anda perlu menambahkan tautan ke setiap gambar ke dalam README Anda. Jadi, jika saya memiliki nama gambar 1_ArtistsActivity.pngdan 2_AlbumsActivity.pngdalam direktori screenshot saya, saya akan menambahkan tautannya seperti ini:
Jika Anda ingin setiap tangkapan layar pada baris yang terpisah, tulis tautannya pada baris yang berbeda. Namun, lebih baik jika Anda menulis semua tautan dalam satu baris, hanya dipisahkan oleh spasi. Ini mungkin sebenarnya tidak terlihat terlalu bagus tetapi dengan melakukannya GitHub secara otomatis mengaturnya untuk Anda.
Anda harus menyelesaikan pergantian yang sebenarnya di atas (mis. MY_IMAGE = image.jpg) agar ini berfungsi.
Tapi, tunggu ... gagal - tidak ada foto yang diberikan sebenarnya! Dan tautannya persis seperti yang diberikan oleh Google Storage!
Github camo- Gambar Anonim
Github meng-host gambar Anda secara anonim , ya! Namun, ini menyajikan masalah untuk aset penyimpanan Google. Anda perlu mendapatkan url yang dihasilkan dari Google Cloud Console Anda.
Saya yakin ada cara yang lebih halus, namun, cukup kunjungi titik akhir URL yang Anda berikan dan salin URL yang panjang. Detail:
FYI - Tampaknya ada sesuatu yang berubah di Google atau Github. Saya memiliki beberapa gambar dalam README yang gagal melalui metode ini, dan beberapa bekerja pada sore hari 28 Maret 2020. YMMV di sini!
Jason R Stevens CFA
0
Bagi saya cara terbaik adalah -
Buat masalah baru dengan repositori itu di github dan kemudian unggah file dalam format gif. Untuk mengonversi file video ke format gif, Anda dapat menggunakan situs web ini http://www.online-convert.com/
Kirim masalah yang baru dibuat.
Salin alamat file yang diunggah
Akhirnya di file README Anda, pasang! [Demo] (ALAMAT YANG DI COPI)
Dengan gambar-gambar yang terletak di /screen-shotsdirektori. Bagian luar <div>memungkinkan gambar diposisikan. Padding dicapai dengan menggunakan <img width="desired-padding" height="0">.
[Read more words!](docs/more_words.md)
Jawaban:
Jika Anda menggunakan Markdown (README.md):
Asalkan Anda memiliki gambar di repo Anda, Anda dapat menggunakan URL relatif:
Jika Anda perlu menyematkan gambar yang dihosting di tempat lain, Anda dapat menggunakan URL lengkap
GitHub merekomendasikan Anda menggunakan tautan relatif dengan
?raw=true
parameter untuk memastikan titik reposisi bercabang dengan benar.The
raw=true
parameter yang ada untuk memastikan gambar yang link ke, akan diberikan seperti. Itu berarti bahwa hanya gambar yang akan ditautkan, bukan seluruh antarmuka GitHub untuk file tersebut. Lihat komentar ini untuk lebih jelasnya.Lihatlah sebuah contoh: https://raw.github.com/altercation/solarized/master/README.md
Jika Anda menggunakan SVGs maka Anda harus mengatur atribut membersihkan untuk
true
juga:?raw=true&sanitize=true
. (Terima kasih @EliSherer)Juga, dokumentasi tentang tautan relatif dalam file README: https://help.github.com/articles/relative-links-in-readmes
Dan tentu saja dokumen penurunan harga: http://daringfireball.net/projects/markdown/syntax
Selain itu, jika Anda membuat cabang baru
screenshots
untuk menyimpan gambar, Anda bisa menghindarinya berada dimaster
pohon kerjaAnda dapat menanamkannya menggunakan:
sumber
/relative/path/to/img.jpg
, bukankah itu jalur absolut karena garis miring utama?raw=true
parameternya ada untuk membuat gambar yang ditunjuk jalur GitHub, bukan antarmuka GitHub. Coba dan lihat perbedaannya: github.com/altercation/solarized/blob/master/img/… vs github.com/altercation/solarized/blob/master/img/… . URL pertama akan menampilkan antarmuka GitHub dan gambar, sedangkan URL kedua hanya menampilkan gambar. Tautan relatif masih berguna saat kloning / forking repo, jadi ya Anda harus menggunakan jalur relatif dengan parameter itu, tetapi mereka adalah dua konsep yang berbeda.Meskipun sudah ada jawaban yang diterima, saya ingin menambahkan cara lain untuk mengunggah gambar ke readme di GitHub.
Lebih detail bisa Anda temukan di sini
sumber
Saya menemukan bahwa jalur ke gambar di repo saya tidak cukup, saya harus menautkan ke gambar di
raw.github.com
subdomain.Format URL
https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}
Contoh penurunan harga
![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)
sumber
raw.github.com
subdomain? tempat mengunggah file gambar?sumber
Satu baris di bawah ini adalah apa yang Anda cari
jika file Anda di repositori
jika file Anda ada di url eksternal lain
sumber
Sintaks markdown untuk menampilkan gambar memang:
TAPI: Bagaimana cara menyediakannya
url
?Jadi ... Anda dapat menggunakan trik luar biasa ini untuk menjadikan github meng-host file gambar Anda. TDLR:
http://solutionoptimist.com/2013/12/28/awesome-github-tricks/
sumber
Jauh lebih sederhana daripada menambahkan URL. Cukup unggah gambar ke repositori yang sama, seperti:
![Screenshot](screenshot.png)
sumber
tambahkan ini ke README
sumber
Penurunan harga:
![Screenshot](http://url/to/img.png)
Kemudian salin sumber gambar
Sekarang tambahkan
![Screenshot](http://url/to/img.png)
ke file README.md AndaSelesai!
Atau Anda dapat menggunakan beberapa situs hosting gambar seperti
imgur
dan mendapatkan url dan menambahkannya dalam file README.md Anda atau Anda dapat menggunakan beberapa hosting file statis juga.Masalah sampel
sumber
Metode 1-> Cara penurunan harga
Metode 2-> Cara HTML
atau
Catatan -> Jika Anda tidak ingin menata gambar, mis. Mengubah ukuran, hapus bagian gaya
sumber
Pertama, buat direktori (folder) di root repo lokal Anda yang akan berisi yang
screenshots
ingin Anda tambahkan. Sebut nama direktori iniscreenshots
. Tempatkan gambar (JPEG, PNG, GIF, `dll) yang ingin Anda tambahkan ke direktori ini.Tangkapan Layar Android Studio Workspace
Kedua, Anda perlu menambahkan tautan ke setiap gambar ke dalam README Anda. Jadi, jika saya memiliki nama gambar
1_ArtistsActivity.png
dan2_AlbumsActivity.png
dalam direktori screenshot saya, saya akan menambahkan tautannya seperti ini:Jika Anda ingin setiap tangkapan layar pada baris yang terpisah, tulis tautannya pada baris yang berbeda. Namun, lebih baik jika Anda menulis semua tautan dalam satu baris, hanya dipisahkan oleh spasi. Ini mungkin sebenarnya tidak terlihat terlalu bagus tetapi dengan melakukannya GitHub secara otomatis mengaturnya untuk Anda.
Akhirnya, komit perubahan Anda dan dorong!
sumber
Saya mencari beberapa pertanyaan serupa di Google dan tidak melihat jawaban atas masalah saya dan solusi yang cukup sederhana / mudah.
Google Cloud Storage - pendekatan yang sedikit berbeda untuk gambar di READMEs
Begini: seperti OP, saya ingin gambar di Github README saya, dan, mengetahui sintaks Markdown untuk melakukannya, ketikkan:
Anda harus menyelesaikan pergantian yang sebenarnya di atas (mis. MY_IMAGE = image.jpg) agar ini berfungsi.
Github
camo
- Gambar AnonimGithub meng-host gambar Anda secara anonim , ya! Namun, ini menyajikan masalah untuk aset penyimpanan Google. Anda perlu mendapatkan url yang dihasilkan dari Google Cloud Console Anda.
Saya yakin ada cara yang lebih halus, namun, cukup kunjungi titik akhir URL yang Anda berikan dan salin URL yang panjang. Detail:
Instruksi
https
tidakgs
) ke tab / jendela browser baruSemoga ini membantu mempercepat dan memperjelas masalah ini untuk orang lain.
sumber
Bagi saya cara terbaik adalah -
Semoga ini bisa membantu.
sumber
Tambahkan gambar dalam repositori dari opsi unggah file kemudian dalam file README
sumber
Dengan gambar-gambar yang terletak di
/screen-shots
direktori. Bagian luar<div>
memungkinkan gambar diposisikan. Padding dicapai dengan menggunakan<img width="desired-padding" height="0">
.sumber