rubber - אונליין בענן

תָכְנִית:

שֵׁם

rubber - מערכת בנייה למסמכי LaTeX

תַקצִיר

גומי [אפשרויות] מקורות ...
צינור גומי [אפשרויות]

תיאור

גומי הוא מעטפת עבור LaTeX ותוכניות נלוות. המטרה שלו היא, בהינתן LaTeX
מקור לעיבוד, כדי לקמפל אותו מספיק פעמים כדי לפתור את כל ההפניות, אולי פועלות
תוכניות לוויין כגון BibTeX, makeindex, Metapost וכו' להפקת נתונים מתאימים
קבצים.

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

הפקודה צינור גומי עושה את אותו הדבר עבור מסמך אחד אבל הוא קורא את מקור ה-LaTeX ממנו
קלט סטנדרטי ומשליך את המסמך המורכב על פלט סטנדרטי.

לא ניתן לחלץ מידע מסויים ממקורות LaTeX. זה המקרה, עבור
למשל, עם נתיבי החיפוש (שניתן לציין במשתני סביבה כמו
TEXINPUTS), או הסגנון שיש להשתמש בו עם Makeindex. כדי לטפל בבעיה זו, אפשר להוסיף
מידע עבור Rubber בהערות של מקורות LaTeX, ראה סעיף הוראות.

אפשרויות

האפשרויות משמשות לבחירת הפעולה שתבוצע או כדי להגדיר את
תהליך בנייה. הם לרוב אותו דבר ב גומי ו צינור גומי. האפשרויות מנותחות
באמצעות מוסכמות GNU Getopt.

-ב, --bzip2
דחוס את המסמך הסופי (ב bzip2 פוּרמָט). זה שווה ערך לאמירה -o
bzip2 אחרי כל האפשרויות האחרות.

--לְנַקוֹת
הסר את כל הקבצים שנוצרו על ידי הקומפילציה, במקום לבנות את המסמך.
אפשרות זו קיימת ב גומי רק. זה חל על הקומפילציה כפי שהיה
לעשות עם האפשרויות האחרות של שורת הפקודה, כלומר לומר "rubber --clean
foo" לא ימחק את foo.ps, בעוד שאמירת "rubber --ps --clean foo" ימחק.

-ג, --פקודה
בצע את הפקודה שצוינה (או ההנחיה) לפני ניתוח קבצי הקלט. לִרְאוֹת
סעיף הוראות לקבלת פרטים.

, --אֶפִּילוֹג
בצע את הפקודה שצוינה (או ההנחיה) לאחר ניתוח קבצי הקלט. לִרְאוֹת
סעיף הוראות לקבלת פרטים.

-ו, --כּוֹחַ
כפה לפחות קומפילציה אחת של המקור. זה עשוי להיות שימושי, למשל, אם
השתנתה תלות חריגה כלשהי (למשל חבילה בספריית מערכת). זֶה
אפשרות לא רלוונטית ב צינור גומי.

-ז, --gzip
דחוס את המסמך הסופי (ב מופעלת דחיסת פוּרמָט). זה שווה ערך לאמירה -o gz
אחרי כל האפשרויות האחרות.

-ח, - עזרה
הצג את רשימת כל האפשרויות הזמינות וצא בצורה יפה.

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

--לְתוֹך
עבור אל הספרייה שצוינה לפני הקומפילציה, כך שכל הקבצים יופקו
שם ולא בספרייה הנוכחית.

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

-ק, --לִשְׁמוֹר
אפשרות זו משמשת ב צינור גומי רק. עם אפשרות זו, הקבצים הזמניים
לא יוסר לאחר הרכבת המסמך והשלכת התוצאות
פלט סטנדרטי. המסמך הזמני נקרא rubtmpX.tex, כאשר X הוא מספר
כך שלא קיים קובץ בשם זה בתחילה.

-ל, --נוֹף
ציין שהמסמך הסופי צריך להשתמש בכיוון לרוחב. זה רלוונטי
רק בעת השימוש dvips or dvipdfm.

-נ, --maxerr
הגדר את המספר המרבי של השגיאות המוצגות. כברירת מחדל, עד 10 שגיאות
דיווח, אומר -n -1 מציג את כל השגיאות.

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

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

-או, --הודעה [:]
השתמש במודול שצוין כפוסט-מעבד. זה דומה ל -m אפשרויות
אלא שהמודול נטען לאחר ניתוח המסמך.

