Pomoc:Transkluzja
- Dla zaawansowanych
- Te informacje dotyczą edytora wikikodu. Brak analogicznych dotyczących edytora wizualnego (Czym to się różni?)
Transkluzja – załączenie zawartości strony na innej stronie poprzez podanie nazwy załączanej strony. Pozwala na zamieszczenie tej samej treści na wielu stronach bez konieczności edytowania każdej z osobna. Zmiana treści załączanej strony powoduje automatyczne uaktualnienie treści na stronach załączających. Ze wszystkich możliwości, jakie daje transkluzja, można korzystać wyłącznie w edytorze kodu źródłowego.
Jak działa transkluzja
[edytuj | edytuj kod]Po wstawieniu szablonu problemu do 10 tysięcy artykułów czytelnicy Wikipedii zobaczą 10 tysięcy identycznych informacji o problemie na 10 tysiącach artykułów, ale komunikat jest edytowany na jednej stronie, czyli np. w razie potrzeby poprawienia wystarczy jedna edycja, widoczna na 10 tysiącach artykułów.
- Jeśli źródło strony jest w przestrzeni nazw artykułu (np. Polska), musisz wstawić dwukropek (:) przed nazwą, czyli:
{{:Polska}}. - Jeśli źródło strony jest w przestrzeni nazw „Szablon” (np. Szablon:To popraw), użyj samej nazwy, czyli:
{{To popraw}} - Jeśli źródło jest w jakiejkolwiek innej przestrzeni nazw (np. Wikipedysta:Testuj wiki), musisz użyć nazwy razem z przestrzenią nazw, czyli:
{{Wikipedysta:Testuj wiki}}
Transkluzja działa w obrębie jednego projektu MediaWiki, np. w polskojęzycznej Wikipedii nie możemy transkludować stron z Wikipedii w języku suahili ani z hebrajskiego Wikisłownika.
Częściowa transkluzja
[edytuj | edytuj kod]Przy użyciu znaczników „noinclude”, „onlyinclude” oraz „includeonly” można transkludować nie tylko całą, ale również część strony. Często użyteczne jest pominięcie jakichś informacji przy transkluzji, np. dokumentacji szablonów.
- noinclude. Znacznik
<noinclude>…</noinclude>spowoduje, że tekst pomiędzy znacznikami nie będzie transkludowany do innej strony, lecz pojawi się tylko na stronie, na której się znajduje. Jest to użyteczne np. do tworzenia dokumentacji. - includeonly. Znacznik
<includeonly>…</includeonly>spowoduje, że tekst pomiędzy znacznikami nie pojawi się na tej stronie, w której źródle jest wpisany, lecz będzie użyty tylko wtedy, gdy dana strona zostanie transkludowana do innej strony. Jest to użyteczne np. do dodawania kategorii do stron transkludujących szablon, bez dodawania samego szablonu do tych kategorii. - onlyinclude. Znacznik
<onlyinclude>…</onlyinclude>oznacza, że tylko tekst wewnątrz niego ma być transkludowany do innej strony. Jest to najbardziej subtelny z tagów częściowych transkluzji, ponieważ często jest nadrzędny względem innych. Jeśli strona zawiera przynajmniej jedną parę tagów „onlyinclude”, to przy każdym transkludowaniu tej strony wyłącznie materiał wewnątrz tagów „onlyinclude” jest transkludowany. Może być więcej takich sekcji, a w każdej takiej sekcji konkretne części tekstu mogą być wyłączone z transkluzji przez znaczniki „noinclude". Mogą być także otoczone przez tagi „includeonly”, aby nie pojawiły się na oryginalnej stronie. Jednak treść poza tagami „onlyinclude” będzie ignorowana, gdy strona będzie transkludowana do innych stron. Jest to użyteczne np. aby powtórzyć mały fragment jednej strony na drugiej stronie: po prostu otocz ten mały fragment przez tagi „onlyinclude”, i transkluduj ją do drugiej strony.
Jeżeli strona załączana ma fragmenty oddzielnie objęte znacznikami transkluzji, zawsze na stronie załączającej wyświetlą się wszystkie. Nie ma możliwości wyboru transkluzji jednego z większej liczby fragmentów objętych znacznikami transkluzji.