الگو:Webarchive

توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

این الگو در تعداد زیادی صفحه صفحه به‌کار رفته است و تغییر دادن آن می‌تواند تأثیرات گسترده‌ای داشته باشد. لطفاً تغییرات را در زیرصفحه‌های /تمرین یا /آزمایشی الگو، یا در زیرصفحهٔ کاربری خودتان بیازمایید. توصیه می‌شود که ابتدا در خصوص تغییرات مورد نظر در صفحهٔ بحث گفتگو کرده و سپس آن‌ها را پیاده‌سازی کنید.

این الگو از لوآ استفاده می‌کند:

پودمان:Webarchive (تمرین)

{{Webarchive}} برای پیوند دادن به خدمات بایگانی وب مانند وی‌بک ماشین، WebCite، Archive.is و دیگر خدمات بایگانی وب به کار می‌رود.

این الگو جایگزینی برای الگوی قدیمی {{وی‌بک}} و چند الگوی مشابه (مانند webcite، memento و cite archives) است که کار آن‌ها را یک‌جا انجام می‌دهد.

نکته: رایج‌ترین روش برای پیوند دادن به یک بایگانی وب، استفاده از الگوهای یادکرد CS1/CS2 مانند {{یادکرد وب}} همراه با پارامترهای |نشانی بایگانی=، |تاریخ بایگانی= و |پیوند مرده= است. پیش از تبدیل این الگو به یک الگوی یادکرد CS1/CS2، به شیوهٔ ارجاع به منابع توجه کنید.

استفاده

در بیشتر موارد الگو تنها به دو پارامتر نیاز دارد: نشانی بایگانی (|url=) و تاریخ بایگانی (|date=). افزودن یک |title= نیز رایج است. برای برخی نشانی‌ها، الگو می‌تواند تاریخ را به‌طور خودکار نمایش دهد. برای جلوگیری از افزودن پیوند درون‌ویکی به نام خدمت بایگانی، پارامتر |nolink= را با هر مقداری تنظیم کنید.

نمونهٔ ۱ (|url= و |date=):

