gropdf - מקוון בענן

תָכְנִית:

שֵׁם

gropdf - מנהל התקן PDF עבור groff

תַקצִיר

gropdf [-delvs] [-F dir] [-p גודל נייר] [-y בֵּית יְצִיקָה] [-u [cmapfile]] [קבצים ...]

אפשר שיהיה רווח לבן בין אפשרות שורת הפקודה לפרמטר שלה.

תיאור

gropdf מתרגם את הפלט של GNU טראף ל-PDF. בדרך כלל gropdf יש להפעיל על ידי
באמצעות הפקודה groff עם a -Tpdf אוֹפְּצִיָה. אם לא ניתנו קבצים, gropdf קורא את
קלט סטנדרטי. שם קובץ של - גורם גם gropdf כדי לקרוא את הקלט הסטנדרטי. PDF
הפלט נכתב לפלט הסטנדרטי. מתי gropdf מנוהל על ידי גרף אפשרויות יכולות להיות
עבר ל gropdf באמצעות גרף's -P אוֹפְּצִיָה.

ראה סעיף גופן התקנה להלן מדריך כיצד להתקין גופנים עבור gropdf.

אפשרויות

-d כלול מידע על ניפוי באגים כהערות בתוך ה-PDF. מייצר גם א
PDF לא דחוס.

-e כפה על כל הגופנים להיות מוטבעים ב-PDF.

-Fdir הוסף ספרייה dir/ devשם לנתיב החיפוש של גופן ותיאור המכשיר
קבצים; שם הוא שם המכשיר, בדרך כלל PDF.

-l הדפס את המסמך בפורמט לרוחב.

-pגודל נייר
הגדר ממד פיזי של מדיום פלט. זה עוקף את גודל נייר,
אורך נייר, ו רוחב נייר פקודות ב- DESC קוֹבֶץ; הוא מקבל את אותו הדבר
טיעונים כמו ה גודל נייר פקודה. לִרְאוֹת groff_font (5) לקבלת פרטים.

-v הדפס את מספר הגרסה.

-yבֵּית יְצִיקָה
הגדר את בית היציקה לשימוש לבחירת גופנים באותו שם.

-e כוחות gropdf להטביע את כל הגופנים (אפילו 14 גופני ה-PDF הבסיסיים).

-s הוסף שורת הערה לסוף ה-PDF המציגה נתונים סטטיסטיים, כלומר מספר הדפים
מסמך. של Ghostscript ps2pdf מתלונן על הקו הזה אם הוא כלול, אבל
עובד בכל מקרה.

-u
-ucmapfilename
Gropdf בדרך כלל כולל ToUnicode CMap עם כל גופן שנוצר באמצעות text.enc as
קובץ הקידוד, זה מקל על החיפוש אחר מילים המכילות
קשירות. אתה יכול לכלול CMap משלך על ידי ציון א cmapfilename או שאין
CMap בכלל על ידי השמטת הטיעון.

נוהג

הקלט ל gropdf חייב להיות בפורמט פלט על ידי טראף(1). זה מתואר ב
groff_out(5).

בנוסף, קבצי תיאור ההתקן והגופנים עבור המכשיר בו נעשה שימוש חייבים לעמוד בהגדרות מסוימות
דרישות: הרזולוציה חייבת להיות כפולה שלמה של פי 72 קנה מידה. ה
PDF המכשיר משתמש ברזולוציה של 72000 ובקנה מידה של 1000.

קובץ תיאור המכשיר חייב להכיל גודל נייר חוקי; לִרְאוֹת groff_font(5) לעוד
מידע. gropdf משתמש באותם גופני Adobe postscript מסוג 1 כמו ה- מגששים מכשיר
נהג. למרות שתקן PDF מאפשר שימוש בסוגי גופנים אחרים (כמו TrueType) זה
הטמעה מקבלת רק את הגופן Postscript Type 1. פחות גופנים מסוג 1 נתמכים
מקורי במסמכי PDF מאשר 35 הגופנים הסטנדרטיים הנתמכים על ידי מגששים והכל לאחר כתב
מדפסות, אבל כל הגופנים זמינים מכיוון שכל הגופנים שאינם נתמכים באופן מקורי
מוטבע אוטומטית ב-PDF.

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

כל קובץ תיאור גופן חייב להכיל פקודה

שם פנימי psname

שאומר ששם ה-PostScript של הגופן הוא psname. שורות שמתחילות ב # ו
מתעלמים מהשורות הריקות. הקוד עבור כל תו שניתן בקובץ הגופן חייב
מתאים לקוד בקידוד ברירת המחדל של הגופן. ניתן להשתמש בקוד זה עם
מה היא \N רצף בריחה פנימה טראף כדי לבחור את התו, גם אם התו לא
יש שם גס. כל תו בקובץ הגופן חייב להתקיים בגופן PostScript,
והרוחבים הניתנים בקובץ הגופן חייבים להתאים לרוחבים המשמשים בגופן PostScript.

