cgifile - מקוון בענן

תָכְנִית:

שֵׁם

cgiemail, cgiecho, cgifile - כלי המרת CGI טופס לדואר

אל האני cgiemail המשתמש מדריך

מדריך זה יעזור לך לכתוב טופס WWW ששולח לך הודעת דואר אלקטרוני. ה
נדרשים השלבים הבאים:

· צור תבנית דואר אלקטרוני.

· שימו קישור לתבנית בעמוד שלכם.

· החלט אם קישור mailto: יתאים.

· צור טופס HTML.

· צור טפסי HTML מתקדמים יותר.

· ודא שה-ACTION נכונה.

· נסה את הטופס שלך עם cgiecho.

· עבור לחיות עם cgiemail.

· ניפוי באגים אם אינך מקבל דואר

השלבים הבאים הם אופציונליים.

· הוסף טקסט לדף ההצלחה.

· השתמש בדף הצלחה חלופי.

· בצע כמה כניסות נדרשות.

· ציין עיצוב עבור חלק מהקלטים.

· השתמש במשתני סביבת CGI.

צור an דוא"ל תבנית.
לפני שתתחיל לקבל הודעות דואר אלקטרוני דרך האינטרנט, עליך להחליט מהן
הודעות צריכות להיראות כך. צור קובץ ASCII, הנקרא תבנית דואר אלקטרוני, שנראה
משהו כזה:

