זוהי הפקודה hxtoc שניתן להפעיל בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות המרובות שלנו, כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS
תָכְנִית:
שֵׁם
hxtoc - הכנס תוכן עניינים בקובץ HTML
תַקצִיר
hxtoc [ -x ] [ -l נמוך ] [ -h גָבוֹהַ ] [ פילה ] [ -t ] [ -d ] [ -c בכיתה ]
תיאור
אל האני hxtoc הפקודה קוראת קובץ HTML, מכניסה תכונות מזהות חסרות בכל H1 עד H6
אלמנטים בין הרמות -l ו -h (אלא אם כן האפשרות -d בתוקף, ראה להלן) ו
מוסיף גם רכיבי A עם תכונות NAME, כך שדפדפנים ישנים יזהו את ה-H1 עד H6
כותרות גם כעוגני יעד (אלא אם כן האפשרות -t בתוקף). הפלט הוא
נכתב ל-stdout.
אם יש הערה לטופס
או צמד הערות
...
אז ההערה, או הצמד עם כל מה שביניהם, יוחלף בטבלה של
תוכן, המורכב מרשימה (UL) של קישורים לכל הכותרות במסמך.
טקסט הכותרות מועתק לתוכן העניינים הזה, כולל כל סימון מוטבע,
אלא שתגי DFN ותגי SPAN עם CLASS של "אינדקס" מושמטים (אבל האלמנטים
התוכן מועתק).
אם לכותרת יש תכונה CLASS עם כערך (או אחד מהערכים שלה), מילת המפתח "לא-
toc", אז הכותרת הזו לא תופיע בתוכן העניינים.
אפשרויות
האפשרויות הבאות נתמכות:
-x השתמש במוסכמות XML: רכיבים ריקים נכתבים עם קו נטוי בסוף:
-l נמוך מגדיר את הכותרת בעלת המספרים הנמוכים ביותר שתופיע בטבלת התוכן. ברירת המחדל היא 1
(כלומר, H1).
-h גָבוֹהַ מגדיר את הכותרת בעלת המספרים הגבוהים ביותר שתופיע בטבלת התוכן. ברירת המחדל היא 6
(כלומר, H6).
-t בדרך כלל, hxtoc מוסיף גם תכונות מזהה וגם רכיבי A ריקים עם NAME
תכונה ו-CLASS="bctarget", כך שדפדפנים ישנים יותר שאינם מבינים מזהה
עדיין ימצא את המטרה. עם אפשרות זו, רכיבי A לא יהיו
נוצר.
-c בכיתה לרכיבי UL שנוצרו בתוכן העניינים תהיה תכונה CLASS
עם הערך מעמד. ברירת המחדל היא "toc".
-d מנסה להשתמש ברכיבי חתך כמטרות בתוכן העניינים במקום
H1 עד H6. רכיב מקטע הוא רכיב DIV, SECTION, ARTICLE, ASIDE או NAV
שהילד הראשון שלו הוא רכיב כותרת (H1 עד H6) או HGROUP. החתך
רכיב יקבל מזהה אם עדיין אין לו. עם אפשרות זו, ה
רמה של כל H1 עד H6 שהוא הצאצא הראשון של רכיב חתך (או של
HGROUP שהוא עצמו הבן הראשון של אלמנט מקטע) לא נקבע
לפי שמו, אבל לפי עומק הקינון של אלמנטי החתך. (כל H1 עד H6
שהם לא הבן הראשון של אלמנט מקטע עדיין יש את הרמה שלהם
משתמע מהשם שלהם.)
אופרנדים
האופרנד הבא נתמך:
פילה שם קובץ HTML. אם אין, קלט סטנדרטי נקרא במקום זאת.
דיאגנוסטיקה
ערכי היציאה הבאים מוחזרים:
0 השלמה מוצלחת.
> 0 אירעה שגיאה בניתוח של קובץ ה-HTML. hxtoc ינסה לתקן
השגיאה ולייצר פלט בכל מקרה.
השתמש ב-hxtoc באינטרנט באמצעות שירותי onworks.net
