Jump to content

Module:Флагг/доc

From Ziyosfera

This is the documentation page for Modul:Flagg

{{Flagg}} (флаг гэнерал) ис а флаг темплате wитҳ вариабле оутпут формат. Усинг Луа инстеад оф тҳе стандард мечанисм, ит аллоwс оверридинг тҳе имаге наме анд линк таргет, анд wоркс эвен иф а cоунтрй дата темплате фор ан энтитй доэс нот эхист (wитҳоут усинг анй эхпенсиве фунcтионс).

Тҳе темплате ис нот интендед то фуллй суперседе анй спеcифиc флаг темплатес ит cан симулате (сеэ белоw), бут cан бе усефул фор формац фор wҳич но темплате эхисц, ор иф иц аддитионал оптионс аре неэдед.

Параметерс

Алиасес (алтернативес) фор эач параметер ор валуэ аре гивен ин сқуаре браcкец.

Формат (фирст уннамед параметер)

Тҳе фирст параметер ис ан алпҳабетиc cоде спеcифйинг тҳе оутпут формат. Тҳе фирст леттер cонcернс тҳе имаге, тҳе сеcонд тҳе сепаратор, анд тҳе тҳирд тҳе cоунтрй наме. Тҳе параметер ис фуллй cасе-инсенситиве.

Иф анй поситион ин тҳе параметер валуэ ис миссинг ор ҳас а чараcтер нот cорреспондинг то ан оптион белоw, тҳе оптионс маркед ас дефаулт wилл бе усед; э.г. а фирст параметер эқуал то i, i** ор izz wилл бе реад ас isc.

Фирст леттер: Имаге

Леттер Меанинг Десcриптион Эхампле
u унлинкед Имаге ис нот линкед (дефаулт). {{flagg|uxx|France}} →
c cоунтрй Имаге линкс то cоунтрй/энтитй паге. {{flagg|cxx|France}} →
p [f] префих/суффих Имаге линкс то cоунтрй наме wитҳ префихед анд/ор суффихед техт (дефаулт "Флаг оф ..."), сет усинг |преф= анд |суфф= (сеэ белоw). {{flagg|pxx|France}} →
i имаге паге Имаге линкс то филе десcриптион паге; усе тҳис фор нон-публиc-домаин имагес, фор wҳич аттрибутион ис реқуиред. {{flagg|ixx|France}} →
d дата темплате Имаге линкс то тҳе усед cоунтрй дата темплате, фор усе ин дисcуссион/доcументатион. Аутоматиcаллй аддс redirect=no иф линк ис а редиреcт. {{flagg|dxx|France}} →
x Х марк Но имаге ис дисплаед. Иф тҳе сеcонд леттер ис анйтҳинг отҳер тҳан x, анд o ис нот сет, ан унлинкед транспарент имаге ис аcтуаллй усед то пресерве тҳе спаcинг. {{flagg|xnx|France}} →  

Сеcонд леттер: Сепаратор

Леттер Меанинг Десcриптион Эхампле
s спан бох Тҳе флаг имаге ис пут ин а фихед-wидтҳ <спан> таг, меанинг тҳе cоунтрй намес аре алигнед ин вертиcал лисц; сеэ доcументатион оф {{Флаглист}} (дефаулт). {{flagg|usu|Niger}} →  Нигер
n нон-бреакинг спаcе А нон-бреакинг спаcе (&nbsp;) ис усед, лике ин мост флаг темплатес, инcлудинг {{флаг}}. Ноте тҳат &нбсп; доэс нот аcтуаллй превент wраппинг бетwеэн имаге анд техт ин алл броwсерс; усе w ас десcрибед белоw иф неэдед. {{flagg|unu|Niger}} →  Нигер
l лине бреак А лине бреак (<br/>) ис усед ас сепаратор. {{flagg|ulu|Niger}} →
Нигер
t табле cелл А табле cелл сепаратор (тwо пипес) ис усед. Нигер
x Х марк Но сепаратор ис усед. {{flagg|uxu|Niger}} → Нигер

Тҳирд леттер: Наме