ל: [מוגן בדוא"ל] קווי כותרת
נושא: שאלות שלוש
שורה ריקה
מה השם שלך? [השם שלך]
מה המסע שלך? [שאיפה] BODY
מה הצבע האהוב עליך? [צֶבַע]

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

· בכל מקום שתרצה שהמשתמש בטופס שלך יספק מידע, השתמש במילה אחת
בתוך סוגריים מרובעים ללא רווחים, למשל השם שלך: [שם שלך]. לא [שים את שמך
פה].

· ודא שהכתובת בשדה אל: נכונה.

· אם יש שורות ריקות בין שורות הכותרת, הסר אותן.

· אם יש שורות ריקות לפני שורות הכותרת, הסר אותן.

· ודא שכל שורות הכותרות שלך חוקיות. התו הראשון בשורה חייב להיות א
מִכְתָב. רוב המידע צריך להיכנס לגוף ההודעה; אל תמציא בעצמך
כותרות.

· ודא שיש שורה ריקה בין שורות הכותרת לגוף.

· הקפד לשמור אותו כטקסט ASCII. לדוגמה, אם אתה משתמש ב-Microsoft Word, השתמש
"שמור בשם" ובחר "טקסט רק עם מעברי שורות".

· אם יצרת את הקובץ ב-Mac, הקפד להעלות אותו כטקסט, כלומר CR's מתורגם.
(למחשבי יוניקס יש קודים שונים המציינים את סוף השורה מאלה של Mac, כך ש-
הקובץ עשוי להיראות כמו שורה אחת ארוכה למחשב יוניקס.)

במסגרת ההנחיות הללו ישנה גמישות רבה. אתה יכול לשים Bcc:, X-Face:, או כל אחד
כותרת אחרת בכותרות. אתה יכול לשים דברים כמו Cc: [שם שלך] בכותרות. לִהיוֹת
יְצִירָתִי. רק אל תכניס לשם שום דבר שלא היית רוצה שמנהל האתר שלך יראה,
כי לשם מגיעות הודעות חוזרות.

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

שים a קישור ל מה היא תבנית on שֶׁלְךָ עמוד.
הנה דוגמה:

האם תרצה לחצות את הגשר? הורד את טופס ה"שאלות שלוש" שלי ושלח אותו אל
<[מוגן בדוא"ל]>.

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

להחליט if a mailto: קישור יצטרך לעשות.
כבר, בלי שום HTML מסובך, יש לך דרך לאנשים ב-WWW לשלוח לך
המידע שאתה רוצה. לפני שאתה מתאמץ ליצור טופס HTML, החלט אם
זה באמת שווה את זה. לטפסים ב-WWW יש שני חסרונות מיוחדים:

· תקבל הרבה דואר אלקטרוני מופרך מאנשים שרק ``גולשים באינטרנט''.

· כתובת הדואר האלקטרוני של המשתמש מוקלדת באופן ידני, ולעתים קרובות היא מוקלדת בטעות, כך שיש לך
אין דרך להשיב. זו פחות בעיה עם קישורי mailto:.

צור מה היא HTML הטופס.
אם החלטת ליצור טופס HTML, אתה צריך לתת לאנשים דרך לספק טופס
כתובת דוא"ל. עם הקישור mailto:, הדואר שלהם יספק את כתובת מאת: עבור
אוֹתָם. אבל עכשיו אתה צריך להוסיף שורה בראש תבנית הדואר האלקטרוני שלך כך:

מדוא"ל]

להלן טופס HTML לדוגמה.

כתובת המייל שלך: ____________________

השם שלך: ____________________

החיפוש שלך: ____________________

הצבע האהוב עליך: __________________

שלח דואר אלקטרוני (דוגמה זו לא ממש שולחת דואר אלקטרוני.)

זה מקור ה-HTML:

<FORM METHOD="POST"
ACTION="http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

כתובת המייל שלך:
השם שלך:
החיפוש שלך:
הצבע האהוב עליך:



זו דוגמה מאוד פשוטה. שים לב שהשם של כל קלט מתאים למה שאתה
הכנס בעבר לתבנית הדואר האלקטרוני. בדוגמה זו הם דוא"ל, השם שלך, קווסט,
וצבע. זהו מושג המפתח בשימוש ב-cgiemail. היזהר לעשות אותם בדיוק את
אותו; אם תכניס את NAME="color" בטופס ה-HTML שלך ואת [color] (שים לב לאות
ההבדל) בתבנית הדואר האלקטרוני שלך, הקלט לא יופיע בדואר האלקטרוני.

צור יותר מתקדם HTML צורות.
כדי ללמוד ליצור טפסים מסובכים יותר, קרא את המדריך של NCSA. כל צורות הדוגמא שלהם
ניתן להמיר לטפסי cgiemail רק על ידי שינוי ה-ACTION. שלא כמו צורות אחרות-ל-
תוכניות דואר אלקטרוני, אינך נדרש להשתמש בקלט נסתרות עם שמות מיוחדים.

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

לעשות בטוח מה היא פעולה is לתקן.
החלק הקשה ביותר בטופס ה-HTML הוא להגדיר כהלכה את ה-ACTION. התחל עם ה
כתובת האתר של תבנית הדואר האלקטרוני שלך, ואז פצל אותה לשני חלקים, למשל

http://web.mit.edu/wwwdev/cgiemail/questions3.txt
\ /\ /
`--- חלק 1 ---' ` -------- חלק 2 ----------'

ואז אתה שם את שם התסריט באמצע. בדרך כלל זה ``/cgi-bin/cgiecho'', אבל זה
תלוי איך השרת שלך מוגדר. ב-web.mit.edu זה קורה
``/bin/cgiecho'', לכן ה-ACTION שלי נראה כך:

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ /\ /\ /
`--- חלק 1 ---' שם התסריט ` -------- חלק 2 ----------'

למען הפשטות, אתה יכול להשאיר את חלק 1 בחוץ, אבל אתה חייב לכלול אותו אם אתה רוצה לבדוק את שלך
טופס כקובץ מקומי. אם אתה לא יודע מה זה אומר, פשוט אל תהסס להשמיט את חלק 1.

לנסות הַחוּצָה שֶׁלְךָ טופס עם cgiecho.
הכנס את הטופס שלך לדפדפן ה-WWW המועדף עליך, מלא את התשומות ושלח אותו. אתה
צריך לראות איך נראה הטופס המעובד. אם במקום זאת אתה רואה שגיאה עם מספר
קרוב ל-500, ה-ACTION שלך כנראה מוגדר שגוי. חזור לשלב הקודם.

אם נראה שחלק מהקלטים שלך לא מופיעים בטופס המעובד, ודא זאת
לכניסות יש את אותם שמות בדיוק בצורת HTML כמו בתבנית ASCII. לְמָשָׁל
NAME="שם שלך" בטופס HTML ו-[שם שלך] בתבנית הדואר האלקטרוני.

Go לחיות עם cgiemail.
כעת שנה את cgiecho ל-cgiemail ב-ACTION של טופס ה-HTML שלך. נסה את זה. אתה צריך
לקבל הודעת דואר אלקטרוני עם הטופס המעובד. אם אתה מקבל דף הצלחה אבל לא
לקבל דואר, יש בעיה כלשהי בקובץ התבנית שלך. חזור ותוודא שאתה
פעל בהתאם להנחיות בשלב 1.

אם זה עובד, מזל טוב!

9. ניפוי באגים אם לא קיבלת דואר

בדרך כלל, דואר נשלח באופן אסינכרוני, כלומר הוא נכנס לתור להישלח בשעה א
זמן נוח. דואר אסינכרוני נשלח בצורה יעילה ואמינה יותר, אך יש לו את
חסרון שניתן לדווח על בעיות רק על ידי שליחת הודעת שגיאה בחזרה אל
שׁוֹלֵחַ. למערכת הדואר, נראה ששולח הדואר הוא שרת האינטרנט, אז
הודעת השגיאה לא תגיע אליך.

אם אינך מקבל דואר, תוכל להשתמש באופן זמני במשלוח דואר סינכרוני על ידי יצירה
קלט נסתר בשם cgiemail-mailopt ונותן לו ערך המכיל "sync", למשל



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

אופציונלי: להוסיף טֶקסט ל מה היא הצלחה עמוד.
כאשר דואר נשלח, מופיע עמוד שכותרתו ``הצלחה'' עם הטקסט של הודעת הדואר האלקטרוני.
אתה יכול להשתמש במשתנה נסתר בשם ``תוספת'' כדי להוסיף טקסט משלך. הנה דבר פשוט
דוּגמָה:



אם אתה מוכן להניח שקוראי הטופס שלך משתמשים בתוכנת דפדפן עדכנית
כמו Lynx 2.6 או Netscape 3.0, אז אתה יכול לשים סימון HTML במשתנה זה באמצעות ה-
ישויות אופי מתאימות. למשל, אם רצית להוסיף

תודה רבה לך!

אז סימון HTML יהיה

תודה!

כלומר תצטרך את הדברים הבאים בטופס שלך:

<INPUT TYPE="hidden" NAME="תוספת"
VALUE="<em>תודה!</em>">

שים לב שמלבד היותה קשה לכתיבה, תכונה זו לא תעבוד עבור אנשים שמשתמשים במבוגרים
תוכנת דפדפן.

אופציונלי: השתמש an חלופי הצלחה עמוד.
אם אתה לא אוהב את עמוד ברירת המחדל שעולה כאשר דואר אלקטרוני נשלח בהצלחה, אתה יכול
ציין כתובת אתר חלופית באמצעות משתנה נסתר בשם ``הצלחה'' בטופס ה-HTML שלך,
לְמָשָׁל

<INPUT TYPE="hidden" NAME="הצלחה" VALUE="http://web.mit.edu/">

הערה: התחל את כתובת האתר שלך עם / או עם http://. אחרת cgiemail יכוון את הדפדפן שלך
להפעלה שנייה של cgiemail, וכתוצאה מכך השגיאה ללא החלפות משתנים.

נכון לגרסה 1.3, אין דרך לגרום לדף הצלחה חלופי זה להכיל מידע
המשתמש שהגיש בטופס. תכונה זו צפויה להתווסף במהדורה עתידית.

אופציונלי: לעשות כמה תשומות נדרש.
אם ברצונך לדחות אוטומטית טפסים עם קלט מסויים שנותר ריקים, הוסף את
קידומת ``נדרש-'' לשם הקלט גם בטופס ה-HTML וגם בדואר האלקטרוני שלך
תבנית. הנה דוגמה:

בטופס HTML:

השם שלך:

בתבנית המייל

השם שלך: [נדרש-שם שלך]

אופציונלי: לפרט עיצוב ל כמה תשומות.
אם, בתבנית הדואר האלקטרוני שלך, הטקסט בתוך סוגריים מרובעים מתחיל ב-%, cgiemail יעשה זאת
להשתמש printf () פונקציה ב-C בשם השדה אחרי הפסיק. אם אתה לא מכיר
עם פונקציה זו, עיין בספר על C. אם אתה מכיר אותה, אנא שים לב לאלה
שני הבדלים:

· התו הראשון במחרוזת הפורמט חייב להיות %.

· תווים כמו \n ו-\t חייבים להיות מילוליים. אם אתה רוצה קו חדש, אתה צריך לשים א
שורה חדשה ממש לפני הפסיק, למרות שזה נראה מוזר. לדוגמה, אם
פיצה גודזילה רצו תוספות רשומות אחת בכל שורה, הם היו מכניסים את הדברים הבאים
תבנית המייל שלהם:

[%s
,ציפוי]

אופציונלי: השתמש CGI סביבה משתנים.
תכונה זו עשויה לעבוד או לא, תלוי אם מנהל האתר שלך הפעיל אותה או לא
בעת הגדרת cgiemail.

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

[$HTTP_USER_AGENT]

יכניס את שם הדפדפן ו/או השער של המשתמש בהודעת הדואר האלקטרוני שלך. כדי
לכבד את הפרטיות, טופס ה-HTML שלך צריך להזהיר את המשתמשים על כל מידע לגביו
אלה שייכללו בדואר האלקטרוני, למשל HTTP_USER_AGENT, REMOTE_ADDR.

אדמיניסטרטיביה
איש קשר במעלה הזרם: cgiemail[מוגן בדוא"ל]>

מתחזקת דביאן: אניבל מונסלב סלאזאר[מוגן בדוא"ל]>

מידע מלא על בנייה, התקנה ושימוש ב-cgiemail זמין באתר WWW:

http://web.mit.edu/wwwdev/cgiemail/

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