htlatex - מקוון בענן

תָכְנִית:

שֵׁם

TeX4ht - מערכת ליצירת היפרטקסט עם TeX וחברים

תַקצִיר

mk4ht הפקודה פילה [ אפשרויות 1 ] [ אפשרויות 2 ] [ אפשרויות 3 ]

htex|htlatex|httexi פילה [ אפשרויות 1 ] [ אפשרויות 2 ] [ אפשרויות 3 ]

ht טקס|לטקס פילה [ t4ht אפשרויות ]

טקסט4ht [ -fdir-char ] קובץ[.dvi] [ -cתג שם ] [ -eenv-קובץ ] [ -gמפת סיביות-קובץ-ext ] [
-h(e|f|F|g|s|v|V) ] [ -ihtf-font-dir ] [ -lקובץ הנהלת חשבונות ] [ -P(*|לסנן) ] [ -ttfm-
font-dir ] [ -U10 ] [ -utf8 ] [ -קסים ]

t4ht [ -fdir-char ] קובץ [.lg] [ -cתג שם ] [ -dout-dir ] [ -eenv-קובץ ] [ -i ] [ -mמצב
] [ -Mמצב ] [ -p ] [ -r ] [ -S(*|לסנן) ] [ -Xתוכן שדה ] [ -.תוכן שדה ]

תיאור

(דף מדריך זה נכתב עבור הפצת Debian GNU/Linux בגלל המקור
לתוכנית אין דף ידני. במקום זאת, הוא מתועד בפירוט אצל המחבר
אתר אינטרנט; ראה למטה. אנא עיין בתיעוד זה לפרטים נוספים או עדכניים
מֵידָע.)

עמוד זה מתעד בקצרה את התסריט פורטמנטאו perl mk4ht, הקליפה הספציפית יותר
סקריפטים htex, htlatex, httexi, ואחרים כמוהם, תסריט המעטפת ברמה נמוכה יותר
ממשק ht, והפקודות טקסט4ht ו t4ht שכל התסריטים האלה מפעילים. יַחַד
תוכניות אלה מהוות TeX4ht; מערכת כתיבה מבוססת TeX הניתנת להגדרה גבוהה עבור
הפקת היפרטקסט.

TeX4ht מקיים אינטראקציה עם יישומים מבוססי TeX באמצעות קובץ סגנון tex4ht.sty ואחר
קבצים שנטענים על ידי קובץ סגנון זה, ומשאירים את העיבוד של קבצי המקור
מהדר ה-TeX המקורי. הפלט של מהדר TeX מעובד לאחר מכן על ידי טקסט4ht
ו t4ht. כתוצאה מכך, TeX4ht יכול להתמודד עם רוב התכונות של מערכות מבוססות TeX באופן כללי,
ושל LaTeX בפרט.

תסריטי הקליפה htex , htlatex ו httexi המרת TeX (בהתאמה LaTeX ו-texinfo)
לתוך HTML. דרישות משתמש טיפוסיות צריכות להיות מרוצות על ידי סקריפטים אלה שיכולים
בדרך כלל להמיר מקור TeX טיפוסי לְלֹא הדורשים שינויים כלשהם.

כדי להמיר מאחד מהדיאלקטים האחרים של TeX (כמו ConTeXt), or להמיר לאחד
מהווריאציות האחרות של היפרטקסט (MathML, XML, OO וכן הלאה), זה כן מוּמלָץ שאתה
השתמש בסקריפט perl mk4ht. השימוש הנפוץ ביותר במערכת יכול להיות מכוסה על ידי
שימוש מתאים בפקודה זו עם האפשרויות שלה.

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

כל התסריטים הללו מתחילים בקריאות מתאימות של טקס(1) או שרף גומי(1) או ניבים אחרים
של TeX לפי הצורך. לאחר העיבוד של ה .dvi הפלט מטופל על ידי טקסט4ht. כל דבר
שלא ניתן לעבד באמצעות HTML (או וריאנט ההיפרטקסט הנבחר שלו), כגון היצירה
של תמונות מפת סיביות או קבצי CSS (Cascade Style Sheet) מטופלת על ידי תוכנית העזר
t4ht. ניתן להגדיר את השיטה המשמשת להפקת התמונות.

אפשרויות

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

