Tekst źródłowy strony Pomoc:Podstrony, aspekty techniczne

{{Spis treści (pomoc)/uplink|toc=toc}}{{clear}}
==Używania podston na Wikiźródłach==
===Zasady===
Używanie podstron na wiki zależy od ustawień i jest włączane na poziomie przestrzeni nazw (patrz: poradnik ''[[Pomoc:Przestrzeń nazw|Przestrzeń nazw]]''). Na polskich Wikiźródłach używane są:
*w przestrzeni głównej do tworzenia hierarchii dla '''niesamodzielnych''' części utworu
**w przestrzeni głównej tradycyjnie tworzymy również wariant prezentacji utworu jako podstronę '''/całość''' (patrz: poradnik ''[[Pomoc:Strony całości|Strony całości]]'')
*w innych przestrzeniach do tworzenia opisów szablonów, modułów, do rezerwacji indeksów, do tworzenia eksperymentalnych (prywatnych) modułów i szablonów

Najważniejsza i charakterystyczna dla Wikiźródeł jest koncepcja samodzielności utworu (patrz: poradnik ''[[Pomoc:Samodzielność części tekstu|Samodzielność części tekstu]]'').

===Najważniejsze uwagi===
Z punktu widzenia redagowania Wikiźródeł najważniejszy jest powyższy podrozdział ''[[#Zasady|Zasady]]'' oraz aspekt ''[[#W praktyce|W praktyce]]''.

===Zalety podstron===
*Główną zaletą tworzenia podstron w przestrzeni głównej jest utrzymywanie jasnej hierarchii w ramach części utworu, utrzymywanie wszystkich części razem.
*Tworzenie automatycznych linków ułatwiających nawigację między częściami. 
*Umożliwia osobom z odpowiednimi uprawnieniami (''movesubpages'') &ndash; na polskich Wikiźródłach administratorzy &ndash; zmianę nazwy strony wraz z podstronami
===Wady===
*Zajmuje znak ukośnika
*Utrudnia korzystanie ze stron dyskusji

==Nawigacja==
===Automatyczna nawigacja===
Na górze podstrony tworzone są automatyczne linki prowadzące do (pod)strony bezpośrednio powyżej w hierarchii.
===Linki przy pomocy ../===
W obrębie podwójnych nawiasów kwadratowych (a więc w normalnej składni wiki linków) można używać w celu linkowania względnego (względem strony na której się kod znajduje) następujących symboli:
*'''../''' &ndash; dla poziomu powyżej
*'''/{{ParametrPomoc|foo}}''' &ndash; dla poziomu niżej o nazwie {{ParametrPomoc|foo}}
W niektórych sytuacja dodatkowy ukośnik na końcu powoduje wyświetlanie się jedynie ostatniego segmentu nazwy.


Bardziej rozbudowany przykład:
{| class="wikitable" style="width:75%; margin:0 auto 0 auto;"
!By utworzyć na stronie poniżej link do strony {{f*|kol=fuchsia|Daleka wyprawa/Księga II/Część pierwsza}}
!Można użyć poniższego kodu
|-
|Wyprawa
|{{tab}}<nowiki>[[/Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}/Księga I
|{{tab}}<nowiki>[[../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III}}/Część pierwsza
|{{tab}}<nowiki>[[../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}/Rozdział 1
|{{tab}}<nowiki>[[../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}/Rozdział 2
|{{tab}}<nowiki>[[../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III}}/Część druga
|{{tab}}<nowiki>[[../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}/Rozdział 1
|{{tab}}<nowiki>[[../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}/Rozdział 2
|{{tab}}<nowiki>[[../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../../../Księga II/Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}/Księga II
|{{tab}}<nowiki>[[/Część pierwsza]]</nowiki>
|-
|{{f*|kol=fuchsia|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III}}/Część pierwsza}}
|{{tab}}{{tab}}<nowiki>—</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}/Rozdział 1
|{{tab}}<nowiki>[[../]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}/Rozdział 2
|{{tab}}<nowiki>[[../]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część p}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III}}/Część druga
|{{tab}}<nowiki>[[../Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}/Rozdział 1
|{{tab}}<nowiki>[[../../Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../../Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../../Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}/Rozdział 2
|{{tab}}<nowiki>[[../../Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja i
|{{tab}}<nowiki>[[../../../Część pierwsza]]</nowiki>
|-
|{{0|Daleka }}{{1|„}}{{0|wyprawa}}{{0|Księ}}{{1|„}}{{0|ga III/Część}}{{1|„}}{{0|ierwsza}}{{0|/Rozd}}„{{0|ał 1}}/Sekcja ii
|{{tab}}<nowiki>[[../../../Część pierwsza]]</nowiki>
|-
|}

Samodzielnie konstrukcje typu '''/Rozdział I''' czy '''../Księga I''' nie tworzą linków, mogą być w tym celu ujęte (jak to pokazano) w nawiasy kwadratowe. Samodzielnie '''../''' itp. są zwykłym tekstem. Nazwy stron można uzyskać przy pomocy <nowiki>{{#rel2abs:</nowiki>{{ParametrPomoc|ścieżka}}<nowiki>}}</nowiki>, gdzie {{ParametrPomoc|ścieżka}} to konstrukcja jak wyżej. Stosuje się wtedy:
*'''./''' &ndash; dla obecnego poziomu
*'''../''' &ndash; dla poziomu powyżej
*'''/{{ParametrPomoc|foo}}''' &ndash; dla poziomu niżej o nazwie {{ParametrPomoc|foo}}

Należy jeszcze dodać, że ewentualne ukośniki w nazwie strony (gdy są częścią nazwy ale nie tworzą hierarchii np. System operacyjny OS/2 ) mogą zaburzyć nawigację przy pomocy skrótów typu '''../'''.

{{f|w=90%|Podanie parametru {{ParametrPomoc|nazwa strony}}: <nowiki>{{#rel2abs:</nowiki>{{ParametrPomoc|ścieżka}}<nowiki>|</nowiki>{{ParametrPomoc|nazwa strony}}<nowiki>}}</nowiki> umożliwia analizę innej strony niż ta, na której kod jest wywoływany.}}

===Użycie magicznych słów===
====Definicje====
Magiczne słowa <nowiki>{{NAMESPACE}}, {{ROOTPAGENAME}}, {{BASEPAGENAME}}, {{SUBPAGENAME}}, {{PAGENAME}}, {{FULLPAGENAME}}</nowiki> mają nieco inną logikę, choć w pewnych wypadkach mogą mieć podobne działanie. Nie ujęte w nawiasy kwadratowe dają po prostu tekst, w połączeniu z nawiasami mogą być częścią funkcjonującego linku.<br>
Jak widać powyżej konstrukcje oparte na '''../''' pozwalają na nawigację względem danej (pod)strony w górę lub dół hierarchii o określoną liczbę stopni. Podobnie działa jedynie <nowiki>{{BASEPAGENAME}}</nowiki>. Inne zwracają część nazwy (pod)strony i tak:<br>
{| class="wikitable" style="width:75%; margin:0 auto 0 auto;"
!Magiczne słowo
!Opis działania
|-
|<nowiki>{{NAMESPACE}}</nowiki>
|nazwę przestrzeni, w której się znajduje dana (pod)strona
|-
|<nowiki>{{PAGENAME}}</nowiki>
|nazwę podstrony, ale bez nazwy przestrzeni, w której się znajduje dana (pod)strona<br>W przypadku stron w przestrzeni głównej jest to zarazem pełna nazwa (pod)strony
|-
|<nowiki>{{FULLPAGENAME}}</nowiki>
|nazwę podstrony, wraz z nazwą przestrzeni, w której się znajduje dana (pod)strona<br>W przypadku stron w przestrzeni głównej jest to to samo co <nowiki>{{PAGENAME}}</nowiki>, zaś w przypadku ogólnym odpowiada konstrukcji: <nowiki>{{NAMESPACE}}:{{PAGENAME}}</nowiki>
|-
|<nowiki>{{ROOTPAGENAME}}</nowiki>
|najgłębsza część nazwy (pod)strony, ale bez nazwy przestrzeni, w której się znajduje dana (pod)strona
|-
|<nowiki>{{BASEPAGENAME}}</nowiki>
|nazwa (pod)strony, w hierarchii bezpośrednio „nad” daną podstroną, ale bez nazwy przestrzeni, w której się znajduje dana (pod)strona<br>Można (zwłaszcza w przypadku innych przestrzeni niż przestrzeń główna zastosować konstrukcję <nowiki>{{NAMESPACE}}:{{BASEPAGENAME}}</nowiki>
|-
|<nowiki>{{SUBPAGENAME}}</nowiki>
|nazwa ostatniego członu nazwy (pod)strony. Z reguły nie daje funkcjonalnego (a przynajmniej sensownego) linku. Może być stosowana na przykład do odróżniania stron '''/całość''' od innych.
|}
<br><br>
{{CentrujStart}}
<math>\underbrace{\overbrace{\underbrace{ \text{Daleka wyprawa}}_{\{\{\text{ROOTPAGENAME}\}\}}/\text{Księga pierwsza}/	\ldots}^{\{\{\text{BASEPAGENAME}\}\}}/\overbrace{ \text{Rozdział 104}}^{\{\{\text{SUBPAGENAME}\}\}}}_{\{\{\text{PAGENAME}\}\}}</math>
<br><br>
W przypadkach „zdegenerowanych” (nazwa dwu&#8209; lub jednoczłonowa) mamy:
<br><br>

<math>\left.\underbrace{\overbrace{\underbrace{ \text{Daleka wyprawa}}}_{\{\{\text{ROOTPAGENAME}\}\}}^{\{\{\text{BASEPAGENAME}\}\}}/\overbrace{\text{Księga pierwsza}}^{\{\{\text{SUBPAGENAME}\}\}}}_{\{\{\text{PAGENAME}\}\}}\;\;\;\;\right\vert\;\;\;\overbrace{\overbrace{\underbrace{\underbrace{\text{Daleka wyprawa}}_{\{\{\text{ROOTPAGENAME}\}\}}}_{\{\{\text{PAGENAME}\}\}}}^{\{\{\text{BASEPAGENAME}\}\}}}^{\{\{\text{SUBPAGENAME}\}\}}</math>
<br><br><br>

Dla stron w przestrzeni głównej <nowiki>{{NAMESPACE}}</nowiki> zwraca pusty tekst, zaś <nowiki>{{PAGENAME}} = {{FULLPAGENAME}}</nowiki>. W innych przypadkach można to prześledzić na poniższym schemacie:

<math>\overbrace{\underbrace{\text{Strona}}_{\{\{\text{NAMESPACE}\}\}}:\underbrace{\text{PL Kowalski Daleka wyprawa.djvu/327}}_{\{\{\text{PAGENAME}\}\}}}^{\{\{\text{FULLPAGENAME}\}\}}</math>
{{CentrujKoniec}}

====Przykłady====

{|class="wikitable" style="width:75%; margin:0 auto 0 auto;"
!Strona
!<nowiki>{{NAMESPACE}}</nowiki>
!<nowiki>{{PAGENAME}}</nowiki>
!<nowiki>{{FULLPAGENAME}}</nowiki>
!<nowiki>{{ROOTPAGENAME}}</nowiki>
!<nowiki>{{BASEPAGENAME}}</nowiki>
!<nowiki>{{SUBPAGENAME}}</nowiki>
|-
!Daleka wyprawa
|
|Daleka wyprawa
|Daleka wyprawa
|Daleka wyprawa
|Daleka wyprawa
|Daleka wyprawa
|-
!Daleka wyprawa/Księga I
|
|Daleka wyprawa/Księga I
|Daleka wyprawa/Księga I
|Daleka wyprawa
|Daleka wyprawa
|Księga I
|-
!Daleka wyprawa/Księga I/Część pierwsza
|
|Daleka wyprawa/Księga I/Część pierwsza
|Daleka wyprawa/Księga I/Część pierwsza
|Daleka wyprawa
|Daleka wyprawa/Księga I
|Część pierwsza
|-
!Pomoc:Xxx
|Pomoc
|Xxx
|Pomoc:Xxx
|Xxx
|Xxx
|Xxx
|-
!Pomoc:Xxx/Yyy
|Pomoc
|Xxx/Yyy
|Pomoc:Xxx/Yyy
|Xxx
|Xxx
|Yyy
|-
!Pomoc:Xxx/Yyy/Vvv
|Pomoc
|Xxx/Yyy/Vvv
|Pomoc:Xxx/Yyy/Vvv
|Xxx
|Xxx/Yyy
|Vvv
|-
!Pomoc:Xxx/Yyy/Vvv/Qqq
|Pomoc
|Xxx/Yyy/Vvv/Qqq
|Pomoc:Xxx/Yyy/Vvv/Qqq
|Xxx
|Xxx/Yyy/Vvv
|Qqq
|}

====Analiza innej strony niż bieżąca====
Wstawienie w słowach magicznych po dwukropku nazwy strony powoduje efektywnie analizę nazwy np. <nowiki>{{BASEPAGENAME:Pomoc:Xxx/Yyy/Vvv/Qqq}}→Xxx/Yyy/Vvv</nowiki>.<br>
Można to również wykorzystać, by wyodrębnić na przykład przedostatni człon nazwy strony <nowiki>{{SUBPAGENAME:{{BASEPAGENAME}}}}</nowiki>. Ten kod wywołany na stronie Daleka&nbsp;wyprawa/Księga&nbsp;I/Część&nbsp;pierwsza da nam '''Księga&nbsp;I'''.

===Użycie funkcji parsera #titleparts===
Użycie funkcji parsera #titleparts umożliwia najpełniejszą kontrolę kosztem czytelności kodu.<br>
Funkcja dzieli nazwę strony na segmenty kierując się ukośnikami zwraca fragment nazwy zgodnie ze schematem:
<nowiki>{{#titleparts:</nowiki>{{ParametrPomoc|nazwa strony}}|{{ParametrPomoc|liczba segmentów}}|{{ParametrPomoc|pierwszy segment}}<nowiki>}}</nowiki><br><br>
Jeśli {{ParametrPomoc|liczba segmentów}} nie jest określona, to przyjmuje wartość domyślną '''0''', co jest interpretowane jako wszystkie wskazane. Jeśli {{ParametrPomoc|pierwszy segment}} nie jest określony lub jest równy '''0''', to przyjmowana jest wartość '''1'''.

Przykłady:

{| class="wikitable" style="width:75%; margin:0 auto 0 auto;"
!Kod
!Efekt
|-
|<nowiki>{{#titleparts: </nowiki>{{f*|kol=fuchsia|Pomoc:Xxx/Yyy/Vvv/Qqq}}<nowiki> }}</nowiki>
|'''Pomoc:Xxx/Yyy/Vvv/Qqq'''
|-
|<nowiki>{{#titleparts: </nowiki>{{f*|kol=fuchsia|Pomoc:Xxx}}<nowiki>/Yyy/Vvv/Qqq | 1 }}</nowiki>
|'''Pomoc:Xxx'''{{tab}}{{f*|w=90%|<br>{{tab|4|em}}(dla przestrzeni głównej podobnie do <nowiki>{{ROOTPAGENAME}}</nowiki><br>{{tab|4|em}}dla innych przestrzeni <nowiki>{{NAMESPACE}}:{{ROOTPAGENAME}}</nowiki>}})
|-
|<nowiki>{{#titleparts: </nowiki>{{f*|kol=fuchsia|Pomoc:Xxx/Yyy}}<nowiki>/Vvv/Qqq | 2 }}</nowiki>
|'''Pomoc:Xxx/Yyy'''
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/</nowiki>{{f*|kol=fuchsia|Yyy/Vvv}}<nowiki>/Qqq | 2 | 2 }}</nowiki>
|'''Yyy/Vvv'''
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/</nowiki>{{f*|kol=fuchsia|Yyy/Vvv/Qqq}} <nowiki>| | 2 }}</nowiki>
|'''Yyy/Vvv/Qqq'''
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/Yyy/Vvv/Qqq | | 5 }}</nowiki>
|
|}

Oba parametry numeryczne mogą mieć również wartość ujemną. Negatywna wartość {{ParametrPomoc|liczba segmentów}} mówiąc obrazowo obcina segmenty końcowe. Negatywną wartość {{ParametrPomoc|pierwszy segment}} należy interpretować jako wartość liczoną od końca {{ParametrPomoc|nazwa strony}}.

{| class="wikitable" style="width:75%; margin:0 auto 0 auto;"
!Kod
!Efekt
|-
|<nowiki>{{#titleparts: </nowiki>{{f*|kol=fuchsia|Pomoc:Xxx/Yyy/Vvv}}<nowiki>/Qqq | -1 }}</nowiki>
|'''Pomoc:Xxx/Yyy/Vvv'''{{tab}}{{f*|w=90%|(zwraca nazwę strony bezpośrednio nad daną stroną,<br>{{tab|4|em}}dla przestrzeni głównej podobnie do <nowiki>{{BASEPAGENAME}}</nowiki><br>{{tab|4|em}}dla innych przestrzeni <nowiki>{{NAMESPACE}}:{{BASEPAGENAME}}</nowiki>}})}}
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/Yyy/Vvv/Qqq | -4 }}</nowiki>
|{{tab}}{{f*|w=90%|obcina wszystkie cztery segmenty z wyniku.}}
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/Yyy/Vvv/Qqq | -5 }}</nowiki>
|{{tab}}{{f*|w=90%|obcina wszystkie segmenty z wyniku.}}
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/</nowiki>{{f*|kol=fuchsia|Yyy/Vvv}}/Qqq <nowiki>| -1 | 2 }}</nowiki>
|'''Yyy/Vvv'''{{tab}}{{f*|w=90%|(obcina jeden segment od prawej, potem zwraca od drugiego segmentu)}}
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/Yyy/</nowiki>{{f*|kol=fuchsia|Vvv}}<nowiki>/Qqq | -1 | -2 }}</nowiki>
|'''Vvv'''{{tab}}{{f*|w=90%|(zaczyna od drugiego segmentu od prawej, obcina jeden segment od prawej)}}
|-
|<nowiki>{{#titleparts: </nowiki>{{f*|kol=fuchsia|Pomoc:Xxx/Yyy}}/Vvv<nowiki>/Qqq | -2 }}</nowiki>
|'''Pomoc:Xxx/Yyy'''{{tab}}{{f*|w=90%|(zaczyna od początku, obcina dwa segmenty od prawej)}}
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/Yyy/</nowiki>{{f*|kol=fuchsia|Vvv/Qqq}}<nowiki> | 0 | -2 }}</nowiki>
|'''Vvv/Qqq'''{{tab}}{{f*|w=90%|(zaczyna od drugiego segmentu od prawej, zwraca wszystkie segmenty)}}
|-
|<nowiki>{{#titleparts: Pomoc:Xxx/Yyy/Vvv/</nowiki>{{f*|kol=fuchsia|Qqq}}<nowiki> | 0 | -1 }}</nowiki><br><nowiki>{{#titleparts: Pomoc:Xxx/Yyy/Vvv/</nowiki>{{f*|kol=fuchsia|Qqq}}<nowiki> | 1 | -1 }}</nowiki>
|'''Qqq'''{{tab}}{{f*|w=90%|(zwraca ostatni segment, podobnie do <nowiki>{{SUBPAGENAME}}</nowiki>)}}<br>{{f*|w=90%|{{tab|2|em}}jednak dla <nowiki>{{#titleparts: Pomoc:Xxx}}</nowiki> zwraca '''Pomoc:Xxx'''}}
|}

By użyć tej konstrukcji tak, by analizowana była nazwa strony, na której funkcja #titleparts jest wywoływana należy użyć konstrukcji <nowiki>{{#titleparts:{{FULLPAGENAME}}...}}</nowiki>.

==W praktyce==
===Linkowanie między częściami utworu, włączanie do właściwej kategorii===
Jak wspomniano powyżej, podstrony służą do tworzenia hierarchii w ramach utworu. Nazwy utworów na Wikiźródłach zmieniają się stosunkowo często – np. dodawane jest w nawiasie nazwisko autora, rok wydania. Dla zachowania konsystencji po zmianie nazwy wskazane jest używanie względnych nazw (linków) w utworach podzielonych na podstrony:
*w szablonie {{s|Dane tekstu}}/{{s|Dane tekstu2}} w polu '''|Tytuł=''' na przykład <nowiki>[[{{ROOTPAGENAME}}|</nowiki>{{ParametrPomoc|Ciekawa książka}}<nowiki>]]</nowiki> 
*w szablonie {{s|Dane tekstu}}/{{s|Dane tekstu2}} w polu '''|Poprzedni='''  <nowiki>{{ROOTPAGENAME}}/</nowiki>{{ParametrPomoc|Rozdział II}} lub gdy to możliwe szablonu zawierającego podobną funkcjonalność {{s|PoprzedniU}}
*w szablonie {{s|Dane tekstu}}/{{s|Dane tekstu2}} w polu '''|Następny='''  <nowiki>{{ROOTPAGENAME}}/</nowiki>{{ParametrPomoc|Rozdział IV}} lub gdy to możliwe szablonu zawierającego podobną funkcjonalność {{s|NastępnyU}}
*w szablonie {{s|Dane tekstu}}/{{s|Dane tekstu2}} w polu '''|inne=''' <nowiki>{{całość|{{ROOTPAGENAME}}/</nowiki>całość|epub=i<nowiki>}}</nowiki>
*w '''spisie treści''' tworzonym bezpośrednio na stronie głównej 
*w '''kategorii''' np. <nowiki>[[Kategoria:{{ROOTPAGENAME}}|C03]]</nowiki> lub ewentualnie: <nowiki>[[Kategoria:{{ROOTPAGENAME}}|C</nowiki>{{s|BieżącyU|2}}<nowiki>]]</nowiki>
Zastosowanie w szablonie {{s|Dane tekstu}} w polu '''|Rozdział=''' (gdy powinno być to pole wypełnione) <nowiki>{{SUBPAGENAME}}</nowiki> może również nieco ułatwić tworzenie kolejnych podstron.<br>
'''Nie należy''' jednak wstawiać bezrefleksyjnie takich konstrukcji gdy nazwy nie powinny być trwale powiązane (na przykład nazwa pliku lub kategorii na commons), które podlegają zasadom niezależnym od Wikiźródeł a dodatkowo utrudniają korzystanie na przykład z automatycznie tworzonych galerii.

===Szablon <nowiki>{{Tfi}}</nowiki>===
Zaletą tworzenia odnośników względnych jest przede wszystkim możliwość zmiany nazwy stron wraz z podstronami.<ref>Dodatkowymi, mniej istotnymi zaletami jest pewne uproszczenie kodu i większa odporność na literówki.</ref> W przypadku, gdy chcemy odczytać tytuł tekstu głównego, który jest tworzony na podstawie indeksu można użyć szablonu {{s|Tfi}}.<br>
Gdy części tekstu są samodzielne (np. zbiory nowel) szablon ten może być użyty w szablonie {{s|Dane tekstu}}/{{s|Dane tekstu2}} w polu '''Pochodzenie''' oraz dla dołączenia do właściwej kategorii.<br>
Innym zastosowaniem będzie tworzenie odnośników w spisie treści tworzonym w tekście (w przestrzeni '''Strona:''').

===Inne przydatne konstrukcje===
====Przykłady====
*test czy kod jest na stronie '''/całość''' <code><nowiki>{{#ifeq:{{SUBPAGENAME}}|całość|</nowiki>{{ParametrPomoc|pierwsza możliwość}}|{{ParametrPomoc|druga możliwość}}<nowiki>}}</nowiki></code>
*test czy kod jest na stronie głównej czy podstronie lub głębiej na pod-pod...-stronie <code><nowiki>{{#ifeq:{{ROOTPAGENAME}}|{{PAGENAME}}|</nowiki>{{ParametrPomoc|strona główna}}|{{ParametrPomoc|jakaś podstrona}}<nowiki>}}</nowiki></code>
*test czy kod jest na stronie głównej lub podstronie czy też głębiej na pod-pod...-stronie <code><nowiki>{{#ifeq:{{ROOTPAGENAME}}|{{BASEPAGENAME}}|</nowiki>{{ParametrPomoc|strona główna lub podstrona}}|{{ParametrPomoc|głębszy poziom}}<nowiki>}}</nowiki></code>
*test czy kod jest na stronie głównej, na stronie całości bezpośrednio pod stroną główną, czy na jakiejś podstronie
::<code><nowiki>{{#switch: {{PAGENAME}} |{{ROOTPAGENAME}}=</nowiki>{{ParametrPomoc|strona główna}}<nowiki>|{{ROOTPAGENAME}}/całość=</nowiki>{{ParametrPomoc|strona całości bezpośrednio pod stroną główną}} |{{ParametrPomoc|inne przypadki}}<nowiki>}} </nowiki></code>
*test czy kod jest na stronie głównej lub na głównej stronie całości, czy na jakiejś podstronie
::<code><nowiki>{{#switch: {{PAGENAME}} |{{ROOTPAGENAME}}|{{ROOTPAGENAME}}/całość=</nowiki>{{ParametrPomoc|strona główna lub całości bezpośrednio pod stroną główną}} |{{ParametrPomoc|inne przypadki}}<nowiki>}} </nowiki></code>
:::na przykład:
::::::<code><nowiki>| okładka = {{#switch: {{PAGENAME}} |{{ROOTPAGENAME}}|{{ROOTPAGENAME}}/całość=Wiktor Hugo - Katedra Notre-Dame w Paryżu T.II.djvu | }} </nowiki></code>
::::::<code><nowiki>| strona z okładką = {{#switch: {{PAGENAME}} |{{ROOTPAGENAME}}|{{ROOTPAGENAME}}/całość=1 | }} </nowiki></code>
*tworzenie stron całości dla tomów <code><nowiki>{{całość|{{PAGENAME}}/całość|epub=i|{{lcfirst:{{SUBPAGENAME}}}}|Cały}}</nowiki></code> – umieszczony na stronie {{ParametrPomoc|Ciekawa książka/Tom I}} w szablonie {{s|Dane tekstu}}/{{s|Dane tekstu2}} w polu '''|inne=''' utworzy link do odpowiedniej strony całości z widocznym tekstem {{f*|kol=blue|Cały tom I}} a ten sam kod na stronie {{ParametrPomoc|Ciekawa książka/Tom III}} oczywiście do strony całości trzeciego tomu z tekstem {{f*|kol=blue|Cały tom III}}.
**lcfirst zamienia tu pierwszą literę na małą
**inne przydatne funkcje z tej grupy to ucfirst (pierwsza litera na wielką), lc (wszystkie litery na małe), uc (wszystkie litery na wielkie)
*sprawdzenie czy istnieje strona '''/całość''' <code><nowiki>{{#ifexist:{{PAGENAME}}/całość|</nowiki>{{ParametrPomoc|istnieje}}|{{ParametrPomoc|nie istnieje}}<nowiki>}}</nowiki></code>
*pierwsza i druga (lub tylko pierwsza, jeśli drugiej nie ma) część nazwy:
::<code><nowiki>{{#titleparts:{{PAGENAME}}|2|1}}</nowiki></code>
*wyekstrahować pierwszą część nazwy (ROOTPAGENAME) i usunąć fragment w nawiasie (wraz z poprzedzającą spacją) <code><nowiki>{{#invoke:string|replace|{{ROOTPAGENAME}}| %b()||plain=false}}</nowiki></code> np.: {{tab}}{{tab}}{{tab}}Zakopane (Hoesick, 1900) → Zakopane
*zazwyczaj synonim powyższego: <code><nowiki>{{#invoke:string|replace|{{ROOTPAGENAME}}| %(.*||plain=false}}</nowiki></code> np.: {{tab}}{{tab}}{{tab}}Zakopane (Hoesick, 1900) → Zakopane
*pierwsza litera tytułu (strony głównej) <nowiki>{{padleft:|1|{{ROOTPAGENAME}}}}</nowiki></code>
*pierwsza litera nazwy rozdziału (ostatniego członu nazwy) <nowiki>{{padleft:|1|{{SUBPAGENAME}}}}</nowiki></code>
*część nazwy strony po ostatniej spacji <code><nowiki>{{#invoke:string|replace|{{PAGENAME}}|.* ([^ ]*)$|%1|plain=false}}</nowiki></code> np.: {{tab}}{{tab}}{{tab}}Zakopane (Hoesick, 1900)/Rozdział XIII → XIII
*druga, trzecia część nazwy strony po usunięciu tekstu przed pierwszą spacją:
**<code><nowiki>{{#invoke:string|replace|{{#titleparts:{{PAGENAME}}|1|</nowiki>{{ParametrPomoc|2}}<nowiki>}}|[^ ]* (.*)$|%1|plain=false}}</nowiki></code> np.: {{tab}}{{tab}}{{tab}}Zakopane (Hoesick, 1900)/Tom IV/Rozdział dwudziesty siódmy → IV
**<code><nowiki>{{#invoke:string|replace|{{#titleparts:{{PAGENAME}}|1|</nowiki>{{ParametrPomoc|3}}<nowiki>}}|[^ ]* (.*)$|%1|plain=false}}</nowiki></code> np.: {{tab}}{{tab}}{{tab}}Zakopane (Hoesick, 1900)/Tom IV/Rozdział dwudziesty siódmy → dwudziesty siódmy

==== Bardziej skomplikowane przykłady ====
'''Dla hierarchii trzyrzędowej:'''<br>
Kod: <code><nowiki>{{#ifeq:{{SUBPAGENAME}}|całość||{{#invoke:string|replace|{{#titleparts:{{PAGENAME}}|1|3}}|[^ ]* (.*)$|%1|plain=false}}}}</nowiki></code>

na stronie: Zakopane (Hoesick, 1900) → ø

na stronie: Zakopane (Hoesick, 1900)/Tom IV → ø

na stronie: Zakopane (Hoesick, 1900)/Tom IV/Rozdział dwudziesty siódmy → dwudziesty siódmy

na stronie: Zakopane (Hoesick, 1900)/całość → ø

na stronie: Zakopane (Hoesick, 1900)/Tom IV/całość → ø


Kod: <code><nowiki>{{#ifeq:{{SUBPAGENAME}}|całość||{{#invoke:string|replace|{{#titleparts:{{PAGENAME}}|1|2}}|[^ ]* (.*)$|%1|plain=false}}}}</nowiki></code>

na stronie: Zakopane (Hoesick, 1900) → ø

na stronie: Zakopane (Hoesick, 1900)/Tom IV → IV

na stronie: Zakopane (Hoesick, 1900)/Tom IV/Rozdział dwudziesty siódmy → IV

na stronie: Zakopane (Hoesick, 1900)/całość → ø

na stronie: Zakopane (Hoesick, 1900)/Tom IV/całość → IV


'''Dla hierarchii dwurzędowej:'''<br>
Kod: <code><nowiki>{{#ifeq:{{SUBPAGENAME}}|całość||{{#invoke:string|replace|{{#titleparts:{{PAGENAME}}|1|2}}|[^ ]* (.*)$|%1|plain=false}}}}</nowiki></code>

na stronie: Zakopane (Hoesick, 1900) → ø

na stronie: Zakopane (Hoesick, 1900)/Rozdział 6 → 6

na stronie: Zakopane (Hoesick, 1900)/całość → ø

'''Osobne strony całości dla tomów'''
{{f|
<pre><nowiki>
| inne={{#switch:{{PAGENAME}}
<!--   -->|{{ROOTPAGENAME}}/całość={{epub}}
<!--   -->|{{ROOTPAGENAME}}/{{SUBPAGENAME}}={{całość|{{PAGENAME}}/całość|epub=nie|{{lcfirst:{{SUBPAGENAME}}}}|Cały}}<br>{{całość|{{ROOTPAGENAME}}/całość|epub=i}}
<!--   -->|{{BASEPAGENAME}}/całość={{epub}}<br>{{całość|{{ROOTPAGENAME}}/całość|epub=i}}
<!--   -->|{{całość|{{ROOTPAGENAME}}/całość|epub=i}} }}
</nowiki></pre>|table}}

===Uwagi stylistyczne===
Należy unikać pisania kodu w sposób trudny do zrozumienia.<br>
Należy preferować konstrukcje bardziej uniwersalne.

{{Przypisy}}

[[Kategoria:Pomoc]]