code2html - מקוון בענן

תָכְנִית:

שֵׁם

code2html - ממיר קוד מקור של תוכנית ל-HTML

תַקצִיר

(1) code2html [אפשרויות] [קובץ קלט [קובץ פלט]]

(2) code2html -p [פילה [קובץ חלופי]]

(3) code2html (כתסריט CGI; עיין בסעיף על CGI)

תיאור

code2html הוא סקריפט perl הממיר קוד מקור של תוכנית לתחביר מודגש
HTML, או כל פורמט אחר שעבורו מוגדרים כללים.

(1) אפשרויות
קובץ קלט
האם הקובץ המכיל את קוד המקור של התוכנית שיש לעצב. אם לא
או שניתן מינוס (-), הקוד ייקרא מ-STDIN.

קובץ פלט
האם הקובץ לכתוב אליו את הקוד המעוצב. אם לא צוין או מינוס (-) הוא
בהינתן, הקוד ייכתב ל-STDOUT.

-l, --מצב שפה
ציין את קבוצת הביטויים הרגולריים לשימוש. אלה צריכים להיות מוגדרים ב-a
קובץ שפה (ראה קבצים לְהַלָן). כדי לגלות אילו מצבי שפה מוגדרים,
גיליון א code2html --מצבים.

קלט זה מטופל ללא רגישות רישיות.

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

-v, --מִלוּלִי
מדפיס מידע התקדמות ל-STDERR.

-n, --מספרי שורות
הדפס את קוד המקור עם מספרי שורות.

-N, --מספרי קישורים
הדפס את קוד המקור עם מספרי שורות. מספרי השורות יקשרו אל
עצמם, מה שמקל על שליחת קישורים לקווים.

-P, -קידומת
קידומת אופציונלית לשימוש עבור עוגני מספר קו.

-t, --החלף-כרטיסיות[=TABSTOP-WIDTH]
החלף כל מופע של תו בכמות הרווחים הנכונה לקבל
ל-Tabstop הבא. ברירת המחדל היא רוחב Tabstop של 8 תווים.

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

-m, --מצבים
הדפס את כל מצבי השפה ופורמטי הפלט המוגדרים כעת ל-STDOUT וצא
בהצלחה. מדפיס גם מצבים מא שפה-קובץ ניתנו על ידי --שפה-קובץ if
יָשִׂים.

--לסגת=שפה
אם מצב השפה נתון עם --מצב שפה לא ניתן למצוא אז השתמש בזה
מצב.

--לסגת פשוט למשל שימושי כאשר code2html נקרא מתסריט ל
להבטיח יצירת פלט.

-h, - עזרה
הדפס עזרה קצרה וצא בהצלחה.

-V, --גִרְסָה
הדפס את גרסת התוכנית וצא בהצלחה.

-c, --סוג תוכן
מדפיס "Content-Type: text/html\n\n" (או מה שפורמט הפלט מגדיר בתור
content-type) לפני שאר הפלט. שימושי אם הסקריפט מופעל כ
סקריפט cgi.

-o, --פורמט פלט
בוחר את פורמט הפלט. html הוא ברירת המחדל. כדי לגלות אילו פורמטי פלט
מוגדרים, סוגיה א code2html --מצבים.

-H, --ללא כותרת
אל תעשה שימוש בתבנית שהוגדרה על ידי פורמט הפלט. עבור HTML זה אומר
שלא יהיו , , ולא
תגים.

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

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

-w, --רוחב קו=רוחב קו
לעטוף שורות אחרי רוחב קו דמויות. ברירת המחדל היא לא לעטוף שורות כלל.

-b, --linebreakprefix=LINEPREFIX
השתמש fILINEPREFIX בתחילת שורות עטופות. ברירת המחדל היא "» ".

(2) HTML תיקון
code2html -p [פילה [קובץ חלופי]]

code2html גם מאפשר לך לקבל קוד מקור מוטבע בקובץ HTML. אז זה יכול לקחת
קובץ HTML זה והכנס את הקוד המודגש בתחביר.

אם לא ניתן קובץ, code2html קורא מ-STDIN וכותב ל-STDOUT. אם רק קובץ אחד הוא
בהינתן זה מחליף את הקובץ הזה בפלט. אם מסופקים שני קבצים, הראשון הוא
לקרוא מתוך והשני כתוב אליו.

כדי להשתמש בתכונה זו, פשוט הכנס דוגמה כזו לקובץ ה-html שלך:

-->

הקובץ המודגש בתחביר יוכנס במיקום זה מוקף בתגיות .

כל האפשרויות שניתן לתת בשורת הפקודה כמו --מספרי שורות וכו' עבודה. - עזרה,
--גִרְסָה, וכו' גם עובדים אבל זה לא מאוד אינטליגנטי להשתמש בהם :). באמצעות
--פורמט פלט לא מומלץ לבחור בפורמט פלט שאינו HTML. --סוג תוכן is
התעלם.

אתה יכול גם לכתוב את קוד המקור של התוכנית ישירות בקובץ ה-html עם הדברים הבאים
תחביר:

<!-- code2html הוסף [אפשרויות]



->

בדרך כלל זה רעיון טוב לפחות לתת את --מצב שפה אפשרות לציין את
שפה.

