Jump to content

Template:Эхcерпт/доc

From Ziyosfera

Тҳис темплате ис усед фор реусинг парц оф пагес ин отҳер пагес. Тҳис праcтиcе ҳас тҳе фоллоwинг адвантагес:

  • Редуcес маинтенанcе бй авоидинг дуплиcате cонтент тҳат муст бе упдатед мултипле тимес
  • Импровес cонтент қуалитй бй энcоурагинг эдиторс то мерге релатед cонтент, ратҳер тҳан ҳавинг мултипле версионс ин вариоус стагес оф девелопмент
  • Фостерс cоллаборатион бй чаннелинг cонтрибуторс инто оне плаcе, ратҳер тҳан wоркинг ин параллел

Ит алсо ҳас тҳе фоллоwинг дисадвантагес:

  • Импедимент то эдитинг ас ёу ҳаве то го то тҳе суб артиcле то маке чангес то тҳе маин артиcле
  • Редуcес аccураcй ас ан эхcерпт оф оне артиcле ис нот алwайс а перфеcт фит инто а неw артиcле (бут сеэ #Рефинемент усинг инcлусион cонтрол)
  • Деcреасес висибилитй ас чангес то тҳе суб артиcле wилл нот аппеар он тҳе wатчлист оф эдиторс оф тҳе маин артиcле

Тҳис темплате эхтендс тҳе cапабилитиэс оф тҳе буилт-ин нормал трансcлусион анд лабелед сеcтион трансcлусион.

Усаге

Басиc усаге

  • {{Excerpt|Page title}} — Трансcлуде тҳе леад сеcтион (эхампле)
  • {{Excerpt|Page title|Section title}} — Трансcлуде а спеcифиc сеcтион, эхcлудинг анй субсеcтионс (эхампле)

Параметерс

  • 1 ор article ор page — Реқуиред. Наме оф тҳе артиcле ор паге то трансcлуде. Бй дефаулт тҳе леад сеcтион ис трансcлудед (эхампле). Иф тҳе паге cонтаинс ан инфобох, тҳе имаге анд cаптион оф тҳе инфобох wилл бе трансcлудед бут нот тҳе инфобох. Алсо, темплатес листед ат Модуле:Эхcерпт/cонфиг wилл нот бе трансcлудед (унлесс реқуэстед эхплиcитлй wитҳ |темплатес=, сеэ белоw).
  • 2 ор section ор fragment — Наме оф тҳе сеcтион то трансcлуде (эхампле) ор оф тҳе <section> таг то трансcлуде (эхампле). Муст бе маркед wитҳ <section begin=Name of the fragment/> анд <section end=Name of the fragment/> ин тҳе трансcлудед паге. Нотиcе тҳат тҳис темплате провидес отҳер wайс оф таргетинг спеcифиc фрагменц оф а паге wитҳоут ҳавинг то ресорт то сеcтион тагс.
  • only — Элеменц то трансcлуде. Бй дефаулт алл элеменц аре трансcлудед (эхcепт темплатес блаcклистед ат Модуле:Эхcерпт/cонфиг)
    • only=file — Трансcлуде онлй тҳе фирст филе
    • only=files — Трансcлуде онлй филес (эхампле)
    • only=list — Трансcлуде онлй тҳе фирст лист
    • only=lists — Трансcлуде онлй лисц
    • only=table — Трансcлуде онлй тҳе фирст табле
    • only=tables — Трансcлуде онлй таблес (эхампле)
    • only=template — Трансcлуде онлй тҳе фирст темплате
    • only=templates — Трансcлуде онлй темплатес
    • only=paragraph — Трансcлуде онлй тҳе фирст параграпҳ
    • only=paragraphs — Трансcлуде онлй параграпҳс
  • paragraphs — Параграпҳс то трансcлуде. Бй дефаулт алл параграпҳс аре трансcлудед.
    • paragraphs=0 — Трансcлуде но параграпҳс
    • paragraphs=1 — Трансcлуде тҳе фирст параграпҳ
    • paragraphs=2 — Трансcлуде тҳе сеcонд параграпҳ
    • paragraphs=1,3 — Трансcлуде тҳе фирст анд тҳирд параграпҳс
    • paragraphs=1-3 — Трансcлуде тҳе фирст, сеcонд анд тҳирд параграпҳс
    • paragraphs=1-3,5 — Трансcлуде тҳе фирст, сеcонд, тҳирд анд фифтҳ параграпҳс
    • paragraphs=-1 — Трансcлуде алл параграпҳс эхcепт тҳе фирст
    • paragraphs=-2 — Трансcлуде алл параграпҳс эхcепт тҳе сеcонд
    • paragraphs=-1,3 — Трансcлуде алл параграпҳс эхcепт тҳе фирст анд тҳирд
    • paragraphs=-1-3 — Трансcлуде алл параграпҳс эхcепт тҳе фирст, сеcонд анд тҳирд
    • paragraphs=-1-3,5 — Трансcлуде алл параграпҳс эхcепт тҳе фирст, сеcонд, тҳирд анд фифтҳ
  • lists — Лисц то трансcлуде. Бй дефаулт алл лисц аре трансcлудед. Саме сйнтах ас wҳен трансcлудинг параграпҳс.
  • files — Филес то трансcлуде. Бй дефаулт алл филес аре трансcлудед. Саме сйнтах ас wҳен трансcлудинг параграпҳс, бут алсо:
    • files=A.jpg — Трансcлуде тҳе филе намед 'А.жпг'
    • files=A.jpg, B.png, C.gif — Трансcлуде тҳе филес намед 'А.жпг', 'Б.пнг' анд 'C.гиф'
    • files=.+%.png — Трансcлуде алл ПНГ филес
    • files=-A.jpg — Трансcлуде алл филес эхcепт тҳе оне намед 'А.жпг'
    • files=-A.jpg, B.png, C.gif — Трансcлуде алл филес эхcепт тҳе онес намед 'А.жпг', 'Б.пнг' анд 'C.гиф'
    • files=-.+%.png — Трансcлуде алл нон-ПНГ филес
  • tables — Таблес то трансcлуде. Бй дефаулт алл таблес аре трансcлудед. Саме сйнтах ас wҳен трансcлудинг параграпҳс, бут алсо:
    • tables=Stats2020 — Трансcлуде тҳе табле wитҳ ид 'Стац2020'
    • tables=Stats2020, Stats2019, Stats2018 — Трансcлуде тҳе таблес wитҳ идс 'Стац2020', 'Стац2019' анд 'Стац2018'
    • tables=-Stats2020 — Трансcлуде алл таблес эхcепт тҳе оне wитҳ ид 'Стац2020'
    • tables=-Stats2020, Stats2019, Stats2018 — Трансcлуде алл таблес эхcепт тҳе онес wитҳ идс 'Стац2020', 'Стац2019' анд 'Стац2018'
  • templates — Темплатес то трансcлуде. Бй дефаулт алл темплатес аре трансcлудед эхcепт тҳосе блаcклистед ат Модуле:Эхcерпт/cонфиг. Усинг а ҳйпҳен бефоре а cомма-делимитед лист оф темплатес аддс тҳосе темплатес то тҳе блаcклист.
    • templates=-Ocean — Адд тҳе темплате 'Оcеан' то тҳе блаcклист
    • templates=-Ocean, Nature — Адд тҳе темплатес 'Оcеан' анд 'Натуре' то тҳе блаcклист
    • templates=Infobox person — Игноре тҳе блаcклист анд трансcлуде тҳе темплате 'Инфобох персон'
    • templates=Infobox person, Ocean — Игноре тҳе блаcклист анд трансcлуде тҳе темплатес 'Инфобох персон' анд 'Оcеан'
    • templates=.* — Игноре тҳе блаcклист анд трансcлуде алл темплатес
  • this — Чанге тҳе инитиал техт оф тҳе ҳатноте. Фор эхампле, иф тҳе трансcлудед cонтент ис а галлерй, ёу cан сет this=This gallery is со тҳат тҳе ҳатноте реадс "Тҳис галлерй ис ан эхcерпт фром..." (эхампле).
  • hat=no — Ҳиде тҳе ҳатноте "Тҳис сеcтион ис ан эхcерпт фром..."
  • bold=yes — Пресерве болд техт.
  • quote=yes — Wрап тҳе эхcерпт wитҳ <blockquote> тагс.
  • inline=yes — Ремове тҳе ҳатноте анд wрап тҳе эхcерпт wитҳ <span> тагс то усе ит инсиде отҳер техт.
  • references=no — Ремове алл референcес.
  • subsections=yes — Инcлуде субсеcтионс оф тҳе трансcлудед сеcтион. Нотиcе тҳат иф тҳе трансcлусион ис доне фром а сеcтион левел 3, анд тҳе трансcлудед субсеcтионс аре левел 3 тоо, тҳен тҳе трансcлудед субсеcтионс wилл шоw wитҳ тҳе саме ҳиэрарчй ас тҳе трансcлудинг сеcтион, wҳич ис пробаблй нот десирабле, со усе wитҳ cаутион.

Реплаcинг Темплате:Маин

Файл:Ҳоw то эхcерпт.wебм

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

  1. Опен тҳе сеcтион ин оне таб анд тҳе субпаге ин анотҳер.
  2. Эдит ботҳ.
  3. Cопй тҳе техт оф тҳе сеcтион анд пасте ит белоw тҳе леад сеcтион оф тҳе субпаге.
  4. Делете репеатед cонтент анд аджуст усинг cоммон сенсе.
  5. Саве тҳе чангес ин тҳе субпаге wитҳ ан эдит суммарй лике: Бринг cонтент фром [[Page]].
  6. Баcк то тҳе сеcтион, делете алл cонтент анд реплаcе ит фор ан эхcерпт оф тҳе субпаге.
  7. Саве тҳе чангес ин тҳе сеcтион wитҳ ан эдит суммарй лике: Мове cонтент то [[Subpage]] анд леаве ан эхcерпт.

Рефинемент усинг инcлусион cонтрол

Сометимес, а пассаге wилл алмост фит фор а трансcлусион, бут нот қуите. Ин тҳесе cасес, ёу cан эдит тҳе соурcе паге то адд <noinclude>...</noinclude> тагс ароунд cонтент ёу дон'т wант ин тҳе эхcерпт анд <includeonly>...</includeonly> тагс ароунд cонтент ёу wант онлй ин тҳе эхcерпт.

Фор инстанcе, тҳе паге CОВИД-19 мисинформатион бегинс Тҳе CОВИД-19 пандемиc ҳас ресултед ин мисинформатион.... Ҳоwевер, wҳен эхcерптинг тҳис леад то тҳе мисинформатион сеcтион оф CОВИД-19 пандемиc, wе дон'т неэд то спеcифй wҳич пандемиc wе'ре реферринг то. Тҳерефоре, тҳе cоде The <noinclude>[[COVID-19 pandemic]]</noinclude><includeonly>pandemic</includeonly> has resulted in [[misinformation]] cан бе усед ат тҳе мисинформатион паге, со тҳат ит wилл аппеар ат тҳе пандемиc паге ас Тҳе пандемиc ҳас ресултед ин мисинформатион....

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

Плеасе ноте тҳат wҳен тҳе </noinclude> таг ис wраппед инто а неw лине, а чараcтер нехт то ит wоулд бе интерпретед ас а лине бегиннинг. Тҳис cан леад то соме форматтинг проблемс. Фор эхампле, wҳен а </noinclude> ат лине бегиннинг ис суccеэдед бй а wҳитеспаcе чараcтер, тҳе паге энгине wоулд транслате тҳис ас а леадинг спаcе тҳат рендерс тҳе субсеқуэнт параграпҳ ин cоде блоcк анд моноспаcед фонт wитҳ пресервед форматтинг. Фор тҳис реасон, но спаcес шоулд сепарате тҳе </noinclude> таг фром тҳе техт ит преcедес.

Cомпаред то #сеcтион

Фор симпле cасес оф трансcлудинг сеcтионс оф артиcлес, тҳе Андоза:Пф, Андоза:Пф, анд Андоза:Пф (аббревиатед Андоза:Пф, Андоза:Пф, анд Андоза:Пф)) парсер фунcтионс cан бе усед инстеад оф тҳис темплате. Андоза:Пф wилл трансcлуде тҳе сеcтион оф "артиcле" wитҳ тҳе ҳеадер "фрагментнаме", анд Андоза:Пф wилл трансcлуде тҳе леад сеcтион оф "артиcле". Эхcерптинг онлй спеcифиc параграпҳс cан бе доне бй маркинг уп тҳе соурcе артиcле wитҳ <section begin=fragmentname/>...<section end=fragmentname/> тагс анд усинг Андоза:Пф то трансcлуде тҳосе фрагменц, wҳич ис эқуивалент то усинг тҳе |фрагмент=фрагментнаме параметер wитҳ тҳис темплате. Андоза:Пф cан алсо бе усед то трансcлуде эверйтҳинг бут тҳосе фрагменц.

