המכלול:בלעטער-אויסשטעל אנווייזונגען

תוכן וסגנון כתיבה

מדריך לכתיבת ערכים מדריך לכתיבה תורנית מדריך להעתקת ושכתוב ערכים מוויקיפדיה המכלול:כתיבה יהודית

מדריכי מדיניות אספקלריה תורנית היו נועזים בעריכת ערכים מה המכלול איננו כתיבה ללא נגיעות (מדריך) עקרונות וקווים מנחים עקרונות חופש הביטוי זכויות יוצרים מדיניות הפרטיות בעלות על ערכים

סגנון מתן שם לערך המכלול:לשון (שפראך געשפרעכן) לשון תורנית המכלול:כתיב המכלול:עריכה טכנית בלעטער-אויסשטעל אנווייזונגען נגישות במכלול נגישות לניידים כתיבת מונחון

שאלות ותשובות (FAQ) דף העדפות משתמש (הגדרות)

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

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

מעבר לקריאה התאורטית כאן, ניתן לקחת דוגמה מערכים שאהבתם את עיצובם. קחו ערך ובדקו לעומק כיצד הוא בנוי וכתוב על ידי פתיחתו לעריכה (לחיצה על לשונית "עריכת קוד מקור" בראש הערך). אתם יכולים לסגור אותו בסוף בלי לשנותו, אבל כל ערך ניתן לשפר, ונשמח אם תעשו כך.

מבנה כללי לערכים

מבוא הערך

	הנחיה	הסבר	דוגמאות
	הגדרת הנושא	הערך צריך להיפתח בהגדרה ברורה, קצרה ולעניין המתארת היטב את הנושא, וסיכום מאוד גס וכללי של תוכנו העיקרי. כדאי מאוד ששם הערך יהיה חלק מהמשפט הראשון, ורצוי בתחילתו. גודל פרק המבוא הרצוי הוא בדר"כ 2-4 פסקאות. עדיף להימנע משימוש בכותרת "הקדמה" ככותרת ראשונה, מפני שההקדמה צריכה לבוא בראש הערך עוד לפניה. שם אחר לחלק הראשון בערך, לאחר ההקדמה, הוא "סקירה כללית", אבל עדיף לחפש ניסוח יותר ספציפי לכותרת (אם התוכן מאפשר זאת).	קוד: '''משפט פיתגורס''' פותח על ידי המתמטיקאי והפילוסוף היווני [[פיתגורס]] ב[[המאה ה-6 לפני הספירה|מאה ה-6 לפנה"ס]]. תוצאה: משפט פיתגורס פותח על ידי המתמטיקאי והפילוסוף היווני פיתגורס במאה ה-6 לפנה"ס.
	הדגשת מונחים	שמו/נושאו של כל ערך צריך להיות מודגש בהופעתו הראשונה בערך. אם לנושא הערך יש יותר משם אחד, ציינו את כולם בפסקה הראשונה בערך והדגישו את העיקריים שבהם.	קוד: '''קומולונימבוס''' (או '''ענן סופת רעמים''')... תוצאה: קומולונימבוס (או ענן סופת רעמים)...
	הבהרת הקשר	כדאי גם להבהיר, עוד בשורת הפתיחה, את הקשרו של נושא הערך (במידה וזה אינו ברור דיו). אם הערך עוסק בנושא מעולם דמיוני כלשהו - למשל דמות, מקום, מושג וכולי, שנוצר בספר, מקור עממי וכיוצא בזה - יש לציין זאת בפירוש בתחילת הערך, כולל מקור המונח.	קוד: '''סולם''', ב[[מוזיקה]], הוא... תוצאה: סולם, במוזיקה, הוא... אורז (שם מדעי: Oryza) הוא דגן המשמש כמזון העיקרי עבור יותר ממחצית אוכלוסיית העולם.

גוף הערך

	הנחיה	הסבר	דוגמאות
