עזרה:תוכן עניינים
מדיה־ויקי, התוכנה שמריצה את ויקימילון, יוצרת תוכן עניינים בצורה אוטומטית בכל פעם שיש יותר מ-4 כותרות במסמך (אלא אם כן נבחר אחרת בהעדפות).
בקוד המקור כותרות הן מהצורה: == כותרת == כאשר מספר השווינות קובע את רמת הכותרת ויכול לנוע בין 1 (כותרת עליונה, לרוב לא בשימוש) ל-6 (כותרת זעירה). (ראה: עזרה:תחביר ויקי#כותרות)
באופן כללי בתוכן העניינים מופיעות כל הכותרות, באופן מדורג (כלומר כותרות מרמה שנייה מופיעות עם הֲזָחָה ומיספור יחסי לכותרות מרמה ראשונה וכן הלאה). במרחב הערכים שונו ההגדרות כך שיופיעו בתוכן העניינים רק כותרות מדרגה 2. זאת מכיוון שבווקימילון מספר ערכים יכולים להופיע בדף ערכים אחד (ראו ויקימילון:כותרת הערך#ריבוי ערכים) ומצד שני כותרות הסעיפים (מדרגה 3 ומעלה) זהות לכל ערך (ראו ויקימילון:תבנית הערך, מה שיוצר תוכן עניינים עָמוּס ומבלבל. ההגבלה לכותרות מדרגה 2 מגבילה את התוכן להציג רק את כותרות הערכים ולא את תתי הסעיפים שלהם.
| תוכן עניינים |
|---|
הסתרה או שליטה במיקום תוכן העניינים בדף
עריכהתוכן העניינים האוטומטי נוצר לפני הכותרת הראשונה במסמך אולם ניתן לשלוט על הופעתו ועל מיקומו בעזרת פקודות:
- __תוכן_עניינים__ או __TOC__ - גורמת להופעת תוכן העניינים במיקום הכיתוב ובנוסף מכריח את תוכן העניינים להופיע בתנאי שיש לפחות כותרת אחת. פקודה זו איננה שימושית בדרך כלל, אם יש צורך בה, כנראה פסקת הפתיחה ארוכה מדי
- __חייב_תוכן_עניינים__ או __FORCETOC__ - גורמת להופעה של תוכן עניינים כמו __TOC__, אך בניגוד אליה תוכן העניינים לא מופיע במיקום הכיתוב.
- __ללא_תוכן_עניינים__ או __NOTOC__ - מונעת את הופעת תוכן העניינים האוטומטי. שימושית כאשר יש עיצוב מסוים של הדף (הדף הראשי לדוגמה) ורוצים להימנע מהצגת תוכן עניינים שיהרוס את העיצוב.
שינוי ברירת מחדל של תוכן עניינים
עריכהבברירת המחדל, תוכן העניינים מוצג במלואו עם אפשרות להסתרה, כמו כן הוא מיושר לימין. על מנת לשנות את כיוון היישור (לשמאל או למרכז), או על מנת להציגו מוסתר כברירת מחדל (עם אופציה להצגה) ניתן להסתייע באמצעות הצבתו בטבלה, והגדרת הטבלה בפרמטרים הרצויים (יישור, הסתרה/הצגה וכדומה).
- תבנית היוצרת הסתרה של תוכן העניינים כברירת מחדל: {{הסתרת תוכן עניינים}}.
- טבלה היוצרת תוכן עניינים המיושר לשמאל כברירת מחדל: {{תוכן שמאל}}.
- ליישור בשיטה הידנית: (עבור מירכוז יש להחליף את left ב-center).
{| align="left"
|-
! תוכן עניינים
|-
| __תוכן_עניינים__
|}
הגבלת תוכן עניינים
עריכהכאמור במרחב הערכים מוצגות בתוכן העיניינים כותרות עד רמה 2. גם במקרים מסוימים אחרים נרצה לפעמים להציג תוכן עניינים עד רמה מסוימת בלבד. במקרה זה ניתן להשתמש בתבנית {{הגבלת תוכן עניינים}}.
תוכן העניינים לא מוצג בערך
עריכהבמידה ותוכן העניינים לא מופיע בערך מסיבה לא ידועה (כאשר אין שימוש באמצעים המופיעים מעלה), גם לאחר רענון מטמון הדפדפן, ניתן לשמור גרסה חדשה לערך בלי לבצע בו שינוי-להיכנס למצב עריכה, לעשות שינוי ידני קל (כמו הוספת רווח), להפעיל תצוגה מקדימה (כעת תוכן העניינים אמור להופיע אם אין דבר אחר שמונע את הצגתו) ולאחר מכן לבטל את השינוי. במידה ואכן לא נעשה שינוי בערך, פרסום הגרסה לא יוסיף גרסה חדשה להיסטוריית הגרסאות של הערך אבל יגרום להופעת תוכן העניינים.
תוכן עניינים ידני
עריכהיש מקרים בהם לא ניתן או לא רצוי לאפשר לתוכנה לייצר תוכן עניינים באופן אוטומטי, אך בכל זאת נרצה שיופיע תוכן עניינים. לדוגמה בעת שימוש בתבניות מסוג {{לשוניות}}, {{לשוניות2}} או {{תוכן נטען}} (המשמשות מחוץ למרחב הערכים). במקרים כאלו ניתן לייצר את תוכן העניינים ידנית.
שימוש בתבניות
עריכה- אפשר ליצור תוכן על ידי שימוש בתבנית {{תוכן}} היוצרת תוכן אנכי וברור.
- התבנית {{תוכן עניינים ידני}} מאפשרת בניית תיבת תוכן עניינים בצורה כמו מסורתית.
יצירת תוכן עניינים בקוד ויקי
עריכההתבנית {{תוכן עניינים ידני}} פותרת את הצורך בכתיבה של תוכן עניינים באופן עצמאי וכן שומרת על האחידות. אם בכל זאת יש צורך בהתאמה אישית למקרה יחודי, אפשר ליצור תוכן גם בקוד ויקי.
בניית תיבת תוכן עניינים ידנית לא מסובכת במיוחד: העתיקו את קטע הקוד הבא למקום בו אתם רוצים שיופיע תוכן העניינים, והחליפו את כותרות הסעיפים בכותרות שמופיעות בדף. הוסיפו כותרות נוספות לפי הצורך.
קטע להעתקה:
__ללא_תוכן__
{| class="toc" cellpadding = "3px"
|-
! תוכן עניינים
|-
|
:[[#סעיף ראשון|1. סעיף ראשון]]{{ש}}
::[[#תת סעיף|1.1 תת סעיף]]{{ש}}
::[[#עוד תת סעיף|1.2 עוד תת סעיף]]{{ש}}
:[[#סעיף שני|2. סעיף שני]]{{ש}}
:[[#סעיף שלישי|3. סעיף שלישי]]{{ש}}
|}
== כותרת סעיף ראשון ==
פסקה
=== תת סעיף ===
פסקה תמונה פסקה
===עוד תת סעיף===
פסקה
== סעיף שני ==
פסקה פסקה
== סעיף שלישי ==
פסקה
התוצאה: