API אוריון - בנייה
מסמך זה מכסה את Build System APIs
- SunStarSys::תצוגה .
- single_narrative(%args).
- news_page(%args).
- sitemap(%args).
- asymptote(%args).
- דילוג(%args).
- yml2ext(%args).
- fetch_deps($path, $data, $quick).
- breadcrumbs($path).
- memoize(%args).
- compress(%args).
- next_view(%args).
- ssi(%args)
- offline(%args).
- snippet(%args).
- reconstruct(%args).
- trim_local_links(%args).
- normalize_links(%args).
- SunStarSys::כלי שירות .
- unload_package($pkg).
מס’ מערכות הבנייה
SunStarSys::תצוגה.
single_narrative(%args).
ארגומנטים חובה:
ארגומנטים אופציונליים:
news_page(%args).
sitemap(%args).
אינדקס יחסי תלות ספציפי לאזור, ממוין.
ארגומנטים חובה:
ארגומנטים אופציונליים:
asymptote(%args).
בניות ומטמונים אסימפטוטה
.
ארגומנטים חובה:
דילוג(%args).
אל תבנו את זה בכלל. במקום זאת, בנה את קובצי המקור המשויכים שנוצרו (לדוגמה, .bib\$לנג
\$base.page/bibliography.yml\$lang
yml2ext(%args).
המר קובצי YAML.
ארגומנטים אופציונליים:
fetch_deps($path, $data, $quick).
ארגומנטים חובה:
breadcrumbs($path).
מחזיר רשימת נתיבי HTML של נתיב.
memoize(%args).
מעביר למטמון את הבנייה; משמש בעיקר עם fetch_deps ו-quick_deps > 2.
compress(%args).
יצא משימוש.
next_view(%args).
כלי שירות לעיבוד $args{view}.
ssi(%args)
מעריך באופן רקורסיבי ssi.
offline(%args).
מריץ את next_view במצב לא מקוון.
snippet(%args).
מעבד קווי גזירים.
reconstruct(%args).
מעבד מחדש הנחיות תבנית בתוכן מובנה מ-next_view.
trim_local_links(%args).
מעקם סיומות קובץ מקישורים מקומיים.
normalize_links(%args).
מנרמל קישורים מקומיים (./ ו- ../).
SunStarSys::כלי שירות.
read_text_file($file, $out, $content_lines).
מנתח כותרות+תוכן של קובץ מקודד UTF-8 קובץ $
מאחסן תוצאות ב- $out
. $content_lines
הוא המספר המרבי (אופציונלי) של שורות תוכן לקריאה.
קובץ $
יכולה להיות הפניה למחרוזת raw, המייצגת את כל התוכן של קובץ. התוצאות ב $out
.
copy_if_newer($src, $dest).
עותקים $src
עד $יעד
אם חותמת הזמן של השינוי הקודם חדשה מזו של השנייה. על עותק, בנוסף gzip-דוחס את $יעד
.
get_lock($lockfile).
לוקח נעילה בלעדית (f) עבור תהליך UNIX הנוכחי על $lockfile
.
shuffle(\@deck).
רנדומלית במקום (דייג ייטס) של @deck
.
sort_tables($content).
ממיין טבלאות סימון ב-$content בהתאם למפרט העמודה של כל טבלה. ניתן למיין עמודה אחת בדיוק לכל טבלה, אופציונלית, באופן מספרי nn
, בירידה נגישות
או בסדר עולה ^
.
fixup_code($prefix, $type, @_).
מסירה תחילית $ מכל ארגומנט ב-@_. הפונקציה של ארגומנט $type היא ספציפית למימוש, אך משמשת בעיקר לשתילת “מצב” editor.md לעיבוד תוכן זה ב-@_.
unload_package($pkg).
פורק באופן אגרסיבי את חבילת Perl חבילת $pkg
.
purge_from_inc(@paths).
touch(@_).
נגע בכל הקבצים ב- @_
. . אם לא הועברו ארגומנטים, משתמש $_
.
normalize_svn_path(@_).
מנרמל את כל הנתיבים ב- @_
לשימוש בטוח כארגומנטים גולמיים כדי SVN::לקוח
.
sanitize_relative_path(@_).
אבטחת נתיבים ב- @_
לשימוש כנתיבים יחסיים טהורים ב- דוטיאק::DTL
.
parse_filename($path).
Wrapper סביב קובץ::Basename::fileparse
. . ללא טיעונים, שימושים $_
.
walk_content_tree($code).
הליכות מותנות ./תוכן
עץ הקופה של מערכת הבנייה, נרמול ראשון $_
כנתיב משנה רשמי ולאחר מכן מפעיל קוד $
.
archived($path).
דגלים כל סטטוס: ארכיב
נתיב
. . שימושים $_
.
seed_file_deps($path).
עדכונים %path::תלויות
בשביל זה נתיב
מבוסס על שלה יחסי תלות
כותרות גלובליות. ברירות מחדל לשימוש $_
.
seed_file_acl($path).
עדכונים @path::acl
בשביל זה נתיב
מבוסס על שלה רשימת בקרת גישה
מפרט כותרת. ברירות מחדל לשימוש $_
.
טעינה
זהה ל- YAML::XS::טעינה
.
הטלה
זהה ל- YAML::XS::Dump
.