תוכן
	חלוקה לפסקאות קצרות	רצוי לשמור על פסקאות קצרות, מאחר שהעין מתעייפת לאחר קריאת טקסט רצוף ממושך. מסיבה דומה, יש לרווח את הערך - רווח שורה בין פסקה לפסקה, בין כותרת לפסקה וכן הלאה.	תחביר ויקי ליצירת פסקה: שורת רווח ריקה שנמצאת בין שתי פסקאות.
	הפניה למקורות	חשוב לכלול הפניות למקורות חיצוניים באמצעות הערות שוליים המאששים את נכונות העובדות הנכתבות. ראו: המכלול:הערות שוליים ניתן לשלב מעט ציטוטים, אך רצוי שציטוטים מלאים או ציטוטים פחות מהותיים יופיעו בויקיטקסט ובויקיציטוט ויקושרו מהערך.	דוגמה לקוד להערת שוליים: {{הערה|שם המקור}}
	שילוב תמונות ואיורים	רצוי שהערך ישלב תמונות, איורים ועזרים גרפיים לצד הפסקאות, בדרך כלל משמאל לטקסט. הסתייעו בסדנה לגרפיקה ליצירה ולתרגום של איורים לעברית. העדיפו תמונות חופשיות על פני תמונות שימוש הוגן. הימנעו מעומס ויזואלי; העדיפו קישור לגלריה בוויקישיתוף על פני שילוב תמונות רבות (ראו עזרה:עיצוב תמונות לדרכים נוספות). המלצה זו נוגעת לעיתים גם לשימוש בטבלאות או תוכן אופציונלי (כגון הוכחות מתמטיות)-ראו המכלול:מסגרות מוסתרות הנגשת הערך לבעלי לקויות: לתמונה רצוי להוסיף כיתוב (תיאור), גם אם התמונה ברורה או כוללת הסבר עצמי וכיתוב, לטובת הנגשה לנכים ובעלי לקויות.
