قالب:مسار/شرح

هذه صفحة توثيق فرعية تخص قالب:مسار.
تحتوي هذه الصفحة على معلومات و تصنيف ومحتويات أخرى تتعلق بشرح القالب ولا تعتبر جزءا منه.
للاطلاع على صفحة القالب نفسه، انظر قالب:مسار.

This template can be used to create a formatted external link.

Note - this template is for formatting the appearance of displayed URLs, while making them machine-readable as part of emitted microformat meta-data.

If you wish to display text instead of the URL (e.g. "BBC website" instead of bbc.co.uk), please do not use this template.

For web-based references, please see ويكيبيديا:قوالب تحديد المصادر

Usage

• {{مسار|1=url name|2=optional display text}}
  • The first parameter is parsed to see if it takes the form of a complete URL. If it doesn't start with a URI scheme (such as "http:", "https:", or "ftp:"), an "http://" prefix will be prepended to the specified generated target URL of the link.
  • Parameter 2 is deprecated.

Warning: The parameter 1 must be numbered explicitly if the URL contains an equal sign, as is common in the query string. This applies when the value of the URL is unknown, for example when this template is used in another template specifying the effective URL as a variable value. The deprecated second parameter for the displayed text, if present in legacy uses, must also be explicitly numbered if the first parameter is explicitly numbered; otherwise it will override the value of the first parameter.

Examples

Code	Result
{{ مسار }}	{{URL|example.com|optional display text}}
{{ مسار | }}	{{URL|example.com|optional display text}}
{{ مسار | EXAMPLE.com }}	example.com
{{ مسار | example.com }}	example.com
{{ مسار | http://example.com }}	example.com
{{ مسار | www.example.com }}	www.example.com
{{ مسار | http://www.example.com }}	www.example.com
{{ مسار | https://www.example.com }}	www.example.com
{{ مسار | ftp://www.example.com }}	www.example.com
{{ مسار | ftp://ftp.example.com }}	ftp.example.com
{{ مسار | http://www.example.com/ }}	www.example.com
{{ مسار | http://www.example.com/path }}	www.example.com/path
{{ مسار | irc://irc.example.com/channel }}	irc.example.com/channel
{{ مسار | www.example.com/foo }}	www.example.com/foo
{{ مسار | http://www.example.com/path/ }}	www.example.com/path/
{{ مسار | www.example.com/foo/ }}	www.example.com/foo/
{{ مسار | 1=http://www.example.com/path?section=17 }}	www.example.com/path?section=17
{{ مسار | 1=www.example.com/foo?page=42 }}	www.example.com/foo?page=42
{{ مسار | www.example.com | الموقع الرسمي }}	الموقع الرسمي
{{ مسار | http://www.example.com/foo | link }}	link (Deprecated)
{{ مسار | www.example.com/foo | link }}	link (Deprecated)
{{ مسار | http://www.example.com/foo/ | link }}	link (Deprecated)
{{ مسار | www.example.com/foo/ | link }}	link (Deprecated)

Microformat

The template wraps the displayed URL with a class="url" so that it is included in any parent microformat which takes a URL parameter - see our microformats project.

TemplateData

هذا توثيق بيانات القالب لهذا القالب المستخدم بواسطة المحرر المرئي والأدوات التانيه.

بيانات قالب مسار

A template to display and format a URL

وسائط القالب[تحرير بيانات القالب]

وسيط		وصف	نوع	حالة
URL	1	The URL to be linked	نص	مطلوب
Display text	2	The text to be displayed instead of the URL. Deprecated	نص	اختياري