ctanify - מקוון בענן

תָכְנִית:

שֵׁם

ctanify - הכן חבילה להעלאה ל-CTAN

תַקצִיר

ctanify [--pkgname=מחרוזת] [--[לא]המכונית] [--tdרק=מפרט קבצים ...] [--[לא]unixify]
[--[לא]לדלג] [--tdsdir=שם הדירוג ...] [-טקס=macro_pkg] [--[לא]להטעות] מפרט קבצים[=שם הדירוג]
...

ctanify [- עזרה]

ctanify [--גִרְסָה]

תיאור

ctanify מיועד למפתחים שיש להם חבילת LaTeX שהם רוצים להפיץ
באמצעות רשת ארכיון TeX המקיפה (CTAN). בהינתן רשימה של שמות קבצים, ctanify
יוצר טרבול (א .tar.gz file) עם הקבצים מונחים במבנה המועדף על CTAN.
ה-tarball מכיל בנוסף ZIP (Zip.) קובץ עם עותקים של כל הקבצים המפורטים ב
מבנה ה-TeX Directory הסטנדרטי (TDS), המאפשר הכללת החבילה ב
הפצת TeX Live.

אפשרויות

ctanify מקבל את אפשרויות שורת הפקודה הבאות:

-h, - עזרה
פלט מידע שימוש בסיסי ויציאה.

-V, --גִרְסָה
תְפוּקָה ctanifyמספר הגרסה של ויציאה.

-p מחרוזת, --pkgname=מחרוזת
ציין במפורש שם חבילה. בדרך כלל, ctanify משתמש בשם הבסיס של הראשון
.ins or .דִיר חֲזִירִים הקובץ רשום כשם החבילה. שם החבילה יוצר את שם הבסיס
של הטארבול ש ctanify מייצר.

--נואוטו
אל תוסיף אוטומטית קבצים ל-tarball. בדרך כלל, ctanify באופן אוטומטי
כולל את כל הקבצים המוזכרים ב-a .ins קובץ.

-t מפרט קבצים, --tdרק=מפרט קבצים
ציין קבוצת משנה של הקבצים הנקראים בשורת הפקודה שתכלול רק ב-TDS
קובץ ZIP, לא בספריית החבילות של CTAN. תווים כלליים מותרים (מצוטט אם
הכרחי), ו --tdרק ניתן להשתמש מספר פעמים באותה שורת פקודה.

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

נוֹסָף אפשרויות

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

-d שם הדירוג, --tdsdir=שם הדירוג
במקום ליצור Tarball עבור CTAN, פשוט צור את עץ החבילה TDS המושרש בו
בספרייה שם הדירוג.

-T macro_pkg, -טקס=macro_pkg
טען שהקבצים הנארזים עבור CTAN מכוונים לחבילת מאקרו TeX אחרת מאשר
שרף גומי. כמה דוגמאות נפוצות של macro_pkg הם "גנרי", "רגיל" ו"הקשר".

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

-נוק, --לא לדלג
להכריח ctanify לכלול קבצים כגון קבצים מוסתרים של Unix, קבצי גיבוי של Emacs ו
קובצי מטא נתונים של בקרת גרסה, ש-CTAN לא אוהב לקבל.

-m, --לעשות
שנה את השם של ספריות המכילות קובץ בודד ל"שונות". (לדוגמה, שנה שם
"tex/latex/mypackage/mypackage.sty" ל-"tex/latex/misc/mypackage.sty".) זה היה
פרקטיקה מקובלת בעבר, אך כעת היא מאוד לא מעודדת אותה.

דיאגנוסטיקה

"ההעתקה נכשלה שם הקובץ (לא כזה פילה or מַדרִיך)"
הודעה זו נגרמת בדרך כלל על ידי א .ins קובץ שיוצר שם הקובץ אבל לזה יש
לא עברו כבר טקס or שרף גומי לייצר בפועל שם הקובץ. ctanify עושה
לא פועל אוטומטית טקס or שרף גומי; זה צריך להיעשות באופן ידני על ידי המשתמש. לִרְאוֹת
"CAVEATS" למידע נוסף.

"שונה שם הקובץ ל להשתמש יוניקס קו סיומות (להשתמש --לא-לאחד ל למנוע זֶה)"
למען עקביות, CTAN מאחסן את כל קבצי הטקסט עם סיומת שורה בסגנון Unix (יחיד
תו הזנת שורה ללא תו החזרת כרכרה). כדי לעזור במאמץ זה,
ctanify מחליף אוטומטית סיומות שורה שאינן בסגנון יוניקס. הקודם בלבד
הודעה מודיעה למשתמש שהוא לא צריך להיבהל לראות גודל שונה עבורו
שם הקובץ בטרבול לעומת המקור שם הקובץ בדיסק (אשר ctanify לעולם לא
משנה). אם יש סיבה טובה לשמר את סיומי השורה המקוריים (ושם
לעתים נדירות הוא), ה --לא-לאחד ניתן להשתמש באפשרות כדי למנוע ctanify משינוי כל
קבצים בעת אחסוןם ב-tarball.

