Шаблон:Дакументацыя

(Пасля перасылкі з Шаблон:Doc)
(i) Дакументацыя

Уключае падстаронку з дакументацыяй для бягучага шаблона. Дакладней, уключае шаблон Назва старонкі/Дакументацыя. Працуе таксама і ў абмеркаванні шаблона, гэта значыць уключае адну і тую ж старонку як з шаблона, так і з яго абмеркавання. І ўсё ж уключэнне дакументацыі ў абмеркаванне з’яўляецца непажаданым.

Прасцей за ўсё ўставіць выклік гэтага шаблона, а потым перайсці па спасылцы, якая з’явілася, і стварыць ці скапіраваць туды дакументацыю. Дастаткова дадаць код <noinclude>{{doc}}</noinclude>.

Дакументацыя шаблона {{Дакументацыя}} сфарміравана па тым жа прынцыпе, так што можна паглядзець код.

Асноўная мэта вынасу дакументацыі на асобную старонку — пазбегнуць перагенерацыі HTML для ўсіх старонак, якія выкарыстоўваюць шаблон, пры рэдагаванні яго дакументацыі. Таксама гэта скарачае старонку самога шаблона, што робіць рэдагаванне прасцей.

Шаблон падтрымлівае неабавязковы параметр: пры ўводзе {{Дакументацыя|Поўная назва старонкі}} замест старонкі /Дакументацыя будзе ўключана любая неабходная. Гэта зручна для стварэння агульнай дакументацыі для аднатыпных шаблонаў.

Гл. таксама

  • Пара шаблонаў {{Дакументацыя ў тэксце}} і {{Дакументацыя/Канец}}

Каб пазбегнуць паломак старонак, дзе ўжыты гэты шаблон, пажадана эксперыментаваць у сваёй асабістай прасторы.