Görüntüleri bir GitHub wiki (gollum) deposuna mı gömmek?

Github wiki'leri ayrı bir git deposu ve ardından ana proje deposu tarafından desteklenir.

Github ekibi tarafından yapılan bu gönderi , wiki biçimlendirmesi içindeki wiki deposunda depolanan resimlere bağlanabilmeniz gerektiği gibi görünmesini sağlıyor.

Resimler ve Klasörler

Artık Git deposunda barındırılan görüntülere başvurabilirsiniz.

Vikimin deposunu kontrol ettim ve içine bir kaynak klasörü ve bir resim gönderdim. Sorum şu, bu resmi kullanmaya nasıl başlayacağım ?

Bu mümkün mü yoksa bir şeyi yanlış mı anladım?

Göreli yolları kullanmak için şunları yapın:

[[foo.jpg]]

Daha fazla bilgi için, demo wiki'nin resimler sayfasına bakın .

Resimleri bir github wiki'de görüntülemek isteyen izleyiciler için çalışmak için aşağıdaki yöntemi buldum:

• Deponuzun wiki sayfasındaki "Git Erişimi" sekmesine gidin ve şu şekilde olması gereken SSH yolunu alın: git@github.com: USER / REPO.wiki.git burada USER, hesap adınız ve REPO ise depo adı.

• Yerel makinenizde, seçtiğiniz yerel dizine cd yapmak istediğiniz Git komut satırı aracını kullanın ve depoyu şu yolla alın:

  git clone git@github.com: KULLANICI / REPO.wiki.git

• Şimdi bu arşivde bir resim dizini oluşturun, ona "resimler" diyeceğim ve dizine istediğiniz resimleri koyacağım

• Ve sonra git wiki dizininizi github'a itin

• Örneğin "Sayfalar" sekmesindeki resimleri fiziksel olarak göremezsiniz, ancak yalnızca yerel bir bağlantıdaki resimlere atıfta bulunursanız, onları görebilmeniz gerekir. Markdown ile aşağıdaki örnek:

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

• Ayrıca, aşağıdaki gibi daha fazla kaydırarak görseli bir bağlantı olarak da gömebilirsiniz:

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

Ayrıca "sayfalar" sekmesi onları listelediğinden, wiki'yi düzenlemeye yardımcı olmak için yerel kopyanıza alt dizinler de ekleyebilirsiniz. Ancak, yeni dizine basıldığında bile "sayfalar" sekmesinin dizini listelemediğini unutmayın.

Bir resim eklerken yanıtların hiçbiri işe yaramıyor gibi görünüyor readme.md. Yine de bir çözümüm var:

Resmin URL'si ise:

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

Değiştirme blobile rawsize ham resmin URL'sini verir:

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

Şimdi, resmi normal işaretlemeyi kullanarak gömeceksiniz:

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

GÜNCELLEME: Şu an itibariyle GitHub, farklı bir alt etki alanından ham görüntüler de sunmaktadır raw.github.com. Yani şunları da kullanabilirsiniz:

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

MİSAL: https://raw.github.com/Automattic/liveblog/master/screenshot-1.png

Göreceli yol benim için şu şekilde çalışır:

wiki'nin ana sayfası:

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

wiki'nin alt sayfası:

![text](images/someimage.png)

Önizleme yaparken görüntünün gösterilmeyeceğini, onu kaydetmiş olduğumu unutmayın.

Sürükle / bırak ile hızlı bir şekilde bir görüntü yüklemek istiyorsanız, aşağıdakileri gerçekleştirebilirsiniz (bilgisayar korsanlığı da olsa):

Sahte bir sorun oluşturun; resminizi oraya sürükleyip bırakın; yüklenen markdown resim kodunu wiki'nize kopyalayın / yapıştırın;

Sorunu bir kez oluşturduktan sonra, bunu yapmak için istediğiniz kadar kullanabilirsiniz.