"לְמַעֵט שם הקובץ (להשתמש --לא לדלג ל כּוֹחַ הַכלָלָה)"
ctanify בדרך כלל מתעלם מקבצים - גם כאשר מצוין במפורש בפקודה
קו - ש-CTAN מעדיף לא לקבל. אלה כוללים קבצים ששמותיהם מתחילים ב
"." (קבצים מוסתרים של יוניקס), סיים ב"~" (גיבויים אוטומטיים של Emacs), או שמגיעים מא
CVS or .svn ספרייה (קבצי מטא נתונים של בקרת גרסה). אם יש סיבה טובה לכך
להגיש קבצים כאלה ל-CTAN (ולעתים רחוקות יש), את --לא לדלג ניתן להשתמש באפשרות
למנוע ctanify מהתעלמות מהם.

"CTAN מעדיף להחזיק רק תיעוד PDF (בעניין: שם קובץ)"
בגלל הפופולריות של פורמט PDF, CTAN רוצה לקבל כמה שיותר תיעוד
ככל האפשר מופץ ב-PDF. ההודעה הקודמת מבקשת מהמשתמש להחליף כל
תיעוד PostScript או DVI עם PDF אם אפשר. (ctanify עדיין יכלול
תיעוד PostScript ו-DVI ב-tarball; ההודעה הקודמת היא רק א
בקשה מנומסת.)

"לא כלול שם הקובץ in מה היא TDS עץ (לא ידוע סיומת)"
ctanify ממקם קבצים בעץ TDS על סמך טבלה של סיומות קבצים. ל
לדוגמה, כולם .דִיר חֲזִירִים קבצים ממוקמים ב טקסט/לטקס/שם חבילה. אם ctanify לא
יודע איפה לשים קובץ זה לא שם אותו בשום מקום. ראה את הפסקה האחרונה של
"אפשרויות" להסבר כיצד לציין במפורש את מיקום היעד של קובץ ב
עץ TDS. עבור סיומות קבצים נפוצות שבמקרה נעדרות מהן ctanify's
טבלה, שקול גם להודיע ctanifyהמחבר של בכתובת המוצגת למטה
"מְחַבֵּר".

דוגמאות

השמיים Common מקרה
בדרך כלל, כל מה שצריך זה לספר ctanify השם של .ins קובץ (או .דִיר חֲזִירִים אם
החבילה אינה משתמשת ב-DocStrip) ובתיעוד המובנה מראש, אם יש:

$ ctanify mypackage.ins mypackage.pdf README

490347 mypackage.tar.gz

1771 mypackage/README
15453 mypackage/mypackage.dtx
1957 mypackage/mypackage.ins
277683 mypackage/mypackage.pdf
246935 mypackage.tds.zip

1771 doc/latex/mypackage/README
277683 doc/latex/mypackage/mypackage.pdf
15453 source/latex/mypackage/mypackage.dtx
1957 source/latex/mypackage/mypackage.ins
1725 tex/latex/mypackage/mypackage.sty

ctanify מפלט את הגודל ב-bytes של ה-tarball שהתקבל, כל קובץ בתוכו וכל קובץ
קובץ בתוך קובץ ה-ZIP הכלול. בדוגמה הקודמת, שימו לב כיצד ctanify
ביצע אוטומטית את כל הפעולות הבאות:

· כולל mypackage.dtx (נמצא על ידי ניתוח mypackage.ins) בשני ה החבילה שלי
ספרייה וקובץ ה-ZIP,

· כולל mypackage.sty (נמצא על ידי ניתוח mypackage.ins) בקובץ ה-ZIP אבל, כי
זה קובץ שנוצר, לא ב- החבילה שלי מדריך, וכן

· הצבת כל הקבצים בספריות TDS מתאימות (תיעוד, מקור, ראשי
חבילה) בתוך קובץ ה-ZIP.

שקול מה יידרש כדי לייצר מקבילה באופן ידני mypackage.tar.gz קובץ.
ctanify היא בהחלט חלופה פשוטה ומהירה יותר.

מתקדם נוֹהָג
ctanify מניח שקובצי PostScript הם תיעוד ולכן מאחסן אותם תחת
doc/latex/package-name/ בעץ TDS בתוך קובץ ה-ZIP. אולם נניח כי א
חבילת LaTeX משתמשת בסט של קבצי PostScript לשליטה dvipsהפלט של. במקרה הזה,
ctanify יש לומר לכלול את קובצי PostScript בספריית החבילה, לא את
ספריית תיעוד.

$ ctanify mypackage.ins "mypackage*.ps=tex/latex/mypackage"

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