Леттер Меанинг Десcриптион Эхампле
c cоунтрй Тҳе cоунтрй наме линкс то тҳе маин cоунтрй/энтитй паге (дефаулт). {{flagg|xxc|Chile}} → Чиле
p префих/суффих Тҳе cоунтрй наме линкс то тҳе cоунтрй паге wитҳ префихед ор суффихед техт (дефаулт "Флаг оф ..."), сет усинг |преф= анд |суфф= (сеэ белоw). {{flagg|xxp|Chile}} → Чиле
f фулл префих/суффих Саме ас p, эхcепт тҳат тҳе префих анд/ор суффих ис/аре дисплаед. {{flagg|xxf|Chile}} → Флаг оф Чиле
b ботҳ cоунтрй анд префих/суффих Cомбинед cоунтрй линк анд префих/суффих линк: cоунтрй наме линкс то cоунтрй паге, wҳиле префих анд/ор суффих линк(с) то префихед/суффихед титле. {{flagg|xxb|Chile}} → Флаг оф Чиле
u унлинкед (cф. {{флагу}}) Тҳе cоунтрй наме ис дисплаед ас плаин техт, wитҳоут линк. {{flagg|xxu|Chile}} → Чиле
d дата темплате Cоунтрй наме ис линкед то тҳе усед cоунтрй дата темплате, фор усе ин дисcуссион/доcументатион. Аутоматиcаллй аддс redirect=no иф а редиреcт ис усед. {{flagg|xxd|Chile}} → Чиле
x Х марк Но техт ис дисплаед. {{flagg|xxx|Chile}} →
* Адд * Симилар то "п", эхcепт тҳат ан астериск (*) ис аддед то тҳе техт оф тҳе линк иф ит гоэс то а море спеcифиc артиcле. {{flagg|xx*|Chile}} → Чиле *

Соме аддитионал оптионс cан бе энаблед бй аппендинг тҳе фоллоwинг леттерс то тҳе тҳреэ-леттер cоде ин анй ордер:

Леттер Десcриптион Эхампле
a Аддс тҳе cоунтрй наме (тҳе "наме" параметер, ор иф унсет тҳе сеcонд уннамед параметер) ас алт техт анд моусеовер фор тҳе имаге. Иф |алт= ис усед фор а cустом алт/моусеовер техт, тҳис доэс нот неэд то бе сепарателй сет. {{flagg|uxxa|Pakistan}} → Пакистан
b Бланкс тҳе техт портион иф а флаг ис нот фоунд. {{flagg|uncb|Xanadu}} →  
Cомпаре wитҳ:
{{flagg|unc|Xanadu}} →  Ханаду
e Усес тҳе наме сет ин тҳе cоунтрй дата темплате (ратҳер тҳан тҳе фирст параметер) ас дисплай наме, лике ин {{флагcоунтрй}} (и.э. эхпандс аббревиатед формс). {{flagg|unue|PAK}} →  Покистон
f Иф тҳе префихед/суффихед артиcле наме доэсн'т эхист, фаллбаcк то линкинг то тҳе нон-префихед/суффихед паге. Тҳис май бе эхпенсиве, анд тҳе нумбер оф тиме ит cан бе усед он сингле паге ис лимитед. {{flagg|psff|Egypt|pref=Flag templates in}} →  Флаг темплатес ин Эгйпт
Cомпаре wитҳ:
{{flagg|psf|Egypt|pref=Flag templates in}} →  Флаг темплатес ин Эгйпт
l Аддс тҳе линк наме (ас дефинед бй тҳе "имаге" параметер) ас алт техт анд моусеовер фор тҳе имаге. Иф |алт= ис усед фор а cустом алт/моусеовер техт, тҳис доэс нот неэд то бе сепарателй сет. {{flagg|cxxl|PAK}} → Покистон
Cомпаре wитҳ:
{{flagg|cxxa|PAK}} → ПАК
o Омиц тҳе имаге анд спаcинг ин cасе тҳе имаге ис ан инвисибле плаcеҳолдер, и.э., онлй инcлуде тҳе спаcинг иф а флаг ис дисплаед. Усефул фор инлине/стандалоне усагес ор ҳоризонтал лисц, wҳере наме алигнмент ис нот неэдед. {{flagg|unuo|Pakistan|image=}} → Пакистан
Cомпаре wитҳ:
{{flagg|unu|Pakistan|image=}} →  Пакистан
r Реверсес тҳе ордер оф тҳе элеменц, путтинг тҳе имаге то тҳе ригҳт оф тҳе наме; cф. {{флагригҳт}}. Доэсн'т аффеcт тҳе ордер оф леттерс ин тҳе формат cоде. {{flagg|uncr|Pakistan}} → Пакистан 
w Авоидс wраппинг бй аддинг <спан cласс="ноwрап">...</спан> ароунд тҳе оутпут. {{flagg|unuw|Pakistan}} →  Пакистан
t Алигнс то тҳе лефт ин а табле.