שים לב כי gropdf כרגע הוא מסוגל להציג רק את 256 הגליפים הראשונים בכל גופן. זֶה
ההגבלה תוסר בגרסה מאוחרת יותר.

gropdf יכול לכלול באופן אוטומטי את הגופנים להורדה הדרושים להדפסת המסמך.
גופנים עשויים להיות בפורמט PFA או PFB.

כל הגופנים הניתנים להורדה שאמורים, בעת הצורך, להיכלל על ידי gropdf חייב להיות רשום
בקובץ /usr/share/groff/1.22.3/font/devpdf/download; זה צריך להיות מורכב משורות של
הצורה

בֵּית יְצִיקָה גופן שם הקובץ

איפה בֵּית יְצִיקָה הוא שם היציקה או ריק עבור בית היציקה המוגדר כברירת מחדל. גופן האם ה
שם PostScript של הגופן, ו שם הקובץ הוא שם הקובץ המכיל את הגופן;
שורות שמתחילות ב # ושורות ריקות מתעלמות; יש להפריד בין השדות באמצעות כרטיסיות
(רווחים הם לֹא מוּתָר); שם הקובץ מחפשים אותו באמצעות אותו מנגנון שבו נעשה שימוש
עבור קבצי מדדי גופן groff. ה להורדה גם את הקובץ עצמו מחפשים באמצעות זה
מַנגָנוֹן; כרגע, נעשה שימוש רק בקובץ שנמצא הראשון בנתיב הגופן. שמות בית יציקה
הם בדרך כלל תו בודד (כגון 'U' עבור URW Foundry) או ריקים עבור ברירת המחדל
בֵּית יְצִיקָה. ברירת מחדל זו משתמשת באותם גופנים כמו סקריפט רפאים משתמש כאשר הוא מטמיע גופנים ב-a
קובץ PDF.

בהגדרת ברירת המחדל ישנם סגנונות שנקראים R, I, B, ו BI מותקן במיקומי גופן 1
עד 4. הגופנים מקובצים למשפחות A, BM, C, H, HN, N, P, ו T שיש חברים
כל אחד מהסגנונות האלה:

AR ספר אוונגרד
AI AvantGarde-BookOblique
AB אוונגרד-דמי
ABI AvantGarde-DemiOblique
BMR Bookman-Light
ה-BMI Bookman-LightItalic
BMB איש הספרים-דמי
BMBI Bookman-DemiItalic
CR שליח
CI שליח-אלכסון
CB שליח-נועז
כת"ב Courier-BoldOblique
HR Helvetica
HI Helvetica-Oblique
HB Helvetica-Bold
HBI Helvetica-BoldOblique
HNR Helvetica-Narrow
חני Helvetica-Narrow-Oblique
HNB Helvetica-צר-בולד
HNBI Helvetica-Narrow-BoldOblique
NR NewCenturySchlbk-Roman
NI NewCenturySchlbk-Italic
NB NewCenturySchlbk-Bold
NBI NewCenturySchlbk-BoldItalic
PR פלטינו-רומי
PI פלטינו - נטוי
PB פלטינו-בולד
PBI Palatino-BoldItalic
TR טיימס-רומן
TI Times-Etalic
TB זמנים-נועזים
TBI Times-BoldItalic

יש גם את הגופן הבא שאינו בן משפחה:

ZCMI ZapfChancery-MediumItalic

יש גם כמה גופנים מיוחדים שנקראים S עבור הגופן PS Symbol. האותיות הקטנות ביוונית
התווים נטויים באופן אוטומטי (כדי להתאים לגופן SymbolSlanted (SS) הזמין עבורו
לאחר כתבה). Zapf Dingbats זמין בתור ZD, הגליף "יד מצביע שמאלה" (\[lh]) הוא
זמין מאז שהוגדר באמצעות הרחבה \X'pdf: xrev' אשר הופכת את
כיוון האותיות בתוך המילים.

צבע ברירת המחדל עבור \m ו \M זה שחור; עבור צבעים המוגדרים במרחב הצבעים 'rgb'
setrgbcolor משמש, עבור 'cmy' ו-'cmyk' setcmykcolor, ועבור 'אפור' סטגריי. שים לב ש
setcmykcolor היא פקודה PostScript LanguageLevel 2 ולכן אינה זמינה בחלק ישן יותר
מדפסות.

