راهنما:تراگنجانش بخش برچسب‌خورده
 | این صفحه یک راهنمای چگونه انجام دادن است. که یک کار یا فرایند را در ویکی‌پدیای فارسی شرح می‌دهد. این صفحه یکی از سیاست‌ها یا رهنمودهای ویکی‌پدیا نیست، زیرا هنوز توسط اجتماع مورد بررسی و تأیید قرار نگرفته است. |
تراگنجانش بخش برچسب‌خورده (LST)، که در این صفحهٔ راهنما از آن با نام تراب یاد می‌شود، دو روش ابتدایی برای تعیین یک «بخش» از یک صفحه به‌منظور تراگنجانش را در اختیار کاربران قرار می‌دهد. یکی از این روش‌ها، استفاده از نام صفحه و یک سرفصل (یعنی عنوان بخش به‌شکلی که در ظاهر نهایی صفحه نمایش می‌یابد) است. روش دیگر امکان تراگنجانش «بخش» دلخواه را فراهم می‌کند، اما پیش از هر چیز نیازمند علامت‌گذاری صفحه برای افزودن برچسب است.
سه تابع برای تراگنجانیدن بخشی از یک نام صفحه در دسترس هستند.
- {{#section:نام صفحه|برچسب}} (یک بخش دارای برچسب)
- {{#section-x:نام صفحه|برچسب}} (کل صفحه به‌جز بخش دارای برچسب)
- {{#section-h:نام صفحه|سرفصل}} (یک بخش عادی)
توجه داشته باشید که نام‌های جایگزینی نیز برای این توابع وجود دارند، اما نام‌های اصلی آن‌ها #lst، #lstx و #lsth است.
برای آماده‌سازی «بخش» دلخواه به‌منظور تراگنجانش بخش برچسب‌خورده، آن را با افزودن ویژگی‌های begin و end در درون برچسب‌های <section /> و قرار دادن label درون آن‌ها، برچسب بزنید:
نشانه‌گذاری تراگنجانش موردی برخلاف تراگنجانش تراب، نمی‌تواند برچسب‌خورده باشد، و از همین روی نمی‌توان مجموعه‌ای از بخش‌های صفحهٔ مبدأ را در یک صفحه، و مجموعه‌ای دیگر از بخش‌های آن را در صفحه‌ای دیگر تراگنجانش کرد. صفحه‌ای که تنها با برچسب‌های تراگنجانش موردی برچسب خورده باشد، همواره به یک شکل ثابت تراگنجانش خواهد شد. اما می‌توان در یک صفحه از تراب و تراگنجانش موردی به‌طور همزمان استفاده کرد.
این توابع تراب پارامترهای بیشتری را هم می‌پذیرند که در ادامه به آن پرداخته خواهد شد. در بخش § صفحه‌های نمونه پیوندهایی قرار گرفته است که شما را به مقاله‌هایی هدایت می‌کنند که در حال حاضر از این ویژگی استفاده می‌کنند و می‌توانید عملکرد این توابع را در آن صفحه‌ها ببینید.
مرور توابع
[ویرایش]این بخش به بررسی سه تابع تجزیه‌گر موجود در افزونهٔ تراگنجانش بخش برچسب‌خورده می‌پردازد.
نحو: {{تابع: نام‌کامل‌صفحه | بخش | بازه/تغییر}}
| پارامتر | نهاد تجزیه‌گری که شناسایی می‌کند | |
|---|---|---|
| 1 | نام‌کامل‌صفحه | صفحهٔ مبدأ. تنها آرگومان اجباری. به‌صورت دستی وارد کنید یا از متغیرهایی نظیر {{نام‌کامل‌صفحه}} استفاده کنید (اما از پیونددهی به زیرصفحه با ../ استفاده نکنید). |
| 2 | بخش | برچسب («بخش برچسب‌خورده»)، یا سرفصل (عنوان بخش) مبدأ برای تراگنجانیدن. استفاده از این پارامتر اختیاری است. اگر بنا بر استفاده از برچسب بود، باید ابتدا برچسب به صفحه افزوده شده و ذخیره شود. |
| 3 | بازه | بخش نهایی در مجموعه‌ای از سرفصل‌ها یا برچسب‌های پیوسته برای تراگنجانش. استفاده از این پارامتر اختیاری است.
|
| 3 | تغییر | ویکی‌متن جایگزین. تنها #lstx هنگام تراگنجانش قادر به بازنویسی یک بخش برچسب‌خورده است. استفاده از این پارامتر اختیاری است. |
امکان وارد کردن پارامترهای الگو به بخش یا صفحهٔ تراگنجانش‌شده وجود ندارد، اما می‌توان واژه‌های جادویی نظیر {{نام‌صفحه}} را به کد صفحه افزود تا تشخیص دهد که در کجا قرار گرفته و بر آن اساس، به‌شکلی متفاوت ��فتار کند.
| تابع تجزیه‌گر | نام مستعار | توضیح |
|---|---|---|
| #lst | #section | تراگنجانش‌کردن یک label یافت‌شده در درون برچسب‌های <section />. برچسب‌های تراگنجانش را مد نظر قرار می‌دهد. پیش‌فرض آن، کل صفحه است. اگر برچسب یافت نشود، هیچ‌چیزی را تراگنجانش نمی‌کند.
|
| #lstx | #section-x | تراگنجانش‌کردن کل صفحه، به‌جز یک برچسب خاص. سرفصل‌ها را نادیده می‌گیرد. برچسب‌های تراگنجانش را مد نظر قرار می‌دهد. پیش‌فرض آن، کل صفحه است. اگر برچسب یافت نشود، کل صفحه را تراگنجانش می‌کند. |
| #lsth | #section-h | تراگنجانش‌کردن یک heading (عنوان بخش). برچسب‌ها را نادیده می‌گیرد. برچسب‌های تراگنجانش را مد نظر قرار نمی‌دهد.† پیش‌فرض آن، بخش آغازین صفحه است. اگر برچسب یافت نشود، هیچ‌چیزی را تراگنجانش نمی‌کند. |
- † #section-h باعث می‌شود که صفحهٔ هدف مشابه صفحهٔ مبدأ ظاهر شود. در صفحهٔ مبدأ:
- <noinclude> محتوای درون خود را نمایش می‌دهد
- <onlyinclude> محتوای درون خود را نمایش می‌دهد
- <includeonly> محتوای درون خود را نمایش نمی‌دهد
- بنابراین #section-h نباید منجر به نمایش محتوای درون
<includeonly>در صفحهٔ هدف شود.
رفتار برچسب‌های <section /> تراب:
- برچسب end الزامی نیست. هرگاه فقط برچسب begin یافت شود، تراگنجانش تا انتهای صفحه ادامه خواهد داشت.
- از همین برچسب می‌شود برای برچسب‌زدن چندین بخش با begin/end استفاده کرد. در این صورت، هرآنچه از نخستین begin تا آخرین end آمده است را می‌توان یک «بازه» در نظر گرفت.
- برچسب‌های متفاوت می‌توانند با یکدیگر تداخل نیز داشته باشند. همچنین می‌توان آن‌ها را به‌شکل تودرتویی به‌کار برد.
- نمی‌توانند به‌واسطهٔ تراگنجانش به یک صفحه افزوده شوند، اما در عوض باید به‌همان شکلی که در پایگاه داده ذخیره شده‌اند، باید در صفحه موجود باشند. § الگو ممنوع در پایین را ببینید.
گزینه‌های تراگنجانش تراب:
- دارای قابلیت پیش‌نمایش است.
- صفحهٔ هدف خودش می‌تواند صفحهٔ مبدأ تراگنجانش باشد.
- می‌تواند جانشانی شود. § جانشانی کردن در پایین را ببینید.
نحو استاندارد بر آن اعمال می‌شود:
- فضای خالی زیاد مجاز است: {{ #lst: فضای نام: نام‌صفحه | بخش }}
- یک دونقطه : بدون فاصله باید بلافاصله پس از نام تابع تجزیه‌گر درج شود.
- در برچسب‌ها، در اطراف علامت = برچسب (ویژگی درون برچسب) نباید فاصله‌ای درج شود: begin=برچسب
- در برچسب‌ها، استفاده از فاصله پیش از خط مورب / اختیاری و مجاز است: <section end=برچسب />
خطاهای متداول در استفاده:
- حلقه در الگو شناسایی شد: پیش‌نمایش تراگنجانش یک نسخهٔ تراگنجانش‌شده در نسخهٔ ذخیره‌شدهٔ صفحه منجر به تولید این خطا می‌شود.
- خطاهای یادکرد. هرجا و در هر صفحه‌ای که نیاز به ارجاع نام‌دار باشد، باید توصیف کامل آن ارجاع را نیز قرار دهید.
- به‌منظور نمایش پانویس‌های تراگنجانش‌شده، باید محل نمایش‌یافتن آن‌ها در صفحه را مشخص کنید.
نشانه‌گذاری
[ویرایش]در صورتی که تنها از عنوان بخش‌ها برای تراگنجانش استفاده شود، نیازی به درج نشانه‌گذاری در صفحهٔ مبدأ نیست. این قاعده در زمان استفاده از #section-h اعمال می‌شود.
برای برچسب‌زدن یک بخش به‌منظور تراگنجانش با تراب، از نشانه‌گذاری که در ادامه می‌آید استفاده کنید.
نشانه‌گذاری بخش
[ویرایش]محدودهٔ بخش مورد نظر خود در صفحهٔ مبدأ را با استفاده از دو برچسب مفرد <section /> علامت‌گذاری کنید؛ برای مثال، به‌منظور برچسب‌زدن یک بخش تحت عنوان «فصل۱»:
<section begin=فصل۱ />محتوای فصل<section end=فصل۱ />
دقت کنید که این برچسب مانند برچسب‌های اچ‌تی‌ام‌ال به‌شکل عادی باز و بسته نمی‌شود. در اچ‌تی‌ام‌ال، برچسب <section>...</section> نامعتبر محسوب می‌شود. برچسب تجزیه‌گر <section /> با عناصر اچ‌تی‌ام‌ال سازگار نیست؛ زیرا نشانه‌گذاری مدیاویکی برچسب تجزیه‌گری را به‌کار می‌گیرد که تنها برای استفاده توسط افزونهٔ تراگنجانش بخش برچسب‌خورده افزوده شده است.
تراگنجانیدن بخش
[ویرایش]برای تراگنجانیدن بخش از تابع تجزیه‌گر #section استفاده کنید. برای مثال، برای تراگنجانیدن بخشی از صفحه‌ای با عنوان مقاله فلان که تحت عنوان فصل۱ برچسب خورده:
{{#section:مقاله فلان|فصل۱}}
تراگنجانش صفحه به‌همراه مستثنی‌کردن یک بخش
[ویرایش]برای تراگنجانیدن یک صفحه و مستثنی‌کردن یک بخش مشخص از آن صفحه، از تابع تجزیه‌گر #section-x استفاده کنید:
{{#section-x:نام‌کامل‌صفحه|برچسب}}
یا
{{#section-x:نام‌کامل‌صفحه|سرفصل}}
به‌طور اختیاری می‌توانید متن جایگزینی را برای بخش مستثنی‌شده تعیین کنید.
{{#section-x:نام‌کامل‌صفحه|برچسب|متن جایگزین}}
مثال:
{{#section-x:مقاله فلان|فصل۱|فصل ۱ در [[مقاله فلان]] را ببینید.}}
متن جایگزین در جایی درج می‌شود که بخش مستثنی‌شده در صفحهٔ مبدأ در آنجا قرار داشته و در زمان تراگنجانش مستثنی شده و خالی مانده است.
واکنش به فضای خالی اضافی
[ویرایش]به‌طور پیش‌فرض، تابع #section تمام فضاهای خالی موجود در بخش را تراگنجانش می‌کند که در صورتی که در تلاش برای تراگنجانیدن بخش در یک مقالهٔ متفاوت باشید، می‌تواند منجر به بروز مشکلاتی شود. برای رفع این مشکل، این نکته را در نظر بگیرید که تابع تجزیه‌گر 30783182#اگر}} فاصله‌های خالی اطراف ورودی خود را برش می‌زند. برای مثال:
{{#اگر:1|{{#section:مقاله فلان|فصل۱}}}}
این کار باعث حذف فضای خالی از ابتدا و انتهای محتوا می‌شود و مقاله به‌شکلی که مد نظر است، نمایش داده خواهد شد. از آنجا که با این کار در حال استفادهٔ تودرتویی از الگوها هستید، اندازه دربرگ��ری پس از بسط بخش منتخب، دوبرابر خواهد شد که در صفحه‌های حجیم‌تر منجر به بروز مشکل می‌شود. بنابراین بهتر است که صفحهٔ مبدأ را ویرایش کنید و محتوای مورد نظر خود برای تراگنجانش را بدون فضاهای خالی اضافی در میان برچسب‌های <onlyinclude>...</onlyinclude> قرار دهید. همچنین می‌توانید از الگوی {{اصلاح}} به‌جای 30783182#اگر:1}} استفاده کنید، اما از آنجا که این الگو نیز تنها یک الگوی لفاف برای تکنیک 30783182#اگر:1}} است که در بالا به آن اشاره شد، این کار نیز منجر به افزایش سه‌برابری اندازه دربرگیری پس از بسط خواهد شد.
سایر توابع
[ویرایش]بخش‌های ناپیوسته
[ویرایش]این امکان وجود دارد که چندین بخش با نام یکسان در صفحه موجود باشد؛ در این صورت، هر بخشی که از آن نام برخوردار باشد گنجانده/مستثنی خواهد شد. این قابلیت به‌ویژه برای علامت‌گذاری چندین ریسه در صفحه‌های بحث می‌تواند مفید باشد.
بازه‌ها
[ویرایش]این توابع می‌توانند کل صفحه را تراگنجانش کنند و از همین روی دارای دو آرگومان اختیاری برای تنظیم عملکرد هستند: ۱) نام یک بخش برچسب‌خورده یا عنوان یک سرفصل در صفحه، ۲) بازه‌ای از برچسب‌هایی که با نام واردشده برچسب خورده‌اند، یا عنوان یک بخش، و ۳) محتوای جایگزین برای بخش نام‌گذاری‌شده.
{{#section:مقاله فلان|فصل۱|فصل۳}}همه‌چیز را از ابتدای فصل ۱ تا انتهای فصل ۳ در صفحهٔ هدف می‌گنجاند. این قابلیت امکان استفاده از مجموعه‌علامت‌های خالی به‌منظور علامت‌گذاری یک سرِ بخش، که احتمالاً در الگوها کاربرد خواهد داشت، را فراهم می‌کند.{{#section-h:مقاله فلان|فصل۱|فصل۳}}محتوای فصل۱ و سرفصل و محتوای فصل۲ را در صفحهٔ هدف می‌گنجاند.{{#section-x:مقاله فلان|فصل۱|فصل۳}}محتوا و سرفصل فصل۱ را با واژهٔ «فصل۳» جایگزین می‌کند.
جانشانی
[ویرایش]برای «تراگنجانیدن» محتوا تنها برای یک بار (کپی کردن آن) به‌جای تراگنجانش در هر بار بازدید، از جانشانی استفاده کنید:
- {{جا:{{#section...}}}}
برای مثال، به‌منظور بایگانی بحث‌های قدیمی در صفحهٔ بحث خود، می‌توانید محتوا را به یک صفحهٔ بایگانی کپی کنید و سپس آن را حذف کنید. تمام این کار را می‌تواند با استفاده از تراب انجام دهید:
<section begin=بایگانی />را در ابتدای بخشی که می‌خواهید بایگانی کنید، و<section end=بایگانی />را در انتهای آن قرار دهید. (در اینجا از «بایگانی» به‌عنوان برچسب استفاده شده، اما استفاده از هر برچسب دیگری مجاز است). این بخش می‌تواند در هرکجای صفحه باشد و حتی می‌تواند حاوی چندین مبحث باشد.- تغییرات مذکور را در صفحهٔ بحث خود ذخیره کنید.
- یک صفحهٔ بایگانی جدید ایجاد کنید. عبارت {{جا:#section:بحث کاربر:نام‌کاربری|بایگانی}} را در آن قرار دهید.
- آن صفحهٔ بایگانی را ذخیره کنید. بحث‌های قدیمی در آن صفحهٔ بایگانی کپی خواهند شد. تراگنجانش ناپدید خواهد شد؛ زیرا محتوا جانشانی شده است.
- مجدداً صفحهٔ بحث خود را ویرایش کنید. کل ویکی‌متن موجود در صفحه را با {{جا:#section-x:بحث کاربر:نام‌کاربری|بایگانی}} جایگزین کنید. صفحهٔ موجود در پایگاه داده، منهای ویکی‌متن کاملاً منطبق با آنچه در صفحهٔ بایگانی ذخیره شده و نیز برچسب‌های بخش (که آن‌ها را تحت عنوان «بایگانی» برچسب زده بودیم)، تراگنجانیده خواهد شد.
لطفاً هنگام استفاده از جانشانی برای تراگنجانش محتوا در ویکی‌پدیا، برای اعمال حقوق و تعهدات باز-استفاده‌کنندگان از خلاصهٔ ویرایش استفاده کنید. این قاعده بر هرگونه محتوای قابل توجه اعمال می‌شود، و نه فقط بر محتوای مقاله‌ها.
الگو ممنوع
[ویرایش]در حال حاضر هیچ الگویی قادر به تسهیل استفاده از نشانه‌گذاری تراب نیست؛ زیرا استفاده از #برچسب به‌منظور «پیش‌ذخیره‌سازی‌تبدیل» (preSaveTransform) واژه‌های جادویی درون هرگونه برچسب، ضروری است. برای تلاشی که در گذشته به این منظور انجام شده الگوی (غیرقابل استفادهٔ) {{بخش}} را ببینید.
تنها راه برای ارزیابی آرگومان‌های الگو درون یک برچسب (به علت ترتیب تجزیه کردن)، استفاده از #برچسب است. تراب، همزمان با تولید برچسب بخش، نیازمند ارزیابی (الگو) برای برچسب است:
{{ #برچسب: section | {{{1}}} }}
اما #برچسب تنها برچسب‌های مشابه اکس‌ام‌ال (متعادل، بازشده و بسته‌شده، دارای آغاز و پایان) را تولید می‌کند؛ در حالی که تراب از یک برچسب مفرد که به‌طور صریح و به‌تنهایی بسته شده، استفاده می‌کند. بنابراین برچسب‌های تراب نمی‌توانند توسط هیچ الگویی تولید شوند. مقایسه کنید خرجی واقعی را:
{{#tag:section|content|begin=label}} →
< section begin=label> content </section> 
با خروجی مورد درخواست:
<section begin=label /> content <section end=label />
صفحه‌های نمونه
[ویرایش]این پیوندها به جستجوهایی برای یافتن کاربردهای این توابع هدایت می‌شوند:
- insource:"section h" insource:/\#"section-h"/ (مقاله‌ها)
- insource:section insource:/\{\{\#section/ (مقاله‌ها)
- all: insource:"section x" insource:/\#"section-x"/ (کل ویکی)
- insource:lst insource:/\#lst/ (مقاله‌ها)
- insource:lsth insource:/\{\{\#lsth/ (مقاله‌ها)
- all: insource:lstx insource:/\#lstx/ (کل ویکی)
جستارهای وابسته
[ویرایش]الگوها
[ویرایش]- {{Excerpt}}
- {{تراگنجانش بخش}}
- {{R}}