gtbl - מקוון בענן

תָכְנִית:

שֵׁם

tbl - פורמט טבלאות עבור troff

תַקצִיר

tbl [-קו"ח] [קבצים ...]

תיאור

דף מדריך זה מתאר את גרסת GNU של tbl, שהוא חלק ממסמך הגרוף
מערכת עיצוב. tbl אוסף תיאורים של טבלאות המוטמעות בתוכם טראף קבצי קלט
לתוך פקודות שמובנות על ידי טראף. בדרך כלל, יש להפעיל אותו באמצעות ה -t
אופציה של גרוף. זה מאוד תואם ל-Unix tbl. הפלט שנוצר על ידי GNU tbl
לא ניתן לעבד עם Unix טראף; זה חייב להיות מעובד עם GNU טראף. אם אין קבצים
ניתן בשורת הפקודה או בשם הקובץ של - נתון, הקלט הסטנדרטי נקרא.

אפשרויות

-C אפשר מצב תאימות לזיהוי .TS ו .TE גם כאשר אחריו א
תו מלבד רווח או שורה חדשה. דמויות מנהיג (\a) מטופלות כמו
פירשתי.

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

שָׂפָה סקירה כללית

tbl מצפה למצוא תיאורי טבלה עטופים ב- .TS (התחלה שולחן) ו .TE (שולחן
סוף) פקודות מאקרו. בתוך כל מקטע טבלה כזה, ניתן להגדיר טבלה נוספת על ידי שימוש ב-
לבקש .T& לפני הפקודה האחרונה .TE. לכל הגדרת טבלה יש את הדברים הבאים
מבנה you

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

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

תאים מופרדים על ידי תו טאב כברירת מחדל. זה יכול להשתנות על ידי גלוֹבָּלִי
אוֹפְּצִיָה tbl(c), שם c הוא דמות שרירותית.

פשוט דוגמאות

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

התוצאה היא

זה מרוכז
ובכן, גם זה

הגדרה זו זהה ל
.TS
tab(@);
עותק.
This@is@centered
ובכן, @זה@גם
.TE
כאן, תו הטאב המפריד משתנה לאות @.

יתר על כן ניתן להוסיף כותרת ולשנות את כיווני המרכז לרבים אחרים
An University you
.TS
tab(@);
css
lcn .
כותרת
left@centers@123
another@number@75
.TE
התוצאה היא

כותרת
מרכז שמאל 123
עוד מספר 75
כאן l אומר עזב מוצדק, ו n אומר מספרית, שנמצא כאן מוצדקת.

נוהג

גלוֹבָּלִי אפשרויות
הקו מיד אחרי ה .TS מאקרו עשוי להכיל כל אחד מהגלובליים הבאים
אפשרויות (התעלמות מהרישיות של תווים - Unix tbl מקבל רק אפשרויות עם הכל
תווים באותיות קטנות או כל התווים באותיות רישיות), מופרדים על ידי רווחים, טאבים או פסיקים:

allbox סגרו כל פריט בטבלה בקופסה.

קופסה סגרו את הטבלה בקופסה.

מרכז מרכז את הטבלה (ברירת המחדל היא מוצדקת שמאלה). שם מילת המפתח החלופי מֶרְכָּז
מוכר גם (זו הרחבה של GNU tbl).

נקודה עשרונית(c)
הגדר את התו שיזוהה כנקודה העשרונית בעמודות מספריות (GNU tbl
רק).

delim(xy)
השתמש x ו y כמפרידי התחלה וסוף עבור eqn(1).

doublebox
סגרו את השולחן בקופסה כפולה.

מסגרת כפולה
זהה ל-Doublebox (GNU tbl בלבד).

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

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

מסגרת זהה לתיבה (GNU tbl בלבד).

גודל קווים (n)
הגדר קווים או כללים (למשל מ קופסה) ב n-סוג נקודה.

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

ללא רווחים
התעלם מרווחים מובילים ונגררים בפריטי נתונים (GNU tbl בלבד).

nowarn כבה אזהרות הקשורות לטבלאות החורגות מרוחב הקו הנוכחי (GNU tbl
רק).

לשונית(x) השתמש בדמות x במקום כרטיסייה להפרדת פריטים בשורת נתוני קלט.

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

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

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

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

תווי המפתח הזמינים הם:

a,A מרכז את השורה הארוכה ביותר בעמודה זו ולאחר מכן מצדיק את כל שאר השורות בעמודה זו
עמודה ביחס לקו המרוכז הזה. הרעיון הוא להשתמש באלפביתי כזה
עמודות משנה (ומכאן השם של תו המפתח) בשילוב עם L; הם
נקרא עמודות משנה כי A פריטים מוזחים ב-1n ביחס ל L ערכים.
דוגמא:

.TS
tab(;);
ln,an.
פריט ראשון; 1
סעיף משנה שני;2
סעיף משנה שלישי;3
.T&
ln,an.
פריט אחד עשרה;11
סעיף משנה עשרים ושתיים;22
סעיף משנה שלושים ושלוש;33
.TE

התוצאה:

פריט ראשון 1
סעיף משנה שני 2
סעיף משנה שלישי 3
פריט אחד עשרה 11
סעיף משנה עשרים ושתיים 22
סעיף משנה שלושים ושלוש 33

c,C מרכז פריט בתוך העמודה.

l,L פריט יישור שמאלי בתוך העמודה.

n,N הצדק מספרי פריט בעמודה: מיקומי יחידות של מספרים מיושרים
בֵּמְאוּנָך. אם יש נקודה אחת או יותר ליד ספרה, השתמש בנקודה הימנית ביותר
אחד ליישור אנכי. אם אין נקודה, השתמש בספרה הימנית ביותר עבור
יישור אנכי; אחרת, מרכז את הפריט בתוך העמודה. יישור יכול להיות
נאלץ למיקום מסוים באמצעות '\&'; אם יש מקרה אחד או יותר של זה
תו מיוחד (שלא מודפס) הקיים בתוך הנתונים, השתמש בתו השמאלי ביותר עבור
יישור. דוגמא:

.TS
n.
1
1.5
1.5.3
א ב ג ד ה
אבגדה
.TE

התוצאה:

1
1.5
1.5.3
א ב ג ד ה
א ב ג ד ה

אם ערכים מספריים משולבים עם L or R ערכים - זה יכול לקרות אם
פורמט הטבלה משתנה עם .T& - למרכז את הרחב ביותר מספר (מהנתונים שהוזנו
תחת N משטר המפרט) ביחס לרחב ביותר L or R כניסה, שמירה על
יישור כל הערכים המספריים. בניגוד ל A סוג ערכים, אין תוספת
הֲזָחָה.

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

r,R יישר פריט ימני בתוך העמודה.

s,S העבר את הפריט הקודם משמאל לתוך העמודה הזו. אסור לעמודה הראשונה.

^ פתח את הערך למטה מהשורה הקודמת בעמודה זו. אסור לשורה הראשונה.

_,- החלף את הערך הזה בקו אופקי. שים לב שניתן להשתמש ב-'_' ו'-' עבור
שדות טבלה בלבד, לא עבור שורות מפרידי עמודות.

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

| העמודה המקבילה הופכת לכלל אנכי (אם שניים מהם צמודים, א
כלל אנכי כפול).

פס אנכי משמאל לאות המפתח הראשונה או מימין לאות האחרונה
מייצר קו בקצה השולחן.

כדי לשנות את פורמט הנתונים בתוך טבלה, השתמש ב- .T& פקודה (בתחילת שורה).
אחריו מופיעות קווי פורמט ונתונים (אך ללא אפשרויות גלובליות) בדומה ל- .TS
בַּקָשָׁה.

טור מפרט
להלן המפרטים שיכולים להופיע בסיומות לאותיות מפתח העמודה (בכל סדר):

b,B צורה קצרה של fB (הפוך את הערכים המושפעים להדגשה).

d,D התחל פריט המשתרע אנכית על שורות, באמצעות מפרט העמודה '^' או '\^'
פריט נתונים, בתחתית הטווח שלו במקום למרכז אותו אנכית (GNU tbl
רק). דוגמא:

.TS
tab(;) allbox;
ll
אני אדע
ר ^
l rd.
0000;foobar
T{
1111
.br
2222
T};פו
r;
T{
3333
.br
4444
T};סרגל
\^;\^
.TE

התוצאה:

┌─────┬────────┐
│0000 │ foobar │
├─────┼────────┤
│1111 │ │
│2222 │ │
├─────┤ │
│ r │ foo │
├─────┼────────┤
│3333 │ │
│4444 │ בר │
└─────┴────────┘
e,E צור עמודות ברווח שווה. כל העמודות המסומנות במפרט זה מקבלות אותו הדבר
רוֹחַב; זה קורה לאחר חישוב רוחבי העמודות המושפעים (זה אומר
שערך הרוחב הגדול ביותר שולט).

f,F לאחר כל אחד מהמפרטים הללו יכול להיות שם גופן (אחד או שניים
אורך תווים), מספר גופן (ספרה בודדת), או שם ארוך בסוגריים (ה
הצורה האחרונה היא סיומת GNU tbl). שם גופן בן אות אחת חייב להיות מופרד באחד
או יותר ריקים מכל הבא.

i,I צורה קצרה של fI (הפוך את הערכים המושפעים לנטוי).

m,M זוהי הרחבה של GNU tbl. כל אחד מהמפרטים הללו עשוי להיות מלווה במאקרו
שם (אורך תו אחד או שניים), או שם ארוך בסוגריים. אחד-
שם המאקרו האותי חייב להיות מופרד על ידי ריק אחד או יותר מכל הבא.
יש להגדיר את המאקרו שניתן לציין כאן לפני יצירת ה
שולחן. זה נקרא ממש לפני הפלט של טקסט התא של הטבלה. כפי שיושם
נכון לעכשיו, מאקרו זה נקרא רק אם נעשה שימוש בקלט בלוק, כלומר, טקסט בין
'T{' ו-'T}'. המאקרו צריך להכיל רק פשוט טראף בקשות לשנות את
עיצוב בלוק טקסט, כמו התאמת טקסט, מיקוף, גודל או גופן. המאקרו
נקרא לאחר שינויים אחרים בתאים כמו b, f or v הם פלט. כך המאקרו
יכול לדרוס מפרטי שינויים אחרים.

p,P אחריו מספר, זה משנה את גודל הנקודה עבור השדות המושפעים. אם
חתום, גודל הנקודה הנוכחי מוגדל או מופחת (באמצעות מספר חתום
במקום ספרה חתומה היא סיומת GNU tbl). מפרט גודל נקודה הגיע אחריו
מספר הפרדת עמודות חייב להיות מופרד על ידי ריק אחד או יותר.

t,T התחל פריט המשתרע אנכית בשורות בראש הטווח שלו במקום
מרכז אותו אנכית.

u,U הזז את העמודה המתאימה למעלה חצי קו אחד.

v,V אחריו מספר, זה מציין את מרווח השורות האנכי שיש להשתמש ב-a
כניסת טבלה מרובת שורות. אם חתום, מרווח השורות האנכי הנוכחי הוא
מוגדל או מופחת (שימוש במספר חתום במקום ספרה בסימן הוא a
סיומת GNU tbl). מפרט מרווח בין שורות אנכי ואחריו עמודה
מספר ההפרדה חייב להיות מופרד בחסר אחד או יותר. אין השפעה אם
הזנת הטבלה המתאימה אינה בלוק טקסט.

w,W ערך רוחב עמודה מינימלי. חייב להיות אחריו או א טראף(1) ביטוי רוחב
בסוגריים או מספר שלם ללא יחידה. אם לא ניתנת יחידה, נעשה שימוש ב-en units.
משמש גם כאורך השורה המוגדר כברירת מחדל עבור בלוקי טקסט כלולים. אם נעשה שימוש מרובה
פעמים כדי לציין את הרוחב עבור עמודה מסוימת, הערך האחרון ייכנס לתוקף.

x,X עמודה מורחבת. לאחר חישוב כל רוחבי העמודות ללא an x מפרט, שימוש
את רוחב הקו הנותר עבור עמודה זו. אם יש יותר מאחד מורחב
עמודה, הפזר את החלל האופקי הנותר באופן שווה בין העמודות המושפעות
(זו הרחבה של GNU). לתכונה זו יש את אותה השפעה כמו ציון א
רוחב עמודה מינימלי.

z,Z התעלם מהעמודה המתאימה למטרות חישוב רוחב, כלומר, אל תשתמש
את השדות אלא רק את המפרטים של העמודה הזו כדי לחשב את הרוחב שלה.

סיומת מספר על תו מפתח מתפרשת כהפרדת עמודות ב-en units
(מוכפל בפרופורציה אם ה להרחיב האפשרות מופעלת - במקרה של שולחנות מלאים מדי זה
יכול להיות אפס). הפרדת ברירת המחדל היא 3n.

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

טבלתי נתונים
אחרי שורות הפורמט מופיעות שורות המכילות את הנתונים בפועל של הטבלה, ואחריהן
סוף סוף על ידי .TE. בתוך שורות נתונים כאלה, הפריטים בדרך כלל מופרדים על ידי תווי טאב
(או התו שצוין עם כרטיסייה אוֹפְּצִיָה). ניתן לפרוץ קווי קלט ארוכים
מספר שורות אם התו האחרון בשורה הוא '\' (שנעלם לאחר מכן
שִׁרשׁוּר).

