cgifile - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

cgiemail, cgiecho, cgifile - Công cụ chuyển đổi Biểu mẫu sang Thư CGI

Sản phẩm thư điện tử người sử dụng hướng dẫn

Hướng dẫn này sẽ giúp bạn viết một biểu mẫu WWW để gửi một thông điệp e-mail cho bạn. Các
các bước sau là bắt buộc:

· Tạo một mẫu e-mail.

· Đặt một liên kết đến mẫu trên trang của bạn.

· Quyết định xem một liên kết mailto: sẽ hoạt động.

· Tạo biểu mẫu HTML.

· Tạo các biểu mẫu HTML nâng cao hơn.

· Đảm bảo rằng ACTION là chính xác.

· Hãy thử mẫu của bạn với cgiecho.

· Phát trực tiếp với cgiemail.

· Gỡ lỗi nếu bạn không nhận được thư

Các bước sau là tùy chọn.

· Thêm văn bản vào trang thành công.

· Sử dụng một trang thành công thay thế.

· Thực hiện một số đầu vào cần thiết.

· Chỉ định định dạng cho một số đầu vào.

· Sử dụng các biến môi trường CGI.

Tạo an e-mail bản mẫu.
Trước khi bắt đầu nhận tin nhắn e-mail qua web, bạn nên quyết định những gì
tin nhắn sẽ trông như thế nào. Tạo tệp ASCII, được gọi là mẫu e-mail, trông
đại loại như thế này:

Đến: [email được bảo vệ] DÒNG ĐẦU
Chủ đề: câu hỏi ba
dòng trống
Tên của bạn là gì? [tên của bạn]
Nhiệm vụ của bạn là gì? [nhiệm vụ] BODY
Màu sắc yêu thích của bạn là gì? [màu sắc]

Theo một nghĩa nào đó, mẫu này là dạng tự do. Những người muốn gửi e-mail cho bạn có thể tải xuống
mẫu này, hãy điền vào và gửi nó cho bạn. Tuy nhiên, mẫu cũng sẽ được sử dụng
bằng chương trình cgiemail, vì vậy trước khi bạn tải tệp lên máy chủ WWW của mình, hãy cẩn thận
làm theo các nguyên tắc sau:

· Bất cứ nơi nào bạn muốn người dùng biểu mẫu của bạn cung cấp thông tin, hãy sử dụng một từ duy nhất
bên trong dấu ngoặc vuông không có khoảng trắng, ví dụ: Tên của bạn: [tên bạn]. Không phải [Đặt tên của bạn
ở đây].

· Đảm bảo rằng địa chỉ trong trường Tới: là chính xác.

· Nếu có dòng trống giữa các dòng tiêu đề, hãy xóa chúng.

· Nếu có các dòng trống trước các dòng tiêu đề, hãy loại bỏ chúng.

· Đảm bảo rằng tất cả các dòng tiêu đề của bạn đều hợp lệ. Ký tự đầu tiên trên dòng phải là
thư. Hầu hết thông tin nên đi trong nội dung thư; đừng tự trang điểm
tiêu đề.

· Đảm bảo rằng có một dòng trống giữa các dòng tiêu đề và nội dung.

· Hãy chắc chắn rằng bạn lưu nó dưới dạng văn bản ASCII. Ví dụ: nếu bạn đang sử dụng Microsoft Word, hãy sử dụng
"Lưu dưới dạng" và chọn "Chỉ văn bản có ngắt dòng".

· Nếu bạn đã tạo tệp trên máy Mac, hãy đảm bảo tải tệp đó lên dưới dạng văn bản, tức là bản dịch của CR.
(Máy tính Unix có các mã biểu thị cuối dòng khác với máy Mac, vì vậy
tệp có thể trông giống như một dòng dài đối với máy tính Unix.)

Trong các hướng dẫn này có rất nhiều sự linh hoạt. Bạn có thể đặt Bcc :, X-Face :, hoặc bất kỳ
tiêu đề khác trong tiêu đề. Bạn có thể đặt những thứ như Cc: [yourname] trong tiêu đề. Thì là ở
sáng tạo. Chỉ cần không đưa bất cứ thứ gì vào đó mà bạn không muốn quản trị viên web của mình nhìn thấy,
bởi vì đó là nơi các tin nhắn bị trả lại đi đến.