-ד, -- pdf
הפקת פלט PDF. כאשר האפשרות הזו מגיעה לאחר מכן --נ.ב (למשל בטופס
-pd) זוהי מילה נרדפת ל -o ps2pdf, אחרת הוא פועל כמו -m pdftex, על מנת להשתמש
pdfLaTeX במקום LaTeX.

-פ, --נ.ב
עבד את ה-DVI המיוצר על ידי התהליך דרך dvips(1) לייצר PostScript
מסמך. אפשרות זו היא מילה נרדפת ל -o dvips, זה לא יכול לבוא אחרי -- pdf.

-q, --שֶׁקֶט
הפחת את רמת הדיבור. זה ההפך מ -v.

-ר, --לקרוא
קרא הנחיות נוספות מהקובץ שצוין (ראה גם ההנחיה "קריאה").

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

-ס, --קצר
הצג את הודעות השגיאה של LaTeX בצורה קומפקטית (שגיאה אחת בכל שורה).

-אני, --Texpath
הוסף את הספרייה שצוינה לנתיב החיפוש של TeX.

--סינקטקס
אפשר תמיכה ב-SyncTeX בהפעלת LaTeX.

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

-ב, --מִלוּלִי
הגדל את רמת הדיבור. קיימות רמות בין 0 ל-4, רמת ברירת המחדל היא 1
ל גומי ו 0 עבור צינור גומי. היזהרו, אומר -vvv גורם לגומי לדבר הרבה.

--גִרְסָה
הדפס את מספר הגרסה וצא יפה.

-W, --לְהַזהִיר
דווח על מידע מהסוג הנתון אם לא הייתה שגיאה במהלך ההידור. ה
הסוגים הזמינים הם: תיבות (קופסאות מלאות וחסרות), שופטים (לא מוגדר או
הכפל הפניות מוגדרות), misc (אזהרות אחרות) ו את כל לדווח על כל האזהרות.

מודולים

פעולת הגומי מושפעת ממודולים. מודולים דואגים לתכונות המיוחדות של
חבילות ותוכניות חיצוניות.

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

אסימפטוטה
עבד את קבצי ה-.asy שנוצרו על ידי חבילת LaTeX, ולאחר מכן מפעיל את a
קומפילציה מחדש.

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

ביבטקס, ביבלטקס
דואג לעיבוד הביבליוגרפיה של המסמך עם BibTeX בעת הצורך. זֶה
המודול נטען אוטומטית אם המסמך מכיל את המאקרו \bibliography
(ראה גם ב הוראות לאפשרויות).

לשלב
חבילת השילוב משמשת לאיסוף מספר מסמכי LaTeX לאחד,
ומודול זה מטפל בתלות במקרה זה.

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

מילונים
הפעל makeglossaries והידור מחדש כאשר קובץ ה-.glo משתנה.

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

hyperref
טפל בקבצים הנוספים שהחבילה הזו מייצרת במקרים מסוימים.

אינדקס, makeidx, nomencl
עבדו את האינדקסים והמינונים של המסמך עם makeindex(1) בעת הצורך (ראה
סעיף הוראות לאפשרויות).

ניתן לטקסט
הוסף תלות לקבצים שהוכנסו דרך חבילת ה-Ltxt הניתנת ל-LTX.

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

עוד פועל, מלה במלה
מוסיף את הקבצים הכלולים עם \verbatiminput ופקודות מאקרו דומות לרשימה של
תלות.

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

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

עיבוד מקדים
המודולים הבאים מסופקים לשימוש בתוכנות היוצרות מקור LaTeX מ-a
פורמט קובץ שונה:

cweb מטרת המודול הזה היא לפעול לשזור(1) במידת הצורך לפני תהליך ההידור ל
לייצר את מקור ה-LaTeX. מודול זה נטען אוטומטית אם הקובץ
שצוין בשורת הפקודה יש .w בתור הסיומת שלו.

lhs2TeX
מודול זה משתמש ב- lhs2TeX מעבד קדם ליצירת מקור ה-LaTeX מ-a
תוכנית Haskell קרוא וכתוב. זה מופעל אוטומטית אם שם קובץ הקלט
נגמר עם .lhs.

לאחר עיבוד
המודולים הבאים מסופקים כדי לתמוך בסוגים שונים של עיבודים מאוחרים. הערה
שהסדר משנה בעת שימוש במודולים אלה: אם אתה רוצה להשתמש בשרשרת עיבוד
כמו
foo.tex -> foo.dvi -> foo.ps -> foo.pdf -> foo.pdf.gz
אתה צריך לטעון את המודולים dvips, ps2pdf ו gz לפי הסדר הזה, למשל באמצעות ה-
שורת הפקודה
rubber -p -o ps2pdf -z foo.tex

bzip2 הפק גרסה של הקובץ הסופי דחוס עם bzip2(1).

dvipdfm
ריצות dvipdfm(1) בסוף הקומפילציה להפקת מסמך PDF.

dvips ריצות dvips(1) בסוף הקומפילציה להפקת מסמך PostScript. זֶה
מודול נטען גם על ידי אפשרות שורת הפקודה --נ.ב.

להרחיב הפק מקור LaTeX מורחב על ידי החלפת פקודות מאקרו קלט בקבצים הכלולים,
מאקרו ביבליוגרפיה לפי הביבליוגרפיה שהופקה על ידי ביבטקס(1), וכיתות מקומיות
וחבילות לפי המקור שלהן. אם הקובץ הראשי הוא foo.tex ואז קובץ מורחב
ייקרא שם foo-final.tex. עיין בתיעוד המידע לפרטים.

gz הפק גרסה של הקובץ הסופי דחוס עם מופעלת דחיסת(1).

ps2pdf בהנחה שהקומפילציה מייצרת מסמך PostScript (למשל באמצעות
מודול dvips), המר מסמך זה ל-PDF באמצעות ps2pdf(1).

מהדר בחירה
המודולים הבאים משמשים לשינוי מהדר LaTeX:

אָלֶף השתמש במהדר Aleph במקום ב-TeX, כלומר מרכיב את המסמך באמצעות ל(1)
במקום שרף גומי.

אוֹמֶגָה השתמש במהדר אומגה במקום ב-TeX, כלומר מרכיב את המסמך באמצעות למבדה(1)
במקום שרף גומי. אם המודול dvips משמש גם, זה ישתמש odvips(1) ל
לתרגם את קובץ ה-DVI. שים לב שמודול זה מופעל אוטומטית כאשר
המסמך משתמש בחבילה אוֹמֶגָה.

pdftex מורה לגומי להשתמש pdflatex(1) במקום שרף גומי(1) כדי להרכיב את המסמך. על ידי
ברירת מחדל, זה מייצר קובץ PDF במקום DVI, אך בעת טעינת המודול
עם האופציה דוי (למשל באמירה -m pdftex:dvi) המסמך מורכב
לתוך DVI באמצעות pdflatex. מודול זה נטען גם על ידי אפשרות שורת הפקודה
-- pdf.