שים לב כי tbl מחשב את רוחבי העמודה שורה אחר שורה, תוך החלת \w על כל ערך אשר
אינו בלוק טקסט. כתוצאה מכך, קונסטרוקציות כמו

.TS
ג,ל.
\s[20]מ"מ
ממממ
.TE

לְהִכָּשֵׁל; אתה חייב לומר

.TS
cp20,lp20.
MM
ממממ
.TE

or

.TS
ג,ל.
\s[20]מ"מ
\s[20]MMMM
.TE

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

אם קו נתונים מורכב מ'_' או '=' בלבד, קו בודד או כפול, בהתאמה, הוא
נמשך על פני השולחן באותה נקודה; אם פריט בודד בשורת נתונים מורכב מ'_' בלבד
או '=', אז פריט זה מוחלף בשורה אחת או כפולה, המצטרף לשכניו. אם
פריט נתונים מורכב רק מ'\_' או '\=', קו בודד או כפול, בהתאמה, מצויר
מעבר לשדה באותה נקודה שאינה מצטרפת לשכנותיה.

פריט נתונים המורכב רק מ'\Rx' ('x' כל תו) מוחלף בחזרות של
תו 'x' רחב כמו העמוד (לא מצטרף לשכנותיו).

פריט נתונים המורכב רק מ'\^' מציין שהשדה שמיד למעלה משתרע
כלפי מטה מעל שורה זו.

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