Bây giờ, hãy tiếp tục và tải mẫu e-mail của bạn lên máy chủ WWW và xem xét nó với
Trình duyệt WWW.

Đặt a Link đến các mẫu on qua một vài thao tác đơn giản về .
Đây là một ví dụ:

Bạn có muốn đi qua cầu không? Tải xuống biểu mẫu "câu hỏi ba" của tôi và gửi đến
<[email được bảo vệ]>.

Ngay cả sau khi bạn tạo biểu mẫu WWW của mình, bạn sẽ muốn để lại liên kết này để tăng
khả năng tiếp cận người dùng khuyết tật.

Quyết định if a mailto: Link sẽ làm.
Hiện tại, không cần bất kỳ HTML phức tạp nào, bạn có một cách để mọi người trên WWW gửi cho bạn
thông tin bạn muốn. Trước khi bạn cố gắng tạo một biểu mẫu HTML, hãy quyết định xem
nó thực sự đáng giá. Các biểu mẫu trên WWW có hai nhược điểm cụ thể:

· Bạn sẽ nhận được rất nhiều e-mail phù phiếm từ những người chỉ đơn thuần là `` lướt web ''.

· Địa chỉ e-mail của người dùng được nhập theo cách thủ công và thường bị gõ sai, do đó bạn có
không có cách nào để trả lời. Đây là ít vấn đề hơn với các liên kết mailto:.

Tạo các HTML hình thức.
Nếu bạn đã quyết định tạo một biểu mẫu HTML, bạn cần cung cấp cho mọi người một cách để cung cấp
địa chỉ email. Với liên kết mailto:, bưu phẩm của họ sẽ cung cấp địa chỉ From: cho
họ. Nhưng bây giờ bạn cần thêm một dòng vào đầu mẫu e-mail của mình như sau:

Từ: [email]

Đây là một mẫu HTML mẫu.

Địa chỉ email của bạn: ____________________

Tên của bạn: ____________________

Nhiệm vụ của bạn: ____________________

Màu yêu thích của bạn: ____________________

Gửi e-mail (Ví dụ này không thực sự gửi e-mail.)

Đây là nguồn HTML:

<PHƯƠNG PHÁP MẪU="ĐĂNG"
ACTION = "http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

Địa chỉ email của bạn:
Tên của bạn:
Nhiệm vụ của bạn:
Màu yêu thích của bạn:



Đây là một ví dụ rất đơn giản. Lưu ý rằng TÊN của mỗi đầu vào tương ứng với những gì bạn
trước đó đã được đưa vào mẫu e-mail. Trong ví dụ này, chúng là email, tên của bạn, nhiệm vụ,
và màu sắc. Đây là khái niệm quan trọng trong việc sử dụng cgiemail. Hãy cẩn thận để làm cho chúng chính xác
tương tự; nếu bạn đặt NAME = "color" trong biểu mẫu HTML của mình và [color] (lưu ý chính tả
khác biệt) trong mẫu e-mail của bạn, thông tin đầu vào sẽ không hiển thị trong e-mail.

Tạo chi tiết tiên tiến HTML các hình thức.
Để tìm hiểu cách tạo các biểu mẫu phức tạp hơn, hãy đọc hướng dẫn của NCSA. Tất cả các mẫu ví dụ của họ
có thể được chuyển đổi sang dạng cgiemail chỉ bằng cách thay đổi ACTION. Không giống như các hình thức khác
chương trình email, bạn không bắt buộc phải sử dụng các đầu vào ẩn với các tên đặc biệt.

Tất cả các loại đầu vào (nút radio, v.v.) hoạt động theo cùng một cách. Mỗi đầu vào cần một TÊN và
tên đó phải xuất hiện trong dấu ngoặc vuông trong mẫu e-mail của bạn. Nó đơn giản mà. Đến
để có thêm ý tưởng, hãy xem trang ví dụ về cgiemail.

Hãy chắc chắn các HÀNH ĐỘNG is chính xác.
Phần khó nhất của biểu mẫu HTML là đặt ACTION một cách chính xác. Bắt đầu với
URL của mẫu e-mail của bạn, sau đó chia nó thành hai phần, ví dụ:

