الگو:تصویر حاشیه‌نویسی‌شده/توضیحات
 | این زیرصفحهٔ مستندات الگو:تصویر حاشیه‌نویسی‌شده است. این شامل اطلاعات استفاده، الگوها، پیوندهای بین زبانی و سایر اطلاعات است که در اصل الگو صفحه قرار نمی‌گیرد. |
این الگو امکان افزودن یادداشت‌های توضیحی به تصاویر در قالب متن واقعی (که می‌تواند حاوی پیوند نیز باشد) را فراهم می‌کند که معمولاً خواناتر از متنی است که به‌شکل تصویر درآمده است – به‌ویژه هنگامی که اندازهٔ تصویر، به اندازهٔ بندانگشتی کاهش یافته باشد.
از این الگو همچنین می‌توان برای برش دادن یک تصویر به‌منظور حذف بخش‌های نامهم، و همچنین بزرگ‌نمایی بخش‌های مهم و بین‌المللی‌سازی نیز استفاده کرد تا بتوان حاشیه‌نویسی‌ها را بدون نیاز به اعمال تغییر در تصویر، تغییر داد.
این الگو و {{تصویر حاشیه‌نویسی‌شده ۴}} تنها دو الگوی حاشیه‌نویسی تصویر هستند که برای افزودن ویکی‌متن به تصویر الگوی {{annotation}} را به‌کار می‌گیرند.
نحو[ویرایش]
{{تصویر حاشیه‌نویسی‌شده
| تصویر =
| عرض تصویر =
| راست تصویر =
| بالای تصویر =
| عرض =
| ارتفاع =
| شناور =
| گزارمان =
{{Annotation | راست (به پیکسل)| بالا (به پیکسل) | متن | text-align=right | font-size=12 | font-weight=bold | font-family=Times New Roman | background-color=#ffcccee | color=blue}}
| توضیح =
}}
پارامترها[ویرایش]
تمامی پارامترهای این الگو، دارای نام هستند؛ هیچ پارامتر نام‌گذاری‌نشدهٔ «عددی» در این الگو موجود نیست.
دو مورد از پارامترها، یعنی تصویر و تصویر نقشه، متقابلاً اختصاصی هستند: تنها از یکی از آن‌ها استفاده کنید، نه هردو.
در فهرست زیر، پارامترهایی که برای عملکرد الگو الزامی هستند به‌صورت پررنگ آمده‌اند.
| پارامتر | مقدارهای مجاز | مقدار پیش‌فرض | عملکرد و توضیحات |
|---|---|---|---|
| توضیح | ویکی‌متن | توضیحی برای درج به‌همراه تصویر. | |
| جایگزین | متن | خالی | متنی جایگزی برای افرادی که قادر به مشاهدهٔ تصویر نیستند (وپ:جایگزین را ببینید). |
| تصویر یا تصویر نقشه |
نام معتبر پروندهٔ تصویرالف یا نقشه تصویر معتبر X/HTML |
یکی از پارامترهای تصویر یا نقشه تصویر را استفاده کنید، نه هر دو. | |
| عرض | هر عدد مثبت | – | عرض کامل (به پیکسل) برای جعبه‌ای که حاوی تصویر و حاشیه‌نویسی‌ها است. باید دست کم به اندازهٔ عرض نمایش‌یافتهٔ تصویر باشد (که می‌توان آن را با استفاده از عرض تصویر تنظیم کرد). |
| ارتفاع | هر عدد مثبت | – | ارتفاع کامل (به پیکسل) برای جعبه‌ای که حاوی تصویر و حاشیه‌نویسی‌ها است. باید دست کم به اندازهٔ ارتفاع نمایش‌یافتهٔ تصویر باشد. اگر عرض نمایش‌یافتهٔ تصویر با وارد کردن پارامتر عرض تصویر تغییر یافته باشد، ارتفاع نمایش‌یافتهٔ تصویر و هرگونه «margin» اضافی برای حاشیه‌نویسی‌ها باید محاسبه شوند. |
| راست تصویر | عدد | (صفر) | مختصات X گوشهٔ بالایی سمت راست تصویر (به پیکسل)، نسبت به گوشهٔ بالایی سمت راست جعبهٔ حاوی تصویر و حاشیه‌نویسی. مقدارهای منفی منجر به برش خوردن تصویر می‌شوند. |
| بالای تصویر | عدد | (صفر) | مختصات Y گوشهٔ بالایی سمت راست تصویر (به پیکسل)، نسبت به گوشهٔ بالایی سمت راست جعبهٔ حاوی تصویر و حاشیه‌نویسی. مقدارهای منفی منجر به برش خوردن تصویر می‌شوند. |
| عرض تصویر | عدد مثبت | عرص تصویر اصلی (به پیکسل). (به صفحهٔ پرونده بنگرید و عدد دوم در اندازهٔ تصویر را در این پارامتر استفاده کنید.) | |
| گزارمان | گزارمان (حاشیه‌نویسی) برای تصویر. اگر تصویر باید تنها برش بخورد، این پارامتر باید وارد شود، اما مقدار آن خالی بماند (یعنی به‌صورت |... |گزارمان= |... استفاده شود). | ||
| شناور |
|
چپ | برای تعیین این که آیا الگو باید در سمت راست متن مجاور شناور شود یا سمت چپ آن. |
| سی‌اس‌اس خارجی | هرگونه دستور معتبر سی‌اس‌اس | – | دستورات اضافی سی‌اس‌اس برای اعمال بر جعبهٔ خارجی. منجر به چشم‌پوشی از سایر پارامترهای واردشده برای جعبهٔ خارجی نمی‌شود (به این معنی که بهتر است تنها به‌عنوان «آخرین راه حل» از این پارامتر استفاده شود). |
| رنگ پس‌زمینه تصویر | هرگونه رنگ معتبر CSS | white | رنگ پس‌زمینهٔ جعبه‌ای که تصویر در آن نمایش یافته است (نام فارسی رنگ‌ها پذیرفته نیست). برای مثال، پس‌زمینهٔ تاریک برای تصویری که خود نیز نسبتاً تاریک است و حاشیه‌نویسی‌های رنگی نسبتاً روشن روی آن قرار گرفته‌اند. |
| سی‌اس‌اس تصویر | هرگونه دستور معتبر CSS | – | دستورات اضافی سی‌اس‌اس برای اعمال بر [جعبهٔ داخلی حاوی] تصویر. منجر به چشم‌پوشی از سایر پارامترهای واردشده برای جعبهٔ داخلی نمی‌شود (به این معنی که بهتر است تنها به‌عنوان «آخرین راه حل» از این پارامتر استفاده شود). |
| تراز متن گزارمان |
|
راست | برای تنظیم یک تراز متن پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
| رنگ پس‌زمینه گزارمان | هرگونه رنگ معتبر CSS | transparent | برای تنظیم رنگ پس‌زمینهٔ پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
| خانواده قلم گزارمان | هرگونه خانواده قلم معتبر CSS | – | برای تنظیم خانوادهٔ قلم پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
| اندازه قلم گزارمان | عدد مثبت | – | برای تنظیم اندازهٔ قلم پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
| وزن قلم گزارمان | هرگونه وزن قلم معتبر CSS | – | برای تنظیم وزن قلم پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
| سبک قلم گزارمان | هرگونه سبک قلم معتبر CSS | – | برای تنظیم سبک قلم (مثلاً «italic») پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
| ارتفاع سطر گزارمان | هرگونه ارتفاع سطح معتبر CSS | – | برای تنظیم ارتفاع سطر (فاصلهٔ بین خطوط) پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
| رنگ گزارمان | هرگونه رنگ معتبر CSS | – | برای تنظیم رنگ پیش‌فرض برای تمام حاشیه‌نویسی‌های شامل‌شده کاربرد دارد. می‌توان برای هر حاشیه‌نویسی آن را تغییر داد. |
الف تصاویر اس‌وی‌جی مجاز هستند.
بین‌المللی‌سازی[ویرایش]
بین‌المللی‌سازی این الگو ساده است؛ متن از پیش جدای از تصویر است و ترجمهٔ متن و، در صورت نیاز، جابجایی قطعات متن با توجه به طول بسیار متفاوت متن در زبان‌های مختلف، آسان خواهد بود. برای مثال، nl:Sjabloon:Zijbalk mariene extincties را که نسخهٔ هلندی Template:Annotated image/Extinction است، کاربرد گسترده‌ای دارد.
نمونه‌ها[ویرایش]
الگو:تصویر حاشیه‌نویسی‌شده/انقراض
افزودن یادداشت‌های توضیحی[ویرایش]
الگو:تصویر حاشیه‌نویسی‌شده/توضیحات/نمونه‌ها را ببینید.
برش زدن[ویرایش]
فرض کنید که تصویر نظیر commons:File:Mona Lisa color restoration2.jpg دارید. اما تنها می‌خواهید بخشی از تصویر را نمایش دهید؛ مثلاً بخشی از دهان و بینی:
این کار را می‌توانید با دستورات زیر انجام دهید:
{{تصویر حاشیه‌نویسی‌شده
| تصویر = Mona Lisa color restoration2.jpg
| عرض تصویر = ۲۰۰۰ <!-- عرض مورد نظر خود را انتخاب کنید. کاری به اندازهٔ واقعی تصویر نداشته باشید-->
| راست تصویر = -۸۵۰ <!-- برش سمت راست تصویر. به نماد منفی «-» توجه کنید -->
| بالای تصویر = -۸۰۰ <!-- برش بخش بالایی تصویر. به نماد منفی «-» دقت کنید -->
| عرض = ۲۵۰ <!-- برش سمت چپ تصویر. که در واقع همان عرض تصویر در مقاله خواهد بود -->
| ارتفاع = ۲۵۰ <!-- برش بخش پایین تصویر. که در واقع همان ارتفاع تصویر در مقاله خواهد بود -->
| شناور = راست
| گزارمان = <!-- چه خالی باشد و چه نباشد، این پارامتر باید وارد شود -->
| توضیح = مونا لیزای برش‌خورده از یک تصویر ۲۰۰۰ پیکسلی
}}
نتیجهٔ دستور فوق یک محدودهٔ ۲۵۰ در ۲۵۰ پیکسل از یک تصویر با عرض ۲۰۰۰ پیکسل است (عرض واقعی تصویر اهمیتی ندارد). ۸۰۰ پیکسل بالایی و ۸۵۰ پیکسل از سمت راست تصویر ۲۰۰۰ پیکسلی مذکور «دور انداخته شده» و «باقی‌ماندهٔ» تصویر در سمت چپ کادر ۲۵۰ پیکسلی مورد نظر و همچنین در پایین آن نیز به همین سرنوشت دچار شده‌اند:
زیرصفحه‌ها (الگوهای مبتنی بر این الگو)[ویرایش]
این فهرست به‌طور خودکار تولید و به‌روزرسانی می‌شود. تغییرمسیرهای به‌شکل ایتالیک نمایش یافته‌اند.
الگوهای وابسته[ویرایش]
- {{Annotation}}، برای ایجاد حاشیه‌نویسی‌ها.
- {{تصویر حاشیه‌نویسی‌شده ۴}}، برای حاشیه‌نویسی تصاویر ترازشده در سمت چپ/راست/وسط به‌همراه رنگ پس‌زمینهٔ عادی برای توضیحات.
- {{Image label}}، جایگزینی برای این الگو.
- {{Overlay}}، به تصویر برچسب می‌زند، به‌طور خودکار یک شرح ستونی ایجاد می‌کند و در صورت نیاز، شرح‌های زیرین را نیز تولید می‌کند؛ امکان کنترل جداگانه برای راهنماهایی برای برچسب‌ها را نیز فراهم می‌کند و به تعیین مختصات محل قرارگیری برچسب‌ها نیز کمک می‌کند. این الگو امکانات دیگری نیز دارد که در مستندات آن قابل مشاهده است.
- {{Location map+}}، برای نقشه‌هایی که شامل آیکون‌های مکانی مشابه «پونز» هستند.
- {{Superimpose}} برای روی هم قرار دادن تصویر کاربرد دارد.
- نقشه‌تصویر (افزونهٔ مدیاویکی) - برای افزودن پیوند به محدوده‌های از تصویر