Modul:فۆرمات لنک/بەلگە

Ev belgekirin binrûpela ji bo Modul:Format link e.
Agahiyên bikaranîna kategorî û naveroka din ku ew beşek ji ne eslî yên modul rûpel e.

تهس مۆدولە، مگراتەد فرۆم ئۆرگنس ئن مۆدولە:حاتنۆتە، پرۆڤدەس فونجتئۆنالتی فۆر فۆرماتتنگ لنکس فۆر دسپلای، ئنجلودنگ تهات پۆوەرنگ تهە {{فۆرمات لنک}} تەمپلاتە.

ئت جان پرەتتی-فۆرمات سەجتئۆن لنکس وته تهە سەجتئۆن سیمبۆل ("§") ئاند ئاپپرۆپرئاتە وهتەسپاجە، ئت ئائوتۆماتجاللی ئەسجاپەس جاتەگۆری ئاند فلە نامەس وته تهە جۆلۆن ترجک، ئاند ئنجلودەس فونجتئۆنالتی فۆر ئتالجزنگ تهە پاگە ئۆر سەجتئۆن نامە، ئاند فۆر دەتەجتنگ ئاند جاتەگۆرزنگ رەسولتس تهات پرۆدوجە رەد لنکس.

ئوسە فرۆم وکتەخت

تهە فونجتئۆنس ئن تهس مۆدولە جاننۆت بە ئوسەد درەجتلی فرۆم #ئنڤۆکە، ئاند موست بە ئوسەد تهرۆئوگه تەمپلاتەس ئنستەئاد. پلەئاسە سەئە تەمپلاتە:فۆرمات لنک فۆر دۆجومەنتاتئۆن ئۆن ئوساگە ئۆف تهات تەمپلاتە.

ئوسە فرۆم ئۆتهەر لوئا مۆدولەس

تۆ لۆئاد تهس مۆدولە فرۆم ئانۆتهەر لوئا مۆدولە، ئوسە تهە فۆللۆونگ جۆدە:

local mFormatLink = require('Module:Format link')

یۆئو جان تهەن ئوسە تهە فونجتئۆنس ئاس دۆجومەنتەد بەلۆو.

_فۆرماتلنک

mFormatLink._formatLink{
    link = 'Link',
    display = 'Display',
    target = 'Target',
    italicizePage = true,
    italicizeSection = true,
    categorizeMissing = 'Pages using formatted red links'
}

فۆرماتس لنک ئاس ئا وکلنک. جاتەگۆرئەس ئاند فلەس ئارە ئائوتۆماتجاللی ئەسجاپەد وته تهە جۆلۆن ترجک، ئاند لنکس تۆ سەجتئۆنس ئارە ئائوتۆماتجاللی فۆرماتتەد ئاس پاگە § سەجتئۆن، راتهەر تهان تهە مەدئاوک دەفائولت ئۆف پاگە#سەجتئۆن.

سەڤەرال ئۆپتئۆنس مۆدفی تهە ئۆئوتپوت:

ئف تهە دسپلای ڤالوئە ئس پرەسەنت، تهەن ئت ولل بە ئوسەد ئاس ئا دسپلای ڤالوئە. ئانی مانوئال پپنگ (ئوسنگ تهە {{!}} ماگج وۆرد ئۆر سملار) پرەسەنت ئن لنک ولل بە ئۆڤەررددەن بی تهە دسپلای ڤالوئە ئف پرەسەنت.
ئف تهە تارگەت ڤالوئە ئس پرەسەنت، تهەن ئت ولل ئۆڤەرردە لنک ئاس ئا تارگەت، بوت تهە رەسولت ولل ستلل بە دسپلایەد ئوسنگ ئەئتهەر تهە ڤالوئە فرۆم دسپلای، ئۆر تهە رەسولت ئۆف فۆرماتتنگ لنک.
ئف ئتالجزەپاگە ئس تروئە، تهەن تهە پاگە پۆرتئۆن ئۆف تهە لنک ئس ئتالجزەد ئف پرەسەنت.
ئف ئتالجزەسەجتئۆن ئس تروئە، تهەن تهە سەجتئۆن پۆرتئۆن ئۆف تهە لنک ئس ئتالجزەد ئف پرەسەنت.
ئف جاتەگۆرزەمسسنگ ئس ئا نۆن-ئەمپتی سترنگ، تهەن تهات ڤالوئە ئس ئوسەد ئاس ئا جاتەگۆری نامە، ئاند تهات جاتەگۆری ولل بە ئاپپلئەد ئف تهە رەسولتنگ تارگەت ئۆف تهە لنک (نۆ ماتتەر وهەتهەر تهرۆئوگه لنک ئۆر تهرۆئوگه تارگەت) دۆئەسن'ت ئەخست.

