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

גרסה אחרונה מ־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>{{
+<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>
-#if: {{#if: {{{כתובת|}}} | {{#if: {{{כותרת|}}} |1}}}}
+{{תיעוד}}
-  ||שגיאה בקריאה ל[[תבנית:קישור כללי]]: הפרמטרים '''כתובת''' ו-'''כותרת''' חסרים.
-}}{{
-#if: {{{כתובת_בארכיון|}}}{{{תאריך_הארכיון|}}}
-  | {{#if: {{#if: {{{כתובת_בארכיון|}}}| {{#if: {{{תאריך_הארכיון|}}} |1}}}}
-    ||שגיאה בקריאה ל[[תבנית:קישור כללי]]: חובה לציין את  שני הפרמטרים '''כתובת_בארכיון''' ו '''תאריך_הארכיון''', או להחסיר את שניהם.
-}}
-}}{{#if: {{{הכותב|}}}{{{שם_משפחה|}}}
-  | {{#if: {{{כתובת_הכותב|}}}
-    | {{{כתובת_הכותב}}}|{{#if: {{{שם_משפחה|}}}
-      | {{{שם_משפחה}}}{{#if: {{{שם_פרטי|}}} | , {{{שם_פרטי}}} }}
-      | {{{הכותב}}}
-    }}
-    | {{#if: {{{שם_משפחה|}}}
-      | {{{שם_משפחה}}}{{#if: {{{שם_פרטי|}}} | , {{{שם_פרטי}}} }}
-      | {{{הכותב}}}
-    }}
-  }}
-}}{{#if: {{{הכותב|}}}{{{שם_משפחה|}}}
-  | {{#if: {{{כותבים_משותפים|}}}| <nowiki>;</nowiki>&#32;{{{כותבים_משותפים}}} }}
-}}{{#if: {{{הכותב|}}}{{{שם_משפחה|}}}|
-    {{#if: {{{תאריך|}}}
-    | &#32;מתאריך {{{תאריך}}}
-    | {{#if: {{{שנה|}}}
-      | {{#if: {{{חודש|}}}
-        | &#32;מתאריך {{{חודש}}} {{{שנה}}}
-        | &#32;משנת {{{שנה}}}
-      }}
-    }}
-  |}}
-}}{{#if: {{{שם_משפחה|}}}{{{הכותב|}}}
-  | .&#32;}}{{
-  #if: {{{editor|}}}
-  | &#32;{{{editor}}}:
-}}{{#if: {{{כתובת_בארכיון|}}}
-    | {{#if: {{{כתובת_בארכיון|}}} | {{#if: {{{כותרת|}}} | [{{{כתובת_בארכיון}}} {{{כותרת}}}] }}}}
-    | {{#if: {{{כתובת|}}} | {{#if: {{{כותרת|}}} | [{{{{כתובת}}} {{{כותרת}}}] }}}}
-}}{{#if: {{{שפה|}}} | &#32;<span style="font-size: 0.95em; font-weight: bold; color:#555;">({{{שפה}}})</span>
-}}{{#if: {{{פורמט|}}}
-  | &#32;({{{פורמט|}}})
-}}{{#if: {{{חלק_מ|}}}
-  | .&#32;''{{{חלק_מ}}}''
-}}{{#if: {{{עמודים|}}}
-  | &#32;{{{עמודים}}}
-}}{{#if: {{{מפרסם|}}}
-  | .&#32;{{{מפרסם}}}{{#if: {{{הכותב|}}}{{{שם_משפחה|}}}
-    |
-    | {{#if: {{{תאריך|}}}{{{שנה|}}}{{{חודש|}}} || }}
-  }}
-}}{{#if: {{{הכותב|}}}{{{שם_משפחה|}}}
-  ||{{#if: {{{תאריך|}}}
-    | &#32;מתאריך {{{תאריך}}}
-    | {{#if: {{{שנה|}}}
-      | {{#if: {{{חודש|}}}
-        | &#32;מתאריך {{{חודש}}} {{{שנה}}}
-        | &#32;משנת {{{שנה}}}
-      }}
-    }}
-  }}
-}}.{{#if: {{{תאריך_הארכיון|}}}
-  | &#32;הועבר לארכיון מ[{{{{כתובת}}} הקישור המקורי] ב-{{{תאריך_הארכיון}}}.
-}}{{#if: {{{תאריך_וידוא|}}}
-  | &#32;<small>הקישור עובד נכון ל-{{{תאריך_וידוא}}}{{#if: {{{תאריך_וידוא|}}} | , {{{תאריך_וידוא}}} }}.</small>
-}}{{#if: {{{accessחודשday|}}}
-  | &#32;<small>הקישור עובד נכון ל-{{{תאריך_וידוא}}}, {{{תאריך_וידוא}}}.</small>
-}}{{#if: {{{accessdayחודש|}}}
-  | &#32;<small>הקישור עובד נכון ל-{{{תאריך_וידוא}}} {{{תאריך_וידוא}}}.</small>
-}}{{#if: {{{ציטוט|}}}
-  | &nbsp;“{{{ציטוט}}}”
-}}
-</includeonly><noinclude>
-{{הבהרת חשיבות עם זמן|זמן=20.03.2009}}
-==תיאור==
-כפי [[ויקיפדיה:קישורים חיצוניים#תיאור הקישור|שמתואר בהסבר לקישורים חיצוניים]], לקישורים חיצוניים מסוימים בשפה העברית קיימים [[:קטגוריה:תבניות קישורים חיצוניים|תבניות ספציפיות משלהם]]. תבנית זו מיועדת לכל שאר הקישורים, כלומר לאילו אשר ללא תבניות ספציפיות משלהם. קוד המקור של התבנית מתבסס על [[תבנית: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
-| כותבים_משותפים   =
+		},
-| תאריך        =
+		"אתר": {
-| שנה        =
+			"description": "שם האתר",
-| חודש       =
+			"suggested": true
-| פורמט      =
+		},
-| חלק_מ        =
+		"עמודים": {},
-| מפרסם   =
+		"מידע נוסף": {},
-| מיקום    =
+		"תאריך": {
-| עמודים       =
+			"description": "תאריך פרסום",
-| שפה    =
+			"suggested": true
-| doi         =
+		},
-| כתובת_בארכיון  =
+		"שפה": {},
-| תאריך_הארכיון =
+		"doi": {
-| פורמט_תאריך  =
+			"description": "מזהה דיגיטלי"
-| ציטוט       =
+		},
-}}
+		"תאריך_וידוא": {
-</pre>
+			"description": "תאריך אחרון שבו וידאו את תקינות הקישור"
+		},
-====פרמטרים נדרשים====
+		"ציטוט": {
-*'''כתובת''': הקישור עצמו. התחילו אותו עם קידומת הפרוטוקול, למשל <span dir="ltr"><nowiki>http://</nowiki></span>.
+			"description": "ציטוט אליו מתייחס המקור. הטקסט לא יוצג אך יעזור בחיפושים למקור חלופי במידת הצורך"
-*'''כותרת''': כותרת הקישור.
+		},
+		"archive-url": {
-====פרמטרים נוספים חשובים====
+			"label": "קישור ארכיון",
-*'''מפרסם''': אם הקישור הוא <span dir="ltr"><nowiki>http://www.domain.com/category/page.htm</nowiki></span>, אז ה-מפרסם הוא הערך בוויקיפדיה של החברה/האדם בעלי ה-domain. אם לא קיים ערך כזה, נא לציין רק את [[שם תחום|הדומיין]] בלי תוספות ותחיליות, כלומר פשוט <span dir="ltr"><nowiki>domain.com</nowiki></span>. זהו פרמטר חשוב שבלעדיו הקוראים לא יידעו על מה הם לוחצים.
+			"description": "קישור לארכיון"
-*'''תאריך''': למשל 2008-04-25, כדי שהקוראים יידעו מתי נכתב התוכן שבקישור.
+		},
-*'''תאריך_וידוא''': למשל 2009-01-31, כדי שאם הקישור לא יעבוד (למשל ב-2012) הקוראים יבינו שהוא לא הוסף למאמר בזדון אלא שפשוט במשך זמן רב אף אחד לא וידא שהוא עובד. קוראים שנכנסים לקישורים חיצוניים ואחר כך נמצאים במצב עריכה, מוזמנים לעדכן תאריך_וידוא ישנים.
+		"dead-url": {
-*'''פורמט''': נדרש רק כאשר התוכן שבקישור אינו בפורמט [[HTML]], כדי להזהיר את הקוראים שמדובר בקבצים שלהצגתם נדרשת [[תוכנה]] נוספת בצד המשתמש. במקרה זה יש לציין קישור לסוג הקובץ, למשל <nowiki>[[PDF]]</nowiki> או <nowiki>[[Word]]</nowiki>.
+			"label": "קישור שבור",
+			"description": "האם הקישור שבור",
-====פרמטרים נוספים משניים====
+			"example": "yes"
-*'''הכותב''': מי כתב את התוכן שבקישור
+		},
-**''שם_משפחה''' מצורף ל''שם_פרטי''' כדי להפיק <code>שם משפחה, שם פרטי</code>
+		"archive-date": {
-**'''כתובת_הכותב''' עובד גם עם "הכותב" וגם עם "שם_משפחה" ו"שם_פרטי" בשביל קישורים פנימיים בלבד.
+			"label": "תאריך ארכיון",
-**'''כותבים_משותפים'': כותבים נוספים
+			"example": "2014-10-20"
-**או: '''שנה''': שנת הפרסום, ו"חודש"': שם החודש של הפרסום. אם יש לכם את היום, השתמשו פשוט ב"תאריך".
+		}
-*'''חלק_מ''': אם קישור זה הוא חלק ממשהו גדול יותר, למשל ספר, כיתבו את שם החלק הגדול.
+	},
-**'''location''': Geographical place of publication.
+	"maps": {
-*'''עמודים''': למשל 5-7
+		"citoid": {
-*'''שפה''': לשפות שונות בעברית.
+			"title": "כותרת",
-* '''doi''': קוד [[מזהה עצם דיגיטלי]] שניתן למסמך אלקטרוני ע"י ארגון ה-DOI העולמי. למשל, ''<nowiki>10.1038/news070508-7</nowiki>''
+			"url": "כתובת",
-**'''Doilabel''': אם קוד ה-DOI מכיל תווים המצריכים קידוד, כיתבו כאן את הגירסה הלא מקודדת.
+			"subject": "כותרת",
-*'''כתובת_בארכיון''': הכתובת בארכיון של עותק של הקישור המקורי, כאשר הקישור המקורי אינו זמין יותר. מצריך את הפרמטר ''תאריך_הארכיון''.
+			"blogTitle": "אתר",
-*'''תאריך_הארכיון''': התאריך שבו הקישור המקורי אוכסן בארכיון. דורש את הפרמטר '''כתובת_בארכיון'''), לדוגמא, 2003-09-13
+			"forumTitle": "אתר",
-*'''ציטוט''': ציטוט נבחר מתוך הקישור. מרכאות יוספו אוטומטית.
+			"seriesTitle": "אתר",
+			"websiteTitle": "אתר",
-===דוגמא===
+			"publisher": "אתר",
-אין צורך להשתמש בפרמטרים הלא ידועים:
+			"date": "תאריך",
-<pre>
+			"pages": "עמודים",
-{{קישור כללי
+			"accessDate": "תאריך_וידוא",
-| כתובת         = http://www.hebrewsite.com/category/page.htm
+			"DOI": "doi",
-| כותרת       = יוצר וויקיפדיה מכריז על וויקיפדיה העברית
+			"language": "שפה",
-| תאריך_וידוא  = 2001-02-19
+			"contributor": "הכותב",
-| תאריך        = 1998-01-15
+			"author": "הכותב"
-| מפרסם   = hebrewsite.com
+		}
-}}
+	},
-</pre>
+	"format": "inline",
+	"paramOrder": [
-יוצג כ:
+		"כתובת",
+		"הכותב",
-{{קישור כללי
+		"כותרת",
-| כתובת         = http://www.hebrewsite.com/category/page.htm
+		"אתר",
-| כותרת       = יוצר וויקיפדיה מכריז על וויקיפדיה העברית
+		"עמודים",
-| תאריך_וידוא  = 2001-02-19
+		"מידע נוסף",
-| תאריך        = 1998-01-15
+		"תאריך",
-| מפרסם   = hebrewsite.com
+		"שפה",
-}}
+		"doi",
+		"תאריך_וידוא",
-[[קטגוריה:תבניות קישורים חיצוניים]]
+		"ציטוט",
+		"archive-url",
+		"dead-url",
+		"archive-date"
+	]
+}
+</templatedata>
 </noinclude>