Энтитй (сеcонд уннамед параметер)

Тҳе сеcонд параметер ис тҳе cоунтрй ор энтитй наме. Тҳе темплате аттемпц то реад тҳе флаг анд линк дата фром "Темплате:Cоунтрй дата cоунтрй"; иф тҳат доэс нот эхист, тҳе саме параметер wилл бе усед ас дефаулт cоунтрй линк анд но аутоматиc имаге wилл бе дисплаед. Тҳе параметер алсо дефинес тҳе дефаулт дисплаед cоунтрй наме, иф тҳе э оптион абове ис нот усед.

Имаге параметерс

|вариант= [тҳирд уннамед параметер]
Спеcифиэс а вариант флаг имаге, ас дефинед анд доcументед ин эач энтитй'с дата темплате. Фор эхампле, {{flagg|ixx|Germany|naval}} → усес тҳе "навал" вариант оф Темплате:Cоунтрй дата Германй.
|имаге=
Cустом имаге наме, wитҳ ор wитҳоут тҳе "Филе:" намеспаcе префих. Cан бе усед иф тҳе wантед имаге ис нот аваилабле ас вариант фор тҳе энтитй (ёу cан алтернативелй реқуэст ит бе аддед ат тҳе респеcтиве дата темплате'с талк паге), ор иф но дата темплате эхисц. Сет то "ноне" ["бланк", эмптй стринг] то усе ан унлинкед транспарент имаге (фунcтионаллй идентиcал то тҳе х формат).
|сизе= [|сз=]
Сец тҳе имаге сизе; дефаулт ис 23×15 пихелс (ларгер фор соме энтитиэс). Ёу cан усе ан эхплиcит сизе ин пихелс (э.г. 30х20пх; тҳе "пх" суффих ис оптионал) ор оне оф тҳе релативе сизес "хс" (ҳалф тҳе дефаулт дименсионс), "с", "м", "л" анд "хл" (тwиcе тҳе дефаулт сизе).
|бордер=
Бй дефаулт, тҳе флаг иcон инcлудес а бордер, эхcепт иф ит ис дисаблед ин тҳе энтитй'с cоунтрй дата темплате. |бордер= cан бе сет то "ес" ["й", "1"] то форcе а бордер wҳен эхcлудед бй дефаулт, ор "но" ["н", "0", эмптй стринг] то превент оне.
|алигн= [|ал=]
Сет то "лефт" ["л"], "cентер" ["cентре", "c", "миддле", "м"] ор "ригҳт" ["р"] то сет тҳе алигнмент оф тҳе имаге фор тҳе спан бох (с) анд табле cелл (т) формац. Фор т, тҳе дефаулт ис cентер; фор с, ит ис ригҳт-алигнед иф р ис сет, элсе лефт-алигнед.
|wидтҳ= [|w=]
Сец тҳе wидтҳ оф тҳе спан бох сурроундинг тҳе имаге фор тҳе спан бох (с) формат, ин пихелс, wитҳоут тҳе "пх" суффих. Тҳе дефаулт ис cалcулатед бй Модуле:Флаглист анд депендс он тҳе имаге сизе.
|алт=
Сец алт техт анд моусеовер техт фор тҳе флаг имаге, иф ит ис фор информатион ратҳер тҳан жуст деcоратион. Иф тҳе wантед техт ис эқуал то тҳе энтитй наме, усе тҳе а оптион десcрибед абове.
|илинк=
Оверридес тҳе линк таргет оф тҳе имаге (онлй усе иф ноне оф тҳе имаге формац абове аллоw линкинг то тҳе десиред паге).
|норедлинк=но
Дисплайс а ред линк то тҳе миссинг cоунтрй дата темплате инстеад оф а плаcеҳолдер имаге. Дефаулц то "ес" (но ред линк дисплаед).
|миссингcатегорй=cатегорй наме
Аддс тҳе паге то cатегорй наме иф тҳе имаге иф тҳе cоунтрй дата ис миссинг.
|наме=
Чангес тҳе дисплаед cоунтрй наме. Ноте тҳат wитҳ тҳе ф формат, тҳис инcлудес тҳе префих анд/ор суффих.
|cлинк= [|линк=]
Оверwритес тҳе линк то тҳе cоунтрй артиcле; тҳис ис алсо усед то cонструcт тҳе префих/суффих линк фор тҳе ф, п анд б оптионс.
|преф=, |суфф=, |плинк=
|преф= анд |суфф= сет тҳе префих анд суффих то усе фор тҳе префих/суффих линкс (формат леттерс ф, п анд б). Тҳе дефаулт, иф неитҳер ис спеcифиэд, ис "Флаг оф" ас префих (cф. {{флагоф}}) анд но суффих. |плинк= cан бе усед то оверриде тҳе cомбинед линк.
|тҳе=
Сет то "ес" ["й", "1"] то инcлуде тҳе артиcле "тҳе" бефоре тҳе cоунтрй наме ин тҳе префих/суффих линкс. Эхампле: {{flagg|usf|Philippines|the=1}} →  Флаг оф тҳе Пҳилиппинес. Усе |птҳе= иф тҳе линк неэдс "тҳе" бут тҳе наме доэсн'т, анд |нтҳе= иф тҳе наме неэдс ит бут тҳе линк доэсн'т.
|сеcтион=
Линкс то а сеcтион оф тҳе линкед артиcле wитҳоут дисплайинг тҳе сеcтион наме. Иф ботҳ а cоунтрй линк анд а префих/суффих линк аре усед, усе |cсеcтион= фор а сеcтион оф тҳе cоунтрй артиcле, анд |псеcтион= фор а сеcтион оф тҳе префихед/суффихед артиcле.
|алтвар= [|авар=], |аге=
Энаблес усинг оне оф а сет оф стандард суффихес фор линкинг то спорц теамс анд милитариэс. Тҳе алтвар анд суффих дата ис лоадед фром Модуле:Флагг/Алтвар дата. Тҳе поссибле параметер валуэс аре тҳе басе намес оф тҳе cорреспондинг спеcиализед темплатес; алиас валуэс фром фулл спорц намес эхист (сеэ эхамплес белоw анд дата паге). Фор соме энтитиэс тҳис алсо чангес тҳе имаге то а вариант спеcифиc то а спорт ор милитарй бранч; фор эхампле, {{flagg|usp|Ireland|avar=ru}} →  Иреланд усес тҳе ИРФУ флаг то репресент тҳе Ириш ругбй унион теам. Фор ёутҳ теамс ин соме спорц (сеэ тҳе дата паге), тҳе аге лимит муст бе аддитионаллй сет усинг |аге=.
|налигн= [|нал=]
Сец тҳе алигнмент оф тҳе техт ин табле cелл формат (т). Тҳе дефаулт ис лефт; тҳе поссибле валуэс аре тҳе саме ас фор |алигн=.
|техт=
Оверридес тҳе энтире техт; онлй усе wҳен неcессарй фор анй нонстандард формац. Алтернативелй, ёу cан сет тҳе тҳирд леттер оф тҳе формат параметер то х (но техт) анд адд cустом техт оуциде тҳе темплате.
|нодата=й
Оверридес аттемпц то усе тҳе cорреспондинг {{country data ...}} темплате, wҳич ис усефул wҳен тҳе cорреспондинг дата темплате доэсн'т эхист.
|преф2=, |суфф2=, |плинк2=, |псеcтион2=
Иф тҳе ф эхтра ис спеcифиэд, анд тҳе префих/суффихед артиcле наме беинг линкед то доэсн'т эхист, тҳен усе тҳесе параметерс ас ан алтернате префих/суффих, анд чеcк иф ит эхисц ас wелл. (Иф ит стилл доэсн'т эхист, тҳен фалл баcк то тҳе нон-префихед/суффихед паге ас нормал). Тҳис май бе эхпенсиве, анд тҳе нумбер оф тиме ит cан бе усед он сингле паге ис лимитед.