כברירת מחדל, בלוק הטקסט מעוצב עם ההגדרות שהיו פעילות קודם לכן
נכנסים לשולחן, אולי עוקפים את m, v, ו w מפרטי tbl. לדוגמה,
כדי להפוך את כל גושי הטקסט למרופטים-ימינה, הוסף .na ממש לפני ההתחלה .TS (ו .ad
אחרי השולחן).

אם המפרטים 'w' או 'x[cq] אינם ניתנים עבור את כל עמודות של טווח בלוק טקסט, ה
אורך ברירת המחדל של גוש הטקסט (ליתר דיוק, אורך השורה המשמש לעיבוד
הסטת בלוק טקסט) מחושבת כ-L×C/(N+1), כאשר 'L' הוא אורך השורה הנוכחי, 'C'
מספר העמודות המתפרשות על ידי גוש הטקסט, ו-'N' המספר הכולל של העמודות ב
השולחן. שים לב, עם זאת, רוחב ההסטה בפועל כפי שהוחזר ברישום \n[dl]
משמש בסופו של דבר כרוחב בלוק הטקסט. במידת הצורך, תוכל גם לשלוט בטקסט
רוחב בלוק עם הכנסה ישירה של a .ll בקשה מיד אחרי 'T{'.

שונות
פנקס המספרים \n[TW] מחזיק את רוחב השולחן; לא ניתן להשתמש בו בתוך הטבלה עצמה
אבל מוגדר ממש לפני ההתקשרות .TE כדי שהמאקרו הזה יוכל לעשות בו שימוש.

