hypertocp - מקוון בענן

תָכְנִית:

שֵׁם

hypertoc - יצירת תוכן עניינים עבור מסמכי HTML

גִרְסָה

גרסה 3.20

תַקצִיר

hypertoc --עזרה | --manpage | --man_help | --איש

היפרטוק [--בק מחרוזת ] [ --debug ] [ --entrysep מחרוזת ] [ --תחתונה פילה ] [ --header
פילה ] [ --התעלם_רק_אחד ] [ --התעלם_סוליית_ראשונה ] [ --מוטבע ] [ --לעשות_עוגנים ] [
--make_toc ] [ --notoc_match מחרוזת ] [ --ol | --nool ] [ --ol_num_levels ] [ --outfil
פילה ] [ --החלף ] [ --שקט ] [ --טקסט בלבד ] [ --כותרת מחרוזת ] { --toc_after
תג=סיומת } { --toc_before תג=תחילית } { --toc_end tag=endtag } { --toc_entry תג=רמה
} [ --toc_label מחרוזת ] [ --toc_only | --notoc_only ] [ --toc_tag מחרוזת ] [
--toc_tag_replace ] [ --use_id ] [ --useorg ] קובץ ...

תיאור

hypertoc מאפשר לך לציין "אלמנטים משמעותיים" שיקושרו אליהם ב-a
"תוכן עניינים" (ToC) עבור קבוצה נתונה של מסמכי HTML.

בעיקרון, ה-ToC שנוצר הוא רשימה מרובת רמות המכילה קישורים ל-
אלמנטים משמעותיים. hypertoc מכניס את הקישורים ל-ToC לאלמנטים משמעותיים ב-a
רמה שצוינה על ידי המשתמש.

דוגמא:

אם H1s מצוינים כרמה 1, הם מופיעים ברשימת הרמה הראשונה של ה-ToC. אם
H2s מצוינים כרמה 2, מאשר הם מופיעים ברשימת רמה שנייה ב-ToC.

ישנם שני היבטים לדור ה-ToC: (1) הכנסת עוגנים מתאימים ל-HTML
מסמכים (--make_anchors), ו-(2) הפקת ה-ToC ממסמכי HTML שיש להם
עוגנים בהם עבור ה-ToC לקשר אליו (--make_toc). אפשר לבחור לעשות אחד מהם או את שניהם
אלה.

hypertoc תומך גם ביכולת לשלב את ה-ToC במסמך ה-HTML עצמו
דרך האפשרות --inline.

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

אפשר גם להגדיר אפשרויות בקובץ תצורה כמו גם בשורת הפקודה.

אפשרויות

האפשרויות יכולות להתחיל ב-"--" או "-"; ניתן לשלול אפשרויות בוליאניות על ידי הקדמתן
"לא"; ניתן להוסיף אפשרויות עם ערכי hash או מערך על ידי מתן האפשרות שוב עבור
כל ערך.

ראה Getopt::Long למידע נוסף.

--argfile שם הקובץ
שם קובץ שאפשר לקרוא ממנו אפשרויות נוספות. ניתן להשתמש בזה יותר מפעם אחת. ל
דוּגמָה:

--argfile your.args --argfile my.args

ראה "קבצי אפשרויות" למידע נוסף.

--bak
--bak מחרוזת

אם קובץ/קבצי הקלט מוחלפים (--overwrite מופעל), העתק את
הקובץ המקורי ל"שם הקובץ.מחרוזת". אם הערך ריק, אין קובץ גיבוי
כתוב. (ברירת מחדל:org)

--לנפות
אפשר פלט איתור באגים מילולי. משמש לניפוי באגים של מודול זה; במילים אחרות,
אל תטרח. (ברירת מחדל: כבוי)

--entrysep
--entrysep מחרוזת

מחרוזת מפריד עבור לא- ערכי פריט (ברירת מחדל: ", ")

--כותרת תחתונה
--כותרת תחתונה פילה