כותרות הערך
	חלוקה לכותרות	כותרות יכולות לעזור להבהיר ולסדר את הערך על ידי חלוקתו לתתי-נושאים, וכמו כן, לעשות אותו נוח לשימוש ולניווט דרך תוכן העניינים (נוצר ומוצג באופן אוטומטי). למילים אשר נמצאות בראשי הפרקים בערך, ניתן יותר משקל בעת ביצוע חיפוש באנציקלופדיה. בחרו כותרת אינפורמטיבית, והימנעו מכותרות המנוסחות בצורה של שאלה	דוגמת קוד: == כותרת ==
	חלוקה לכותרות משנה	מספר סימני השווה (זהה משני צדי הכותרת) קובע את גודל הכותרת ואת רמת כותרת המשנה. השתמשו בכותרת רמת 2 לכותרות הגדולות ביותר (הימנעו מכותרת ברמה 1) השתמשו בכותרות רמה 3 לנושאי משנה ובכותרות 4 לכותרות הקטנות ביותר ולתתי-נושא משנה או חלקים מיוחדים. כאשר כל פרק עומד בפני עצמו, קוראים שמתעניינים בעיקר בהיבט מסוים יכולים לדלג לפרק המתאים.	דוגמת קוד: == כותרת ראשית== === כותרת משנית ===
	הימנעו מחלוקת יתר	אין להציף את הערך בפיצול יתר - לרוחב (עודף נושאים) או לעומק (עודף רמות פיצול) - מפני שהדבר עלול ליצור בלבול ופיזור ותקורת תוכן מיותרת. בדרך כלל, פסקאות קצרות אינן מצדיקות כותרת משנה משלהן. ניתן להשתמש בנקודות (רשימת תבליטים, על ידי כוכבית (*)) או טקסט מודגש (על ידי גרש (')). יתרון נוסף של סימון זה הוא, שאין צורך לרווח (לרדת שתי שורות) לאחר מכן. המערכת מרווחת את הכותרת מהטקסט בעצמה.
	הימנעו מקישור כותרות	יש להימנע מקישור כותרות פסקאות וראשי פרקים (או חלקים מהן), מפני שזה גורם לבלבול. עדיף להכניס את הקישורים הרלוונטיים באחד המשפטים הראשונים תחת הכותרת. הסתייעו בקישורים לערכים מורחבים, והימנעו מלפרט פרטים בלתי הכרחיים, שיכולים להכלל בערכי משנה.
קישורים פנימיים
	שילוב קישורים פנימיים	כחלק מהטקסט יש לשלב הפניות לערכים קשורים אחרים, מה שמכונה "קישורים פנימיים", כלומר, מילה (או רצף מילים) בתוכן, המהווה קישור לערך אחר. יש להשתמש בקישורים עבור מונח, מושג, זמן, מקום, אדם, חפץ, וכו' - המופיעה בערך ושווה בעצמה ערך (בין אם קיים ובין אם לאו), ויכולה להרחיב ולהעמיק מעבר לתוכן הערך עצמו. קישורים התואמים למוסכמות נתינת השם במכלול, סביר שיובילו לערכים קיימים ואם לא, יקלו על כתיבת ערכים חדשים בשם ה"נכון". יש לדייק בקישורים. לעיתים, נמצא את הערך המבוקש בשם שונה במקצת ממה שאנו מצפים, כך שכדאי לבדוק כל קישור שמוסיפים, ולוודא שהוא אכן מוביל לערך הנכון.	הקישור נעשה באמצעות צמד סוגריים מרובעים מכל צד של המילה: למשל, [[גמרא]].
	הימנעו מקישור יתר	אל תסמנו כקישור כל הופעה של המילה - מספיק סימון הופעתה הראשונה. הסוגיה מתי להפוך מילה לקישור ומתי לא לעשות זאת אינה פשוטה, כפי שמבהירה הדוגמה הבאה: המילה "עיר" היא מילה טריוויאלית, שכל הקוראים מבינים אותה היטב, ולכן עולה השאלה מתי ראוי להפוך אותה לקישור, ומתי יהיה זה קישור שהקוראים לא ירגישו צורך ללחוץ עליו. בערך העוסק בסופר עמוס עוז נאמר שהוא "עבר להתגורר בעיר ערד". בהקשר זה ברור שאין טעם לתת קישור למילה "עיר", משום שהקישור לא יתרום מידע מהותי להבנת הערך עמוס עוז. בערך העוסק בעיר כלשהי, ראוי לתת קישור לערך המבהיר את המושג "עיר", בדיוק כפי שבערך העוסק בקיבוץ ראוי לתת קישור לערך המבהיר את המושג "קיבוץ".
	קישורים ברורים	ניתן לקשר מילים שאינן בדיוק כשם הערך אליו רוצים לקשר, כפי שמפורט בדף עזרה:קישורים. עם זאת, יש לוודא, שברור לאן הקישור מוביל, מבלי שיהיה צורך להיכנס אליו. במקרים של מופע בצורת ריבוי, תוספת ה' הידיעה, אותיות השימוש או כל אות אחרת שאינה חלק מהמילה עצמה, ניתן לסמן רק את חלק המילה הרצוי במקום לסמן את כולה. זה קל יותר לקריאה, להבנה ולהדפסה. אין להשתמש ב"לחצו כאן" כמילה לקישור, מאחר שאינה מוסרת מידע. יש לקשר רק מילים שכבר נמצאות בתוכן, או לנסות להכניס את הקישור לרצף התוכן (או להוסיף לערך תוכן, באופן לא מאולץ, שיאפשר את הוספת הקישור). אם לא - ניתן לשים את הקישור בסוף הערך, תחת פסקת "ראו גם". בכל מקרה, שם הקישור צריך לציין את הנושא אליו הוא מקשר.	ניתן לקשר מילים שאינן בדיוק כשם הערך אליו רוצים לקשר: [[שם הערך אליו מקשרים|המילה המקשרת]]

ראו גם ולקריאה נוספת

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

שיוך לקטגוריות ולנאוויגאציע מוסטערן

ראו: המכלול:קטגוריה וכן המכלול:תבניות

קישורים לוויקיפדיות – בינוויקי

ראו הסבר בעזרה:בינוויקי

טקסט מיוחד

כאשר מתייחסים במשפט למונח מסוים ולא משתמשים בו באופן או במובנו הרגיל, יש לסמנו במירכאות כפולות (") או בכתב מודגש. בעברית, אין משתמשים בכתב נטוי (Italic), אך במונחים אנגליים ומונחים מתמטיים ניתן להשתמש בו. למשל:

• המונח "התאבכות" מקורו במילה התלמודית "אובך".
• י היא העשירית באותיות האלפבית העברי.

מקרה אחר לשימוש בהדגשה הוא ציון פרשה משפטית:

• המשפט נחמני נ' נחמני היווה תקדים במדינת ישראל.

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

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

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

תבניות

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

• בלאט מוסטער - לכתיבת ערך

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

טיילן פון דער בלאט זענען מעגליך איבערגעזעצט פון העברעאישער וויקיפעדיע
cc-by-sa 3.0 ערלויבעניש • אריגינעלער בלאט • ביישטייערער