gropdf מבין חלק מפקודות ה-X המופקות באמצעות ה- \X רצפי בריחה נתמכים
by מגששים. באופן ספציפי, התמיכה הבאה היא.

\X'ps: invis'
דיכוי פלט.

\X'ps: אנדינוויס'
תפסיק לדכא פלט.

\X'ps: Exec gsave נקודה הנוכחית 2 העתק לתרגם n לסובב neg מחלף neg מחלף לתרגם'
איפה n היא זווית הסיבוב. זאת כדי לתמוך ב ליישר פקודה ב gpic.

\X'ps: Exec גרסטור'
שוב בשימוש על ידי gpic לשחזר לאחר סיבוב.

\X'ps: Exec n setlinejoin'
איפה n יכול להיות אחד מהערכים הבאים.

0 = הצטרפות מיטר
1 = הצטרפות סיבובית
2 = חיבור משופע

\X'ps: Exec n setlinecap'
איפה n יכול להיות אחד מהערכים הבאים.

0 = כובע תחת
1 = כובע עגול, ו
2 = מכסה מרובע מקרין

\X'ps: ... pdfmark'
כל pdfmark פקודות מאקרו מותקנות באמצעות -m pdfmark or -m mspdf (ראו תיעוד
ב-'pdfmark.pdf'). תת-קבוצת פקודות מאקרו אלה מותקנות אוטומטית כאשר אתה
להשתמש -Tpdf כך שלא תצטרך להשתמש ב-'-m pdfmark' לשימוש ברוב ה-PDF
פונקציונליות.

כל שאר נ.ב: מתעלמים מהתגים בשקט.

אחת \X מיוחד המשמש את מנהל ההתקן של DVI מזוהה גם:

\X'papersize=גודל נייר'
שם גודל נייר הפרמטר זהה ל- גודל נייר פקודה. לִרְאוֹת
groff_font(5) לפרטים. זה אומר שאתה יכול לשנות את גודל העמוד כרצונך
בתוך קובץ ה-PDF שנוצר על ידי gropdf. אם אתה כן רוצה לשנות את הנייר
גודל, יש לעשות זאת לפני שתתחיל ליצור את הדף.

בנוסף, gropdf תומך בחבילה משלה של pdf: תגים. התגים הבאים הם
נתמך:

\X'pdf: pdfpic פילה יישור רוחב גובה אורך קו'
הצב תמונה של המצוין רוחב המכיל את ציור ה-PDF מקובץ פילה of
רצוי רוחב ו גובה (אם גובה חסר או אפס אז הוא משתנה
באופן פרופורציונלי). אם יישור is -L הציור מיושר לשמאל. אם זה -C or
-R a אורך קו נדרש גם גדול מרוחב הציור. אם
רוחב צוין כאפס ואז הרוחב משתנה ביחס לגובה.

\X'pdf: xrev'
זה מחליף דגל שהופך את כיוון ההדפסה מכתב by מכתב,
כלומר, כל אות נפרדת הפוכה, לא כל המילה. זה שימושי עבור
היפוך כיוון של גליפים בגופן Dingbats. כדי לחזור לשגרה
הדפסה חזור על הפקודה שוב.

\X'pdf: markstart /ANN הגדרה'
פקודות המאקרו התומכות ב-PDF Bookmarks משתמשות בקריאה זו באופן פנימי כדי להפעיל את
הגדרה של נקודה חמה של סימניה (המשתמש יקרא '.pdfhref L' עם הטקסט
שיהפוך לאזור 'הנקודה החמה'). בדרך כלל זה אף פעם לא בשימוש למעט מ
בתוך פקודות המאקרו pdfmark.

\X'pdf: מארקנד'
פקודות המאקרו התומכות ב-PDF Bookmarks משתמשות בקריאה זו באופן פנימי כדי לעצור את
הגדרה של נקודה חמה של סימניה (המשתמש יקרא '.pdfhref L' עם הטקסט
שיהפוך לאזור 'הנקודה החמה'). בדרך כלל זה אף פעם לא בשימוש למעט מ
בתוך פקודות המאקרו pdfmark.

\X'pdf: marksuspend'
\X'pdf: markrestart'
אם אתה משתמש במלכודות דפים כדי לייצר כותרות, בסיס וכו', עליך להשתמש
אלה במקרה של 'נקודה חמה' חוצה גבול עמוד, אחרת כל פלט טקסט על ידי
המאקרו של הכותרת או הבסיס יסומן כחלק מהנקודה החמה. לעצור
זה קורה פשוט מקם את '.pdfmarksuspend' ו-'.pdfmarkrestart' בהתחלה ו
המאקרו של end of page trap, בהתאמה. (אלו רק פקודות מאקרו נוחות אשר
שלח את קוד \X. יש להשתמש בפקודות מאקרו אלה רק בתוך מלכודות דפים.)