ئەخامپلەس: مفۆرماتلنک._فۆرماتلنک{لنک = 'فۆئۆ#بار'} → [[:Foo#Bar|Foo § Bar]] → شابلۆن:فۆرمات لنک; مفۆرماتلنک._فۆرماتلنک{لنک = 'باز'، دسپلای = 'قوخ'} → [[:Baz|Qux]] → شابلۆن:فۆرمات لنک; مفۆرماتلنک._فۆرماتلنک{لنک = 'فۆئۆ|بار'، دسپلای = 'باز'} → [[:Foo|Baz]] → شابلۆن:فۆرمات لنک; مفۆرماتلنک._فۆرماتلنک{لنک = '#فۆئۆ'، تارگەت = 'ئەخامپلە#فۆئۆ'} → [[:Example#Foo|§ Foo]] → شابلۆن:فۆرمات لنک; مفۆرماتلنک._فۆرماتلنک{لنک = 'تهە لۆرد ئۆف تهە رنگس#پلۆت'، ئتالجزەپاگە = تروئە} → [[:The Lord of the Rings#Plot|''The Lord of the Rings'' § Plot]] → شابلۆن:فۆرمات لنک; مفۆرماتلنک._فۆرماتلنک{لنک = 'جیبەرجرمە پرەڤەنتئۆن ئاجت ئۆف 2012#دسن ڤ. سەجرەتاری ئۆف ژوستجە'، ئتالجزەسەجتئۆن = تروئە} → [[:Cybercrime Prevention Act of 2012#Disini v. Secretary of Justice|Cybercrime Prevention Act of 2012 § ''Disini v. Secretary of Justice'']] → شابلۆن:فۆرمات لنک; مفۆرماتلنک._فۆرماتلنک{لنک = 'نۆنەخستەنت پاگە'، جاتەگۆرزەمسسنگ = 'ئەخامپلە'} → [[:Nonexistent page]][[Category:Example]] → شابلۆن:فۆرمات لنک; مفۆرماتلنک._فۆرماتلنک{لنک = 'ئەخستنگ'، جاتەگۆرزەمسسنگ = 'ئەخامپلە'} → [[:Existing]] → شابلۆن:فۆرمات لنک

فۆرماتپاگەس

mFormatLink.formatPages(options, pages)

تهس دەرڤەد فونجتئۆن ئس ئوسەفول فۆر لستس تهات فۆرمات مانی لنکس. ئت فۆرماتس ئان ئاررای ئۆف پاگەس ئوسنگ تهە _فۆرماتلنک فونجتئۆن، ئاند رەتورنس تهە رەسولت ئاس ئان ئاررای. ئۆپتئۆنس ئن تهە ئۆپتئۆنس تابلە ئارە ئاپپلئەد، ئاند ئوسە تهە سامە نامەس ئاس تهە ئۆپتئۆنس فۆر _فۆرماتلنک.

ئەخامپلە: مفۆرماتلنک.فۆرماتپاگەس({جاتەگۆرزەمسسنگ = 'ئەخامپلە'}، {'فۆئۆ#بار'، 'نۆنەخستەنت پاگە'}) → {'[[:فۆئۆ#بار|فۆئۆ §&نبسپ;بار]]'، '[[:نۆنەخستەنت پاگە]][[جاتەگۆری:ئەخامپلە]]'}

ئەررۆرس

ئف _فۆرماتلنک ئس ئوسەد ئاند نەئتهەر ئا لنک نۆر ئا تارگەت ئارگومەنت ئس پرۆڤدەد، تهەن تهە مۆدولە ولل پرۆدوجە ئان ئەررۆر مەسساگە ئنستەئاد ئۆف ئتس ئوسوئال ئۆئوتپوت، ئاس ئت جاننۆت تهەن پرۆدوجە ڤالد ئۆئوتپوت.

یۆئو جان سۆلڤە تهس ئەررۆر بی پرۆڤدنگ ئاپپرۆپرئاتە پارامەتەرس تۆ _فۆرماتلنک، ئۆر یۆئو مای وانت تۆ ئەنسورە تهات ئا مۆرە دەسجرپتڤە ئەررۆر ئس پرۆڤدەد بی ئا دۆونسترەئام تەمپلاتە ئۆر مۆدولە وهەن ئت وۆئولد ئۆتهەروسە جالل _فۆرماتلنک وته ئنادەقوئاتە ئارگومەنتس.