קובץ המכיל טקסט תחתון עבור תוכן העניינים.

--כּוֹתֶרֶת
--כּוֹתֶרֶת פילה

קובץ המכיל טקסט כותרת לתוכן העניינים.

- עזרה
הדפס הודעת עזרה קצרה וצא.

--התעלם_רק_אחד
אם יהיה רק ​​פריט אחד ב-ToC, אל תיצור ToC.

--תעלם_סוליית_הראשונה
אם הפריט הראשון ב-ToC הוא ברמה הגבוהה ביותר, והוא היחיד מזה
רמה, תתעלם מזה. זה שימושי בדפי אינטרנט שבהם יש רק כותרת H1 אחת אבל
לא יודעים מראש אם יהיה רק ​​אחד.

--בשורה
שים ToC במסמך בנקודה נתונה. למידע נוסף, ראה "הטבעת תוכן העניינים".

--לעשות_עוגנים | --gen_anchors
צור עוגנים לתוכן העניינים לקשר אליהם.

--make_toc | --gen_toc
צור תוכן עניינים המקשר למרכיבים משמעותיים מעוגנים.

--man_help | --manpage | --איש
הדפס את כל התיעוד וצא.

--notoc_match
--notoc_match מחרוזת

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

--ol | --נול
השתמש ברשימה מסודרת עבור ערכי תוכן העניינים (לעומק נתון). אם -ol הוא
false (כלומר --nool מוגדר) אז לא השתמש ברשימה מסודרת עבור ערכי ToC.

(ברירת מחדל:false)

(ראה --ol_num_levels כדי לקבוע עד כמה עומק הרשימה המצוינת)

--ol_num_levels
מספר הרמות לעומק רישום OL יגיע אם --ol נכון. אם מוגדר לאפס,
ישתמש ברשימה מסודרת עבור כל הרמות. (ברירת מחדל:1)

--תיק
--תיק פילה

קובץ לכתוב אליו את הפלט. זה המקום שבו פלט ה-HTML שהשתנה והטבלה-של-
התוכן עובר אל. אם תיתן '-' כשם הקובץ, הפלט יעבור ל-STDOUT.
(ברירת מחדל: STDOUT)

--לכתוב
החלף את קובץ הקלט בפלט. אם זה בתוקף, --outfile מתעלם.
משמש ב ליצור_עוגנים ליצירת העוגנים "במקום" ובתוך gener_toc if
האפשרות --inline בתוקף. (ברירת מחדל: כבוי)

--שֶׁקֶט
דחק הודעות אינפורמטיביות. (ברירת מחדל: כבוי)

--רק טקסט
השתמש רק בתוכן טקסט באלמנטים משמעותיים.

--כותרת
--כותרת מחרוזת

