تراگنجانش بخش برچسبخورده (LST)، که در این صفحهٔ راهنما از آن با نام تراب یاد میشود، دو روش ابتدایی برای تعیین یک «بخش» از یک صفحه بهمنظور تراگنجانش را در اختیار کاربران قرار میدهد.
این صفحه یک راهنمای چگونه انجام دادن است. که یک کار یا فرایند را در ویکیپدیای فارسی شرح میدهد. این صفحه یکی از سیاستها یا رهنمودهای ویکیپدیا نیست، زیرا هنوز توسط اجتماع مورد بررسی و تأیید قرار نگرفته است. |
یکی از این روشها، استفاده از نام صفحه و یک سرفصل (یعنی عنوان بخش بهشکلی که در ظاهر نهایی صفحه نمایش مییابد) است. روش دیگر امکان تراگنجانش «بخش» دلخواه را فراهم میکند، اما پیش از هر چیز نیازمند علامتگذاری صفحه برای افزودن برچسب است.
سه تابع برای تراگنجانیدن بخشی از یک نام صفحه در دسترس هستند.
توجه داشته باشید که نامهای جایگزینی نیز برای این توابع وجود دارند، اما نامهای اصلی آنها #lst
، #lstx
و #lsth
است.
برای آمادهسازی «بخش» دلخواه بهمنظور تراگنجانش بخش برچسبخورده، آن را با افزودن ویژگیهای begin و end در درون برچسبهای و قرار دادن label درون آنها، برچسب بزنید:
نشانهگذاری تراگنجانش موردی برخلاف تراگنجانش تراب، نمیتواند برچسبخورده باشد، و از همین روی نمیتوان مجموعهای از بخشهای صفحهٔ مبدأ را در یک صفحه، و مجموعهای دیگر از بخشهای آن را در صفحهای دیگر تراگنجانش کرد. صفحهای که تنها با برچسبهای تراگنجانش موردی برچسب خورده باشد، همواره به یک شکل ثابت تراگنجانش خواهد شد. اما میتوان در یک صفحه از تراب و تراگنجانش موردی بهطور همزمان استفاده کرد.
این توابع تراب پارامترهای بیشتری را هم میپذیرند که در ادامه به آن پرداخته خواهد شد. در بخش § صفحههای نمونه پیوندهایی قرار گرفته است که شما را به مقالههایی هدایت میکنند که در حال حاضر از این ویژگی استفاده میکنند و میتوانید عملکرد این توابع را در آن صفحهها ببینید.
این بخش به بررسی سه تابع تجزیهگر موجود در افزونهٔ تراگنجانش بخش برچسبخورده میپردازد.
نحو: {{تابع: نامکاملصفحه | بخش | بازه/تغییر}}
پارامتر | نهاد تجزیهگری که شناسایی میکند | |
---|---|---|
1 | نامکاملصفحه | صفحهٔ مبدأ. تنها آرگومان اجباری. بهصورت دستی وارد کنید یا از متغیرهایی نظیر {{نامکاملصفحه}} استفاده کنید (اما از پیونددهی به زیرصفحه با ../ استفاده نکنید). |
2 | بخش | برچسب («بخش برچسبخورده»)، یا سرفصل (عنوان بخش) مبدأ برای تراگنجانیدن. استفاده از این پارامتر اختیاری است. اگر بنا بر استفاده از برچسب بود، باید ابتدا برچسب به صفحه افزوده شده و ذخیره شود. |
3 | بازه | بخش نهایی در مجموعهای از سرفصلها یا برچسبهای پیوسته برای تراگنجانش. استفاده از این پارامتر اختیاری است.
|
3 | تغییر | ویکیمتن جایگزین. تنها #lstx هنگام تراگنجانش قادر به بازنویسی یک بخش برچسبخورده است. استفاده از این پارامتر اختیاری است. |
امکان وارد کردن پارامترهای الگو به بخش یا صفحهٔ تراگنجانششده وجود ندارد، اما میتوان واژههای جادویی نظیر {{نامصفحه}}
را به کد صفحه افزود تا تشخیص دهد که در کجا قرار گرفته و بر آن اساس، بهشکلی متفاوت رفتار کند.
تابع تجزیهگر | نام مستعار | توضیح |
---|---|---|
#lst | #section | تراگنجانشکردن یک label یافتشده در درون برچسبهای . برچسبهای تراگنجانش را مد نظر قرار میدهد. پیشفرض آن، کل صفحه است. اگر برچسب یافت نشود، هیچچیزی را تراگنجانش نمیکند. |
#lstx | #section-x | تراگنجانشکردن کل صفحه، بهجز یک برچسب خاص. سرفصلها را نادیده میگیرد. برچسبهای تراگنجانش را مد نظر قرار میدهد. پیشفرض آن، کل صفحه است. اگر برچسب یافت نشود، کل صفحه را تراگنجانش میکند. |
#lsth | #section-h | تراگنجانشکردن یک heading (عنوان بخش). برچسبها را نادیده میگیرد. برچسبهای تراگنجانش را مد نظر قرار نمیدهد.† پیشفرض آن، بخش آغازین صفحه است. اگر برچسب یافت نشود، هیچچیزی را تراگنجانش نمیکند. |
در صفحهٔ هدف شود.
رفتار برچسبهای تراب:
گزینههای تراگنجانش تراب:
نحو استاندارد بر آن اعمال میشود:
خطاهای متداول در استفاده:
در صورتی که تنها از عنوان بخشها برای تراگنجانش استفاده شود، نیازی به درج نشانهگذاری در صفحهٔ مبدأ نیست. این قاعده در زمان استفاده از #section-h اعمال میشود.
برای برچسبزدن یک بخش بهمنظور تراگنجانش با تراب، از نشانهگذاری که در ادامه میآید استفاده کنید.
محدودهٔ بخش مورد نظر خود در صفحهٔ مبدأ را با استفاده از دو برچسب مفرد علامتگذاری کنید؛ برای مثال، بهمنظور برچسبزدن یک بخش تحت عنوان «فصل۱»:
محتوای فصل
دقت کنید که این برچسب مانند برچسبهای اچتیامال بهشکل عادی باز و بسته نمیشود. در اچتیامال، برچسب
نامعتبر محسوب میشود. برچسب تجزیهگر با عناصر اچتیامال سازگار نیست؛ زیرا نشانهگذاری مدیاویکی برچسب تجزیهگری را بهکار میگیرد که تنها برای استفاده توسط افزونهٔ تراگنجانش بخش برچسبخورده افزوده شده است.
برای تراگنجانیدن بخش از تابع تجزیهگر #section
استفاده کنید. برای مثال، برای تراگنجانیدن بخشی از صفحهای با عنوان مقاله فلان که تحت عنوان فصل۱ برچسب خورده:
{{#section:مقاله فلان|فصل۱}}
برای تراگنجانیدن یک صفحه و مستثنیکردن یک بخش مشخص از آن صفحه، از تابع تجزیهگر #section-x
استفاده کنید:
{{#section-x:نامکاملصفحه|برچسب}}
یا
{{#section-x:نامکاملصفحه|سرفصل}}
بهطور اختیاری میتوانید متن جایگزینی را برای بخش مستثنیشده تعیین کنید.
{{#section-x:نامکاملصفحه|برچسب|متن جایگزین}}
مثال:
{{#section-x:مقاله فلان|فصل۱|فصل ۱ در [[مقاله فلان]] را ببینید.}}
متن جایگزین در جایی درج میشود که بخش مستثنیشده در صفحهٔ مبدأ در آنجا قرار داشته و در زمان تراگنجانش مستثنی شده و خالی مانده است.
بهطور پیشفرض، تابع #section
تمام فضاهای خالی موجود در بخش را تراگنجانش میکند که در صورتی که در تلاش برای تراگنجانیدن بخش در یک مقالهٔ متفاوت باشید، میتواند منجر به بروز مشکلاتی شود. برای رفع این مشکل، این نکته را در نظر بگیرید که تابع تجزیهگر {{#اگر}} فاصلههای خالی اطراف ورودی خود را برش میزند. برای مثال:
{{#اگر:1|{{#section:مقاله فلان|فصل۱}}}}
این کار باعث حذف فضای خالی از ابتدا و انتهای محتوا میشود و مقاله بهشکلی که مد نظر است، نمایش داده خواهد شد. از آنجا که با این کار در حال استفادهٔ تودرتویی از الگوها هستید، اندازه دربرگیری پس از بسط بخش منتخب، دوبرابر خواهد شد که در صفحههای حجیمتر منجر به بروز مشکل میشود. بنابراین بهتر است که صفحهٔ مبدأ را ویرایش کنید و محتوای مورد نظر خود برای تراگنجانش را بدون فضاهای خالی اضافی در میان برچسبهای
قرار دهید. همچنین میتوانید از الگوی {{اصلاح}} بهجای {{#اگر:1}} استفاده کنید، اما از آنجا که این الگو نیز تنها یک الگوی لفاف برای تکنیک {{#اگر:1}} است که در بالا به آن اشاره شد، این کار نیز منجر به افزایش سهبرابری اندازه دربرگیری پس از بسط خواهد شد.
این امکان وجود دارد که چندین بخش با نام یکسان در صفحه موجود باشد؛ در این صورت، هر بخشی که از آن نام برخوردار باشد گنجانده/مستثنی خواهد شد. این قابلیت بهویژه برای علامتگذاری چندین ریسه در صفحههای بحث میتواند مفید باشد.
این توابع میتوانند کل صفحه را تراگنجانش کنند و از همین روی دارای دو آرگومان اختیاری برای تنظیم عملکرد هستند: ۱) نام یک بخش برچسبخورده یا عنوان یک سرفصل در صفحه، ۲) بازهای از برچسبهایی که با نام واردشده برچسب خوردهاند، یا عنوان یک بخش، و ۳) محتوای جایگزین برای بخش نامگذاریشده.
{{#section:مقاله فلان|فصل۱|فصل۳}}
همهچیز را از ابتدای فصل ۱ تا انتهای فصل ۳ در صفحهٔ هدف میگنجاند. این قابلیت امکان استفاده از مجموعهعلامتهای خالی بهمنظور علامتگذاری یک سرِ بخش، که احتمالاً در الگوها کاربرد خواهد داشت، را فراهم میکند.{{#section-h:مقاله فلان|فصل۱|فصل۳}}
محتوای فصل۱ و سرفصل و محتوای فصل۲ را در صفحهٔ هدف میگنجاند.{{#section-x:مقاله فلان|فصل۱|فصل۳}}
محتوا و سرفصل فصل۱ را با واژهٔ «فصل۳» جایگزین میکند.برای «تراگنجانیدن» محتوا تنها برای یک بار (کپی کردن آن) بهجای تراگنجانش در هر بار بازدید، از جانشانی استفاده کنید:
برای مثال، بهمنظور بایگانی بحثهای قدیمی در صفحهٔ بحث خود، میتوانید محتوا را به یک صفحهٔ بایگانی کپی کنید و سپس آن را حذف کنید. تمام این کار را میتواند با استفاده از تراب انجام دهید:
را در ابتدای بخشی که میخواهید بایگانی کنید، و
را در انتهای آن قرار دهید. (در اینجا از «بایگانی» بهعنوان برچسب استفاده شده، اما استفاده از هر برچسب دیگری مجاز است). این بخش میتواند در هرکجای صفحه باشد و حتی میتواند حاوی چندین مبحث باشد.لطفاً هنگام استفاده از جانشانی برای تراگنجانش محتوا در ویکیپدیا، برای اعمال حقوق و تعهدات باز-استفادهکنندگان از خلاصهٔ ویرایش استفاده کنید. این قاعده بر هرگونه محتوای قابل توجه اعمال میشود، و نه فقط بر محتوای مقالهها.
در حال حاضر هیچ الگویی قادر به تسهیل استفاده از نشانهگذاری تراب نیست؛ زیرا استفاده از #برچسب بهمنظور «پیشذخیرهسازیتبدیل» (preSaveTransform) واژههای جادویی درون هرگونه برچسب، ضروری است. برای تلاشی که در گذشته به این منظور انجام شده الگوی (غیرقابل استفادهٔ) {{بخش}} را ببینید.
تنها راه برای ارزیابی آرگومانهای الگو درون یک برچسب (به علت ترتیب تجزیه کردن)، استفاده از #برچسب است. تراب، همزمان با تولید برچسب بخش، نیازمند ارزیابی (الگو) برای برچسب است:
{{ #برچسب: section | {{{1}}} }}
اما #برچسب تنها برچسبهای مشابه اکسامال (متعادل، بازشده و بستهشده، دارای آغاز و پایان) را تولید میکند؛ در حالی که تراب از یک برچسب مفرد که بهطور صریح و بهتنهایی بسته شده، استفاده میکند. بنابراین برچسبهای تراب نمیتوانند توسط هیچ الگویی تولید شوند. مقایسه کنید خرجی واقعی را:
{{#tag:section|content|begin=label}} → < section begin=label> content section>
با خروجی مورد درخواست:
label /> content label />
این پیوندها به جستجوهایی برای یافتن کاربردهای این توابع هدایت میشوند:
This article uses material from the Wikipedia فارسی article راهنما:تراگنجانش بخش برچسبخورده, which is released under the Creative Commons Attribution-ShareAlike 3.0 license ("CC BY-SA 3.0"); additional terms may apply (view authors). محتوا تحت CC BY-SA 4.0 در دسترس است مگر خلافش ذکر شده باشد. Images, videos and audio are available under their respective licenses.
®Wikipedia is a registered trademark of the Wiki Foundation, Inc. Wiki فارسی (DUHOCTRUNGQUOC.VN) is an independent company and has no affiliation with Wiki Foundation.