vtex מורה ל- Rubber להשתמש במהדר VTeX. כברירת מחדל זה משתמש vlatex כמו
מהדר להפקת פלט PDF. עם האופציה ps (למשל כשאומרים "גומי -מ
vtex:ps foo.tex") המהדר בשימוש הוא vlatexp והתוצאה היא קובץ PostScript.

קסלטקס
מורה לגומי להשתמש קסלטקס(1) במקום שרף גומי.

הוראות

ההתנהגות האוטומטית של Rubber מבוססת על חיפוש פקודות מאקרו במקורות LaTeX.
כאשר זה לא מספיק, ניתן להוסיף הנחיות בהערות המקורות. א
ההנחיה היא שורה כמו
% גומי: cmd args
השורה חייבת להתחיל ב-%, ואז כל רצף של סימנים ורווחים של "%", ואז הטקסט
"rubber:" ואחריו רווחים ושם פקודה, אולי ואחריו רווחים ו
ארגומנטים.

כללי הנחיות
כינוי
העמד פנים שהמאקרו של LaTeX name1 שווה name2. זה יכול להיות שימושי כאשר
הגדרת עטיפות סביב פקודות מאקרו נתמכות.

לְנַקוֹת
מציין שיש להסיר את הקובץ שצוין בעת ​​ניקוי באמצעות --לְנַקוֹת.

לסמוך
ראה את הקובץ שצוין כתלות, כך שזמן השינוי שלו יהיה
בָּדוּק.

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

מודול []
טוען את המודול שצוין, אולי עם אפשרויות. זה שווה ערך ל
אפשרות שורת הפקודה --מודול.

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

מאמר
ציין אפשרויות הקשורות לגודל הנייר. כיום הם רגילים לתת -t אפשרויות
ל dvips ו -p אפשרויות ל dvipdfm.

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

לייצר
מצהיר שהרצת LaTeX תיצור או תעדכן את הקבצים שצוינו.

לקרוא
קרא את קובץ ההנחיות שצוין. הקובץ חייב להכיל הנחיה אחת לכל
קַו. מתעלמים משורות ריקות ושורות שמתחילות ב-"%".

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

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

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

shell_escape
סמן את המסמך כדורש תוכניות חיצוניות (shell-escape או write18). גוּמִי
למעשה אינו מאפשר זאת אלא אם כן נקרא עם האפשרות --unsafe.

סינקטקס
אפשר תמיכה ב-SyncTeX בהפעלת LaTeX.

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

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

biblatex.path
מוסיף את הספרייה שצוינה לנתיב החיפוש עבור מסדי נתונים של BibTeX (קבצי.bib).

bibtex.crossrefs
הגדר את המספר המינימלי של crossref נדרש להכללה אוטומטית של ה
ערך מוזכר ברשימת הציטוטים. זה קובע את האפשרות -דקות הצלבות מתי
קוראים ביבטקס(1).

bibtex.path
מוסיף את הספרייה שצוינה לנתיב החיפוש עבור מסדי נתונים של BibTeX (קבצי.bib).

bibtex.stylepath
מוסיף את הספרייה שצוינה לנתיב החיפוש עבור סגנונות BibTeX (קבצי bst).

bibtex.tool
השתמש בכלי ביבליוגרפיה אחר במקום ב-BibTeX.

dvipdfm.options
העבר את בוררי שורת הפקודה שצוינו אל dvipdfm.

dvips.options
העבר את בוררי שורת הפקודה שצוינו אל dvips.

index.tool (אינדקס)
מציין באיזה כלי יש להשתמש לעיבוד האינדקס. הנתמכים כרגע
כלים הם makeindex(1) (ברירת המחדל) ו שינדי(1). הטיעון מדד is
אופציונלי, ניתן להשתמש בו כדי לציין את רשימת האינדקסים שהפקודה חלה עליהם.
כאשר קיים, זה חייב להיות מוקף בסוגריים; הרשימה מופרדת בפסיקים.
כאשר הארגומנט אינו קיים, הפקודה חלה על כל המדדים.

index.language (אינדקס)
בוחר את השפה המשמשת למיון האינדקס. זה חל רק בעת שימוש
שינדי(1) ככלי לאינדקס. לארגומנט האופציונלי יש את אותה סמנטיקה כמו
מֵעַל.

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

index.order (אינדקס)
משנה את אפשרויות המיון של האינדקסים. הטיעונים הם מילים (מופרדות
לפי רווחים) בין תֶקֶן, גרמנית ו מכתב. זה חל רק בעת שימוש
makeindex(1). לארגומנט האופציונלי יש את אותה סמנטיקה כמו לעיל.

index.path (אינדקס)
מוסיף את הספרייה שצוינה לנתיב החיפוש עבור סגנונות אינדקס (קבצי.ist). ה
לארגומנט אופציונלי יש את אותה סמנטיקה כמו לעיל.

index.style (אינדקס)
מציין את סגנון האינדקס שבו יש להשתמש. לארגומנט האופציונלי יש את אותה סמנטיקה
כאמור לעיל.

makeidx.language, .מודולים, .להזמין, .נָתִיב, .סִגְנוֹן, .כְּלִי
הנחיות אלו זהות לאלו של מדד מודול, אלא שהם לא
לקבל את הטיעון האופציונלי.

multibib.crossrefs, .נָתִיב, ‎.stylepath, .כְּלִי
הנחיות אלו זהות לאלו של ביבטקס מודול אבל הם חלים על
ביבליוגרפיות המנוהלות על ידי ה multibib חֲבִילָה. הם לוקחים תחילה אופציונלי
טיעון, עם אותה מוסכמה כמו לגבי הנחיות ה- מדד מודול, אשר
ניתן להשתמש כדי לציין את רשימת הביבליוגרפיות שהפקודה חלה עליהן.

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