כותרת עבור דף ToC (אם לא משתמש ב--header או --inline או --toc_only) (ברירת מחדל: "טבלה
של תוכן")

--toc_after
--toc_after תג=סִיוֹמֶת

--toc_after "H2= "

להגדרת פריסה של אלמנטים משמעותיים ב-ToC. ה תג הוא תג HTML אשר
מסמן את ההתחלה של האלמנט. ה סִיוֹמֶת הוא מה שנדרש לצרף ל-
ערך תוכן העניינים שנוצר עבור התג הזה. זהו טיעון חשיש מצטבר.
(ברירת מחדל: לא מוגדר)

--toc_before
--toc_before תג=קידומת

--toc_before "H2= "

להגדרת הפריסה של אלמנטים משמעותיים ב-ToC. ה תג הוא תג HTML
מה שמסמן את תחילתו של האלמנט. ה קידומת הוא מה שנדרש להקדים
לערך תוכן העניינים שנוצר עבור התג הזה. זהו hash מצטבר
טַעֲנָה. (ברירת מחדל: לא מוגדר)

--toc_end
--toc_end תג=endtag

--toc_end "H1=/H1"

להגדרת אלמנטים משמעותיים. ה תג הוא תג HTML שמסמן את ההתחלה של
האלמנט. ה endtag תג HTML שמסמן את סוף האלמנט. מתי
התאמה בקובץ הקלט, מתעלמים מהרישיות (אך ודא שכל תג אפשרויות
ההתייחסות לאותו תג זהים לחלוטין!). זהו טיעון חשיש מצטבר.
(ברירת מחדל: H1=/H1 H2=/H2)

--toc_entry
--toc_entry תג=רָמָה

--toc_entry "TITLE=1" --toc_entry "H1=2"

להגדרת אלמנטים משמעותיים. ה תג הוא תג HTML שמסמן את ההתחלה של
האלמנט. ה רָמָה היא איזו רמה נחשבת התג. הערך של רָמָה
חייב להיות מספרי ולא אפס. אם הערך שלילי, ערכים עוקבים
המיוצג על ידי האלמנט significant_ יופרד על ידי הערך שנקבע על ידי
אפשרות --entrysep. זהו טיעון חשיש מצטבר. (ברירת מחדל: H1=1 H2=2)

--toc_label | --toclabel
--toc_label מחרוזת

טקסט HTML שמתייג את ה-ToC. תמיד בשימוש. (ברירת מחדל: " תוכן העניינים ")

--toc_only | --לא רק
פלט רק את תוכן העניינים, כלומר את תוכן העניינים בתוספת התווית toc_label.
אם יש --header או --footer, גם אלה יופקו.

אם --toc_only הוא false (כלומר --notoc_only מוגדר) אז אם אין --header, ו
--inline אינו נכון, אז תוצא כותרת מתאימה של דף HTML, ואם יש
אין --footer ו --inline אינם נכונים, אז תופיע כותרת תחתונה של דף HTML.
(ברירת מחדל:--notoc_only)

--toc_tag
--toc_tag מחרוזת

אם יש לכלול ToC בשורה, זהו התבנית המשמשת כדי להתאים את התג
היכן צריך לשים את ה-ToC. זה יכול להיות תג התחלה, תג סיום או הערה, אבל
יש להשאיר את ה<; כלומר, אם אתה רוצה שה-ToC ימוקם אחרי BODY
תג, ואז תן "BODY". אם אתה רוצה שתגית הערה מיוחדת תתאים למקום שבו ה-ToC צריך
עבור, ולאחר מכן כלול את סימני ההערות, לדוגמה: "!--toc--" (ברירת מחדל:BODY)

--toc_tag_replace
בשילוב עם --toc_tag, זהו דגל כדי לומר אם התג הנתון צריך להיות
מוחלף, או אם יש לשים את ה-ToC אחרי התג. זה יכול להיות שימושי אם שלך
toc_tag הוא הערה ואינך זקוק לה לאחר שהתקנת ה-ToC במקום.
(ברירת מחדל:false)

--use_id
השתמש ב-id="שם"עבור עוגנים ולאשם">עוגנים. אולם אם עוגן
כבר קיים עבור רכיב משמעותי, זה לא ייצור מזהה עבור אותו פרט
אלמנט.

--useorg
השתמש בקבצי גיבוי קיימים כמקור הקלט; כלומר, קבצים של הטופס
שם הקובץ.באק (ראה --bak).

קובץ פורמטים

אפשרויות קבצים
ניתן לתת אפשרויות בקבצים כמו גם בשורת הפקודה על ידי שימוש ב--argfile
שם הקובץ אפשרות בשורת הפקודה. כמו כן, הקבצים ~/.hypertocrc ו-./.hypertocrc הם
בדק אם יש אפשרויות.

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

לדוגמה:

# הגדר את ה-ToC לשלוש רמות
--toc_entry H1=1
--toc_entry H2=2
--toc_entry H3=3

--toc_end H1=/H1
--toc_end H2=/H2
--toc_end H3=/H3

ניתן לקנן קבצי Option, על ידי מתן --argfile שם הקובץ טיעון בתוך האפשרות
קובץ, הוא ילך ויקבל גם את הקובץ המופנה.

ראה Getopt::ArgvFile למידע נוסף.

פרטים

משמעותי גורמים
הנה כמה דוגמאות להגדרת המרכיבים המשמעותיים עבור תוכן העניינים שלך.

דוגמה of בְּרִירַת מֶחדָל

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

--toc_entry "H1=1" --toc_end "H1=/H1" --toc_entry "H2=2" --toc_end "H2=/H2"

או, אם הוא הוגדר באחד מ"קבצי האפשרויות" האפשריים:

# הגדרות ברירת מחדל
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

דוגמה of לפני / אחרי

האפשרויות הבאות עושות שימוש באפשרויות לפני/אחרי:

# קובץ אפשרויות שמוסיף עיצוב מסוים
# בצע רשומות ToC ברמה 1
--toc_entry H1=1
--toc_end H1=/H1
--toc_before H1=
--toc_after H1=

# בצע ערכים של רמה 2 ToC
--toc_entry H2=2
--toc_end H2=/H2
--toc_before H2=
--toc_after H2=

# בצע ערכים ברמה 3 כפי שהם
--toc_entry H3=3
--toc_end H3=/H3

דוגמה of מנהג סוף

האפשרויות הבאות מנסות לאינדקס מונחי הגדרה:

# קובץ אפשרויות שיכול לעבוד עבור מסמכים מסוג מילון מונחים
--toc_entry H1=1
--toc_end H1=/H1
--toc_entry H2=2
--toc_end H2=/H2

# מניח שלמסמך יש DD עבור כל DT, אחרת ToC
# יקבל ערכים עם הרבה טקסט.
--toc_entry DT=3
--toc_end DT=DD
--toc_before DT=
--toc_after DT=

עיצוב מה היא תנאי שימוש
האפשרויות --toc_entry וכו' נותנות לך שליטה על איך ערכים של ToC עשויים להיראות, אבל שם
הן אפשרויות אחרות להשפיע על המראה הסופי של קובץ ה-ToC שנוצר.

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

הערה:
אם אתה משתמש באפשרות --header, ודא שהקובץ שצוין מכיל את ה-HTML הפותח
תג, אלמנט HEAD (המכיל את אלמנט TITLE), ותג BODY הפותח.
עם זאת, תגים/אלמנטים אלו לא צריכים להיות בקובץ הכותרת אם האפשרויות --inline
משמש. ראה "הטבעת ה-ToC" למידע על מה קובץ הכותרת צריך להכיל
להטמעת ה-ToC.

עם האפשרות --toc_label, התוכן של המחרוזת הנתונה יופיע לפני ה-
ToC שנוצר (אבל אחרי כל טקסט שנלקח מקובץ --header).

עם האפשרות --footer, תוכן הקובץ יצורף לאחר היצירה
ToC.

הערה:
אם אתה משתמש ב-footer, ודא שהיא כוללת את תגי BODY ו-HTML הסוגרים (אלא אם,
כמובן, אתה משתמש באפשרות --inline).

אם האפשרות --header לא צוינה, סימון HTML ההתחלתי המתאים יהיה
נוסף, אלא אם צוינה האפשרות --toc_only. אם האפשרות --footer אינה
שצוין, יתווסף סימון ה-HTML המתאים לסגירה, אלא אם האפשרות --toc_only
מוגדר.

אם אינך רוצה/צריך להתמודד עם קבצי כותרת עליונה ותחתית, אז אתה רשאי
ציין את הכותרת, אפשרות --title, של קובץ ה-ToC; והוא מאפשר לך לציין א
כותרת, או תווית, לשים לפני רשימת ערכי ToC, את האפשרות --toc_label. שתי האפשרויות
יש ערכי ברירת מחדל, ראה "אפשרויות" למידע נוסף על כל אפשרות.

אם אינך רוצה שתגי עמוד HTML יסופקו, ורק רוצה את ה-ToC עצמו, אז
ציין את האפשרות --toc_only. אם אין קבצי --header או --footer, אז זה יהיה
פשוט פלט את התוכן של --toc_label וה-ToC עצמו.

שיבוץ מה היא תנאי שימוש
היכולת לשלב את ה-ToC ישירות במסמך HTML נתמכת באמצעות ה-
--אפשרות מוטבעת.

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

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

האפשרויות --toc_tag ו--toc_tag_replace משמשות כדי לקבוע היכן וכיצד נמצא ה-ToC
מוכנס לפלט.

דוגמה 1

# זוהי ברירת המחדל
--toc_tag BODY --notoc_tag_replace

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

דוגמה 2

--toc_tag '!--toc--' --toc_tag_replace

זה יציב את ה-ToC שנוצר לאחר ההערה הראשונה של הטופס , וזה
ההערה תוחלף ב-ToC (בסדר
--כּוֹתֶרֶת
--toc_label
תנאי שימוש
--footer) ואחריו שאר קובץ הקלט.

הערה:
קובץ הכותרת לא אמור להכיל את תג ה-HTML ההתחלתי ואת אלמנט HEAD מאז ה-
קובץ HTML המעובד כבר אמור להכיל תגים/אלמנטים אלה.

דוגמאות

צור an מוטבע תנאי שימוש ל אחד פילה
hypertoc --inline --make_anchors --overwrite --make_toc index.html

פעולה זו תיצור עוגנים ב-"index.html", תיצור ToC עם הכותרת "טבלה של
Contents" והצב אותו אחרי תג BODY של "index.html". הקובץ index.html.org יעשה זאת
מכילים את הקובץ index.html המקורי, ללא ToC או עוגנים.

צור a תנאי שימוש פילה החל מ- מספר קבצים
ראשית, צור את העוגנים.

hypertoc --make_anchors --overwrite index.html fred.html george.html

לאחר מכן צור את ה-ToC

hypertoc --make_toc --outfile table.html index.html fred.html george.html

צור an מוטבע תנאי שימוש לאחר מה היא ראשון כּוֹתֶרֶת of מה היא ראשון פילה
hypertoc --make_anchors --inline --overwrite --make_toc --toc_tag /H1 \
--notoc_tag_replace --toc_label "" index.html fred.html george.html

פעולה זו תיצור עוגנים בקבצי "index.html", "fred.html" ו-"george.html", צור
ToC ללא כותרת והצב אותו אחרי הכותרת H1 הראשונה ב-"index.html" וגיבוי
הקבצים המקוריים אל "index.html.org", "fred.html.org" ו-"george.html.org"

צור an מוטבע תנאי שימוש עם מנהג אלמנטים
hypertoc --שקט --make_anchors --bak "" --החלף \
--make_toc --inline --toc_label "" --toc_tag '!--toc--' \
--toc_tag_replace \
--toc_entry H2=1 --toc_entry H3=2 \
--toc_end H2=/H2 --toc_end H3=/H3 myfile.html

פעולה זו תיצור תוכן עניינים מוטבע המחליף את הקובץ המקורי, ומחליף את a
תגובה, ואשר לוקח את כותרות H2 כרמה 1 וכותרות H3 כרמה 2. זה יכול להיות
שימושי כאשר קובץ ה-html נוצר על ידי תהליך אחר, ולאחר מכן תוכל ליצור
ה-ToC כשלב האחרון.

צור a תנאי שימוש עם מנהג אלמנטים
hypertoc --שקט --make_anchors --bak "" --החלף \
--toc_entry TITLE=1 --toc_end TITLE=/TITLE
--toc_entry H2=2 --toc_entry H3=3 \
--toc_end H2=/H2 --toc_end H3=/H3 \
--make_toc --outfile index.html \
mary.html fred.html george.html

זה יוצר עוגנים באלמנטים H2 ו-H3, ויוצר קובץ ToC בשם index.html,
אינדקס על ה-TITLE והרכיבים H2 ו-H3.

צור a תנאי שימוש עם מנהג אלמנטים ו אפשרויות פילה
בהינתן קובץ אפשרויות בשם 'custom.opt' כדלקמן:

# כותרת, H2 ו-H3
--toc_entry TITLE=1
--toc_end TITLE=/TITLE
--toc_entry H2=2
--toc_end H2=/H2
--toc_entry H3=3
--toc_end H3=/H3

אז הדוגמה הקודמת יכולה לכלול שורות פקודה קצרות יותר כדלקמן:

hypertoc --שקט --make_anchors --bak "" --החלף \
--argfile custom.opt --make_toc --outfile index.html mary.html fred.html george.html

אורים

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

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

· hypertoc יתעלם מאלמנט משמעותי אם הוא אינו מכיל רווח שאינו לבן
דמויות. נוצרת הודעת אזהרה אם קיים מצב כזה.

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

לדוגמה (H2 -> H1 עם --ol_num_levels=1):

1.
* כותרת H2 שלי
2. כותרת H1 שלי

לדוגמה (H1 -> H3 -> H2 כאשר --ol_num_levels=0 ו-H3 גם הם משמעותיים):

1. כותרת H1 שלי
1.
1. כותרת H3 שלי
2. כותרת H2 שלי
2. כותרת H1 השנייה שלי

במקרים כגון זה אולי עדיף לא להשתמש באפשרות --ol.

· אם אחד לא משתמש ב--overwrite בעת יצירת עוגנים, אז הפקודה צריכה להיות
נעשה בשני מעברים, על מנת לתת את שמות הקבצים הנכונים (אלה עם הקובץ בפועל
עוגנים בהם) לחלק יצירת ToC. אחרת ל-ToC יהיו עוגנים
מצביע על קבצים שאין להם אותם.

· בעת שימוש ב--inline, יש לנקוט משנה זהירות אם מחליפים -- אם מגדירים את ה-ToC ל
להיכלל אחרי תג נתון (כגון BODY ברירת המחדל) אז אם אחד מפעיל את הפקודה
פעם אחר פעם אפשר לקבל מספר ToCs באותו קובץ, אחד אחרי השני.

מערות

· גרסה 3.10 (ומעלה) מייצרת עוגנים מילוליים (ידידותיים ל-SEO) יותר מקודמתה
גרסאות. לפיכך עוגנים שנוצרו עם גרסאות קודמות לא יתאימו לגרסה 3.10
עוגנים.

· גרסה 3.00 (ומעלה) של hypertoc מתנהגת בצורה שונה במקצת מגרסה 2.x של
היפרטוק. הוא נועד כעת לעשות הכל במעבר אחד, וירד בוודאות
אפשרויות: האפשרות --infile כבר לא בשימוש (כל שמות הקבצים מופיעים בסוף
הפקודה); האפשרות --toc_file כבר לא קיימת; השתמש באפשרות --outfile
במקום זאת; האפשרות --tocmap אינה נתמכת עוד.

כעת הוא יוצר תגים באותיות קטנות ולא באותיות גדולות.

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

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

· סימון לא חוקי ייווצר אם רכיב משמעותי כלול בתוך
לְעַגֵן. לדוגמה:

פקודת FOO

יומר ל-(אם h1 הוא אלמנט משמעותי),

הפקודה FOO

דבר שאינו חוקי מכיוון שלא ניתן לקנן עוגנים.

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

פקודת FOO

hypertoc יזהה את ה-"foo" NAME וישתמש בו.

אפילו טוב יותר זה להשתמש בתעודות זהות:

פקודת FOO

· תכונות NAME ללא מרכאות אינן מזוהות.

השתמש ב-hypertocp באינטרנט באמצעות שירותי onworks.net