זוהי הפקודה pafp שניתן להריץ בספק האירוח החינמי של OnWorks באמצעות אחת מתחנות העבודה המקוונות החינמיות שלנו כגון Ubuntu Online, Fedora Online, אמולטור מקוון של Windows או אמולטור מקוון של MAC OS.
תָכְנִית:
שֵׁם
paf - מסנן תקציר של פוד. שינוי מסמכי פוד משורת הפקודה.
תַקצִיר
ש$>
סיכום paf /usr/bin/paf
paf add_podcmds SomeModule.pm
paf sort -heading=METHODS Pod/Abstract/Node.pm # METHODS היא ברירת המחדל
סיכום מיון paf Pod/תקציר/Node.pm
# ראה Pod::Abstract::Filter::overlay
שכבת-על של paf מיון גזור clear_podcmds SomeClass.pm
# -p יפלוט את source הפוד, במקום להפעיל את perldoc.
paf -p sort Pod::Abstract::Node
paf -p מצא את הרמה Pod::Abstract::Node
תיאור
Paf הוא כלי סינון וטרנספורמציה מודולרי קטן אך רב עוצמה של פודים. הוא מאפשר...
טרנספורמציה הלוך ושוב של מסמכי Pod באמצעות ספריית Pod::Abstract, עם מספר רב של
לסנן שרשראות מבלי לבצע סידור/ניתוח מחדש של המסמך בכל שלב.
Paf מגיע עם סט קטן של מסננים שימושיים, אך ניתן להרחיב אותו פשוט על ידי כתיבת מסננים חדשים.
מחלקות במרחב השמות "Pod::Abstract::Filter".
מסננים
הוסף_podcmds
הוסיפו פקודות =pod מפורשות בסוף כל מקטע חיתוך, כך שכל מקטעי הפוד יהיו
התחיל עם פקודה =pod.
clear_podcmds
הסר את כל פקודות ה-=pod שאינן בלוקי חיתוך מסיימים. פעולה זו תנקה מסמכים ש
צומצמו גם באמצעות מסנן ה"חיתוך".
לחתוך
הסירו את כל הצמתים החתוכים, כך שרק התרמיל יישאר.
כיסוי
שכבת-על של paf Source.pm
כדי ש-overlay יעבוד, חייב להיות מקטע "begin :overlay/end :overlay" בקוד המקור.
קובץ, עם הגדרות "=overlay SECTION Module". התוצאה הסופית היא שכל
כותרות משנה חסרות ב-SECTION מתווספות מאותו סעיף במודולים שצוינו.
שימו לב שזה יכסה את כל כותרת המשנה, כולל צמתים חתוכים, כך שניתן יהיה להוסיף קוד.
למסמך המקור. השתמש ב-"cut" אם אינך מעוניין בכך.
כל מקטע שכוסה יכלול סמן "=לשכבה מ", כך שניתן יהיה
יוחלף על ידי שכבת-על עוקבת מאותו קובץ/מודול. מקטעים אלה יהיו
הוחלף במקומו, כך שסדר הסעיפים לאחר הונחו לראשונה יישמר.
גילוי שכבה
קוד קוד פתוח (paf unoverlay)
רצועות את כל מקטעים המסומנים כמוצגים בשכבה עליונה ותואמים למפרט השכבה העליונה מהמקור.
sort
מיון paf [-heading=שיטות] Source.pm
מיין את כל כותרות המשנה בכותרת בעלת השם (שיטות אם לא סופקו).
פעולה זו תזיז את הצמתים החתוכים יחד עם הכותרות שלהם, כך שהקוד שלך ישתנה. השתמש ב-"cut"
אם אתה רוצה רק פוד בפלט.
לחלופין, ניתן גם לגרום למיון של כותרות על ידי הכללת "=למיון"
בתחילת הקטע שלך (לפני כותרת המשנה הראשונה).
תקציר
ספק סיכום מקוצר של המסמך. אם יש צומת מילולי בגוף המסמך
כותרת המכילה את שם הכותרת, היא תיחשב כדוגמה ותורחב כ
חלק מהסיכום.
למצוא
paf מצא [-f=]שם מקור.pm
מצא תת-סעיפים ספציפיים או פריטי רשימה המזכירים שם. משמש להגבלת קטגוריה גדולה יותר
מסמך קטן יותר שמעניין אותך. אם לא צוין -f, אז ה-
המילה שאחרי חיפוש תהיה מונח החיפוש.
לֹא מְלוּטָשׁ
פאף לא חתוך Source.pm
המר צמתים חתוכים במקור לטקסט מילה במילה. לא ההפך מחיתוך!
מספר_מקטעים
מספר_סעיפים של paf מקור.pm
מחיל מספור סעיפים פשוט מרובה חלקים (3.1.2) על כותרות head1 עד head4.
שימו לב ש-number_sections ימלאו כרגע חלק מהחוכמה בדברים כמו
סיכום, מכיוון ששמות הסעיפים לא יתאימו עוד לשמות הפונקציות.
השתמש ב-pafp באינטרנט באמצעות שירותי onworks.net
