قالب:صورة مشروحة - ويكيبيديا

توثيق القالب[عرض] [عدّل] [تاريخ] [محو الاختزان] [استخدامات]

هذا القالب يسمح للمستخدمين إضافة معلومات وملاحظات لصورة معينة على شكل جمل كاملة أو نصوص (يمكن أن تحوي وصلات خارجيّة)، والمقصود منه تسهيل القراءة للمستخدمين عمومًا والذين يعانون قصر النظر خصوصًا، لا سيما وأن معظم الصور توضع بحجم مُصغّر يُصعب القراء في بعض الأحيان.

يُمكن استخدام هذا القالب أيضًا لإزلة بعض الأقسام غير المرغوبة من إحدى الصور أو تكبير حجم بعضها الآخر، بالإضافة لتدويل الصور، أي وضع شرح واف عنها دون حاجة إلى ترجمتها باستخدام إحدى البرامج الحاسوبيّة.

الاستخدام[عدل]

للاطلاع على الأمثلة أنظر قالب:صورة مشروحة/doc/أمثلة.

إن جميع المعلمات يجب أن تكون ذات أسماء – فلا يمكن أن توجد أي معلمات "مرقمة" غير مسماة.

يُمكن الاستغناء عن إحدى معلمتان بأخرى، وهاتان هما: الصورة وخريطة الصورة، دائمًا استخدم إحداهما لكن لا تستخدم كلاهما معًا.

في معظم الحالات لن يحتاج المستخدم إلا إلى تعبئة المعلمات المطلوبة – أما المعلمات الأخرى فهي موضوعة بحال رغب المستخدم إضافة أو وضع تصميم أكثر توسعًا للصورة.

Name	Allowed values	Default value	Function & notes
caption	wikitext	(required)	Caption of the image, goes in the usual place for image captions.
alt	text	empty	Alt text of image, for readers who cannot see it; see ويكيبيديا:ALT.
image	valid image file name; SVG images are allowed	(see note)	You must specify image or imagemap but not both.
imagemap	valid (X)HTML imagemap	(see note)	You must specify image or imagemap but not both.
width	positive integer	(optional)	Total width (in pixels) of the box containing the image and annotations. Must be at least as large as the image's displayed width (which you can set by using image-width).
height	positive integer	(optional)	Total height (in pixels) of the box containing the image and annotations. Must be at least as large as the image's displayed height. If you change the displayed width of the image by specifying image-width, you will have to work out the image's displayed height and then add any "margins" you need for annotations.
image-left	positive integer	(optional; defaults to 0)	X-coordinate of the image's top left corner (in pixels), relative to the top left corner of the box containing the image and annotations.
image-top	positive integer	(optional; defaults to 0)	Y-coordinate of the image's top left corner (in pixels), relative to the top left corner of the box containing the image and annotations.
image-width	positive integer	(required)	Width of the image (in pixels).
annotations	required	may be left empty (annotations=) if you simply want to crop an image	Annotations for the image.
float	right left none	right	Makes the template's output float to the right or left of the text..
outer-css	any valid CSS	(optional, no default value)	Additional CSS for the outermost box. Cannot over-ride any other parameters that you specify for the outer box. It is best to use this only as a last resort.
image-bg-color	any valid CSS color	white	Background of the box in whichi the image is displayed. You might want to set a dark background if the image is dark and you want to use a light color for the annotations.
image-css	any valid CSS	(optional, no default value)	Additional CSS for the image (or rather, the invisible box that contains it). Cannot over-ride any other parameters that you specify for the image's box. It is best to use this only as a last resort.
annot-text-align	left right center	left	Sets a default text-alignment for all the contained annotations. You can over-ride this for individual annotations if you wish.
annot-background-color	any valid CSS color	transparent	Sets a default background-color for all the contained annotations. You can over-ride this for individual annotations if you wish.
annot-font-family	any valid CSS font-family	(optional, no default value)	Sets a default font-family for all the contained annotations. You can over-ride this for individual annotations if you wish.
annot-font-size	positive integer	(optional, no default value)	Sets a default font-size (in pixels) for all the contained annotations. You can over-ride this for individual annotations if you wish.
annot-font-weight	any valid CSS font-weight	(optional, no default value)	Sets a default font-weight for all the contained annotations. You can over-ride this for individual annotations if you wish.
annot-font-style	any valid CSS font-style (e.g. italic)	(optional, no default value)	Sets a default font-style for all the contained annotations. You can over-ride this for individual annotations if you wish.
annot-line-height	any valid CSS line-height	(optional, no default value)	Sets a default line-height (line spacing) for all the contained annotations. You can over-ride this for individual annotations if you wish. Only useful for multi-line annotations.
annot-font-family	any valid CSS font-family	(optional, no default value)	Sets a default font-family for all the contained annotations. You can over-ride this for individual annotations if you wish.
annot-color	any valid CSS color	(optional, no default value)	Sets a default color for all the contained annotations. You can over-ride this for individual annotations if you wish.

Example[عدل]

قالب:Annotated image/Extinction

Internationalisation[عدل]

This template makes internationalisation easy – the text is already separate from the image, so it is easy to translate the text and, if necessary, move pieces of text, as the lengths of the same text in different languages can vary a lot. For example nl:Sjabloon:Zijbalk mariene extincties, the Dutch version of قالب:Annotated image/Extinction, is widely used..

Pitfall[عدل]

There is one pitfall, although it is mainly about using one browser in the correct way (Microsoft Internet Explorer, of course). Internet Explorer has two ways of scaling-up text to ease readability:

Text resizing, which appears in Internet Explorer's View menu, affects text but not images. This method can disrupt annotated images, as the text is scaled up but the image content and frame are not. Firefox and Opera do not use this mechanism.
Zoom also scales the image as well as text annotations, and thus does not disrupt the relative sizes and locations of annotations in annotated images. Netscape and its Mozilla derivatives, Firefox and Opera have had zoom for years, and it is more useful, as it also scales text implemented as part of an image, e.g., as in the Wikipedia logo. The zoom control sequences (CTRL + to increase, CTRL - to decrease) are the same in Firefox, Opera and Internet Explorer. In Firefox and Opera, there also menu items for zoom, which show the control sequences. In Internet Explorer 7 only text resizing appears in the menu; in order to learn zoom, users must look up some external source.

Subpages: templates based on this one[عدل]

This list is automatically generated and updated. Redirects are shown in italics.

انظر أيضاً[عدل]

Template:Annotation, for creating the annotations
Template:Image label, an alternative
قالب:Overlay, labels the image, automatically constructs a column balanced legend, with sub legends if desired, wikilinks image labels and legend items if desired, allows separate control of label pop up tip, assists in label coordinates determination, etc.
Template:Location map+, for maps with "pins"
قالب:Superimpose, superimposes images

التوثيق في الأعلى مضمن من قالب:صورة مشروحة/شرح.
يمكن للمحررين تجريب تعديلاتهم على القالب في صفحات ملعب ومختبر .
من فضلك أضف التصنيفات في الصفحة الفرعية للقالب /شرح. الصفحات الفرعية لـ قالب.