GitHub deposundaki README dosyasına bir ekran görüntüsü yerleştirmek mümkün müdür? Sözdizimi nedir?
GitHub deposundaki README dosyasına bir ekran görüntüsü yerleştirmek mümkün müdür? Sözdizimi nedir?
Yanıtlar:
Markdown (README.md) kullanıyorsanız:
Reponuzda resim olması koşuluyla, göreli bir URL kullanabilirsiniz:
![Alt text](/relative/path/to/img.jpg?raw=true "Optional Title")
Başka bir yerde barındırılan bir resmi yerleştirmeniz gerekiyorsa, tam bir URL kullanabilirsiniz
![Alt text](http://full/path/to/img.jpg "Optional title")
GitHub , çatallı depoların doğru bir şekilde işaretlenmesini sağlamak için parametre ile göreli bağlantılar kullanmanızı önerir ?raw=true
.
raw=true
Parametre bağlanmak görüntüyü sağlamak amacıyla, orada olduğu gibi görüntüleniyor. Bu, söz konusu dosya için tüm GitHub arayüzüne değil, yalnızca görüntüye bağlanılacağı anlamına gelir. Daha fazla ayrıntı için bu yoruma bakın.
Bir örneği inceleyin: https://raw.github.com/altercation/solarized/master/README.md
Eğer SVG lezyonu kullanırsanız o zaman için sterilize özelliğini ayarlamak gerekir true
yanı: ?raw=true&sanitize=true
. (Teşekkürler @EliSherer)
Ayrıca, README dosyalarındaki göreli bağlantılar hakkındaki belgeler: https://help.github.com/articles/relative-links-in-readmes
Ve elbette markdown belgeleri: http://daringfireball.net/projects/markdown/syntax
Ayrıca, screenshots
görüntüleri saklamak için yeni bir dal oluşturursanız , master
çalışma ağacında olmalarını önleyebilirsiniz
Daha sonra bunları kullanarak gömebilirsiniz:
![Alt text](/../<branch name>/path/to/image.png?raw=true "Optional Title")
/relative/path/to/img.jpg
, bu eğik çizgi nedeniyle mutlak bir yol değil mi?
raw=true
parametre GitHub arabirimini değil, GitHub yolunun işaret ettiği görüntüyü oluşturmak için vardır. Farkı deneyin ve görün: github.com/altercation/solarized/blob/master/img/… vs github.com/altercation/solarized/blob/master/img/… . İlk URL size GitHub arayüzünü ve resmi, ikincisi ise yalnızca resmi gösterir. Depoları klonlarken / çatallarken göreli bağlantılar hala yararlıdır, bu nedenle evet bu parametreyle göreli yollar kullanmalısınız, ancak bunlar iki farklı kavramdır.
Kabul edilmiş bir cevap olmasına rağmen GitHub'da benioku görüntülerini yüklemek için başka bir yol eklemek istiyorum.
Daha fazla ayrıntıyı burada bulabilirsiniz
Repo'mdaki görüntüye giden yolun yeterli olmadığını, raw.github.com
alt alandaki görüntüye bağlanmak zorunda olduğumu fark ettim .
URL biçimi https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}
Markdown örneği ![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)
raw.github.com
alt alandaki resme nasıl bağlanır? görüntü dosyası nereye yüklenir?
Aşağıdaki satırlardan biri aradığınız şey olmalıdır
dosyanız depodaysa
![ScreenShot](https://raw.github.com/{username}/{repository}/{branch}/{path})
dosyanız başka bir harici URL'de ise
![ScreenShot](https://{url})
Görüntüleri görüntülemek için kullanılan işaretleme sözdizimi aslında:
![image](https://{url})
AMA: Nasıl sağlanır url
?
Yani ... bu harika numarayı kullanabilirsiniz github'u görüntü dosyanızı barındırmak için . TDLR:
http://solutionoptimist.com/2013/12/28/awesome-github-tricks/
URL eklemekten çok daha basit Aynı depoya bir resim yükleyin, örneğin:
![Screenshot](screenshot.png)
bunu README'ye ekle
<div align="center">
<img src="/screenshots/screen1.jpg" width="400px"</img>
</div>
Markdown: ![Screenshot](http://url/to/img.png)
Ardından görüntü kaynağını kopyalayın
Şimdi ![Screenshot](http://url/to/img.png)
README.md dosyanıza ekleyin
Bitti!
Alternatif olarak bazı görüntü barındırma sitelerini kullanabilir imgur
ve URL'sini alıp README.md dosyanıza ekleyebilirsiniz ya da bazı statik dosya barındırma da kullanabilirsiniz.
Yöntem 1-> İşaretleme yolu
![Alt Text](https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH})
Yöntem 2-> HTML yolu
<img src="https://link(format same as above)" width="100" height="100"/>
veya
<img src="https://link" style=" width:100px ; height:100px " />
Not -> Resminizi şekillendirmek istemiyorsanız, örneğin yeniden boyutlandırın stil parçasını kaldırın
İlk olarak, yerel repo dosyanızın kökünde screenshots
eklenmesini istediğiniz dizini (klasör) oluşturun . Bu dizinin adını çağıralım screenshots
. Bu dizine eklemek istediğiniz görüntüleri (JPEG, PNG, GIF, `vb.) Yerleştirin.
Android Studio Çalışma Alanı Ekran Görüntüsü
İkinci olarak, her resme README'nize bir bağlantı eklemeniz gerekir. Bu nedenle, adlandırılmış görüntülerim varsa 1_ArtistsActivity.png
ve 2_AlbumsActivity.png
ekran görüntüleri dizinimde, bağlantılarını şöyle ekleyeceğim:
<img src="screenshots/1_ArtistsActivity.png" height="400" alt="Screenshot"/> <img src=“screenshots/2_AlbumsActivity.png" height="400" alt="Screenshot"/>
Her ekran görüntüsünü ayrı bir satıra istiyorsanız bağlantılarını ayrı satırlara yazın. Ancak, tüm bağlantıları yalnızca boşlukla ayrılmış bir satırda yazarsanız daha iyi olur. Aslında çok iyi görünmeyebilir, ancak bunu yaparak GitHub bunları sizin için otomatik olarak düzenler.
Son olarak, değişikliklerinizi yapın ve itin!
Birkaç benzer soruyu araştırdım ve sorunumla ve oldukça basit / kolay çözümü ile herhangi bir cevap görmedim.
İşte gidiyor: OP gibi, Github README'mde bir görüntü istedim ve Markdown sözdizimini bilerek bunu yazdım:
![My Image](https://storage.cloud.google.com/${MY_BUCKET}/${MY_IMAGE}
Bunun çalışması için yukarıdaki gerçek değişiklikleri (örn. MY_IMAGE = image.jpg) tamamlamanız gerekir.
Ancak, bekleyin ... başarısızlık - gerçek bir fotoğraf yok! Ve bağlantı tam olarak Google Storage tarafından verildiği gibidir!
camo
- İsimsiz GörüntülerGithub resimlerinizi anonim olarak barındırıyor , yay! Ancak bu, Google depolama öğeleri için bir sorun oluşturur. Oluşturulan URL'yi Google Cloud Konsolunuzdan almanız gerekir.
Daha yumuşak bir yol olduğundan eminim, ancak verilen URL uç noktanızı ziyaret edin ve uzun URL'yi kopyalayın. Detaylar:
https
değil gs
) yeni bir tarayıcı sekmesine / penceresine kopyalayınUmarım bu, bu sorunu herkes için hızlandırmaya ve açıklığa kavuşturmaya yardımcı olur.
Bana göre en iyi yol -
Umarım bu yardımcı olur.
Dosyayı karşıya yükleme seçeneğinden depoya resim ve ardından README dosyasına ekleyin
![Alt text]("enter image url of repositoryhere")
Görüntüler /screen-shots
dizinde bulunur. Dış <div>
kısım, görüntülerin konumlandırılmasını sağlar. Dolgu kullanılarak elde edilir <img width="desired-padding" height="0">
.
<div align="center">
<img width="45%" src="screen-shots/about.PNG" alt="About screen" title="About screen"</img>
<img height="0" width="8px">
<img width="45%" src="screen-shots/list.PNG" alt="List screen" title="List screen"></img>
</div>
[Read more words!](docs/more_words.md)