http://web.mit.edu/wwwdev/cgiemail/questions3.txt
\ / \ /
`--- Phần 1 --- '' -------- Phần 2 ---------- '

Sau đó, bạn đặt tên script ở giữa. Thông thường đây là `` / cgi-bin / cgiecho '', nhưng nó
phụ thuộc vào cách máy chủ của bạn được cấu hình. Trên web.mit.edu, tình cờ là
`` / bin / cgiecho '', do đó ACTION của tôi trông như thế này:

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ / \ / \ /
`--- Phần 1 --- 'tên kịch bản' -------- Phần 2 ---------- '

Để đơn giản, bạn có thể bỏ qua phần 1, nhưng bạn phải bao gồm nó nếu bạn muốn kiểm tra
dưới dạng tệp cục bộ. Nếu bạn không biết điều đó có nghĩa là gì, vui lòng bỏ qua phần 1.

Thử ra qua một vài thao tác đơn giản về hình thức với cgiecho.
Đưa biểu mẫu của bạn vào trình duyệt WWW yêu thích của bạn, điền thông tin đầu vào và gửi biểu mẫu đó. Bạn
nên xem biểu mẫu đã xử lý trông như thế nào. Nếu thay vào đó, bạn thấy lỗi với một số
gần 500, ACTION của bạn có thể được đặt sai. Quay lại bước trước.

Nếu một số thông tin đầu vào của bạn dường như không hiển thị trong biểu mẫu đã xử lý, hãy đảm bảo rằng
các đầu vào có cùng tên trong biểu mẫu HTML như trong mẫu ASCII. Ví dụ
NAME = "tên của bạn" trong biểu mẫu HTML và [tên của bạn] trong mẫu e-mail.

Go sống với cgiemail.
Bây giờ hãy thay đổi cgiecho thành cgiemail trong ACTION của biểu mẫu HTML của bạn. Hãy thử nó ra. Bạn nên
nhận một tin nhắn e-mail với biểu mẫu đã xử lý. Nếu bạn nhận được một trang thành công nhưng không
nhận được thư, có một số vấn đề với tệp mẫu của bạn. Quay lại và chắc chắn rằng bạn
đã làm theo đúng các hướng dẫn ở bước 1.

Nếu nó hoạt động, xin chúc mừng!

9. Gỡ lỗi nếu bạn không nhận được thư

Thông thường, thư được gửi không đồng bộ, có nghĩa là nó đi vào hàng đợi để được gửi tại
thời gian thuận tiện. Thư không đồng bộ được gửi hiệu quả và đáng tin cậy hơn, nhưng có
nhược điểm là các vấn đề chỉ có thể được báo cáo bằng cách gửi thư thông báo lỗi trở lại
người gửi. Đối với hệ thống thư, có vẻ như người gửi thư là máy chủ web, vì vậy
thông báo lỗi sẽ không đến với bạn.

Nếu bạn không nhận được thư, bạn có thể tạm thời sử dụng gửi thư đồng bộ bằng cách tạo
một đầu vào ẩn có tên cgiemail-mailopt và cung cấp cho nó một giá trị có chứa "đồng bộ hóa", ví dụ:



Lưu ý: Đối với bản phát hành 1.1, điều này sẽ không hoạt động. Yêu cầu quản trị viên web của bạn cài đặt bản phát hành mới hơn.
Một số người gửi thư có phần mở rộng không chuẩn sẽ gửi thư trả lại đến một địa chỉ trong Lỗi-
To: tiêu đề ngoài máy chủ web. Tuy nhiên, một số lỗi làm cho dòng tiêu đề này
không thể đọc được, vì vậy không có cách nào để chắc chắn rằng số trang không truy cập sẽ đến với bạn.

Tùy chọn: Thêm văn bản đến các thành công .
Khi thư được gửi đi, một trang có tiêu đề `` Thành công '' sẽ xuất hiện cùng với nội dung của thư e-mail.
Bạn có thể sử dụng một biến ẩn được gọi là `` phụ lục '' để thêm văn bản của riêng bạn. Đây là một đơn giản
thí dụ:



Nếu bạn sẵn sàng cho rằng người đọc biểu mẫu của bạn đang sử dụng phần mềm trình duyệt gần đây
như Lynx 2.6 hoặc Netscape 3.0, thì bạn có thể đặt đánh dấu HTML vào biến này bằng cách sử dụng
các thực thể ký tự thích hợp. Ví dụ: nếu bạn muốn thêm