Тҳе техт wилл нот бе триммед оф эхcесс wҳитеспаcе, тҳере wилл нот бе а ҳеадер (эқуивалент то |ҳат=но, анд алл филес, темплатес, таблес, референcес, анд субсеcтионс wилл бе инcлудед унлесс тҳе соурcе артиcле ис маркед уп wитҳ <section begin=fragmentname/>...<section end=fragmentname/>, <ноинcлуде>...</ноинcлуде>, ор <онлйинcлуде>...</онлйинcлуде> тагс. Селф линкс wилл аппеар ин болд.

Эхcерпт треэс

Висуал репресентатион оф ан эхcерпт треэ.

Wҳен а верй генерал артиcле (лике Пҳилосопҳй) усес эхcерпц фром море спеcифиc артиcлес (лике Этҳиcс, Метапҳйсиcс, Логиc, этc), wҳич ин турн усе эхcерпц фром эвен море спеcифиc артиcлес (лике Онтологй, Cаусалитй, этc), тҳен а треэ струcтуре эмергес, cаллед ан "Эхcерпт треэ".

Ин тҳис сеcтион ёу cан навигате тҳе маин эхcерпт треэс он тҳе Энглиш Wикипедиа. Ит'с усефул фор эдиторс интерестед ин эхпандинг ор импровинг тҳем. То навигате тҳе треэс, cлиcк тҳе фоллоwинг буттон(С):

ҳттпс://зиёсфера.уз/индех.пҳп?титле=Андоза:Эхcерпт/доc&wитҳЖС=МедиаWики:ЭхcерптТреэ.жс#Эхcерпт_треэс

Сеэ алсо

Темплате дата

Тҳис темплате ис усед фор трансcлудинг парт оф ан артиcле инто анотҳер артиcле.

Темплате параметерс

ПараметерДесcриптионТйпеСтатус
Артиcле1 артиcле паге

Наме оф тҳе артиcле ор паге то трансcлуде

Эхампле
Сcиэнcе
Паге намереқуиред
Сеcтион2 сеcтион фрагмент

Наме оф тҳе сеcтион ор <сеcтион> таг то трансcлуде

Эхампле
Ҳисторй
Стрингоптионал
Онлйonly

Трансcлуде онлй тҳис кинд оф элемент

Эхампле
табле
Стрингоптионал
Параграпҳсparagraphs параграпҳ

Параграпҳс то трансcлуде

Эхампле
1-3,5
Стрингоптионал
Филесfiles филе

Филес то трансcлуде

Дефаулт
1
Эхампле
1-3,5
Стрингоптионал
Таблесtables табле

Таблес то трансcлуде

Эхампле
Стац2020
Стрингоптионал
Лисцlists лист

Лисц то трансcлуде

Эхампле
1
Стрингоптионал
Темплатесtemplates темплате

Темплатес то трансcлуде

Эхампле
Инфобох персон
Стрингоптионал
Референcесreferences

Wҳетҳер то трансcлуде тҳе референcес

Эхампле
но
Боолеаноптионал
Субсеcтионсsubsections

Wҳетҳер то трансcлуде тҳе субсеcтионс оф тҳе реқуэстед сеcтион

Эхампле
ес
Боолеаноптионал
Ҳатнотеhat

Wҳетҳер то инcлуде тҳе ҳатноте

Эхампле
но
Боолеаноптионал
Тҳисthis

Чанге тҳе инитиал техт оф тҳе ҳатноте

Эхампле
Тҳис галлерй ис
Стрингоптионал
Инлинеinline

Ремове тҳе ҳатноте анд wрап тҳе эхcерпт wитҳ <спан> тагс то усе ит инсиде отҳер техт

Эхампле
ес
Боолеаноптионал
Cлассclass

Аддитионал CСС cласс

Эхампле
нопринт
Стрингоптионал