Эхамплес

Формац:

Табле формат & алигнмент:

{{flagg|utu|Jamaica}} Жамаиcа
{{flagg|utur|Jamaica}} Жамаиcа
{{flagg|utu|Jamaica|al=l|nal=l}} Жамаиcа
{{flagg|utu|Jamaica|al=c|nal=c}} Жамаиcа
{{flagg|utu|Jamaica|al=r|nal=r}} Жамаиcа
  • {{flagg|usu|Switzerland}} →  Сwитзерланд
  • {{flagg|usu|Switzerland|al=l}} →  Сwитзерланд
  • {{flagg|usu|Switzerland|al=c}} →  Сwитзерланд
  • {{flagg|usu|Switzerland|al=r}} →  Сwитзерланд

Стандард имаге & наме параметерс:

Линкс анд алтварс:

Нон-эхистинг дата темплате:

  • {{flagg|isc|EUSSR|nodata=1}} →  ЭУССР
  • {{flagg|isc|EUSSR|nodata=1|image=EUSSR red flag.svg|size=xl}} →  ЭУССР
Сеэ алсо: Ҳелп:Табле#Аддинг линкс то спеcиализед cоунтрй, стате, ор территорй артиcлес.

Фор эхампле:

Онcе ёу ҳаве а табле wитҳ {{флаглист}} ор отҳер флаг темплате ит ис эасй то cонверт тҳе линкс то спеcиализед линкс. Со инстеад оф Оклаҳома ёу wоулд ҳаве Инcарcератион ин Оклаҳома, ор иф тҳат артиcле доэс нот эхист, тҳен Cриме ин Оклаҳома.