{{webarchive |url=https://web.archive.org/web/20160801000000/http://example.com |date=1 August 2016}}

خروجی: بایگانی‌شده در ۱ اوت ۲۰۱۶ توسط Wayback Machine

نمونهٔ ۲ (|url= و |date=):

{{webarchive |url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/ |date=12 February 2009}}

خروجی: بایگانی‌شده در ۱۲ فوریه ۲۰۰۹ توسط وب‌کایت

نمونهٔ ۳ (افزودن |title=):

{{webarchive |url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/ |date=12 February 2009 |title=عنوان صفحه}}

خروجی: عنوان صفحه توسط وب‌کایت (بایگانی‌شده ۱۲ فوریه ۲۰۰۹)

چند نشانی

پارامترها

پارامترهای اصلی

url..url10: نشانی (یا نشانی‌های) خدمت بایگانی. همیشه باید یک |url= وجود داشته باشد که نخستین نشانی به شمار می‌رود. هر |url#= می‌تواند |date#= و |title#= متناظر و شماره‌دار خود را داشته باشد. تطبیق نشانی با تاریخ و عنوان بر پایهٔ شماره انجام می‌شود، نه ترتیب. شماره‌ها لازم نیست پشت‌سرهم باشند؛ برای نمونه |url2= و سپس |url5= نیز کار می‌کند.

date..date10: تاریخی که صفحه در آن بایگانی شده‌است. قالب نمایش تاریخ همانی است که وارد می‌شود. اگر |date= وارد نشده باشد، الگو تا حد امکان می‌کوشد تاریخ را با رمزگشایی نشانی بایگانی پیدا کند (برای نمونه وی‌بک و وب‌سایت این داده را در نشانی فراهم می‌کنند) و آن را به‌طور پیش‌فرض به قالب ایزو نمایش می‌دهد. با این حال، وارد کردن تاریخ به‌دلیل قالب‌بندی درست تاریخ و نیز چون ابزارهای دیگر ممکن است توان رمزگشایی تاریخ از نشانی را نداشته باشند، توصیه می‌شود.

title..title10: متنی که برای پیوند نمایش داده می‌شود. اگر |title= داده نشود، |date= نمایش داده می‌شود. اگر هر دو تنظیم شده باشند، |title= اولویت دارد.

پارامترهای ثانویه

nolink: اگر با هر مقداری (حتی خالی، مانند |nolink=) تنظیم شود، پیوند درون‌ویکی به نام خدمت بایگانی نمایش داده نمی‌شود. برای نمونه اگر پیش‌تر در یک مقاله به وی‌بک ماشین پیوند داده شده باشد، دوباره پیوند داده نمی‌شود.

format: گزینه‌ای ویژه برای پشتیبانی از ادغام الگوی cite archives است و ممکن است در آینده منسوخ شود. از آنجا که الگوهای CS1/CS2 در حال حاضر بیش از یک پیوند بایگانی را پشتیبانی نمی‌کنند، این الگو پیوندهای بایگانی افزوده را به انتهای خروجی یک الگوی CS1/CS2 می‌افزاید. این پارامتر دو مقدار می‌پذیرد: |format=addlarchives یا |format=addlpages. مقدار addlarchives خروجی مناسب برای پیوند به چند خدمت بایگانی، و مقدار addlpages خروجی مناسب برای پیوند به چند صفحه در یک بایگانی را نمایش می‌دهد.

نمونه‌ها

شمار نمونه‌های ممکن بسته به ترکیب گزینه‌ها بسیار زیاد است. چند مورد رایج در پی می‌آید.

یک پیوند به وی‌بک با تاریخ و عنوان (روش توصیه‌شده)

{{webarchive |url=https://web.archive.org/web/20160801000000/http://example.com |date=August 1, 2016 |title=عنوان صفحه}}

عنوان صفحه توسط Wayback Machine (بایگانی‌شده اوت ۱, ۲۰۱۶)

یک پیوند به وی‌بک تنها با تاریخ

{{webarchive |url=https://web.archive.org/web/20160801000000/http://example.com |date=August 1, 2016}}

بایگانی‌شده در اوت ۱, ۲۰۱۶ توسط Wayback Machine

یک پیوند به WebCite بدون تاریخ و بدون عنوان

{{webarchive |url=http://www.webcitation.org/5eWaHRbn4?url=http://www.example.com/}}

بایگانی‌شده در ۲۰۱۲-۰۵-۲۶ توسط وب‌کایت

چند پیوند به وی‌بک با تاریخ‌ها و عنوان‌ها (روش توصیه‌شده)

{{webarchive |url=https://web.archive.org/web/20160801/http://example.com |title=عنوان صفحه |date=August 1, 2016 |url2=https://web.archive.org/web/20160901/http://example.com |title2=عنوان صفحهٔ ۲ |date2=September 1, 2016}}

عنوان صفحه توسط Wayback Machine (بایگانی‌شده اوت ۱, ۲۰۱۶^{[طول برچسب زمانی]}). بایگانی‌های بیشتر: عنوان صفحهٔ ۲.

چند پیوند به وی‌بک تنها با تاریخ‌ها

{{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}}

بایگانی‌شده در اوت ۱, ۲۰۱۶^{[طول برچسب زمانی]} توسط Wayback Machine. بایگانی‌های بیشتر: September 1, 2016.

چند پیوند به وی‌بک تنها با عنوان‌ها

{{webarchive |url=https://web.archive.org/web/20160801/http://example.com |title=عنوان صفحه |url2=https://web.archive.org/web/20160901/http://example.com |title2=عنوان صفحهٔ ۲}}

عنوان صفحه توسط Wayback Machine (بایگانی‌شده ۲۰۱۶-۰۸-۰۱^{[طول برچسب زمانی]}). بایگانی‌های بیشتر: عنوان صفحهٔ ۲.

رده‌های ردیابی

رده‌های ردیابی این الگو همگی پنهان هستند. صفحه‌هایی که از این الگو استفاده می‌کنند، از طریق پودمان:Webarchive در رده‌های زیر قرار می‌گیرند:

رده:پیوندهای وی‌بک الگوی بایگانی اینترنت (۴۵٬۵۰۸) – پیوندها به وی‌بک ماشین
رده:پیوندهای وب‌کایت الگوی بایگانی اینترنت (۱۸) – پیوندها به WebCite
رده:پیوندهای آرشیوایز الگوی بایگانی اینترنت (۱٬۴۸۴) – پیوندها به Archive.is
رده:سایر بایگانی‌های الگوی بایگانی اینترنت (۱۳۲) – پیوندها به بایگانی‌های شناخته‌شده‌ای که ردهٔ ردیابی جداگانه ندارند
رده:بایگانی‌های نامعلوم الگوی بایگانی اینترنت (۷۰) – الگو نشانی بایگانی را نمی‌شناسد؛ این ممکن است نشانهٔ خطایی در داده‌ها باشد، یا اینکه خود الگو باید برای پشتیبانی از یک خدمت بایگانی تازه به‌روزرسانی شود
رده:هشدارهای الگوی بایگانی اینترنت (۱۵۹) – خطاهای نرمی که مانع کار الگو نمی‌شوند ولی پیامی قرمز نمایش می‌دهند
رده:خطاهای الگوی بایگانی اینترنت (۳۳) – خطاهایی که معمولاً نیازمند دخالت انسانی هستند

نگهداری الگو

برای نگهداری الگو می‌توان کارهای زیر را انجام داد.

پایش رده‌های ردیابی

رده‌های ردیابی «هشدارها» و «خطاها» را می‌توان برای آگاهی از هر گونه مشکل در داده‌ها پایش کرد.
ردهٔ ردیابی «بایگانی‌های نامعلوم» ممکن است نشان‌دهندهٔ مشکلی در داده‌ها باشد؛ برای نمونه ویرایشگری به‌جای نشانی بایگانی، نشانی منبع را در میدان |url= گذاشته باشد.

پایش کاربرد پارامترهای الگو

این ابزار نشان می‌دهد کدام نمونه‌های الگو از کدام پارامترها استفاده می‌کنند؛ برای نمونه ممکن است نشان دهد که پارامتری پشتیبانی‌نشده در چند مقاله به کار رفته‌است. چون این کار خطاست (الگو آن پارامتر را پشتیبانی نمی‌کند)، آن نمونه‌ها باید اصلاح شوند.

پیکربندی: verifydates

الگو می‌تواند بررسی کند که آیا تاریخ موجود در نشانی وی‌بک (یا وب‌سایت) با تاریخ پارامتر |date= هم‌خوانی دارد یا نه. اگر تاریخ‌ها هم‌خوان نباشند، پیام هشدار قرمز «date mismatch» (ناهم‌خوانی تاریخ) نمایش داده می‌شود و مقاله به ردهٔ ردیابی هشدارها افزوده می‌شود.

چون این بررسی اندکی سربار به الگو می‌افزاید، می‌توان آن را به‌صورت سراسری با تنظیم متغیر «verifydates = no» غیرفعال کرد (به متن پودمان در تابع p.webarchive() نگاه کنید). توجه کنید که پس از تنظیم روی «yes»، ممکن است یک هفته یا بیشتر طول بکشد تا ردهٔ ردیابی به‌طور کامل پر شود.

پیکربندی: maxurls

بیشینهٔ شمار نشانی‌ها ۱۰ است، اما می‌توان آن را با تنظیم متغیر «maxurls» در تابع p.webarchive() تغییر داد. این متغیر سراسری است و بر همهٔ نمونه‌های الگو اثر می‌گذارد، پس با احتیاط به کار رود. کاهش این شمار سرعت الگو را بیشتر و مصرف منابع را کمتر می‌کند.

داده‌های الگو

این، توضیحاتِ الگوداده است که توسط TemplateWizard، ویرایشگر دیداری و دیگر ابزارها استفاده می‌شود. گزارش خطای ماهیانه برای این الگو را ببینید.

الگوداده Webarchive

الگویی برای پیوند دادن به بایگانی‌های بیرونی مانند وی‌بک، WebCite، Archive.is و مانند آن‌ها.

پارامترهای الگو[ویرایش داده‌های الگو]
پارامتر		توضیحات	نوع	وضعیت
نشانی بایگانی	`url`	نشانی صفحهٔ بایگانی‌شده. مثال https://web.archive.org/web/20160101000000/http://example.com	رشته	ضروری
تاریخ بایگانی	`date`	تاریخ بایگانی‌شدن صفحه. مثال 1 January 2016	رشته	پیشنهادشده
عنوان بایگانی	`title`	عنوان (یا متنی) که در صفحهٔ ویکی برای پیوند نمایش داده می‌شود. پیش‌فرض پارامتر تاریخ، یا واژهٔ «بایگانی» مثال وبگاه نمونه	رشته	پیشنهادشده
بدون پیوند	`nolink`	نمایش پیوند درون‌ویکی به صفحهٔ خدمت بایگانی. هر مقداری (حتی خالی) به معنای نمایش‌ندادن پیوند است.	رشته	اختیاری
قالب نمایش الگو	`format`	برای نمونه‌های چندنشانی، خروجی را در یکی از دو قالب نمایش می‌دهد.	رشته	اختیاری

جستارهای وابسته

{{وی‌بک}}

توضیحات بالا تراگنجانده‌شده از الگو:Webarchive/توضیحات است.
ویرایشگران می‌توانند در صفحات تمرین و آزمایشی این الگو را آزمایش کنند.
لطفاً رده‌ها را به زیرصفحهٔ /توضیحات بیفزایید. زیرصفحه‌های این الگو.