זוהי הפקודה lgrind שניתן להריץ בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות החינמיות שלנו כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS.
תָכְנִית:
שֵׁם
lgrind - יצירת רשימות תוכניות נחמדות באמצעות LaTeX
הערה
דף ה-man הזה עדיין לא מיושן בהרבה, אבל אולי יהיה בקרוב אלא אם כן מישהו יבקש ממני לעבוד
על זה. חשבו על מסמכי LaTeX כמסמכים האמיתיים.
תַקצִיר
לגריינד [ -e ] [ -i ] [ - ] [ -n ] [ -c ] [ -t ] [ -h ] [ -d <description
קובץ> ] [ -l ] [ -s ] ...
תיאור
LGrind מעצב את קוד המקור של התוכנית בסגנון נעים באמצעות LaTeX(1). הערות מוצגות ב
אות רומית, מילות מפתח מודגשות, משתנים נטויים ומחרוזות בגופן מכונת כתיבה. מקור
מספרי שורות בקובץ מופיעים בשוליים הימניים (כל 10 שורות).
LGrind מעבד את קובץ/קבצי הקלט שלו וכותב את התוצאה לפלט סטנדרטי. פלט זה
ניתן לשמור לעריכה מאוחרת יותר, הכללה במסמך גדול יותר וכו'.
האפשרויות הן:
-e לעבד קובץ LaTeX עבור קוד מוטמע.
-i קובץ קוד מקור של תהליך להכללה במסמך LaTeX.
- לקחת קלט מקלט סטנדרטי.
-n אל תדגישו מילות מפתח.
-c אל תתייחסו במיוחד ל-@ וכו' בתגובות.
-t שינוי רוחב הכרטיסייה (ברירת מחדל 8).
-h מציין טקסט שייכנס לכותרת.
-d מציין את קובץ הגדרות השפה (ברירת המחדל היא
/usr/lib/texmf/tex/latex/lgrind/lgrindef).
-ד! כמו לעיל, אבל לכתוב קובץ הרצה מתוקן
-l מציין את השפה לשימוש.
-s מציג רשימה של שפות מוכרות כעת.
אם LGrind נקרא ללא פרמטרים, יוצג מסך עזרה. אם אף אחד מהם לא... -e ולא -i
מצוינים, נוצר קובץ LaTeX מלא. כאשר לא צוינה שפה, LGrind
מנסה לגלות את השפה עצמה; C משמש כאשר זה נכשל.
נוהג
לדוגמה, כדי לכלול קובץ C בשם foo.c במסמך LaTeX שלך, ראשית תן את
פקודה:
lgrind -i -lc foo.c > foo.tex
פעולה זו תיצור foo.tex, שתכיל את הגרסה המודפסת והיפה של foo.c עם הרבה...
של פקודות LaTeX.
לאחר מכן, כלול את lgrind.sty כפי שאתה כולל כל סגנון אחר, כלומר עם ה-
שורה \usepackage{lgrind} בתחילת מסמך LaTeX שלך. לאחר שתעשה זאת, בתוך
במסמך ניתן לכלול את foo.tex באמצעות אחת מהפקודות הבאות:
\lgrindfile{foo.tex}
אשר פשוט יכלול את הקובץ בנקודה זו של הטקסט, ויצייר אופקי
שורות לפני ואחרי הרישום.
\lagrind[htbp]{foo.tex}{caption}{label}
אשר יעביר את הרישום גם בתוך סביבת איור, באמצעות ה-float
אפשרויות, כיתוב ותווית שנתת.
כדי ליצור קובץ LaTeX עצמאי, נניח, מקובץ Yacc:
lgrind -ly bary.y > bary.tex
זה משתמש ב- fancyhdr.sty של פיט ואן אוסטרום כדי ליצור את הכותרות העליונות והתחתונות.
להסבר מפורט יותר על פקודות אלו, עיינו ב-
/usr/TeX/texmf/doc/latex/lgrind.dvi.
משובץ תוכניות בְּתוֹך A LaTeX קובץ
(מתוך ההערות של ג'רי ליכטר.)
בתוך הטקסט של קובץ LaTeX שלך, אתה מסמן קבוצות של שורות כטקסט או כתצוגה
קוד תוכנית סגנון:
סגנון טקסט:
הביטוי
%(
א + 3
%)
מייצר 10.
מדפיס משהו כמו: "הביטוי a + 3 מייצר 10." (כאשר "a + 3" מוגדר כ- a
תכנית.)
ניתן להשיג את אותה האפקט עם @'s מוטבעים.
הביטוי @a + 3@ מייצר 10.
סגנון תצוגה:
ההצהרה
%[
א += 3;
%]
הוא דוגמה לאופרטור מצטבר.
מדפיס משהו כמו:
ההצהרה
א += 3;
הוא דוגמה לאופרטור מצטבר.
כללים חשובים:
% והתו שאחריו חייבים להיות שני התווים הראשונים בשורה כדי שיהיו
מוּכָּר.
שים שום דבר בשורה שאחרי ה-% ותו המפתח. אם תעשה זאת, LGrind
יספק סביבת ברירת מחדל שתייצר \hbox עבור %( )%, ו-a
\vbox עבור %[ - %]. אם תשימו דברים על הקו, LGrind יניח שאתם רוצים
לשלוט בפורמט לחלוטין. ביצוע פעולה זו דורש הבנה בדיוק מה ה
הקוד ש-LGrind מייצר עושה. (לפעמים אני לא בטוח שאני עושה!)
%) ו-%] פשוט מתעלמים מהם מחוץ לקבוצת קוד, אבל כל
%( או %[ נוספים מייצרים אזהרה, כך שבדרך כלל נתפס %) או %] חסר.
ניתן להכניס קוד משלך על ידי שימוש בשורה שמתחילה ב-%= בטקסט התוכנית.
כל מה שתזין לאחר מכן יישאר בפלט, בדיוק כפי שהקלדת אותו. זה יהיה
מבוצע בסביבה מוזרה, כך שביצוע כל דבר מפואר הוא מסובך מאוד. מאקרו,
\Line, מסופק כדי לעזור לך לעשות דברים פשוטים. לדוגמה,
%[
%=\Line{________\vdots}
א = 1;
%]
ייצור you
.
.
.
א = 1;
(בתוך טקסט התוכנית, _ פעיל ומתרחב לרווח ברוחב קבוע. חבורה שלמה
של פקודות מאקרו מוגדרות גם כן. אם אתה מבין כיצד LGrind מגדיר שורות, אתה יכול להחליף
ה-8 _ עם קריאה ל-\Tab - אבל אני אתן לך לתלות את עצמך על זה.)
הפלט של LGrind תמיד מכיל בדיוק שורת פלט אחת עבור כל שורת קלט. לכן,
ניתן לחפש מספרי שורות בהודעות שגיאה של TeX בקובץ המקורי, במקום ב
קובץ ה-lgrind'ed (lground?). (כמובן, אם הבעיה היא בפלט של LGrind...)
דברים רבים ניתנים לשליטה על ידי הגדרה מחדש של פקודות מאקרו שונות. ניתן לשנות אילו גופנים
LGrind ישתמש בסוגים שונים של דברים, כמה הוא מוריד כניסה לפלט, האם זה
מוסיף מספרי שורות, ואם כן באיזה מרווח זמן הוא מדפיס אותם והאם הוא מדביק אותם
שמאל או ימין, וכן הלאה. כל הדברים האלה מתוארים ב-lgrind.dvi, למרות שכנראה
לא כל כך טוב. הגדרות ברירת המחדל מייצרות פלט שנראה לי סביר, למרות שאני
אני לא יכול להגיד שאני באקסטזה לגבי זה. עושה בֶּאֱמֶת עבודה טובה תדרוש הגדרה של כמה
גופנים מיוחדים.
השתמש ב-lgrind באופן מקוון באמצעות שירותי onworks.net