Umarım bu, görüntünün depoda bulunmasına gerek kalmadan hızlı bir düzeltme arayan herkese yardımcı olur.

İşte bunu yapmanın pratik bir yolu:

• GitHub'da herhangi bir soruna git
• Yorum bölümünde dosya ekleyebilir, sadece sürükleyip bırakabilir, resminizi seçebilir veya yapıştırabilirsiniz.
• Metin alanında görüntülenen kodu / bağlantıyı kopyalayın
• Wiki'ye yapıştırın
• Kar!

@Tiby çözümüne kıyasla herhangi bir sorunu oluşturmanız veya değiştirmeniz bile gerekmez!

Anladım.

URL aşağıdaki gibi biçimlendirilmiştir

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

pathtoimage İsteğe bağlı

James'in URL formatı benim için çalışmadı, belki değiştirildi. Kullandım:

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

pathtoimageİsteğe bağlı nerede .

Sonunda görüntüleri nerdwin tarafından açıklanan yöntemi kullanarak depoya aldım ve kullanarak wiki'de görüntülenmelerini sağladı. ![test](test.jpg)

Aşağıdaki markdown sizin GitHub bir resim başvuracağı repo sizin tekabül GitHub içinden wiki

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

Yukarıdaki örnek, deponuzda aşağıdaki dosya yapısına sahip olduğunuzu varsayar

• Yol
  • ToAssets
    • İçinde
      • Repo.png

Gerçek bir dünya örneği için, bu görüntüyü github'da ilgili wiki'den referans almak isteseydim , bu markdown'ı kullanırdım.

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

Uyarılar

1. Vaka önemlidir
2. Eğer wikinin özel Ana sayfasındaysanız, ../ ile bir seviyeye çıkmanıza gerek yoktur. Yukarıdaki örneğimde, doğru bağlantı

Ana Sayfa İçin:

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

Göreli yolu kullanın

Wiki şu adreste bulunur: [repositoryname]/wiki

Depodaki dosyalar şu adreste bulunur: [repositoryname]/raw/master/[file path in repository]

Bu nedenle, göreli yolu kullanın: ../raw/master/[file path in repository]

Hem görüntüleri hem de PDF'leri wikilerime koydum. Wiki'yi klonladım ve bir imagesve bir ekledimfiles dizin ekledim, ardından görüntü bağlantılarını gömmek ve dosya bağlantıları eklemek için aşağıdaki işaretlemeyi kullanıyorum:

Görüntüler:

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

Viki sayfalarınızın tümü kök düzeyindeyse baştaki eğik çizgi gerekli değildir, ancak alt dizinler kullanıyorum ve mutlak bir yol doğru şekilde çözülür ve işleri basitleştirir.

Dosyalar:

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

Not, wiki için eğik çizgi yok filesBu formatta bir bağlantı olarak doğru bir şekilde çözümlenmesi yolunun .

Bunu bir GitHub özetinde daha ayrıntılı olarak belgeledim

Harici bir görüntünün küçük resmini gömmek için aşağıdakileri kullanın, ![Image](<external link to the image>)

@ Drew Noakes'tan orijinal soruya yapılan yorum bunu benim için yaptı:

Gösterilmesini istediğim görüntünün sözdizimi:

[[/images/imageName.png]]

Bu resim yalnızca yeniden adlandırılırken görüntülendi:

wikiPage.md --> wikiPage.wiki

Wiki havuzunda aşağıdaki klasör yapısı kullanılmıştır:

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

FAKAT:

.Wiki'deki sözdizimi .md dosyalarından farklıdır.

Cevapların çoğu benim için işe yaramadı, işte sonunda işe yarayan şey:

![](../raw/master/Images/ImportantImage.png)

"Markdown" düzenleyici modunu ve aşağıdaki gibi bir alt sayfayı kullanma:

https://github.com/project/repo/wiki/MyPage

-John