תבנית:קישור כללי: הבדלים בין גרסאות בדף

גרסה אחרונה מ־11:41, 10 בנובמבר 2020

המידע מטה מוצג מתוך הדף תבנית:קישור כללי/תיעוד.

רקע

בוויקיפדיה העברית ישנן תבניות לקישור חיצוניים המתאימות באופן ייעודי לאתרים מסוימים. בדף קטגוריה:תבניות קישורים חיצוניים ניתן לראות את רשימת האתרים עם תבניות ייעודיות משלהם. עבור חלק מהאתרים האלו אף קיימת יכולת יצירה אוטומטית של תבנית הקישור בלחיצת כפתור, כשהיא כבר ממולאת בכל הפרטים. יכולת זאת מתבססת על הבוקמרקלטים של ויקיפדיה העברית. הסברים והוראות התקנה לבוקמרקלטים נמצאים בדף: ויקיפדיה:בוקמרקלטים. רשימת האתרים שנתמכים על ידי הבוקמרקלטים נמצאת בדף: קטגוריה:ויקיפדיה: בוקמרקלטים - אתרים נתמכים.

תיאור

התבנית {{קישור כללי}} מיועדת לקישור לאתרים אשר לא נתמכים על ידי תבניות הקישור הייעודיות לאתרים, ולא נתמכים על ידי הבוקמרקלטים של ויקיפדיה העברית. לפיכך תבנית זו מיועדת לכל שאר הקישורים, כלומר לקישורים עבורם לא קיימת תבנית ייעודית. קוד המקור של תבנית זאת מתבסס על התבנית לקישורים כלליים לאתרים לא בעברית.

עזרה

העזרה מבוססת על הדוקומנטציה האנגלית של cite web.

כל הפרמטרים

{{קישור כללי
|הכותב=
|כתובת=
|כותרת=
|עמודים=
|אתר=
|מידע נוסף=
|תאריך=
|שפה=
|תאריך_וידוא=
|doi=
|ציטוט=
}}

פרמטרים נדרשים

כתובת: הקישור עצמו. התחילו אותו עם קידומת הפרוטוקול, למשל http://.
כותרת: כותרת הקישור.

פרמטרים נוספים חשובים

תאריך: למשל 2008-04-25, כדי שהקוראים יידעו מתי נכתב התוכן שבקישור.
הכותב: מי כתב את התוכן שבקישור
אתר: שם האתר המפרסם, או הגוף שהאתר בבעלותו, רצוי כקישור לערך המתאים בוויקיפדיה. כך למשל לדף באתר הטכניון, נקשר לערך הטכניון - מכון טכנולוגי לישראל עם כיתוב "הטכניון". אין הכוונה לכתובת האתר - זו מופיעה בקישור עצמו.

פרמטרים נוספים משניים

עמודים: הפניה לעמודים מסוימים במסמך, למשל 7-5.
שפה: כאשר השפה היא לא עברית (למשל [[אנגלית]]). כאשר ערכו של פרמטר זה הוא he או he-il או "עברית", השפה אינה מוצגת, משום שעברית היא ברירת המחדל בוויקיפדיה העברית.
מידע נוסף - מידע נוסף שיוצג בקישור (לפני התאריך והשפה).

פרמטרים המיועדים לעזרה בתחזוקה, אך לא יוצגו לקוראים

doi: קוד מזהה עצם דיגיטלי שניתן למסמך אלקטרוני על ידי ארגון ה-DOI העולמי. למשל, 10.1038/news070508-7
ציטוט: ציטוט נבחר מתוך הקישור. הציטוט לא יוצג לקוראים, ומיועד לעזור לאתר מקור חליפי למידע אם הקישור המקורי ייעלם.
תאריך_וידוא: למשל 2009-01-31, כדי שאם הקישור לא יעבוד (למשל ב-2012) הקוראים יבינו שהוא לא הוסף למאמר בזדון אלא שפשוט במשך זמן רב אף אחד לא וידא שהוא עובד. קוראים שנכנסים לקישורים חיצוניים ואחר כך נמצאים במצב עריכה, מוזמנים לעדכן תאריך_וידוא ישנים.

דוגמה

אין צורך להשתמש בפרמטרים הלא ידועים:

{{קישור כללי
|הכותב=[[דאגלס אדמס]]
|כתובת=http://www.hebrewsite.com/category/page.htm
|כותרת=זייפוד ביבלברוקס מכריז על וויקיפדיה בפינית
|עמודים=7-11
|אתר=
|מידע נוסף=הידיעה עצמה התבררה כמתיחת אחד באפריל
|תאריך=1988-01-15
|שפה=בורמזית
|תאריך_וידוא=2001-02-19
}}

יוצג כ:

דאגלס אדמס, זייפוד ביבלברוקס מכריז על וויקיפדיה בפינית (עמ' 7-11), הידיעה עצמה התבררה כמתיחת אחד באפריל, ‏1988-01-15 תבנית:שפת קישור

דוגמה נוספת:

{{קישור כללי
|כתובת=http://www.ice.co.il/media/news/article/785475
|כותרת="בגל השני - המטרות התקשורתיות של נתניהו השתנו לחלוטין"
|אתר=Ice
|שפה=he
|תאריך_וידוא=2020-09-04}}

יוצג כ:

"בגל השני - המטרות התקשורתיות של נתניהו השתנו לחלוטין", Ice

__EXPECTED_UNCONNECTED_PAGE__

תבנית לקישור כללי לאתר חיצוני

פרמטרים של תבניות[עריכת נתוני תבנית]
התבנית הזאת מעדיפה עיצוב פרמטרים בשורה אחת.
פרמטר		תיאור	סוג	מצב
כתובת	`כתובת`	כתובת הדף	URL	דרוש
הכותב	`הכותב`	שם הכותב	לא ידוע	מוצע
כותרת	`כותרת`	כותרת הדף	לא ידוע	דרוש
אתר	`אתר`	שם האתר	לא ידוע	מוצע
עמודים	`עמודים`	אין תיאור	לא ידוע	לא חובה
מידע נוסף	`מידע נוסף`	אין תיאור	לא ידוע	לא חובה
תאריך	`תאריך`	תאריך פרסום	לא ידוע	מוצע
שפה	`שפה`	אין תיאור	לא ידוע	לא חובה
doi	`doi`	מזהה דיגיטלי	לא ידוע	לא חובה
תאריך_וידוא	`תאריך_וידוא`	תאריך אחרון שבו וידאו את תקינות הקישור	לא ידוע	לא חובה
ציטוט	`ציטוט`	ציטוט אליו מתייחס המקור. הטקסט לא יוצג אך יעזור בחיפושים למקור חלופי במידת הצורך	לא ידוע	לא חובה
קישור ארכיון	`archive-url`	קישור לארכיון	לא ידוע	לא חובה
קישור שבור	`dead-url`	האם הקישור שבור דוגמה yes	לא ידוע	לא חובה
תאריך ארכיון	`archive-date`	אין תיאור דוגמה 2014-10-20	לא ידוע	לא חובה

@@ שורה 1: / שורה 1: @@
-<includeonly>{{#תנאי:{{{הכותב|}}}|{{כ}}{{{הכותב}}},&nbsp;}}[{{{כתובת}}} {{כ}}{{{כותרת}}}] {{#תנאי: {{{עמודים|}}}|(עמודים {{{עמודים}}})}} {{#תנאי:{{{מידע נוסף|}}}|, {{{מידע נוסף}}}}} {{כ}}{{#תנאי:{{{תאריך|}}}|, {{{תאריך}}}}}{{כ}} {{#תנאי:{{{שפה|}}}|<sup>{{כ}}({{{שפה}}}){{כ}}</sup>}} {{#בחר:{{{פורמט|}}}|PDF={{PDF}}|DOC={{DOC}}}}</includeonly><noinclude>
+<noinclude>{{ניהול פרמטרים/תוכן}}</noinclude><includeonly>{{#invoke:ParamValidator|validateparams|module_options=יחידה:PV-options}}</includeonly><includeonly>{{#תנאי:{{{הכותב|}}}|{{{הכותב}}},&nbsp;}}[{{{כתובת}}} {{{כותרת}}}]{{#תנאי: {{{עמודים|}}}|&nbsp;(עמ' {{{עמודים}}})}}{{#תנאי:{{{אתר|}}}|, {{{אתר}}}}}{{#תנאי:{{{מידע נוסף|}}}|, {{{מידע נוסף}}}}}{{#תנאי:{{{תאריך|}}}|, {{כ}}{{{תאריך}}}}}{{#תנאי:{{{שפה|}}}|{{#בחר:{{{שפה}}}|he=|he-il=|iw=|עברית=|&nbsp;{{שפת קישור|שפה={{{שפה}}}}}}}}}{{#שווה:{{{dead-url}}}|yes|{{#תנאי:{{{archive-url}}}|&nbsp;([{{{archive-url}}} ארכיון])}}}}</includeonly><noinclude>
-==תיאור==
+{{תיעוד}}
-כפי [[ויקיפדיה:קישורים חיצוניים#תיאור הקישור|שמתואר בהסבר לקישורים חיצוניים]], לקישורים חיצוניים מסוימים בוויקיפדיה העברית קיימות [[:קטגוריה:תבניות קישורים חיצוניים|תבניות ספציפיות משלהם]]. תבנית זו מיועדת לכל שאר הקישורים, כלומר לקישורים עבורם לא קיימת תבנית מיוחדת. קוד המקור של התבנית מתבסס על [[תבנית:cite web|התבנית לקישורים כלליים לאתרים לא בעברית]].
-==עזרה==
+[[קטגוריה:תבניות קישורים חיצוניים|*]]
-העזרה מבוססת על [[:en:Template:Cite web/doc|הדוקומנטציה האנגלית של cite web]].
+<noinclude>
+<templatedata>
-===כל הפרמטרים===
+{
-;כל הפרמטרים, בהצגה אופקית
+	"description": "תבנית לקישור כללי לאתר חיצוני",
+	"params": {
-<tt><nowiki>{{קישור כללי |כתובת= |כותרת= |תאריך_וידוא= |הכותב=  |תאריך=|פורמט= |עמודים= |שפה= |doi= |ציטוט= |מידע נוסף=}}</nowiki></tt>
+		"הכותב": {
+			"description": "שם הכותב",
-;כל הפרמטרים, בהצגה אנכית
+			"suggested": true
-<pre>
+		},
-{{קישור כללי
+		"כתובת": {
-| הכותב =
+			"description": "כתובת הדף",
-| כותרת =
+			"required": true,
-| כתובת =
+			"type": "url"
-| תאריך =
+		},
-| עמודים =
+		"כותרת": {
-| שפה =
+			"description": "כותרת הדף",
-|מידע נוסף =
+			"required": true
-| doi =
+		},
-| ציטוט =
+		"אתר": {
-| תאריך_וידוא =
+			"description": "שם האתר",
-}}
+			"suggested": true
-</pre>
+		},
+		"עמודים": {},
-====פרמטרים נדרשים====
+		"מידע נוסף": {},
-*'''כתובת''': הקישור עצמו. התחילו אותו עם קידומת הפרוטוקול, למשל <span dir="ltr"><nowiki>http://</nowiki></span>.
+		"תאריך": {
-*'''כותרת''': כותרת הקישור.
+			"description": "תאריך פרסום",
+			"suggested": true
-====פרמטרים נוספים חשובים====
+		},
-*'''תאריך''': למשל 2008-04-25, כדי שהקוראים יידעו מתי נכתב התוכן שבקישור.
+		"שפה": {},
-*'''תאריך_וידוא''': למשל 2009-01-31, כדי שאם הקישור לא יעבוד (למשל ב-2012) הקוראים יבינו שהוא לא הוסף למאמר בזדון אלא שפשוט במשך זמן רב אף אחד לא וידא שהוא עובד. קוראים שנכנסים לקישורים חיצוניים ואחר כך נמצאים במצב עריכה, מוזמנים לעדכן תאריך_וידוא ישנים.
+		"doi": {
-*'''פורמט''': נדרש רק כאשר התוכן שבקישור אינו בפורמט [[HTML]], כדי להזהיר את הקוראים שמדובר בקבצים שלהצגתם נדרשת [[תוכנה]] נוספת בצד המשתמש. במקרה זה יש לציין קישור לסוג הקובץ, למשל <nowiki>[[PDF]]</nowiki> או <nowiki>[[Word]]</nowiki>.
+			"description": "מזהה דיגיטלי"
+		},
-====פרמטרים נוספים משניים====
+		"תאריך_וידוא": {
-*'''הכותב''': מי כתב את התוכן שבקישור
+			"description": "תאריך אחרון שבו וידאו את תקינות הקישור"
-*'''עמודים''': למשל 7-5.
+		},
-*'''שפה''': כאשר השפה היא לא עברית (למשל <nowiki>[[אנגלית]]</nowiki>).
+		"ציטוט": {
-* '''מידע נוסף''' - מידע נוסף שיוצג בקישור (לפני התאריך, השפה ומציין הפורמט).
+			"description": "ציטוט אליו מתייחס המקור. הטקסט לא יוצג אך יעזור בחיפושים למקור חלופי במידת הצורך"
-==פרמטרים המיועדים לעזרה בתחזוקה, אך לא יוצגו לקוראים==
+		},
-* '''doi''': קוד [[מזהה עצם דיגיטלי]] שניתן למסמך אלקטרוני על ידי ארגון ה-DOI העולמי. למשל, ''<nowiki>10.1038/news070508-7</nowiki>''
+		"archive-url": {
-*'''ציטוט''': ציטוט נבחר מתוך הקישור. הציטוט לא יוצג לקוראים, ומיועד לעזור לאתר מקור חליפי למידע אם הקישור המקורי ייעלם.
+			"label": "קישור ארכיון",
-* '''תאריך וידוא'''
+			"description": "קישור לארכיון"
+		},
-===דוגמה===
+		"dead-url": {
-אין צורך להשתמש בפרמטרים הלא ידועים:
+			"label": "קישור שבור",
-<pre>
+			"description": "האם הקישור שבור",
-{{קישור כללי
+			"example": "yes"
-|כתובת= http://www.hebrewsite.com/category/page.htm
+		},
-|כותרת= זייפוד ביבלברוקס מכריז על וויקיפדיה בפינית
+		"archive-date": {
-|הכותב= [[דאגלס אדאמס]]
+			"label": "תאריך ארכיון",
-|תאריך_וידוא= 2001-02-19
+			"example": "2014-10-20"
-|תאריך= 1988-01-15
+		}
-|שפה = בורמזית
+	},
-|עמודים = 7-11
+	"maps": {
-|פורמט = PDF
+		"citoid": {
-|מידע נוסף=הידיעה עצמה התבררה כמתיחת אחד באפריל
+			"title": "כותרת",
-}}
+			"url": "כתובת",
-</pre>
+			"subject": "כותרת",
+			"blogTitle": "אתר",
-יוצג כ:
+			"forumTitle": "אתר",
+			"seriesTitle": "אתר",
-{{קישור כללי
+			"websiteTitle": "אתר",
-|כתובת= http://www.hebrewsite.com/category/page.htm
+			"publisher": "אתר",
-|כותרת= זייפוד ביבלברוקס מכריז על וויקיפדיה בפינית
+			"date": "תאריך",
-|הכותב= [[דאגלס אדאמס]]
+			"pages": "עמודים",
-|תאריך_וידוא= 2001-02-19
+			"accessDate": "תאריך_וידוא",
-|תאריך= 1988-01-15
+			"DOI": "doi",
-|שפה = בורמזית
+			"language": "שפה",
-|עמודים = 7-11
+			"contributor": "הכותב",
-|פורמט = PDF
+			"author": "הכותב"
-|מידע נוסף=הידיעה עצמה התבררה כמתיחת אחד באפריל
+		}
-}}
+	},
+	"format": "inline",
-{{מיון רגיל:כללי, קישור}}
+	"paramOrder": [
-[[קטגוריה:תבניות קישורים חיצוניים]]
+		"כתובת",
+		"הכותב",
-[[en:Template:Cite web]]
+		"כותרת",
+		"אתר",
+		"עמודים",
+		"מידע נוסף",
+		"תאריך",
+		"שפה",
+		"doi",
+		"תאריך_וידוא",
+		"ציטוט",
+		"archive-url",
+		"dead-url",
+		"archive-date"
+	]
+}
+</templatedata>
 </noinclude>