יבוא גרפיקה
gropdf תומך רק בייבוא ​​קבצי PDF אחרים כגרפיקה. אבל קובץ PDF זה עשוי להכיל
כל אחד מהפורמטים הגרפיים הנתמכים על ידי תקן PDF (כגון JPEG, PNG, GIF וכו').
אז כל יישום שמוציא PDF יכול לשמש כקובץ מוטבע gropdf. ה-PDF
הקובץ שברצונך להוסיף חייב להיות עמוד בודד והציור חייב להתאים בדיוק בתוך הקובץ
גודל המדיה של קובץ ה-PDF. אז, ב Inkscape(1) או גימפ(1) (לדוגמה) ודא ש
גודל הקנבס מתאים בדיוק לתמונה.

מנתח PDF בשימוש ב gropdf לא נבדק בקפדנות עם כל האפשר
יישומים המייצרים קובצי PDF. אם אתה מוצא PDF של עמוד בודד שלא מצליח לייבא
כמו שצריך, כדאי להריץ את זה דרך pdftk(1) תכנת על ידי הוצאת הפקודה:

pdftk oldfile.pdf תפוקה newfile.pdf

אתה עשוי למצוא את זה newfile.pdf ייטען כעת בהצלחה.

סוג נכון ו אַחֵר גופן פורמטים
gropdf אינו תומך בשום גופן אחר מלבד Adobe Type 1 (PFA או PFB).

גופן התקנה

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

· המר את הגופן שלך למשהו שגרוף מבין. זה או PostScript Type 1
גופן ב-PFA או PFB, יחד עם קובץ AFM.

השורה הראשונה בקובץ PFA/PFB מכילה את זה:

%!PS-AdobeFont-1.0:

לקובץ PFB יש את זה גם בשורה הראשונה, אבל לפני המחרוזת יש כמה
בתים בינאריים.

· המר את קובץ AFM לקובץ תיאור גופן groff עם אפמטודיט(1) תוכנית.
שיחה לדוגמה היא

afmtodit Foo-Bar-Bold.afm map/textmap FBB

הממיר את הקובץ המטרי 'Foo-Bar-Bold.afm' לגופן groff 'FBB'. אם אתה
יש משפחת גופנים שמגיעה עם פנים נטוי רגיל, מודגש, נטוי ומודגש, זה
מומלץ להשתמש באותיות R, B, I, ו BI, בהתאמה, כתיקוני פוסט ב-
שמות גופנים של groff כדי לגרום לבקשת '.fam' של groff לעבוד. דוגמה לכך היא המובנה של groff
גופן Times-Roman: שם משפחת הגופן הוא T, ושמות הגופנים groff הם TR, TB, TI,
ו TBI.

· התקן גם את קבצי התיאור של גופן groff וגם את הגופנים בספריית משנה 'devpdf'
של נתיב הגופן שגרוף מוצא. ראה את הסביבה סעיף ב טראף(1) גבר
דף המפרט את הערך האמיתי של נתיב הגופן. שימו לב שגראף לא משתמש ב-
קבצי AFM (אבל בכל זאת כדאי לאחסן אותם).

· רשום את כל הגופנים שיש להוריד למדפסת ב-'devpdf/download'
קוֹבֶץ. רק המופע הראשון של קובץ זה בנתיב הגופן נקרא. זה אומר
שעליך להעתיק את קובץ 'ההורדה' המוגדר כברירת מחדל לספרייה הראשונה בגופן שלך
נתיב והוסף שם את הגופנים שלך. כדי להמשיך את הדוגמה לעיל אנו מניחים שה-PS
שם הגופן עבור Foo-Bar-Bold.pfa הוא 'XY-Foo-Bar-Bold' (שם הגופן PS מאוחסן ב-
שם פנימי שדה בקובץ 'FBB') ושייך ליציקה 'Fcq] ובכך הדבר הבא
יש להוסיף שורה ל'הורדה':

F XY-Foo-Bar-Bold Foo-Bar-Bold.pfa

השתמש בתו טאב כדי להפריד בין השדות, והשדה 'יציקה' צריך להיות null עבור
בית היציקה המוגדר כברירת מחדל.

הסביבה

GROFF_FONT_PATH
רשימה של ספריות שבהן ניתן לחפש את devשם ספרייה בנוסף ל
ברירת המחדל. אם בקובץ 'הורדה' צוין קובץ הגופן
עם נתיב מלא, לא מחפשים ספריות. לִרְאוֹת טראף(1) ו groff_font(5) עבור
פרטים נוספים.

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

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