عبد العزيز: /* وسائط المحرر المرئي */تنسيق ويكي - إزالة الفراغات الزائدة من القوالب

2023-09-13T12:31:48Z

وسائط المحرر المرئي: تنسيق ويكي - إزالة الفراغات الزائدة من القوالب

صفحة جديدة

{{تبصرة|1=هذا القالب مخصص [[أرابيكا:وصلات خارجية|للوصلات الخارجية]]، وليس لاستخدامه في [[أرابيكا:قوالب الاستشهاد|قوالب الاستشهاد بالمراجع]].}}
{{lua|Module:Webarchive}}
يستخدم قالب {{قا|{{اسم_الصفحة}}}} لربط خدمات أرشفة الويب مثل [[واي باك مشين]] و[[ويب سايت|WebCite]].

== الاستخدام ==
In most cases the template needs only two arguments, the archive {{وسيط|url}} and archive {{وسيط|date}}.

Example:
::<code><nowiki>{{Webarchive|url=https://web.archive.org/web/20160801000000/http://example.com |date=1 August 2016}}</nowiki></code>
::Produces: {{Webarchive|url=https://web.archive.org/web/20160801000000/http://example.com |date=1 August 2016}}

Example 2:
::<code><nowiki>{{Webarchive|url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/ |date=12 February 2009}}</nowiki></code>
::Produces: {{Webarchive|url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/ |date=12 February 2009}}

It is also common to include a {{وسيط|title}}

Example 3:

::<code><nowiki>{{Webarchive|url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/ |date=12 February 2009 |title=Page title}}</nowiki></code>
::Produces: {{Webarchive|url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/ |date=12 February 2009 |title=Page title}}

== Multiple URLs ==

The template optionally supports multiple URLs (up to 10) for linking to multiple archiving services for the same source link. The first url argument is {{وسيط|url}} then {{وسيط|url2}} .. {{وسيط|url10}}. Each URL can have its own date and title argument, thus {{وسيط|date2}} .. {{وسيط|date10}} and {{وسيط|title2}} .. {{وسيط|title10}}.

== خيارات ==

'''Main options'''

:;url..url10: The URL(s) to the archive service. There should always be a {{وسيط|url}} which counts as the first url. Each {{وسيط|url#}} can have its own numbered corresponding {{وسيط|date#}} and {{وسيط|title#}}. Matching of url with date and title is done by numbers, not position. Numbers do not need to be in sequence, for example {{وسيط|url2}} followed by {{وسيط|url5}} works.

:;date..date10: The date the page was archived. The date format displayed is the same as entered. If {{وسيط|date}} is missing the template will make a best effort to find the date by decoding the archive URL (wayback and webcite for example provide this data in the URL), and will display the date in iso format by default. However including a date is recommended for date formatting reasons, and because other tools may not have the ability to decode the date from the URL.

:;title..title10: The text displayed for the link. If no {{وسيط|title}} is provided then {{وسيط|date}} is displayed. Otherwise {{وسيط|title}} takes precedence if both are set.

'''Secondary options'''

:;nolink: If set to any value (including blank such as {{وسيط|nolink}}) the wiki-link for the archive service will not be displayed. For example if [[واي باك مشين]] was previously linked in an article, it won't be linked again.

:;format: This is a special option to support the merger of {{tld|cite archives}}. It may be deprecated in the future. Because CS1|2 templates do not currently support more than 1 archive link, this template will tack on additional archive links to the end of a CS1|2 template output. It takes two values: {{وسيط|format|addlarchives}} or {{وسيط|format|addlpages}}. ''Addlarchives'' will display output appropriate for linking to multiple web archiving services. ''Addlpages'' will display output appropriate for linking to multiple pages at the same archive.

:;origurl: This is the original URL and this argument ''should not be used unless you know what you're doing''. This option is not recommended because it is redundant, not needed by the template and creates error-prone interactions with other link rot tools. For example given the original URL <code><nowiki>http://www.example.com</nowiki></code> it is already contained in the archive URLs:
:::'''Wayback''': {{وسيط|url|https://web.archive.org/web/YYYYMMDDhhmmss/http://www.example.com}}
:::'''Webcite''': {{وسيط|url|http://www.webcitation.org/5eWaHRbn4?url{{=}}http://www.example.com}} (more info at [[أرابيكا:Using WebCite#Use_within_Wikipedia|Using WebCite]])
:::'''Archive.is''': {{وسيط|url|http://archive.is/YYYYMMDDhhmmss/http://www.example.com}} (more info at [[أرابيكا:Using archive.is#Use_within_Wikipedia|Using Archive.is]])
::Archive services that have the option for long-form URLs, like the above examples, should use that (most do) instead of {{وسيط|origurl}}. [[نقاش أرابيكا:Using_archive.is#RfC:_Should_we_use_short_or_long_format_URLs.3F|See RfC]] which discusses the policy of disallowing URL-shortening which can be used to hide blacklisted websites. In the rare instances when an archive service only has shortened URLs available, the original URL can be stored in the {{وسيط|origurl}} argument. Another reason not to use this argument unless necessary is because other link-rot tools (bots, edit scripts etc) may try to "save" the URL - which is presumably dead - by converting it to an archive URL, adding a dead link tag or even messing with the archive URL. Note that the argument is not used by the template it's only for storage.

== أمثلة ==
The number of possible examples is extensive depending on the mix of options. Some common cases follow. For more extensive testing see the [[قالب:Webarchive/testcases|testcases page]].

* Single link at Wayback with date and title ('''recommended method''')
::<code><nowiki>{{Webarchive|url=https://web.archive.org/web/20160801000000/http://example.com |date=August 1, 2016 |title=Page title}}</nowiki></code>
::{{Webarchive|url=https://web.archive.org/web/20160801000000/http://example.com |date=August 1, 2016 |title=Page title}}
* Single link at Wayback with date only
::<code><nowiki>{{Webarchive|url=https://web.archive.org/web/20160801000000/http://example.com |date=August 1, 2016}}</nowiki></code>
::{{Webarchive|url=https://web.archive.org/web/20160801000000/http://example.com |date=August 1, 2016}}
* Single link at WebCite with no date and no title
::<code><nowiki>{{Webarchive|url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/}}</nowiki></code>
::{{Webarchive|url=http://www.webcitation.org/67xHmVFWP}}

*Multi-link at Wayback with dates and titles ('''recommended method''')
::<code><nowiki>{{Webarchive|url=https://web.archive.org/web/20160801/http://example.com |title=Page title |date=August 1, 2016 |url2=https://web.archive.org/web/20160901/http://example.com |title2=Page2 title |date2=September 1, 2016}}</nowiki></code>
::{{Webarchive|url=https://web.archive.org/web/20160801/http://example.com |title=Page title |date=August 1, 2016 |url2=https://web.archive.org/web/20160901/http://example.com |title2=Page2 title |date2=September 1, 2016}}
*Multi-link at Wayback with dates only
::<code><nowiki>{{Webarchive|url=https://web.archive.org/web/20160801/http://example.com |date=August 1, 2016 |url2=https://web.archive.org/web/20160901/http://example.com |date2=September 1, 2016}}</nowiki></code>
::{{Webarchive|url=https://web.archive.org/web/20160801/http://example.com |date=August 1, 2016 |url2=https://web.archive.org/web/20160901/http://example.com |date2=September 1, 2016}}
*Multi-link at Wayback with titles only
::<code><nowiki>{{Webarchive|url=https://web.archive.org/web/20160801/http://example.com |title=Page title |url2=https://web.archive.org/web/20160901/http://example.com |title2=Page2 title}}</nowiki></code>
::{{Webarchive|url=https://web.archive.org/web/20160801/http://example.com |title=Page title |url2=https://web.archive.org/web/20160901/http://example.com |title2=Page2 title}}

== تصنيفات تتبع ==
يتم إضافتها عبر [[وحدة:Webarchive]]:

* {{سطر تصنيف وصفحاته|قالب أرشيف الإنترنت بوصلات واي باك}} – وصلا الى واي باك مشين
* {{سطر تصنيف وصفحاته|Webarchive template webcite links}} – وصلات إلى WebCite
* {{سطر تصنيف وصفحاته|Webarchive template archiveis links}} – وصلات إلى Archive.is
* {{سطر تصنيف وصفحاته|Webarchive template other archives}} – وصلات الى مواقع أرشيف لا يوجد تصانيف تتبع خاصة بها
* {{سطر تصنيف وصفحاته|Webarchive template unknown archives}} –القالب لا يتعرف على وصلة الأرشيف؛ هذا قد يشير إلى وجود خطأ في البيانات، أو أن القالب يحتاج إلى تحديث لمواكبة مواقع الأرشيفات الجديدة.
* {{سطر تصنيف وصفحاته|Webarchive template warnings}} – الأخطاء البسيطة التي لا تمنع القالب من العمل ولكنها تترك رسالة حمراء
* {{سطر تصنيف وصفحاته|Webarchive template errors}} – الأخطاء التي تتطلب عادة تدخل بشري

== صيانة القالب ==

يمكن القيام بالتالي لصيانة القالب.

'''مراقبة تصنيفات التتبع'''

يمكن مراقبة تصنيفات التتبع لـ "التحذيرات" و "الأخطاء" للإنذار بأي مشاكل في البيانات.
قد يشير تصنيف التتبع لـ "الأرشيفات المجهولة" إلى وجود مشكلة في البيانات. على سبيل المثال، قد يستخدم المحرر عنوان URL المصدر بدلاً من عنوان URL الأرشيف في حقل {{وسيط|url}}.

'''التكوين: التحقق من التواريخ (verifydates)'''

يمكن للقالب التحقق من تطابق تواريخ Wayback (أو WebCite) في جزء عنوان URL مع التاريخ في {{وسيط|date}}. إذا لم تتطابق التواريخ، فسيترك رسالة تحذيرية حمراء "عدم تطابق التاريخ" ويضيف المقالة إلى تصنيف التتبع للتحذيرات.

نظرًا لأن وظيفة التحقق تضيف بعض العبء إلى القالب، يمكن تعطيلها عالميًا اختياريًا عن طريق تعيين المتغير "verifydates = no" (انظر مصدر الوحدة في الوظيفة p.webarchive()). لاحظ أنه بعد التعيين على "نعم"، قد يستغرق الأمر أسبوعًا أو أكثر لاكتمال تصنيف التتبع. ضعه على "نعم" إذا كنت تبحث عن مشاكل في البيانات التي تحتاج إلى إصلاح (ستظهر في تصنيف التتبع).

'''التكوين: maxurls'''
الحد الأقصى لعدد عناوين URL هو 10 ولكن يمكن تغيير ذلك عن طريق تعيين المتغير "maxurls" في وظيفة p.webarchive(). هذا متغير عالمي سيؤثر على جميع حالات القالب، استخدمه بحذر. ستزيد تقليل العدد من سرعة القالب وتقليل استخدام الموارد.

== وسائط المحرر المرئي ==
<templatedata>
{
"description": "قالب لربط الأرشيفات الخارجية مثل Wayback و WebCite و Archive.is وما إلى ذلك.",
"params": {
"url": {
"label": "عنوان الأرشيف",
"description": "عنوان URL للأرشيف.",
"type": "string",
"example": "https://web.archive.org/web/20160101000000/http://example.com",
"required": true
},
"date": {
"label": "تاريخ الأرشيف",
"description": "تاريخ الأرشيف.",
"type": "string",
"example": "1 يناير 2016",
"suggested": true
},
"title": {
"label": "عنوان الأرشيف",
"description": "العنوان (أو النص) المعروض على صفحة الويكي للرابط.",
"type": "string",
"suggested": true,
"example": "مثال أرشيف",
"default": "وسيط التاريخ أو كلمة أرشيف"
},
"nolink": {
"label": "وصلة الويكي",
"description": "وصلة الويكي إلى صفحة الأرشيف في التقديم. أي قيمة بما في ذلك الفراغ يعني عدم وجود وصلة ويتم تجاهلها.",
"type": "string"
},
"format": {
"label": "تنسيق عرض القالب.",
"description": "في حالة وجود عدة عناوين URL، يتم عرض العرض في إحدى صيغتين.",
"type": "string"
}
}
}
</templatedata>

<includeonly>{{ملعب آخر||

[[تصنيف:قوالب تضيف تصانيف تتبع]]
}}</includeonly>

قالب:Webarchive/شرح - تاريخ المراجعة

عبد العزيز: /* وسائط المحرر المرئي */تنسيق ويكي - إزالة الفراغات الزائدة من القوالب