Cảm ơn bạn!

thì đánh dấu HTML sẽ là

Cảm ơn bạn!

nghĩa là bạn sẽ cần những thứ sau trong biểu mẫu của mình:

<INPUT LOẠI="ẩn" NAME="phụ lục"
VALUE = "<em> Cảm ơn bạn! </em>">

Lưu ý rằng ngoài việc khó viết, tính năng này sẽ không hoạt động đối với những người sử dụng cũ hơn
phần mềm trình duyệt.

Tùy chọn: Sử dụng an luân phiên thành công .
Nếu bạn không thích trang mặc định xuất hiện khi email được gửi thành công, bạn có thể
chỉ định một URL thay thế bằng cách sử dụng một biến ẩn có tên là `` thành công '' trong biểu mẫu HTML của bạn,
ví dụ

<INPUT TYPE="ẩn" NAME="thành công" VALUE="http://web.mit.edu/">

Lưu ý: Bắt đầu URL của bạn bằng / hoặc bằng http: //. Nếu không, cgiemail sẽ điều hướng trình duyệt của bạn
đến một lệnh gọi thứ hai của cgiemail, dẫn đến lỗi Không có thay thế biến.

Kể từ bản phát hành 1.3, không có cách nào để làm cho trang thành công thay thế này chứa thông tin
người dùng đã gửi trong biểu mẫu. Tính năng này có thể sẽ được thêm vào trong một bản phát hành trong tương lai.

Tùy chọn: Hãy một số đầu vào yêu cầu.
Nếu bạn muốn tự động từ chối các biểu mẫu với một số đầu vào nhất định bị bỏ trống, hãy thêm
tiền tố `` bắt buộc- '' vào tên của đầu vào trong cả biểu mẫu HTML và e-mail của bạn
bản mẫu. Đây là một ví dụ:

Ở dạng HTML:

Tên của bạn:

Trong mẫu e-mail

Tên của bạn: [started-yourname]

Tùy chọn: Chỉ định định dạng cho một số đầu vào.
Nếu, trong mẫu e-mail của bạn, văn bản bên trong dấu ngoặc vuông bắt đầu bằng%, cgiemail sẽ
sử dụng printf () hàm trong C trên tên trường sau dấu phẩy. Nếu bạn không quen
với chức năng này, hãy tìm trong một cuốn sách về C. Nếu bạn đã quen thuộc với nó, hãy lưu ý những
hai điểm khác biệt:

· Ký tự đầu tiên trong chuỗi định dạng phải là%.

· Các ký tự như \ n và \ t phải là chữ. Nếu bạn muốn có một dòng mới, bạn phải đặt một
dòng mới ngay trước dấu phẩy, mặc dù điều này trông lạ. Ví dụ, nếu
Godzilla's Pizza muốn các lớp trên cùng được liệt kê một cái trên mỗi dòng, họ sẽ đặt những thứ sau vào
mẫu e-mail của họ:

[%NS
,Cao sang]

Tùy chọn: Sử dụng CGI môi trường biến.
Tính năng này có thể hoạt động hoặc không, tùy thuộc vào việc quản trị viên web của bạn có bật tính năng này hay không
khi cấu hình cgiemail.

Ngoài đầu vào biểu mẫu, mẫu e-mail của bạn có thể bao gồm các biến môi trường CGI
đơn giản bằng cách đặt trước tên của biến bằng một ký hiệu đô la. Ví dụ,

[$ HTTP_USER_AGENT]

sẽ đặt tên của trình duyệt và / hoặc cổng vào của người dùng trong thư e-mail của bạn. Để
tôn trọng quyền riêng tư, biểu mẫu HTML của bạn phải cảnh báo người dùng về bất kỳ thông tin nào về
chúng sẽ được bao gồm trong e-mail, ví dụ như HTTP_USER_AGENT, REMOTE_ADDR.

hành chính
Liên hệ thượng nguồn: cgiemail[email được bảo vệ]>

Người bảo trì Debian: Anibal Monsalve Salazar[email được bảo vệ]>

Thông tin đầy đủ về xây dựng, cài đặt và sử dụng cgiemail có sẵn trên WWW:

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

Sử dụng cgifile trực tuyến bằng các dịch vụ onworks.net