אפשרויות ל htex, htlatex ו httexi
htex, htlatex ו httexi הם סקריפטים של מעטפת שניתן להשתמש בהם כדי להמיר קובץ ב-
פורמט TeX/LaTeX/texinfo לתוך HTML. קובץ המקור הזה של TeX צריך להיות כמו כל TeX אחר
קובץ המקור המשמש בדרך כלל להפקת א .dvi קובץ על ידי עיבוד עם TeX וחברים. ה
שם קובץ כזה הוא ארגומנט הקובץ החובה עבור כל סקריפט. זה מלווה למעלה
לשלושה ארגומנטים אופציונליים (מופרדים במרכאות). הטיעונים הללו, שהם
לֹא הנדרשים לשימוש טיפוסי, הם כדלקמן:

1. הארגומנט הראשון הוא רשימה של אפשרויות עבור tex4ht.sty קובץ סגנון (בשימוש עם
טקס או לטקס), מופרדים בפסיקים. עיין בתיעוד HTML לרשימה של
אפשרויות זמינות. ה .log קובץ שנוצר על ידי טקסט/לטקס כולל גם סיכומים של
חלק מהאפשרויות הקיימות. אם לא ריק, ארגומנט זה חייב להתחיל עם html or
xhtml. אפשרויות נוספות יכולות להיות מתמ"ל or ספר דוקטור כדי לציין סגנון מתאים
של התפוקה.

2. ארגומנט זה משמש לבחירת קטעים מתויגים של tex4ht.env שמפרט את
קבצי גופן (*.htf) לשימוש. זה מתאים ל -c אפשרות לפקודה טקסט4ht
כפי שמוסבר להלן. דוגמאות מכילות Unicode or מוזילה.

3. ארגומנט זה מפרט אפשרויות עבור t4ht תוכנית כפי שמוסבר להלן.

עיין בתיעוד HTML לפרטים נוספים ודוגמאות.

סקריפטים דומים זמינים בספרייה /usr/share/tex4ht ליצירת אחרים
סוגים של פלט היפרטקסט. אפשר גם להשתמש בסקריפט perl mk4ht כפי שהוסבר
לְהַלָן.

אפשרויות ל mk4ht
mk4ht הוא סקריפט perl שניתן להשתמש בו כדי להמיר קבצי מקור של TeX ממספר ניבים
של TeX לגרסאות היפרטקסט שונות. הסקריפט הזה לוקח שני ארגומנטים חובה: ה
שם הפקודה להרצה והקובץ שעליו להפעיל אותה. כל פקודה אפשרית היא בצורה
" ": כך למשל xhmlatex מציין מקור LaTeX שצריך להיות
הומר ל-XHTML עם הרחבות MathML. ניתן למצוא את השמות האפשריים לפקודות על ידי
רישום הספרייה /usr/share/tex4ht. שלושת הטיעונים האופציונליים ל mk4ht יש לו
זהים לאלה המפורטים לעיל עבור htex, htlatex ו httexi. למעשה, הפקודה
htlatex Foo זהה ל mk4ht htlatex Foo אלא שהראשון קצר יותר להקלדה!
עם זאת, mk4ht ניתן להגדיר לקצר את שורת הפקודה באופן הבא.

כל משתמש יכול ליצור את קובץ התצורה mk4ht.cfg or .mk4ht בבית או בעבודה
ספרייה כדי להגדיר אפשרויות נפוצות עבור mk4ht; בנוסף אפשרויות לניקוי
ניתן להוסיף גם קבצים זמניים לקובץ תצורה זה. הפעלת הפקודה mk4ht
ללא ארגומנטים כלשהם יסכם את השימוש בקובץ תצורת המשתמש הזה.

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

1. שם הפקודה TeX להפעלה, בדרך כלל טקס or שרף גומי.

2. שם קובץ הקלט (עם או בלי סיומת).

זה עשוי לקחת כל אפשרויות נוספות, אשר יועברו לשיחה אל t4ht.

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

1. אסור שיהיה רווח בין אות האפשרות (למשל, -t) ואת הספרייה/קובץ
שם.

2. שם הספרייה חייב להסתיים בקו נטוי נמשך (/, או /! - ראה למטה).

3. ניתן להוסיף סימן קריאה (!) לסוף שם הספרייה, כדי לאפשר
חיפוש ספריות משנה.

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

5. כאשר הידור עם kpathsea (כמו בחבילת דביאן), חיפוש הנתיבים נמצא ב
חלק השתלט על ידי kpathsea. על מערכת דביאן ראה
/usr/share/doc/tex4ht/README.kpathsea למידע נוסף על חיפוש נתיבים ב-a
tex4ht התומך ב-kpathsea.

