Szablon:LinkOgólne/opis
Opis szablonu
[edytuj]Jest to szablon linków inteligentnych (tzw. linki inteligentne), który koloruje linki w zależności do jakiej kategorii szablon zaliczy stronę wskazaną w nim. Zestaw możliwych kodów linkowych, znajduje się na stronie {{Link wewnętrzny}}, w miejscu pod tabelą nawigacyjną {{Tabela nawigacyjna}}, według jego wikikodu opisu.
Szablon {{LinkOgólne}} i jego pochodne w ich definicji, obsługują nazwy przestrzenie nazw kanoniczne (angielskie) lub w jakimś języku, na danym projekcie siostrzanych lub w ich wersjach językowych.
Wystarczy podać nazwę kanoniczną przestrzeni nazw, a ta nazwa zostanie przetłumaczona na nazwę charakterystyczną dla danego projektu, jeżeli podamy parametr: | analiza = tak, bez: | bez przetwarzania = tak, w przeciwnym przypadku tego nie zrobi.
Na przykład na projekcie bieżącym dla szablonów ogólnie nie między-projektowych, wyświetlana nazwa przestrzeni nazw zostanie przetłumaczona na nazwę charakterystyczną dla polskiego Wikibooksa, jeżeli ustawimy szablon, by wyświetlał to w nazwie linku, to je robi możliwie po przetłumaczeniu na język polski, ona w adresie linku nie zostanie przetłumaczona, chyba że podamy parametr | analiza = tak według powyższej specyfikacji.
Szablon zwykle nie tłumaczy w adresie linku nazwy przestrzeni nazw, np. na język polski lub inny, podanym w definicji tego szablonu, jeżeli jest nazwą kanoniczną podaną w definicji tego szablonu, a jeżeli nie, to nie ma czego tłumaczyć (bo w definicji szablonu pod zmienną: miano przestrzeni nazw, np. jest podane: Wikibooks, zamiast: Project), chyba że w przeciwnym wypadku, chcemy by przetłumaczył na język charakterystyczny dla danego projektu, wskazanym przez szablon, wtedy należy podać parametr poniżej opisany do szablonu do głębszej analizy linkowej.
Szablon używa zmiennej: miano przestrzeni nazw, w sposób jawny (w postaci osobnego parametru) lub nie (w pierwszej zmiennej), w przeciwieństwie do {{Link wewnętrzny}}, który tego nie ma, tzn. nazwa przestrzeni nazw jest zawsze podana tam w sposób niejawny w postaci pierwszej zmiennej wraz z adresem linku na danym projekcie i kluczem projektu (wtedy nie ma osobnego parametru do interwiki) lub nie (w postaci zmiennej (zmiennych) do interwiki).
Użycie
[edytuj]Szablon kombajn do budowy innych szablonów linków, oczywiście projektowych i do innego projektu, szablon konfigurowalny, jak ma się zachowywać, to zależy od parametrów podanych do wywołania szablonów.
Opis parametrów
[edytuj]- Pełne pierwsze wywołanie
{{LinkOgólne|1=|2=|za=|po=|klucz projektu=|dyskusja=|miano przestrzeni nazw=|alias miana przestrzeni nazw=|wyświetl miano przestrzeni nazw=}}
- Pełne drugie wywołanie
{{LinkOgólne|1=|2=|za=|po=|kod języka=|kod projektu=|dyskusja=|miano przestrzeni nazw=|alias miana przestrzeni nazw=|wyświetl miano przestrzeni nazw=}}
- Parametry szablonu
1- nazwa strony, do której link linkuje się,2- nazwa linku - (sugerowany),z(przestarzałe) lubza- dokończenie nazwy linku za pomocą umieszczenia jego bezpośrednio za nazwą linku - (opcjonalny),p(przestarzałe) lubpo- dokończenie nazwy linku za pomocą umieszczenia jego bezpośrednio za linkiem - (opcjonalny),k(przestarzałe) lubklucz projektu- kod projektu siostrzanego Wikibooks, ewentualnie w innej wersji językowej Wikimedia, używany zamiastkod językaikod projektu- (opcjonalny),kj(przestarzałe) lubkod języka- kod języka używany zamiastklucz projektu- (opcjonalny),kp(przestarzałe) lubkod projektu- kod projektu używany zamiastklucz projektu- (opcjonalny),d(przestarzałe) lubdyskusja- tłumaczy przestrzeń nazw na przestrzeń nazw dyskusji, gdy niepusty - (opcjonalny),m(przestarzałe),przestrzeń(niezalecana) lubmiano przestrzeni nazw- miano przestrzeni nazw kanoniczne lub niekanoniczne strony, dla projektu polskiego Wikibooksa, i jego siostrzanych projektów, a także dla ich wersji językowych - (opcjonalny),a(przestarzałe),aliaslubalias miana przestrzeni nazw- alias do nazwy przestrzeni nazw, który jest wyświetlany przed nazwą strony, jeśli nie podano nazwy linku i podano niepustą zmiennąwyświetl miano przestrzeni nazw- (opcjonalny),w(przestarzałe),wyświetl(niezalecana) lubwyświetl miano przestrzeni nazw- jeśli wartość niepusta, to wyświetla nazwę przestrzeni nazw w nazwie linku - (opcjonalny).
Parametry w wersji skróconej są jedynie przestarzałe dla nazwy wersji pełnej szablonu nieprzekierowania, a nie są, gdy używamy przekierowania do tego szablonu.
Szablon posiada też parametry: | bez znaczników = tak i | bez przetwarzania = tak, które kolejno znaczą, że bez obramowania znacznikowego span kolorujące link, i bez głębszego, na siłę, przetwarzania linkowego, a także parametr | analiza = tak do głębszego przetwarzania linkowego, ważniejszym od tego jest wcześniejszy ostatni parametr.
Przykłady
[edytuj]- Możliwe poniższe warianty przykładów tego szablonu symbolizują na czym on polega, jak się powinno go używać.
| Przykłady użycia szablonu, przy różnych zestawach jego parametrów, przedstawiające odpowiednie sytuacje wywołań |
|---|
Przykład: {{LinkOgólne|1=Programowanie w HTML}}
Wynik: Programowanie w HTML
|
Błędy
[edytuj]Błędy należy zgłaszać na stronie Wikibooks:Kwestie techniczne.
Parametry szablonu (strukturyzacja Wizualnego Edytora)
[edytuj]Szablon ogólny linków {{LinkOgólne}}, który jest budulcem innych szablonów tego typu, służy do budowania inteligentnych linków, kolorujących je. Szablon {{LinkOgólne}} obsługuje wszystkie poniższe parametry, szablony pochodne używają tylko niektórych. Szablony, ale typowo nie między-projektowe, obsługują wszystkie parametry, oprócz nazwy przestrzeni nazw: miano przestrzeni nazw, i wyświetlania nazwy przestrzeni nazw: wyświetl miano przestrzeni nazw, i skrótu do nazwy przestrzeni nazwy: skrót nazwy przestrzeni nazw. Szablony: {{LinkSpecjalna}}, {{LinkSpecjalna2}} itp., dodatkowo nie obsługują parametru: dyskusja. Szablon {{LinkWB}}, też nie obsługuje parametru: skrót nazwy przestrzeni nazw. Szablony linków między-projektowe nie obsługują parametrów: miano przestrzeni nazw, wyświetl miano przestrzeni nazw, skrót nazwy przestrzeni nazw, klucz projektu, kod języka i kod projektu.
| Parametr | Opis | Typ | Status | |
|---|---|---|---|---|
| 1 | 1 | Nazwa strony, do której link linkuje się. | Nazwa strony | wymagany |
| 2 | 2 | Nazwa linku. | Ciąg znaków | sugerowany |
| za | za z | Dokończenie nazwy linku, poprzez umieszczenie tego napisu bezpośrednio po nazwie linku. | Ciąg znaków | opcjonalny |
| po | po p | Dokończenie nazwy linku, poprzez umieszczenie tego napisu bezpośrednio po linku. | Ciąg znaków | opcjonalny |
| klucz projektu | klucz projektu k | Kod projektu siostrzanego Wikibooks, ewentualnie w innej wersji językowej Wikimedia, używany zamiast kod języka i kod projektu. | Nieznany | opcjonalny |
| kod języka | kod języka kj | Kod języka używany zamiast klucz projektu. | Nieznany | opcjonalny |
| kod projektu | kod projektu kp | Kod projektu używany zamiast klucz projektu. | Nieznany | opcjonalny |
| dyskusja | dyskusja d | Tłumaczy przestrzeń nazw na przestrzeń nazw dyskusji, gdy niepusty . | Ciąg znaków | opcjonalny |
| miano przestrzeni nazw | miano przestrzeni nazw przestrzeń m | Miano przestrzeni nazw kanoniczne lub niekanoniczne strony, dla projektu polskiego Wikibooksa, i jego siostrzanych projektów, a także dla ich wersji językowych. | Ciąg znaków | opcjonalny |
| skrót nazwy przestrzeni nazw | skrót nazwy przestrzeni nazw skrót s | Skrót do nazwy przestrzeni nazw, który jest wyświetlany przed nazwą strony, jeśli nie podano nazwy linku i podano niepustą zmienną wyświetl miano przestrzeni nazw. | Ciąg znaków | opcjonalny |
| wyświetl miano przestrzeni nazw | wyświetl miano przestrzeni nazw wyświetl w | Jeśli wartość niepusta, to wyświetla nazwę przestrzeni nazw w nazwie linku. | Ciąg znaków | opcjonalny |
Zobacz też
[edytuj]- Ogólne szablony linków inteligentnych, kolorujących linki, w zależności do jakiej kategorii one należą, w tym celu wykorzystuje projekt Wikidane
- {{LinkOgólne2}} - jest to szablon linków, oparty o szablon {{LinkOgólne}}, wyświetla link, przy niepodanym drugim parametrze, z nazwą przestrzeni nazw strony,
- {{Link wewnętrzny}} - szablon służy do budowania linków inteligentnych, szablon nie ma parametru nazwy przestrzeni nazw, w przeciwieństwie do {{LinkOgólne}},
- {{Sekcja referencyjna}} - szablon sekcji podręczników, używana w ramach jednej książki, szablon na substronie
Wersja do druku, wyświetla tylko linki manewrowania po całej tej stronie, a wewnątrz podręcznika, pomiędzy jego artykułami, - {{LinkURL}} - szablon tworzy, pełny adres URL, na podstawie użytych parametrów.
- Szablony wydobywające linki z wikitekstu
- {{WydobądźLinki}} - wydobywa linki wewnętrzne i zewnętrzne, jeżeli występują.
- Kategorie skojarzone z szablonem:
- Szablon zgłasza błędy parametrów w kategorii: Kategoria:Szablon LinkOgólne do sprawdzenia (Liczba stron: 0).
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||