tbl מגדיר גם מאקרו .T# מה שמייצר את השורות התחתונות והצדדיות של שולחן בארגז.
בעוד tbl אכן קורא למאקרו הזה עצמו בסוף הטבלה, ניתן להשתמש בו במאקרו
חבילות ליצירת תיבות לטבלאות מרובות עמודים על ידי קריאה לה בכותרת התחתונה של העמוד. א
דוגמה לכך מוצגת על ידי -גברת פקודות מאקרו המספקות פונקציונליות זו אם טבלה
מתחיל עם .TS H במקום השיחה הרגילה ל- .TS מאקרו.

אינטראקציה עִם EQN

tbl(1) תמיד צריך להתקשר לפני eqn(אחד) (גרף(1) דואג אוטומטית ל
סדר נכון של מעבדי קדם).

גנה TBL שיפורים

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

פריטים מספריים ואלפביתיים עשויים להופיע באותה עמודה.

פריטים מספריים ואלפביתיים עשויים להשתרע אופקית.

tbl משתמש בשמות רישום, מחרוזת, מאקרו והסטה המתחילים בספרה 3. כאשר
באמצעות tbl עליך להימנע משימוש בשמות שמתחילים בא 3.

גנה TBL בְּתוֹך מקרו

השאלה היא איך? tbl מגדיר פקודות מאקרו משלו (ממש לפני כל טבלה) יש צורך להשתמש ב-'end-
מאקרו של מאקרו. בנוסף, יש לכבות את דמות הבריחה. כאן א
דוגמא.

.eo
.de ATABLE ..
.TS
הכרטיסייה allbox(;);
cl.
\$1;\$2
.TE
...
.ec
.ATABLE שולחן
.ATABLE שולחן נוסף
.ATABLE ו"עוד אחד"

שים לב, עם זאת, לא כל התכונות של tbl ניתן לעטוף לתוך מאקרו כי tbl רואה
הקלט מוקדם יותר מ טראף. לדוגמה, עיצוב מספרים עם מיושר אנכי
נקודות עשרוניות נכשלות אם המספרים הללו מועברים כפרמטרי מאקרו בגלל עשרוניות
יישור הנקודות מטופל על ידי tbl עצמו: הוא רואה רק '\$1', '\$2' וכו', ולכן
לא יכול לזהות את הנקודה העשרונית.

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