בנוסף לאפשרויות שורת הפקודה, רוב האפשרויות הללו ניתנות (ובדרך כלל צריכות) להיות מוגדרות
קובץ התצורה tex4ht.env. הפורמט בקובץ זה דומה, אך ללא
באמצעות מקף לפני אות האפשרות. עיין בתיעוד HTML לפרטים נוספים על
אפשרויות התצורה הזמינות. הקובץ tex4ht.env ניתן להחליף על
ספרייה ו/או בסיס לכל משתמש כפי שהוסבר בתיעוד ה-HTML. על דביאן
מערכת לראות /usr/share/doc/tex4ht/README.Debian גם כן.

אפשרויות ל טקסט4ht
-cתג שם
קווים מסוימים בתוך tex4ht.env ניתן לסמן את קובץ התצורה בתגיות.
שורות אלה (בדרך כלל htf-font-dir שורות חיפוש) יושמטו אלא אם כן
מבוקש במיוחד על ידי ציון שם התג בשורת הפקודה tex4ht. אם
לא בשימוש, אפשרות שורת פקודה של -cברירת מחדל מניחים. (ראה את המצורף
קובץ tex4ht.env לדוגמאות של קטעים מתויגים.)

-eenv-קובץ
ציין כתובת של קובץ התצורה של text4ht tex4ht.env.

-gמפת סיביות-קובץ-ext
הגדר את ההרחבה של תמונות מפת סיביות ל מפת סיביות-קובץ-ext במקום ברירת המחדל . Png.
שימו לב שהתוסף צריך להתחיל בנקודה (.). שימו לב גם לאפשרות זו
משפיע רק על תמונות שנוצרות אוטומטית עבור גופני סמלים, ולא על תמונות
נוצר עם ה \תְמוּנָה מאקרו של tex4ht.

-הוא מעקב אחר שגיאות ואזהרות (מפיק פלט מילולי).

-הג מעקב אחר קבוצות

-ש עקבות \מיוחדs.

-hV עקבו אחר נתיב חיפוש עבור קובץ התצורה tex4ht.env

-hF עקבו אחר נתיב חיפוש עבור .htf קבצי גופנים

-הוו זרוק תוכן של קובץ התצורה של tex4ht.env שנמצא ל-stderr (לניפוי באגים)

-hf לזרוק תוכן של כל אחד .htf קובץ הגופן נמצא ל-stderr (לניפוי באגים)

-ihtf-font-dir
הגדר את הספרייה עבור קובצי גופן HTF (בשימוש על ידי tex4ht) ל htf-font-dir.

-lקובץ הנהלת חשבונות
ציין את השם של מטמון רישום הקבצים המשמש להאצת חיפושי שמות קבצים (התעלם
אם הידור עם תמיכת kpathsea)

-Pלסנן
הגבל קריאות מערכת המבוקשות בקבצי המקור (La)TeX לכלי שירות שלהם
לשמות יש לסנן בתור תחילית. השתמש בכוכבית יחידה כ לסנן לאפשר כל מערכת
שיחות.

-ttfm-font-dir
הגדר את הספרייה עבור קבצי גופן TFM ל tfm-font-dir (התעלם אם הוא מורכב עם kpathsea
תמיכה).

-U10 השתמש בקידוד בסיס 10 עבור תווי Unicode.

-utf8 השתמש בקידוד utf-8 עבור תווי Unicode.

-קסים השתמש בשמות קבצים 8.3 (סגנון MSDOS) עבור קבצי PNG שנוצרו.

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

-dout-dir
פלט קבצים לספרייה out-dir, במקום לספרייה הנוכחית.

-eenv-קובץ
ציין כתובת של קובץ התצורה של text4ht tex4ht.env.

-i צור פלט איתור באגים מילולי.

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

-Mמצב As -m אבל שנה את כל המצבים של כל קבצי הפלט (כולל מפות סיביות בשימוש חוזר).

-p אל תמיר תמונות (כלומר, תמונות שנוצרו עם פקודות מאקרו כמו \תְמוּנָה, לא
תווים בגופני סמלים שיומרו אוטומטית לגרפיקה
קובץ).

-r אל תשתמש מחדש במפות סיביות קיימות של גליפים (עבור תווים בגופני סמלים וכו'), אלא
במקום זאת צור את כל מפות הסיביות מחדש.

-Sלסנן
הגבל קריאות מערכת המבוקשות בקבצי המקור (La)TeX לכלי שירות שלהם
לשמות יש לסנן בתור תחילית. השתמש בכוכבית יחידה כ לסנן לאפשר כל מערכת
שיחות.

-Xתוכן שדה
ניתן לציין סקריפטים לעיבוד לאחר קבצים ב-tex4ht.env. אם אלו
סקריפטים מתייחסים לשדה %% 3, ניתן להגדיר תוכן עבור שדה זה בפקודה זו-
אפשרות קו.

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

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