(3) CGI
אם הסקריפט משמש כסקריפט CGI (GATEWAY_INTERFACE סט סביבה ולא
ניתנו ארגומנטים של שורת הפקודה) code2html קורא את הארגומנטים ממחרוזת השאילתה
או מ-SDTIN. (שיטות POST ו-GET).

--סוג תוכן מופעל אוטומטית והפלט תמיד עובר ל-STDOUT.

הפרמטרים/האפשרויות הבאות מתקבלים:

מצב שפה - אופציונאלי
`c', `cc', `pas' וכו'.

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

נסיגה - אופציונאלי
`plain', `c' וכו' אם לא ניתן למצוא מצב שפה, השתמש במצב זה

בורר קלט - אופציונאלי
או `קובץ', `cgi-input1', `cgi-input2', או `REDIRECT_URL'

ברירת מחדל: קובץ

שם הקובץ
קובץ לקרוא ממנו if בורר קלט הוא 'קובץ'

cgi-input1
קוד המקור להדגשת תחביר. למשל מ- או מ-a
להעלות. לִרְאוֹת בורר קלט.

cgi-input2
קוד המקור להדגשת תחביר. למשל מ- או מ-a
להעלות. לִרְאוֹת בורר קלט.

מספרי שורות - אופציונאלי
'כן', 'לא' או 'קישור'

ברירת מחדל: לא

החלפת כרטיסיות - אופציונאלי
אם 0 אז הכרטיסיות לא מוחלפות, אחרת החליפו כל הופעה של תו
עם כמות הרווחים הנכונה כדי להגיע ל-Tabstop הבא.

ברירת מחדל: 0

כותרת - אופציונאלי
הגדר היא כותרת הקובץ.

ללא קידוד - אופציונאלי
כברירת מחדל code2html מנסה לקודד את הפלט בתור אחד מהם bz2/gz/Z אם הלקוח
תומך בזה (HTTP_ACCEPT_ENCODING) והתוכנית הדרושה זמינה ב-
שרת. ייתכן שיהיה עליך לשנות @CGI_ENCODING בתסריט כדי להתאים לתוכנית שלך
מיקומים.

If ללא קידוד מוגדר כ"נכון" code2html לא מנסה לקודד את הפלט.

מדוע שני כניסות cgi אתה עשוי לשאול: זה כדי לאפשר למשתמשים שלך לבחור באמצעות
ממשק אם הם רוצים להכניס את הקובץ שלהם ל- או למשתמש
לחצן כדי לבחור את הקובץ שלהם. ראה את הדוגמה בדף הבית שלי.

שים לב שאם $FILES_DISALLOWED_IN_CGI הוא 0 זה אפשרי עבור המשתמשים שלך לקרוא את כל
קבצים שה-httpd יכול לקרוא (אם אתה לא מפעיל cgi-wrapper או משהו כזה. על ידי
ברירת מחדל ערך זה מוגדר ל-1, לכן אין לאפשר קריאת קבצים באמצעות cgi. אתה יכול
אפשר זאת עם הגדרה $FILES_DISALLOWED_IN_CGI ל-0 בחלק העליון של התסריט.

בורר הקלט REDIRECT_URL צריך הסבר מיוחד. שם הקובץ נוצר מתוך
שני משתני הסביבה DOCUMENT_ROOT ו REDIRECT_URL.

אם אתה רוצה ש-apache יתקשר אוטומטית code2html עבור כל קבצי קוד המקור של התוכנית אתה
יכול לעשות זאת על ידי הוספת שתי שורות אלה ל-srm.conf שלך:

AddHandler text/x-sourcecode .c .cc .cpp .pas .h .p

טקסט פעולה/x-sourcecode /cgi-bin/code2html?input-selector=REDIRECT_URL&foo=

או משהו דומה לזה. בשורה AddHandle אתה יכול לבחור לאילו הרחבות
עובר דרך code2html.

אזהרה: אל תוסיף .pl לשורה זו ותן שם לסקריפט זה "code2html.pl". זה יביא לתוצאה
בלופ.

כמו כן ודא שאתה טוען את מודול הפעולה (srm.conf).

החלף את /cgi-bin/code2html במיקום הווירטואלי שמתחתיו ניתן לגשת לקובץ.
שימו לב לחלק "foo=". Apache מוסיף את כתובת האתר של הקובץ כדי להציג בסוף הקובץ
חלק פעולה. אנחנו לא צריכים את זה מכיוון שאנו משתמשים במשתנה הסביבה REDIRECT_URL
עם זאת, איננו רוצים לקבל את כתובות ה-url שמוסיפות למחרוזת בורר הקלט. לכן, אנחנו
הוסף את החלק "&foo=".

Tnx לקווין ברטון <[מוגן בדוא"ל]> לרעיון. הוא גם קובע זאת

> זה חזק יותר אם אתה משתמש בו באפאצ'י
> תג
>
>
>
> #עם תג הפעולה שלך כאן... כך תוכל
> #עדיין יש קבצי .java רגילים בשרת שלך.
>
>
>

דוגמא

בהנחה code2html נמצא בספרייה הנוכחית, אתה יכול להקליד

code2html -l perl code2html.pl code2html.html

כדי להמיר את הסקריפט לקובץ HTML.

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