Усе а глобал финд-анд-реплаcе ин тҳе wикитехт. Реплаcе:

{{flaglist

wитҳ

{{flagg|us*eft|pref=Incarceration in|pref2=Crime in

Тҳе {{флагг}} темплате лоокс фор тҳе артиcлес. Иф ит финдс оне оф тҳе тwо чоиcес ит аддс тҳе линк анд ан астериск афтер тҳе стате, cоунтрй, территорй, ор отҳер субнатионал ареа наме. Иф ит доэс нот финд эитҳер артиcле, ит жуст аддс тҳе стандард линк.

Субституте ёур преферред топиcс ин тҳе преф= анд преф2= споц. Фор море инфо сеэ Ҳелп:Табле анд иц сеcтионс он аддинг флагс анд cоунтрй/стате/территорй линкс.

Тҳис партиcулар усе оф {{флагг}} параметерс ис эхпенсиве анд cан онлй бе усед он а феw ҳундред линкс пер артиcле. Эверй тиме тҳе артиcле ис савед ит оccурс. Со онлй оне биг cоунтрй табле пер артиcле. Отҳер cоунтрй таблес ин тҳе саме артиcле шоулд усе стандард линкс.

Cомпарисон wитҳ отҳер темплатес

Тҳесе "спеcиализед" темплатес предате Флагг, анд wҳиле мост до нот ҳаве оптионс фор cустом линкс анд имагес, тҳей аре пробаблй фастер беcаусе тҳей онлй до тwо трансcлусионс wитҳоут инвокинг Луа.

Генерал темплатес

Темплате Cорреспондинг {{flagg}} сйнтах Эхампле
{{flag|country}} {{flagg|uncb|country}} {{flag|China}} →  Чина
{{flagg|unc|China}} →  Чина
{{flagbig|country}} {{flagg|ulc|country|sz=l}} {{flagbig|China}} → Андоза:Флагбиг
{{flagg|ulc|China|sz=l}} →
Чина
{{flagc|country}} {{flagg|inc|country}} {{flagc|China}} → Андоза:Флагc
{{flagg|inc|China}} →  Чина
{{flagcountry|country}} {{flagg|unce|country}} {{flagcountry|CHN}} →  Хитой
{{flagg|unce|CHN}} →  Хитой
{{flagdeco|country}} {{flagg|uxxo|country}} {{flagdeco|China}} →
{{flagg|uxx|China}} →
{{flagicon|country}} {{flagg|cxxlo|country}} {{flagicon|China}} → Хитой
{{flagg|cxxlo|China}} → Хитой
{{flagicon image|image}} {{flagg|uxx|image=image}} {{flagicon image|Flag of China.svg}} →
{{flagg|uxx|image=Flag of China.svg}} →
{{flaglink|country|suffix}} {{flagg|unp|country|suff=suffix}} {{flaglink|China|at the Hopman Cup}} →  Хитой
{{flagg|unp|China|suff=at the Hopman Cup}} →  Чина
{{flag+link|prefix|country}} {{flagg|unp|country|pref=prefix}} (но эхистенcе чеcк) {{flag+link|Agriculture in|China}} → Андоза:Флаг+линк
{{flagg|unp|China|pref=Agriculture in}} →  Чина
{{flaglist|country}} {{flagg|usc|country}} {{flaglist|China}} →  Чина
{{flagg|usc|China}} →  Чина
{{flagof|country}} {{flagg|unp|country|sz=l}} {{flagof|China}} → Андоза:Флагоф
{{flagg|unp|China|sz=l}} →  Чина
{{flagright|country}} {{flagg|uncr|country}} {{flagright|China}} → Андоза:Флагригҳт
{{flagg|uncr|China}} → Чина 
{{flagu|country}} {{flagg|unu|country}} {{flagu|China}} →  Чина
{{flagg|unu|China}} →  Чина
{{noflag|country}} {{flagg|xnu|country}} {{noflag|China}} →  Чина
{{flagg|xnu|China}} →  Чина
{{noflag|[[country]]}} {{flagg|xnc|country}} {{noflag|[[China]]}} →  Чина
{{flagg|xnc|China}} →  Чина

Спорц/милитарй темплатес

Тҳе фоотбалл темплатес аре усед ас эхамплес ҳере; отҳер спорц тҳат ҳаве сепарате темплатес wорк cорреспондинглй.

Темплате Cорреспондинг {{flagg}} сйнтах Эхампле
{{fb|country}} {{flagg|unpe|country|avar=fb}} {{fb|China}} →  Хитой
{{flagg|unpe|China|avar=fb}} →  Хитой
{{fb|country|align=1}} {{flagg|uspe|country|avar=fb|al=c}} {{fb|China|align=1}} → Андоза:Флаглинк/алигнед
{{flagg|uspe|China|al=c|avar=fb}} →  Хитой
{{fb-big|country}} {{flagg|ulpe|country|avar=fb|sz=l}} {{fb-big|China}} →
Хитой
{{flagg|ulpe|China|sz=l|avar=fb}} →
Хитой
{{fb-rt|country}} {{flagg|unpre|country|avar=fb}} {{fb-rt|China}} → Хитой 
{{flagg|unpre|China|avar=fb}} → Хитой 
{{fbu|age|country}} {{flagg|unpe|country|avar=fbu|age=age}} {{fbu|17|China}} →  Хитой
{{flagg|unpe|China|age=17|avar=fbu}} →  Хитой
{{fbw|country}} {{flagg|unpe|country|avar=fbw}} {{fbw|China}} →  Хитой
{{flagg|unpe|China|avar=fbw}} →  Хитой
{{fbwu|age|country}} {{flagg|unpe|country|avar=fbwu|age=age}} {{fbwu|17|China}} →  Хитой
{{flagg|unpe|China|age=17|avar=fbwu}} →  Хитой
{{army|country}} {{flagg|unfe|country|avar=army}} (но аутоматиc наме оверриде) {{army|China}} →  Халқ Қуруқлик қўшин кучларининг Озод Армияси
{{flagg|unfe|China|avar=army}} →  Хитой Армй
{{navy|country}} {{flagg|unfe|country|avar=navy}} (но аутоматиc наме оверриде) {{navy|China}} →  Халқ Ҳарбий денгиз кучларининг Озод Армияси
{{flagg|unfe|China|avar=navy}} →  Хитой Навй
{{air force|country}} {{flagg|unfe|country|avar=air force}} (но аутоматиc наме оверриде) {{air force|China}} →  Халқ Ҳаво кучларининг Озод Армияси
{{flagg|unfe|China|avar=air force}} →  Хитой Аир Форcе

Сеэ алсо

  • Усер:СиБр4/Флагг тесц — эхтенсиве тесц оф тҳе темплате'с фунcтионс, wҳич май алсо серве ас аддитионал эхамплес