Prawidłowym rozwiązaniem tego jest użycie referencji względnych, zgodnie z tą odpowiedzią stackoverflow.com/a/11916467/1633251 (zobacz komentarz z łączem do nowego dokumentu github na temat tego, jak to zrobić). Odpowiedź jest krótka do użytku[Read more words!](docs/more_words.md)
David H
2
Większość rozwiązań wskazuje na samo repozytorium. Co jeśli chcesz uniknąć plików binarnych w repozytorium (nawet w oddzielnej gałęzi, zgodnie z propozycją) i chcesz przechowywać go w miejscu zewnętrznym? Jakieś dobre praktyki? Może istota (IDK, jeśli istota może być binarna lub tylko tekstowa)? tworzysz kolejne repozytorium „myproject-resources” dla projektu „myproject”? Jakieś zewnętrzne popularne miejsce na zdjęcia podobne do faktycznego standardu YouTube do przesyłania filmów?
GitHub zaleca używanie łączy względnych z ?raw=trueparametrem, aby zapewnić rozwidlenie punktu repos.
Ten raw=trueparametr służy do zapewnienia, że obraz, do którego prowadzi łącze, będzie renderowany w takiej postaci, w jakiej jest. Oznacza to, że tylko obraz zostanie połączony, a nie cały interfejs GitHub dla tego odpowiedniego pliku. Zobacz ten komentarz, aby uzyskać więcej informacji.
Cóż, dodałem oficjalne dokumenty dotyczące linków względnych, ale nie jestem w stanie znaleźć repozytorium, które ich użyje, jeśli masz sugestie, chętnie pomogę, ponieważ cały punkt pomaga większej liczbie osób, a nie pozostaje w zasięgu (mój błąd tutaj).
Kiedy mówisz /relative/path/to/img.jpg, czy nie jest to absolutna ścieżka z powodu wiodącego cięcia?
JWW
1
@kelvin, raw=trueparametr służy do renderowania obrazu, na który wskazuje ścieżka GitHub, a nie interfejsu GitHub. Spróbuj i zobacz różnicę: github.com/altercation/solarized/blob/master/img/... vs github.com/altercation/solarized/blob/master/img/... . Pierwszy adres URL pokazuje interfejs GitHub i obraz, a drugi pokazuje tylko obraz. Względne linki są nadal przydatne podczas klonowania / tworzenia repozytoriów, więc tak, powinieneś używać ścieżek względnych z tym parametrem, ale są to dwie różne koncepcje.
Paul
70
Mimo że istnieje już akceptowana odpowiedź, chciałbym dodać inny sposób przesyłania zdjęć do pliku readme na GitHub.
Musisz stworzyć problem w swoim repozytorium
Przeciągnij i upuść w polu komentarza swój obraz
Po wygenerowaniu linku do obrazu wstaw go do pliku readme
Interesuje mnie, jak długo będą ładowane obrazy załadowane w ten sposób. Czy github wykonuje czyszczenie niektórych obrazów? Na przykład: „jeśli do tego obrazu nie odwołuje się żaden problem z githubem, mogę go bezpiecznie usunąć” ...
artin
1
@Artin prawdopodobnie tylko wtedy, gdy problem zostanie całkowicie usunięty. Zamknięte problemy
trwają na
55
Odkryłem, że ścieżka do obrazu w moim repozytorium nie była wystarczająca, musiałem połączyć się z obrazem w raw.github.comsubdomenie.
Format adresu URL https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}
Przykład obniżki cen ![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)
Głosowanie w dół z powodu komentarza @sorens do zaakceptowanej odpowiedzi. Określenie kąpieli bezwzględnej jest złe, ponieważ nie będzie dobrze działać na rozwidlonych repozytoriach. (Lub jeśli zmienisz nazwę swojego repo lub jeśli github zmieni nazwę domeny itp.)
Linus Unnebäck
7
@ LinusUnnebäck: Jest jeden dobry powód, aby używać ścieżek bezwzględnych imho: Jeśli readme.md jest używany również w innych miejscach, na przykład jako strona główna Doxygen. Względne linki nie będą wtedy działać.
Ela782,
1
@ Ela782, chociaż, z drugiej strony, nie powinno to stanowić problemu dla oprogramowania, które zgrywa pliki README specjalnie z GitHub ; takie oprogramowanie powinno wiedzieć, jak poprawnie rozwiązywać względne adresy URL. npm robi .
Mark Amery
jak link do obrazu w raw.github.comsubdomenie? gdzie przesłać plik obrazu?
Saif
@ Saif raw.github.com to tylko odzwierciedlenie tego, co jest zaangażowane w Twoje repozytorium github. Po prostu prześlij obraz do swojego repozytorium i postępuj zgodnie z określonym formatem adresu URL.
-1 z powodu podanego przez @ shaobin0604; oficjalni doktorzy zalecają używanie linków względnych podczas łączenia z plikiem we własnym repozytorium, aby po rozwidleniu link wskazywał właściwe miejsce.
Mark Amery
17
Składnia przeceny do wyświetlania obrazów jest w rzeczywistości:
![image](https://{url})
ALE: Jak zapewnić url?
Prawdopodobnie nie chcesz zaśmiecać repozytorium zrzutami ekranu, nie mają one nic wspólnego z kodem
możesz nie chcieć radzić sobie z kłopotami związanymi z udostępnianiem obrazu w Internecie ... (prześlij go na serwer ...).
Więc ... możesz użyć tej niesamowitej sztuczki, aby github hostował twój plik obrazu. TDLR:
utwórz problem na liście problemów swojego repozytorium
przeciągnij i upuść zrzut ekranu dotyczący tego problemu
skopiuj kod rabatowy, który właśnie utworzył github, aby wyświetlić obraz
Najpierw utwórz katalog (folder) w katalogu głównym lokalnego repozytorium, który będzie zawierać screenshotsżądany dodatek. Nazwijmy ten katalog screenshots. Umieść obrazy (JPEG, PNG, GIF, `itp.), Które chcesz dodać do tego katalogu.
Po drugie, musisz dodać link do każdego obrazu do swojego README. Więc jeśli mam obrazy o nazwach 1_ArtistsActivity.pngi 2_AlbumsActivity.pngw moim katalogu zrzutów ekranu, dodam ich linki w następujący sposób:
Jeśli chcesz, aby każdy zrzut ekranu znajdował się w osobnej linii, napisz ich linki w osobnych liniach. Lepiej jest jednak napisać wszystkie linki w jednym wierszu, oddzielone tylko spacją. Może nie wygląda to zbyt dobrze, ale dzięki temu GitHub automatycznie zaaranżuje je dla Ciebie.
Aby to zadziałało, musisz wypełnić powyższe faktyczne podstawienia (np. MY_IMAGE = image.jpg).
Ale czekaj ... porażka - nie ma faktycznie renderowanego zdjęcia! Link jest dokładnie taki, jak podany przez Google Storage!
Github camo- Anonimowe obrazy
Github hostuje twoje zdjęcia anonimowo , tak! Stanowi to jednak problem dla zasobów pamięci masowej Google. Musisz pobrać wygenerowany adres URL z konsoli Google Cloud.
Jestem pewien, że istnieje płynniejszy sposób, po prostu odwiedź podany punkt końcowy adresu URL i skopiuj długi adres URL. Detale:
FYI - Wygląda na to, że coś się zmienia po stronie Google lub Github. Miałem kilka obrazów w README, które zawiodły przy użyciu tej metody, a niektóre działały od popołudnia 28 marca 2020 r. Tutaj YMMV!
Jason R. Stevens CFA
0
Dla mnie najlepszym sposobem jest -
Utwórz nowy problem z tym repozytorium na github, a następnie prześlij plik w formacie gif. Aby przekonwertować pliki wideo na format gif, możesz skorzystać z tej witryny http://www.online-convert.com/
Prześlij nowo utworzony problem.
Skopiuj adres przesłanego pliku
Wreszcie w pliku README umieść! [Demo] (COPIED ADDRESS)
Z obrazami znajdującymi się w /screen-shotskatalogu. Zewnętrzne <div>pozwala na ustawienie obrazów. Wypełnienie uzyskuje się za pomocą <img width="desired-padding" height="0">.
[Read more words!](docs/more_words.md)
Odpowiedzi:
Jeśli używasz Markdown (README.md):
Pod warunkiem, że masz obraz w swoim repozytorium, możesz użyć względnego adresu URL:
Jeśli chcesz osadzić obraz hostowany w innym miejscu, możesz użyć pełnego adresu URL
GitHub zaleca używanie łączy względnych z
?raw=true
parametrem, aby zapewnić rozwidlenie punktu repos.Ten
raw=true
parametr służy do zapewnienia, że obraz, do którego prowadzi łącze, będzie renderowany w takiej postaci, w jakiej jest. Oznacza to, że tylko obraz zostanie połączony, a nie cały interfejs GitHub dla tego odpowiedniego pliku. Zobacz ten komentarz, aby uzyskać więcej informacji.Sprawdź przykład: https://raw.github.com/altercation/solarized/master/README.md
Jeśli używasz pomostów żylnych wtedy trzeba ustawić atrybut do dezynfekcji
true
, a także:?raw=true&sanitize=true
. (Dzięki @EliSherer)Ponadto dokumentacja dotycząca odnośników względnych w plikach README: https://help.github.com/articles/relative-links-in-readmes
I oczywiście dokumenty Markdown: http://daringfireball.net/projects/markdown/syntax
Dodatkowo, jeśli utworzyć nowy oddział
screenshots
do przechowywania obrazów można uniknąć ich będąc wmaster
drzewie pracyMożesz je następnie osadzić, używając:
źródło
/relative/path/to/img.jpg
, czy nie jest to absolutna ścieżka z powodu wiodącego cięcia?raw=true
parametr służy do renderowania obrazu, na który wskazuje ścieżka GitHub, a nie interfejsu GitHub. Spróbuj i zobacz różnicę: github.com/altercation/solarized/blob/master/img/... vs github.com/altercation/solarized/blob/master/img/... . Pierwszy adres URL pokazuje interfejs GitHub i obraz, a drugi pokazuje tylko obraz. Względne linki są nadal przydatne podczas klonowania / tworzenia repozytoriów, więc tak, powinieneś używać ścieżek względnych z tym parametrem, ale są to dwie różne koncepcje.Mimo że istnieje już akceptowana odpowiedź, chciałbym dodać inny sposób przesyłania zdjęć do pliku readme na GitHub.
Więcej informacji można znaleźć tutaj
źródło
Odkryłem, że ścieżka do obrazu w moim repozytorium nie była wystarczająca, musiałem połączyć się z obrazem w
raw.github.com
subdomenie.Format adresu URL
https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}
Przykład obniżki cen
![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)
źródło
raw.github.com
subdomenie? gdzie przesłać plik obrazu?źródło
Jedna linia poniżej powinna być tym, czego szukasz
jeśli twój plik znajduje się w repozytorium
jeśli plik znajduje się w innym zewnętrznym adresie URL
źródło
Składnia przeceny do wyświetlania obrazów jest w rzeczywistości:
ALE: Jak zapewnić
url
?Więc ... możesz użyć tej niesamowitej sztuczki, aby github hostował twój plik obrazu. TDLR:
http://solutionoptimist.com/2013/12/28/awesome-github-tricks/
źródło
Znacznie prostsze niż dodawanie adresu URL Wystarczy załadować obraz do tego samego repozytorium, na przykład:
![Screenshot](screenshot.png)
źródło
dodaj to do README
źródło
Obniżka cen:
![Screenshot](http://url/to/img.png)
Następnie skopiuj źródło obrazu
Teraz dodaj
![Screenshot](http://url/to/img.png)
do pliku README.mdGotowy!
Alternatywnie możesz użyć witryny hostingu obrazów, na przykład
imgur
uzyskać adres URL i dodać go do pliku README.md lub hostować pliki statyczne.Przykładowy problem
źródło
Metoda 1-> Metoda Markdown
Metoda 2-> sposób HTML
lub
Uwaga -> Jeśli nie chcesz stylizować obrazu, tzn. Zmienić rozmiaru, usuń część stylu
źródło
Najpierw utwórz katalog (folder) w katalogu głównym lokalnego repozytorium, który będzie zawierać
screenshots
żądany dodatek. Nazwijmy ten katalogscreenshots
. Umieść obrazy (JPEG, PNG, GIF, `itp.), Które chcesz dodać do tego katalogu.Zrzut ekranu obszaru roboczego Android Studio
Po drugie, musisz dodać link do każdego obrazu do swojego README. Więc jeśli mam obrazy o nazwach
1_ArtistsActivity.png
i2_AlbumsActivity.png
w moim katalogu zrzutów ekranu, dodam ich linki w następujący sposób:Jeśli chcesz, aby każdy zrzut ekranu znajdował się w osobnej linii, napisz ich linki w osobnych liniach. Lepiej jest jednak napisać wszystkie linki w jednym wierszu, oddzielone tylko spacją. Może nie wygląda to zbyt dobrze, ale dzięki temu GitHub automatycznie zaaranżuje je dla Ciebie.
Wreszcie, zatwierdź swoje zmiany i wciśnij je!
źródło
Przeszukałem kilka podobnych pytań i nie znalazłem odpowiedzi na mój problem i jego dość proste / łatwe rozwiązanie.
Google Cloud Storage - nieco inne podejście do obrazów w plikach README
Oto i tak: podobnie jak OP chciałem obraz w moim Github README i znając składnię Markdown, wpisałem go:
Aby to zadziałało, musisz wypełnić powyższe faktyczne podstawienia (np. MY_IMAGE = image.jpg).
Github
camo
- Anonimowe obrazyGithub hostuje twoje zdjęcia anonimowo , tak! Stanowi to jednak problem dla zasobów pamięci masowej Google. Musisz pobrać wygenerowany adres URL z konsoli Google Cloud.
Jestem pewien, że istnieje płynniejszy sposób, po prostu odwiedź podany punkt końcowy adresu URL i skopiuj długi adres URL. Detale:
Instrukcje
https
niegs
) do nowej karty / okna przeglądarkiMamy nadzieję, że pomoże to przyspieszyć i wyjaśnić ten problem innym osobom.
źródło
Dla mnie najlepszym sposobem jest -
Mam nadzieję, że to pomoże.
źródło
Dodaj obraz w repozytorium z opcji przesyłania pliku, a następnie do pliku README
źródło
Z obrazami znajdującymi się w
/screen-shots
katalogu. Zewnętrzne<div>
pozwala na ustawienie obrazów. Wypełnienie uzyskuje się za pomocą<img width="desired-padding" height="0">
.źródło