Czy istnieje sposób na utworzenie kotwicy URL <a>
, linku z pliku Markdown, do innego pliku w tym samym repozytorium i gałęzi (inaczej link do bieżącej gałęzi)?
Na przykład w gałęzi master mam plik README.md, który chciałbym zrobić coś takiego:
# My Project
is really really cool. My Project has a subdir named myLib, see below.
## myLib documentation
see documentation [here](myLib/README.md)
Pozwoliłoby mi to na linkowanie z jednego .md do drugiego w ramach tej samej gałęzi i nie musiałbym się martwić, w której gałęzi jestem (unikam konieczności tworzenia absolutnego adresu URL zawierającego nazwę gałęzi github.com).
Oto działający przykład tego, co mam na myśli:
- GOTO http://github.com/rynop/testRel , link nie działa.
- GOTO http://github.com/rynop/testRel/blob/master/README.md , link działa.
Jest to oczekiwane, ponieważ w tym momencie początkowy adres URL znajduje się w gałęzi. Jak mogę uzyskać bieżącą gałąź w pliku README.md w katalogu głównym repozytorium?
Aktualizacja : otworzyłem problem z GitHub dla tego żądania funkcji.
Odpowiedzi:
Aktualizacja 30 stycznia 2013 r. 16 miesięcy później:
GitHub Blog Post Względne linki w plikach znaczników :
Aktualizacja 20 grudnia 2011 r .:
Problem znaczników GitHub 84 jest obecnie zamknięty przez technoweenie , z komentarzem:
12 października 2011 r .:
Jeśli spojrzysz na surowe źródło
README.md
samego Markdown (!), Ścieżki względne nie są obsługiwane.Znajdziesz odniesienia takie jak:
źródło
[Welcome](./wiki/Hello)
działa, gdzie Hello to kolejna strona wiki w tym samym repozytorium.[Welcome](Hello)
tam, gdzie Hello to kolejna strona wiki w tym samym repozytorium.Na przykład masz repozytorium takie jak następujące:
Względny link do
subtext.md
wtext.md
może wyglądać następująco:Względny link do
subsubtext.md
wtext.md
może wyglądać następująco:Względny link do
subtext.md
wsubsubtext.md
może wyglądać następująco:Względny link do
subsubtext2.md
wsubsubtext.md
może wyglądać następująco:Względny link do
text.md
wsubsubtext.md
może wyglądać następująco:źródło
Na dzień 31 stycznia 2013 r. Obniżka cen w Github obsługuje względne linki do plików .
W tym wątku komentarza omówiono jednak kilka braków .
Alternatywnie możesz użyć Gitdown do zbudowania pełnych adresów URL do repozytorium, a nawet uświadomienia ich gałęzi, np
Gitdown to preprocesor przeceny GitHub. Usprawnia typowe zadania związane z utrzymywaniem strony dokumentacji dla repozytorium GitHub, np. Generowanie spisu treści, w tym zmiennych, generowanie adresów URL i uzyskiwanie informacji o samym repozytorium w momencie przetwarzania danych wejściowych. Gitdown bezproblemowo integruje się ze skryptami budynku.
Jestem autorem biblioteki Gitdown.
źródło
GitHub może to znacznie poprawić przy minimalnej pracy. Oto obejście.
Myślę, że chcesz czegoś bardziej podobnego
lub wskazać na sam plik README
Powodzenia
źródło
Chciałem tylko to dodać, ponieważ żadne z powyższych rozwiązań nie zadziałało, jeśli docelowym linkiem jest katalog ze spacjami w nazwie. Jeśli docelowy link jest katalogiem i ma spację, to nawet ucieczka spacji za pomocą \ nie renderuje linku na Github.
%20
Dla każdego miejsca używa tylko rozwiązania, które mi odpowiada .np .: jeśli jest to struktura katalogów
Aby
Dir A
umieścić link do pliku README.md,Top_dir
możesz to zrobić:źródło
Możesz utworzyć link do pliku, ale nie do folderów, i pamiętaj, że Github doda
/blob/master/
przed odnośnikiem względnym (i folderom brakuje tej części, więc nie można ich połączyć, ani przy pomocy<a>
tagów HTML , ani łącza Markdown).Tak więc, jeśli mamy plik
myrepo/src/Test.java
, będzie miał adres URL taki jak:Aby połączyć go w pliku readme, możemy użyć:
lub:
<a href="src/Test.java">This is a link</a>
.(Myślę, że
master
reprezentujemaster
gałąź i różni się, gdy plik znajduje się w innej gałęzi).źródło
Możesz używać względnych adresów URL z katalogu głównego repozytorium za pomocą
<a href="">
. Zakładając, że Twoje repozytorium ma nazwętestRel
, wstaw następujące polecenietestRel/README.md
:źródło
To pytanie jest dość stare, ale nadal wydaje się ważne, ponieważ nie jest łatwo umieścić odnośniki z readme.md na stronach wiki na Githubie.
Grałem trochę i ten względny link wydaje się działać całkiem dobrze:
[Your wiki page](../../wiki/your-wiki-page)
Obaj
../
usuną/blob/master/
bazę i wykorzystają ją jako punkt wyjścia. Jednak nie próbowałem tego na innych repozytoriach niż Github (mogą występować problemy ze zgodnością).źródło
Nie jestem pewien, czy widzę tę opcję tutaj. Możesz po prostu utworzyć
/folder
w swoim repozytorium i używać go bezpośrednio:Nazwa obiektu blob, drzewa lub repozytorium nie jest potrzebna i działa jak urok.
źródło
Jeśli chcesz względny link do swojej strony wiki na GitHub, użyj tego:
Jeśli chcesz link do pliku w repozytorium, powiedzmy, aby odwołać się do pliku nagłówka, a strona wiki znajduje się w katalogu głównym wiki, użyj tego:
Uzasadnieniem tego ostatniego jest pominięcie ścieżki „/ wiki” za pomocą „../” i przejście do gałęzi master w drzewie repozytorium bez podania nazwy repozytorium, która może ulec zmianie w przyszłości.
źródło