gather_stx_titles - מקוון בענן

תָכְנִית:

שֵׁם

gather_stx_titles - אסוף הצהרות כותרת ממסמכי Stx

תַקצִיר

אוסף_stx_titles [ -f מ-סיומת ] [ -ת לסיומת ] [ m4 אפשרויות ] פילה [ פילה ... ]

תיאור

gather_stx_titles חופר הצהרות מטא נתונים של Stx מהרשימה קבצים, וזורק את
מידע על כותרת ומזהה מסמך כהגדרות m4 לתוך פלט סטנדרטי. זֶה
מידע יכול לשמש מאוחר יותר על ידי w_crosslink כדי לקשר את המסמכים לפי המטא נתונים שלהם.

למה זה שימושי? ובכן, תאר לעצמך שיש לך אתר גדול עם הרבה קישורים צולבים.
שם מסמך יופיע במקומות רבים: בתפריט הקישורים (אם יש לך) ובתוכו
הגוף של דפים שונים שמהם הוא מקושר. gather_stx_titles מאפשר לך לשים
כל המידע במקום אחד ואיפה שהוא שייך, כלומר הקובץ עצמו. אתה תהיה
שמח אם עשית זאת, בבוא הזמן לשנות את כותרות המסמכים או להעביר את המסמכים
סְבִיב; במיוחד אם לאתר שלך יש קסם רב לשוני.

אפשרויות

gather_stx_titles משתמש ב-m4 באופן פנימי ויקבל כל אפשרות ש-m4 מקבל. בנוסף
עבור אלה, זה לוקח את האפשרויות הבאות:

-f מ-סיומת
בנתוני שם הקובץ, החלף את הסיומת מ-סיומת. בעצם,
מ_סיומת עשוי להיות ביטוי רגולרי; טיפשי אבל נכון, ב-GNU m4 זה א
ביטוי רגולרי "מסורתי", בעוד שב-BSD m4 הוא ביטוי רגולי "מורחב". ברירת מחדל ל
אין סיומת (אין מה לקחת).

-t לסיומת
בנתוני שם הקובץ, החלף את הסיומת שנלקחה על ידי מ-סיומת עם ל-
סִיוֹמֶת. אם מ-סיומת הוא אפס (ברירת המחדל), צרף לסיומת לכל שמות הקבצים.

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

--גרסה, -V
פשוט הצג מידע על הגרסה וצא.

--עזרה, -?
פשוט הצג הודעת עזרה קצרה וצא.

דוגמאות

אני מניח שרוב הזמן תרצה להפוך את השימוש לאוטומטי של gather_stx_titles, עבור
דוגמה עם Makefile כזה:

SOURCES = $(תו כללי *.stx)
TARGETS = $(SOURCES:.stx=.html)

הכל: $(TARGETS)

titles.m4: $(SOURCES)
gather_stx_titles -f stx -t html $^ > $@

%.html: %.stx titles.m4
stx2any -T html titles.m4 $< > $@

אם אינך רוצה להיות כל כך צודק, שחרר את התלות .html ב-titles.m4 או
תלות titles.m4 ב-SOURCES. אין צורך להשתמש בקבצים זמניים: זה צריך גם
עֲבוֹדָה:

$ gather_stx_titles *.stx | stx2any - mydoc.stx

השתמש ב-collect_stx_titles באופן מקוון באמצעות שירותי onworks.net