Title: Linki --- Markdown pozwala wstawiać linki do innych stron na trzy sposoby: bezpośrednio *liniowo* w tekście, poprzez referencję oraz automatycznie. Dwa pierwsze sposoby korzystają z nawiasów kwadratowych `[ ]` do otoczenia fragmentu tekstu, który ma stać się linkiem. Bezpośrednio w tekście ---------------------- By wstawić odnośnik bezpośrednio w tekście wystarczy wstawić zwykłe nawiasy bezpośrednio po kwadratowych. Możesz również podać opcjonalnie tytuł linku (umieszczony zostanie w atrybucie `title` w HTML-u wyjściowym) po spacji, otoczony cudzysłowami. ~~~ TypeFriendly zostało stworzone przez [grupę Invenzzia](http://www.invenzzia.org) TypeFriendly zostało stworzone przez [grupę Invenzzia](http://www.invenzzia.org "Invenzzia") ~~~ > TypeFriendly zostało stworzone przez [grupę Invenzzia](http://www.invenzzia.org) > > TypeFriendly zostało stworzone przez [grupę Invenzzia](http://www.invenzzia.org "Invenzzia") Poprzez referencje ------------------ Referencja do odnośnika używa również nawiasów kwadratowych, które umieszczamy tuż po nawiasach nazwy linku. W referencji podaje się nazwę etykiety do której później można się odnieść. Można opcjonalnie oddzielić spacją referencję od nazwy linku. ~~~ To jest [przykład][id] linków z referencją. To jest [przykład] [id] linków z referencją. ~~~ Definicja referencji wygląda następująco: [id]: http://www.example.org/ "Opcjonalny tytuł" Są to kolejno: 1. Nawiasy kwadratowe, w których umieszczona jest nazwa etykiety referencji 2. Dwukropek 3. Co najmniej jedna spacja lub tabulacja 4. Adres URL, do którego odnosi się referencja 5. Opcjonalnie, po spacji, bądź w nowej linijce wcięty spacjami lub tabulacją, otoczony cudzysłowami, apostrofami lub nawiasami tytuł linku Poniższe linijki oznaczają to samo: [id]: http://www.example.org/ "Opcjonalny tytuł" [id]: http://www.example.org/ 'Opcjonalny tytuł' [id]: http://www.example.org/ (Opcjonalny tytuł) [id]: http://www.example.org/ "Opcjonalny tytuł" Możesz również opcjonalnie otoczyć link nawiasami kierunkowymi (`< >`): [id]: > [information] > Definicje referencji używane są tylko przez parser Markdowna i wycinane z treści wynikowego dokumentu. Etykiety referencji mogą się składać z liter, cyfr, spacji, znaków interpunkcyjnych, ale nazwa nie zależy od wielkości liter. Poniższe linijki odnoszą się do tej samej referencji: [tekst odnośnika][a] [tekst odnośnika][A] Można również pominąć nazwę etykiety, poprzez umieszczenie pustych nawiasów klamrowych `[]` - wtedy za etykietę przyjęta zostaje nazwa odnośnika. Możesz np. napisać: [Invenzzia][] I utworzyć definicję: [Invenzzia]: http://www.invenzzia.org W podobny sposób można tworzyć referencje nawet do nazw linków składających się z kilku słów! [Grupa Invenzzia][] [Grupa Invenzzia]: http://www.invenzzia.org Definicje referencji mogą być umieszczone gdziekolwiek w dokumencie, oddzielone od elementów blokowych (akapity, listy..) pustymi linijkami. Można je umieścić np. pod akapitem, w którym zostały użyte referencje, albo na końcu dokumentu. #### Przykład użycia referencji: ~~~ Mamy 10 razy więcej ruchu z wyszukiwarki [Google][1] niż z [Netsprint][2] lub [Onet][3]. W rzeczywistości, [Google][1] jest najpopularniejszą wyszukiwarką. [1]: http://www.google.pl [2]: http://www.netsprint.pl [3]: http://szukaj.onet.pl ~~~ #### Z użyciem automatycznych etykiet: ~~~ Mamy 10 razy więcej ruchu z wyszukiwarki [Google][] niż z [Netsprint][] lub [Onet][]. [google]: http://www.google.pl [netsprint]: http://www.netsprint.pl [onet]: http://szukaj.onet.pl ~~~ ### Po co używać referencji? Tekst źródłowy staje się dzięki temu czytelniejszy. Linki umieszczone są w osobnych linijkach pod akapitami i nie mieszają się z tekstem (szczególnie te bardzo długie). Automatycznie ------------- Markdown umożliwia również wstawienie bezpośrednio linków do tekstu w bardzo prosty sposób, przy użyciu nawiasów kierunkowych `< >`, w których umieszczony zostaje link. Zajrzyj na naszą stronę: > Zajrzyj na naszą stronę: W podobny sposób można postąpić a adresami e-mail. W tym przypadku jednak parser Markdown zamieni je w wyjściowym HTML-u na "sieczkę" HTML-owych encji. Adres kontaktowy: > Adres kontaktowy: Odnośniki do pozostałych rozdziałów dokumentacji ================================================ TypeFriendly definiuje listę domyślnych referencji do wszystkich rozdziałów generowanej dokumentacji przy użyciu ich identyfikatorów. Jeżeli chcemy odnieść się do rozdziału `api.klasy.jakas-klasa` wystarczy napisać: Zajrzyj do [tego rozdziału][api.klasy.jakas-klasa] Spowoduje to automatyczne utworzenie linku do żądanego rodziału. Odnośniki do kotwic {#links_anchors} ------------------- Od wersji 0.1.3 TypeFriendly można odnosić się do [kotwic][docs.syntax.headers#headers_anchors] w innych rozdziałach. Składnia jest taka sama jak normalnie do rozdziału, dodaje się tylko po identyfikatorze odnośnik kotwicy: `#kotwica`: Zajrzyj do [tego fragmentu rozdziału][api.klasy.jakas-klasa#kotwica] > [important] > > Aby odnieść się do kotwicy w tym samym rozdziale nadal należy stosować powyższą składnię i **nie używać** `[odnośnik](#kotwica)`. Jest tak z powodu tego, że TypeFriendly do każdej kotwicy nagłówka dodaje prefiks `h:id_rodziału:`, tak, aby kotwice były unikalne w całej dokumentacji.