באַקוקן דעם קאוד פון מוסטער:משתמש נושא מועדף/תיעוד

<noinclude>{{דעסקריפציע}}</noinclude>תבנית זו ל[[ויקיפדיה:תיבת משתמש|תיבות משתמש]] משמשת לפירוט תחום עניין. היא בדרך כלל מקבלת כפרמטרים את תחום העניין ותמונה אילוסטרטיבית.

{{הודעה כללית|שימו לב: עבור הנושאים המופיעים כבר ב[[:קטגוריה:ויקיפדיה - משתמש - נושא מועדף]], מוטב להשתמש בתבניות המוכנות.}}

== דוגמאות ==
{| class="wikitable"
! הסבר
! קוד ויקי
! תוצאה
|-
| שימוש עם נושא בלבד, ללא תמונה (לא מומלץ)
|  <syntaxhighlight lang="wikitext" dir="rtl">
{{משתמש נושא מועדף|[[דינוזאורים]]}}
</syntaxhighlight>
| {{משתמש נושא מועדף|[[דינוזאורים]]}}
|-
| שימוש עם נושא ותמונה
|  <syntaxhighlight lang="wikitext" dir="rtl">
{{משתמש נושא מועדף|[[דינוזאורים]]|תמונה=P Dinosaurs.svg}}
</syntaxhighlight>
| {{משתמש נושא מועדף|[[דינוזאורים]]|תמונה=P Dinosaurs.svg}}
|-
| שימוש בכל הפרמטרים המומלצים
|  <syntaxhighlight lang="wikitext" dir="rtl">
{{משתמש נושא מועדף
    |[[פילוסופיה]]
    |תמונה=Immanuel_Kant_(painted_portrait).jpg‏
    |סוג=גלייכט
}}
</syntaxhighlight>
| {{משתמש נושא מועדף
    |[[פילוסופיה]]
    |תמונה=Immanuel_Kant_(painted_portrait).jpg‏
    |סוג=גלייכט
}}
|-
| שימוש בכל הפרמטרים
|  <syntaxhighlight lang="wikitext" dir="rtl">
{{משתמש נושא מועדף
    |[[פילוסופיה]]
    |תמונה=Immanuel_Kant_(painted_portrait).jpg‏
    |גודל תמונה=x47px
    |קישור=עמנואל קאנט
    |רקע תמונה=aqua
    |רקע=aqua
    |צבע טקסט=#000080
    |מסגרת=blue
    |סוג=אינטערעסע
    |משתמשת=כן
}}
</syntaxhighlight>
| {{משתמש נושא מועדף
    |[[פילוסופיה]]
    |תמונה=Immanuel_Kant_(painted_portrait).jpg‏
    |גודל תמונה=x47px
    |קישור=עמנואל קאנט
    |רקע תמונה=aqua
    |רקע=aqua
    |צבע טקסט=#000080
    |מסגרת=blue
    |סוג=אינטערעסע
    |משתמשת=כן
}}
|-
| סוג=ליב
|  <syntaxhighlight lang="wikitext" dir="rtl">
{{משתמש נושא מועדף|[[פילוסופיה]]|תמונה=Immanuel_Kant_(painted_portrait).jpg‏|סוג=ליב}}
</syntaxhighlight>
| {{משתמש נושא מועדף|[[פילוסופיה]]|תמונה=Immanuel_Kant_(painted_portrait).jpg‏|סוג=ליב}}
|}

== פרמטרים ==

<templatedata>
{
	"description": "תבנית משתמש כללית לפירוט תחום עניין",
	"params": {
		"1": {
			"label": "תחום",
			"description": "תחום העניין עצמו כקוד ויקי",
			"type": "content",
			"required": true,
			"suggested": true,
			"example": "[[דינוזאורים]]"
		},
		"תמונה": {
			"description": "שם התמונה שתוצג כאילוסטרציה",
			"type": "wiki-file-name",
			"required": false,
			"suggested": true,
			"example": "P Dinosaurs.svg"
		},
		"גודל תמונה": {
			"description": "גודל התמונה. כברירת מחדל ייבחר הרוחב, אך אם מוסיפים את התחילית 'x' ייבחר הגובה. בכל מקרה היחס רוחב:גובה ישמר.",
			"type": "line",
			"required": false,
			"default": "38px",
			"example": "x47px"
		},
		"קישור": {
			"description": "שם העמוד בוויקיפדיה אליו תפנה לחיצה על התמונה",
			"type": "wiki-page-name",
			"required": false
		},
		"רקע תמונה": {
			"description": "צבע הרקע שיוצג מאחורי התמונה",
			"type": "line",
			"required": false,
			"default": "#FFFFFF (לבן)"
		},
		"רקע": {
			"description": "צבע הרקע",
			"type": "line",
			"required": false,
			"default": "#DBDBDB (אפור בהיר)"
		},
		"צבע טקסט": {
			"description": "צבע הטקסט",
			"type": "line",
			"required": false,
			"default": "black (שחור)"
		},
		"מסגרת": {
			"description": "צבע המסגרת",
			"type": "line",
			"required": false,
			"default": "#808080 (אפור כהה)"
		},
		"סוג": {
			"description": "סוג העניין שיש למשתמש/ת בנושא ('ידע', 'תחביב', 'עניין' או 'אהבה')",
			"type": "line",
			"required": false,
			"suggested": true,
			"default": "קען"
		},
		"משתמשת": {
			"description": "כשהתבנית מוצגת בדף משתמש, מוצג המגדר בהתאם להגדרות המשתמש. במידה והמגדר לא ידוע, הטקסט יוצג בלשון נקבה אם הערך הוא 'כן', וזכר אם הוא ריק.",
			"type": "line",
			"required": false
		}
	},
	"paramOrder": [
		"1",
		"תמונה",
		"סוג",
		"משתמשת",
		"גודל תמונה",
		"קישור",
		"רקע תמונה",
		"רקע",
		"צבע טקסט",
		"מסגרת"
	]
}
</templatedata>

את שמות הצבעים יש לציין בענגליש. לצפייה בשמות ולאפשרויות נוספות, ראו [[:en:Web Color|Web Color]].

<noinclude>
{{תיעוד תבנית}}
</noinclude>