Модул:Пронађи изворе/доц

Тхис модуле продуцес а лист оф линкс то сеарцх енгинес то хелп едиторс финд соурцес абоут а гивен субјецт. Ит имплементс {{Пронађи изворе}} анд отхер симилар темплатес. Ит ис хигхлy еxтенсибле; неw темплатес анд неw линк тyпес цан бе аддед еасилy анд бy анy усер.

Усаге

Фром wикитеxт

Усуаллy, фром wикитеxт тхис модуле схоулд бе усед виа а темплате, е.г. {{Пронађи изворе}}. Хоwевер, ит ис алсо поссибле то усе ит дирецтлy фром #инвоке, лике тхис:

{{#invoke:Pronađi izvore|template|search term 1|search term 2|...}}

темплате ис тхе наме оф тхе темплате тхат схоулд бе цаллед. Ит муст бе тхе фулл паге наме оф тхе темплате, wитхоут тхе намеспаце, анд wитх тхе цоррецт цапиталисатион. Со, фор Темплате:Пронађи изворе, тхе темплате наме схоулд бе "Пронађи изворе"; "пронађи изворе" wитх а лоwер-цасе "п" wоулд цаусе ан еррор. Тхис параметер ис реqуиред.
сеарцх терм 1, сеарцх терм 2, етц., аре тхе термс то бе сеарцхед фор ин еацх оф тхе сеарцх енгине линкс. Тхе фирст сеарцх терм wилл аппеар ин qуотатион маркс, анд субсеqуент сеарцх термс wилл бе аддед wитхоут qуотатион маркс. Еацх терм wилл бе сепаратед бy спацес. Тхесе параметерс аре алл оптионал. Иф но параметерс аре гивен, тхе цуррент паге наме wилл бе усед ас а сеарцх терм.

Фром Луа

Лоад тхе модуле wитх тхе фоллоwинг цоде:

local mFindSources = require('Modul:Pronađi izvore')

Yоу цан тхен продуце тхе лист оф сеарцх линкс лике тхис:

mFindSources._main(template, searchTerms)

темплате ис тхе темплате наме, ас оутлинед ин тхе #Фром wикитеxт сецтион абове. Тхис параметер ис реqуиред.
сеарцхТермс ис ан арраy оф сеарцх термс. Еацх итем ин тхе арраy цорреспондс то а нумберед сеарцх терм ас оутлинед ин тхе #Фром wикитеxт сецтион абове. Тхис параметер ис оптионал.

Еxампле сyнтаx:

mPronađi izvore._main('Pronađi izvore', {'Albert Einstein', '-"Marilyn Monroe"', 'relativity', 'science'})

Аваилабле темплатес

Тхе фоллоwинг темплатес аре аваилабле фор усе:

Луа грешка ин пацкаге.луа ат лине 80: модуле 'Модул:Пронађи изворе/темплатес' нот фоунд.

Макинг неw темплатес

Тхере аре тwо басиц ингредиентс то макинг а неw соурце-финдинг темплате. Тхе фирст ис тхе темплате цонфигуратион модуле, анд тхе сецонд ис тхе темплате инвоцатион он тхе темплате паге.

Темплате цонфигуратион паге

То финд тхе наме оф тхе темплате цонфигуратион паге, таке тхе паге наме оф yоур пропосед темплате wитхоут тхе намеспаце префиx, анд адд ит то тхе басе паге оф "Модуле:Пронађи изворе/темплатес/". Фор еxампле, фор Темплате:Пронађи изворе, тхе цонфигуратион паге ис лоцатед ат Модуле:Пронађи изворе/темплатес/Пронађи изворе. Ноте тхат тхе темплате муст бе цапиталисед еxацтлy ас тхе паге наме ис, отхерwисе тхе аргументс wилл нот бе пассед тхроугх фром тхе темплате паге то тхе модуле.

Тхе темплате цонфигуратион паге схоулд лоок сометхинг лике тхис:

return {
	blurb = "Pronađi izvore for $1 – $2",
	introLink = {code = 'google'},
	links = {
		{code = 'google news', display = 'news'},
		{code = 'google newspapers', display = 'newspapers'}
	},
	separator = ', ',
	isUsedInMainspace = true,
	class = 'custom-class',
	style = 'color: green; font-size: 110%;'
}

блурб - тхе теxт пресентед то усерс. Тхере аре тwо параметерс аваилабле ин тхе блурб, $1 анд $2. $1 ис тхе интро линк, иф специфиед, анд $2 репресентс тхе отхер линкс. Тхис фиелд ис реqуиред.
интроЛинк - ан оптионал интродуцторy линк. Иф специфиед, тхис муст бе а линк табле. Иф тхе дисплаy валуе ин тхе линк табле ис нот сет, тхе сеарцх термс тхат тхе усер ентеред wилл бе усед инстеад.
линкс - ан арраy оф линк таблес дефининг тхе маин линкс то бе усед бy тхе темплате. Тхис фиелд ис реqуиред.
сепаратор - тхе теxт сепаратинг тхе сеарцх енгине линкс. Тхис фиелд ис оптионал; тхе дефаулт валуе ис такен фром МедиаWики:Дот-сепаратор.
исУседИнМаинспаце - сет тхис то труе иф тхе темплате wилл бе усед ин тхе маин намеспаце. Иф тхис ис нот сет, wхен тхе темплате ис усед ин тхе маин намеспаце ит wилл продуце ан еррор анд бе пут ин Цатегорy:Пагес wитх темплатес ин тхе wронг намеспаце.
цласс - а цустом ХТМЛ цласс то апплy то тхе темплате теxт. Тхе "плаинлинкс" цласс ис аддед бy дефаулт. Тхис фиелд ис оптионал.
стyле - цустом ЦСС то апплy то тхе темплате теxт. Тхис фиелд ис оптионал.

Онце yоу хаве цреатед yоур темплате цонфигуратион паге, yоу неед то адд тхе темплате то Модуле:Пронађи изворе/темплатес ин ордер фор ит то схоw уп ин тхе табле оф темплатес он тхис доцументатион паге.

Линк таблес

Линк таблес аре усед ин тхе "интроЛинк" анд "линкс" фиелдс оф тхе темплате цонфигуратион. Тхеy цан цонтаин тwо фиелдс, "цоде" анд "дисплаy". Тхе "цоде" фиелд ис цомпулсорy, анд муст бе оне оф тхе линк цодес листед ин тхе табле белоw. Тхе "дисплаy" фиелд ис оптионал, анд специфиес а цустом дисплаy валуе фор тхат линк то бе усед бy тхе темплате. Иф тхе дисплаy фиелд ис нот сет, а дефаулт валуе ис сет бy тхе модуле. Фор тхе "интроЛинк" фиелд, тхе дефаулт валуе ис тхе сеарцх теxт ентеред бy тхе усер; фор тхе "линкс" фиелд, тхе дефаулт валуе ис дефинед ин тхе линк цонфигуратион модулес.

Тхе фоллоwинг табле цонтаинс алл тхе аваилабле линк цодес, wитх десцриптионс анд еxамплес.

Цоде	Десцриптион	Еxампле	Цонфигуратион	Нотес
бинг	Бинг, Мицрософт'с флагсхип сеарцх енгине.	Бинг	маин, доцументатион	Тхис ис а реплацемент фор МС Боокс анд МС Ацадемиц, wхицх унфортунателy хаве беен дисцонтинуед бy Мицрософт.
дуцкдуцкго	ДуцкДуцкГо, а сеарцх енгине тхат емпхасизес протецтинг сеарцхерс' привацy анд авоидинг тхе "филтер буббле" оф персонализед сеарцх ресултс.	ДуцкДуцкГо	маин, доцументатион
гоогле	Гоогле, тхе флагсхип сеарцх енгине фром Гоогле Инц.	Гоогле	маин, доцументатион
гоогле боокс	Гоогле Боокс, Гоогле'с сеарцх енгине фор боокс.	Гоогле Боокс	маин, доцументатион
гоогле фрее имагес	Гоогле Имагес, Гоогле'с сеарцх енгине фор имагес. Онлy имагес цомпатибле wитх Wикипедиа'с лиценсинг аре инцлудед.	Фрее Гоогле Имагес	маин, доцументатион
гоогле неwс	Гоогле Неwс, Гоогле'с сеарцх енгине фор неwс ситес.	Гоогле Неwс	маин, доцументатион	Ин тхе паст тхис линк сеарцхед неwс арцхивес, бут тхис фунцтионалитy хас беен ремовед бy Гоогле. Цуррентлy, онлy рецент неwс артицлес аре сеарцхед.
гоогле неwспаперс	Гоогле Неwспаперс, а сеарцх оф Гоогле'с дигитал арцхиве оф принт неwспаперс.	Гоогле Неwспаперс	маин, доцументатион
гоогле сцхолар	Гоогле Сцхолар, Гоогле'с сеарцх енгине фор ацадемиц паперс анд отхер сцхоларлy ресеарцх.	Гоогле Сцхолар	маин, доцументатион
хигхбеам	Хигхбеам, а паид сеарцх енгине анд фулл теxт онлине арцхиве оwнед бy Ценгаге Леарнинг. Аваилабле тхроугх Тхе Wикипедиа Либрарy.	Хигхбеам	маин, доцументатион
јстор	ЈСТОР, ан онлине либрарy цонтаининг дигитисед версионс оф ацадемиц јоурналс. Реqуирес а субсцриптион.	ЈСТОР	маин, доцументатион
неw yорк тимес	Тхе wебсите оф Тхе Неw Yорк Тимес, а хигхлy респецтед неwспапер.	Неw Yорк Тимес	маин, доцументатион
вгрс	Тхиббс' Гоогле РС, а цустом Гоогле сеарцх енгине тхат лимитс тхе сеарцх то ситес листед ин Wикипедиа:WикиПројецт Видео гамес/Соурцес.	ВГРС	маин, доцументатион
wикипедиа либрарy	А линк то Wикипедиа:Тхе Wикипедиа Либрарy. Тхис исн'т ацтуаллy а сеарцх линк, бут а портал паге фор вариоус ресоурцес аваилабле онлy то Wикипедианс.	Wикипедиа Либрарy	маин, доцументатион
wикипедиа референце сеарцх	Wикипедиа Референце Сеарцх, а Гоогле сеарцх тхат онлy сеарцхес ситес веттед бy Wикипедианс.	Wикипедиа Референце Сеарцх	маин, доцументатион

Темплате инвоцатион

Тхе темплате инвоцатион он тхе темплате паге итселф схоулд лоок лике тхис:

{{#invoke:Pronađi izvore|template}}<noinclude>
{{#invoke:Pronađi izvore/autodoc|template}}
</noinclude>

Тхис ацтиватес тхе темплате цоде анд алсо провидес аутоматиц доцументатион. темплате ис тхе наме оф тхе темплате wитхоут тхе намеспаце префиx, анд муст бе цоррецтлy цапиталисед.

Иф yоу wант то усе цустом доцументатион фром а /доц субпаге инстеад оф тхе аутоматиц доцументатион, усе тхис инвоцатион инстеад:

{{#invoke:Pronađi izvore|template}}<noinclude>
{{documentation}}
<!-- Categories go on the /doc subpage, and interwikis go on Wikidata. -->
</noinclude>

Аддинг неw линкс

То маке а неw линк цоде аваилабле то усе фром соурце-финдинг темплатес, yоу неед то маке а линк цонфигуратион модуле фор ит. Тхе паге наме фор тхис модуле схоулд старт wитх "Модуле:Пронађи изворе/линкс/" анд енд wитх тхе линк цоде. Линк цодес схоулд бе схорт бут десцриптиве, анд схоулд бе ин лоwер цасе. Фор еxампле, тхе линк цоде фор Гоогле сеарцх ис "гоогле", анд тхе цонфигуратион паге ис ат Модуле:Пронађи изворе/линкс/гоогле.

Тхе линк цонфигуратион паге схоулд лоок сометхинг лике тхис:

return {
	url = '//www.google.com/search?q=$1',
	display = 'Google',
	separator = ','
}

урл - Тхе урл то перформ тхе сеарцх. Тхис фиелд такес а параметер $1, wхицх ис тхе УРЛ-енцодед сеарцх теxт ентеред бy тхе усер. Тхис фиелд ис реqуиред.
дисплаy - Иф а дисплаy валуе ис нот специфиед ин тхе темплате цонфигуратион, тхис валуе ис усед инстеад. Тхис фиелд ис реqуиред.
сепаратор - Тхис ис усед то сепарате тхе сеарцх термс ентеред бy тхе усер. Тхис ис оптионал, анд дефаултс то "+" (а УРЛ-енцодед спаце).

Онце yоу хаве цреатед yоур линк цонфигуратион паге, yоу неед то адд тхе линк то Модуле:Пронађи изворе/линкс ин ордер фор ит то схоw уп ин тхе табле оф линкс он тхис доцументатион паге.

Аутоматиц доцументатион

Аутоматиц доцументатион ис провидед фор темплатес басед он тхис модуле; тхе доцументатион ис генератед бy Модуле:Пронађи изворе/аутодоц. Тхе аутодоц модуле усес тхе фоллоwинг пагес:

Темплате:Пронађи изворе доцументатион - тхе темплате усед фор мост оф тхе доцументатион цонтент.
Тхе темплате цонфигуратион паге. Усед то финд тхе лист оф линк цодес, анд то сее иф тхе темплате ис усед ин артицлес.
Тхе темплате доцументатион цонфигуратион паге. Усед то финд темплате схортцутс.
Тхе линк доцументатион цонфигуратион паге. Усед то финд десцриптионс оф еацх оф тхе сеарцх линкс.

Темплате доцументатион цонфигуратион паге

Тхис паге ис лоцатед ат тхе "/аутодоц" субпаге оф тхе темплате цонфигуратион паге. Ит ис онлy усед то генерате тхе доцументатион, нот то генерате анy оф тхе ацтуал темплате оутпут, со ит доес нот неед то бе протецтед. Ит схоулд лоок сометхинг лике тхис:

return {
	shortcuts = {'shortcut1', 'shortcut2'},
	description = 'This template is used to provide source links on [[WP:AFD|AfD]] pages',
	docIntro = 'This template produces a series of search-engine links to be used on [[WP:AFD|AfD]] pages.'
}

схортцутс - ан арраy оф схортцутс тхат редирецт то тхе темплате паге. Тхесе аре дисплаyед он тхе темплате доцументатион паге усинг тхе {{темплате схортцут}} темплате.
десцриптион - а бриеф десцриптион оф wхат тхе темплате доес. Тхис ис дисплаyед он тхис доцументатион паге ин тхе табле оф аваилабле темплатес.
доцИнтро - теxт то бе усед инстеад оф тхе фирст сентенце оф тхе темплате доцументатион фор индивидуал соурце-финдинг темплатес. Тхис ис оптионал, анд тхе дефаулт валуе ис "Тхис темплате продуцес а сериес оф линкс то вариоус сеарцх интерфацес то хелп финд аддитионал референце материал фор артицлес."

Линк доцументатион цонфигуратион паге

Тхис паге ис лоцатед ат тхе "/аутодоц" субпаге оф тхе линк цонфигуратион паге. Ит ис онлy усед то генерате тхе доцументатион, нот то генерате анy оф тхе ацтуал темплате оутпут, со ит доес нот неед то бе протецтед. Ит схоулд лоок сометхинг лике тхис:

return {
	description = '[[Google]], the flagship search engine from Google Inc.',
	notes = 'This is the most commonly used search link.'
}

десцриптион - а бриеф десцриптион оф wхат тхе сеарцх енгине линк доес. Тхис ис усед ин тхе темплате доцументатион то генерате тхе лист оф линк десцриптионс, анд алсо то маке тхе десцриптионс ин тхе табле оф линк цодес абове. Тхис ис оптионал, бут рецоммендед.
нотес - нотес абоут тхе сеарцх енгине линк. Тхесе аре пут ин тхе табле оф линк цодес абове, бут тхеy аре нот пут ин тхе темплате доцументатион фор индивидуал соурце-финдинг темплатес. Тхис фиелд ис оптионал.

Цонфигуратион

Тхе мессагес усед ин тхис модуле цан бе фоунд ат Модуле:Пронађи изворе/цонфиг анд Модуле:Пронађи изворе/аутодоц/цонфиг. Тхис цан бе хелпфул фор транслатинг тхис модуле фор усе ин отхер лангуагес. Ноте тхат анy темплате анд линк цонфигуратион усед муст алсо бе транслатед.