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

CHƯƠNG TRÌNH:

TÊN

WML - Ngôn ngữ META của Trang web

PHIÊN BẢN

2.0.12 (16-2008-XNUMX)

SYNOPSIS

wml [-I PATH] [-i PATH] [-D TÊN=STR] [-D TÊN~PATH] [-n] [-r] [-O cấp] [-o
[SLICÉTERM":"]PATH[@CHMODOPT]] [-P PATH] [-E PATH] [-t] [-p STR] [-W STR] [-s] [-v [NUM]]
[-q] [tập tin đầu vào]

wml [-V [NUM]] [-h]

MÔ TẢ

Đây là chương trình điều khiển của Website Kim loại Ngôn ngữ (WML), một thế hệ HTML miễn phí
bộ công cụ cho Unix, bên trong bao gồm 9 ngôn ngữ độc lập.

Ý tưởng chính của WML là một lược đồ lọc tuần tự trong đó mỗi ngôn ngữ cung cấp một trong các
9 đường chuyền xử lý. Vì thế wml đọc tập tin đầu vào (hoặc từ tiêu chuẩn if tập tin đầu vào là một dấu gạch ngang hoặc
hoàn toàn bị thiếu), áp dụng các đường chuyền 1-9 (hoặc chỉ các đường chuyền được chỉ định bởi -p) và cuối cùng
sản xuất một hoặc nhiều tập tin đầu ras.

Để biết thêm chi tiết về sơ đồ xử lý này, hãy đọc WML Giới thiệu Dưới wml_intro(7)
và WML Hướng Dẫn Dưới wml_tutorial(7).

LỰA CHỌN

-I, --bao gồm =PATH
thêm một thư mục vào danh sách người dùng bao gồm đường dẫn. Sử dụng tùy chọn này để đặt thời gian chạy
môi trường cho vượt qua 1. Xem wml_p1_ipp(3) để biết thêm chi tiết.

-i, --includefile =PATH
Tải trước một bao gồm cụ thể hồ sơ, tức là hầu như thêm một

#include "PATH"

ở đỉnh cao của tập tin đầu vào. Sử dụng điều này để tự động bao gồm các tệp bao gồm người dùng mặc định.
Nếu bạn muốn bao gồm một hệ thống bao gồm tệp, bạn phải bao quanh PATH với góc
dấu ngoặc, ví dụ sử dụng `` "-i" " "'' để bao gồm tệp foo / bar.wml
từ hệ thống bao gồm khu vực. Ngoài ra, bạn có thể sử dụng cú pháp đặc biệt
`` "wml :: foo :: bar" '' như với lệnh "#use".

-D, --define =TÊN=STR
Xác định một biến có thể được nội suy trong lượt 1 (IPP) qua "$ (NAME)", trong lượt 2
(mp4h) qua <"get-var NAME">, trong lượt 3 (ePerl) qua "<: = $ NAME:>" và trong lượt 4 (GNU m4)
qua "m4_NAME". Một biến thể đặc biệt --define =TÊN= UNDEF làm ngược lại, nó sẽ xóa
các định nghĩa trước đây (có thể khác với việc xác định các biến này, ví dụ:
với các biến do hệ thống xác định).

-D, --define =TÊN~PATH
Tương tự như trên nhưng xác định một biến có tên đường dẫn được tự động điều chỉnh
(xem bên dưới). Nó có thể được nội suy theo các cách giống như biến thể "NAME = STR" từ
ở trên.

-n, --noshebang
Điều này buộc WML bỏ qua một dòng shebang có thể chứa trong tập tin đầu vào. Đây là
thường được sử dụng bởi WMk, vì WMk đã phân tích cú pháp dòng này và cung cấp các tùy chọn cho
WML.

-r, --norcfile
Điều này buộc WML bỏ qua tất cả .wmlrc các tập tin.

-c, --nocd
Khi WML xử lý một tệp đầu vào từ một thư mục khác, nó sẽ nhảy vào thư mục đó
trước khi phân tích cú pháp .wmlrc và sau đó quay lại thư mục hiện tại. Nếu tùy chọn này
được thiết lập, không có thay đổi thư mục nào được thực hiện và .wmlrc các tệp được đọc tương tự như hiện tại
thư mục làm việc.

-O, --optimize =NUM
Đây là tùy chọn tối ưu hóa được chuyển trực tiếp để vượt qua 8 (sửa lỗi html). Nó
kiểm soát số lượng tối ưu hóa / loại bỏ được áp dụng cho HTML được tạo
mã đánh dấu.

-o, --outputfile =SLICÉTERM:tập tin đầu ra[@CHMODOPT]
Điều này chuyển hướng đầu ra thành một tệp. Thông thường toàn bộ tệp sẽ được gửi đến tiêu chuẩn
(giống như "TẤT CẢ: -"). Bạn có thể sử dụng tùy chọn này nhiều lần để xuất ra nhiều hơn một
tập tin trong khi sử dụng SLICÉTERM như một thuật ngữ lý thuyết tập hợp các lát để xác định cái nào
nội dung sẽ được đưa vào từng tệp đầu ra cụ thể. Tùy chọn CHMODOPT is
nhằm mục đích chỉ định các tùy chọn cho một cuối cùng được áp dụng chmod chỉ huy. Ví dụ sử dụng
`` "u + x" 'để tạo tệp với tập bit thực thi (tính năng XBitHack của Apache).
Xem lát(1) để biết thêm chi tiết.

-P, --prolog =PATH
Chạy bộ lọc prolog trên tệp đầu vào. Chương trình này nhận dữ liệu để hành động
dưới dạng STDIN và phải tạo ra dữ liệu đã lọc trên STDOUT.

-E, --epilog =PATH
Chạy một chương trình kết thúc trên các tệp kết quả cuối cùng. Hiện tại
các chương trình dành riêng cho WML sau đây được biết đến: htmlthông tin, liên kết, dọn dẹp ngăn nắp và tơ nhện. Nhưng
bạn có thể chỉ định bất kỳ chương trình nào có sẵn trong "PATH" của bạn. Chương trình này nhận được
tệp để hoạt động như đối số dòng lệnh đầu tiên của nó. Lưu ý rằng đầu ra không
được chuyển hướng đến tệp này, vì vậy bạn phải sử dụng trình bao bọc hoặc cờ chương trình cụ thể nếu bạn
muốn sửa đổi các tệp đầu ra.

-t, --cài đặt thời gian
Điều này đặt thời gian sửa đổi của tất cả các tệp đầu ra thành thời gian sửa đổi của
tập tin đầu vào cộng thêm 1 giây. Điều này rất hữu ích vì Máy chủ trang web sẽ tạo ra
Tiêu đề "Sửa đổi lần cuối" và ở đó thời gian chỉnh sửa quan trọng hơn
thời gian thế hệ. Phần bù 1 giây dành cho các phần phụ thuộc của Makefiles.

-M, --lệ thuộc[=LỰA CHỌN]
Đưa ra một quy tắc phù hợp để `` make '' mô tả các phần phụ thuộc của mỗi tệp đầu ra, như
`gcc 'không. Nó chỉ có ý nghĩa khi -o tùy chọn được sử dụng. Không có quá trình xử lý nào được thực hiện
ngoại trừ lần vượt qua đầu tiên.

Sản phẩm D tùy chọn cờ ghi quy tắc vào một tệp phụ thuộc. Tên của tệp này là
thu được bằng cách thay thế hậu tố của tệp đầu ra bằng ".d".

Sản phẩm M tùy chọn cờ xóa các tệp hệ thống khỏi danh sách các phần phụ thuộc.

-p, --pass =STR
Chỉ định cách vượt qua được mô tả ở trên thực sự được áp dụng trong thời gian chạy. Các
đối số STR là danh sách các số được phân tách bằng dấu phẩy với một trường hợp đặc biệt: Bạn có thể
viết "XY" cho tất cả các lần chuyển "X ... Y". Khi vượt qua 9 không phải là một phần của STR kết quả
đầu ra được ghi vào GIỚI THIỆU. Mặc định là chuỗi `` "1-9" ''.

-W, --passoption =NUM,STR
Đặt tùy chọn STR cho qua NUM.

-s, --an toàn
Điều này vô hiệu hóa một số thủ thuật Perl bên trong WML, giúp tăng tốc độ xử lý bằng cách giảm
rẽ nhánh khi chạy các đường chuyền khác nhau.

Nếu không có tùy chọn này, WML sẽ biên dịch trước các đường chuyền 1,5,6,7,8 (được viết bằng Perl!)
vào một không gian tên khác của trình thông dịch Perl hiện đang chạy thay vì
chạy chúng ra bên ngoài thông qua "system ()". Kết quả là các chương trình này được chạy từ
trong cùng một trình thông dịch Perl, do đó tiết kiệm được năm "fork ()" sử dụng CPU và thời gian.
Mức tăng thực tế là từ 2 đến 4 giây thời gian xử lý. Mặc dù kinh nghiệm
cho thấy rằng nó hoạt động tốt, vấn đề lý thuyết vẫn là, rằng cách tiếp cận này là
hơi rủi ro do xung đột biến Perl nội bộ.

Sử dụng tùy chọn này để tắt các tốc độ tăng tốc này bằng cách buộc WML sử dụng "fork ()" an toàn
tiếp cận.

-v, --dài dòng[=NUM]
Điều này đặt chế độ dài dòng (từ 1 đến 9) trong đó một số thông tin xử lý sẽ được cung cấp
trên bảng điều khiển. Hữu ích cho việc gỡ lỗi. Tùy chọn này cũng được chuyển cho một số
các chương trình lọc. Mặc định là không có chi tiết và chỉ -v có nghĩa -V1.

-q, --Yên lặng
Điều này đặt chế độ yên tĩnh, nơi giá đỡ xử lý không còn hiển thị. Dùng cái này
tùy chọn khi chạy wml như một công việc hàng loạt. Tùy chọn này tự động bị buộc khi
tập tin đầu vào bị mất tích. Sau đó, WML tự động đọc từ tiêu chuẩn ở chế độ yên tĩnh.

-V, --phiên bản[=NUM]
Cung cấp chuỗi nhận dạng phiên bản và tuyên bố từ chối trách nhiệm (không NUM or NUM > = 1), WML
xây dựng thông tin (NUM > = 2) và thông tin bản dựng Perl (NUM > = 3). Dùng cái này
để có được mô tả ngắn gọn về hệ thống WML đã cài đặt của bạn, đặc biệt là khi
báo cáo lỗi cho tác giả.

-h, --Cứu giúp
In trang tóm tắt sử dụng.

MÔI TRƯỜNG

ĐỊNH NGHĨA BIẾN
Các biến sau đây luôn được xác định bởi wml dưới thời gian chạy và thường là
nội suy qua <"get-var NAME"> bên trong Vượt qua 2 và qua $ NAME trong Vượt qua 3.

WML_SRC_DIRNAME
Thư mục làm việc hiện tại từ đâu wml đa băt đâu. Một hệ thống tệp Unix tuyệt đối
con đường.

WML_SRC_FILENAME
Tên của tập tin đầu vào từ dòng lệnh. Hữu ích khi chạy wml trên một phần lớn
tệp và các tệp bao gồm phải xác định chúng được bao gồm trong đó.

WML_SRC_BASENAME
Tên cơ sở của tập tin đầu vào, tức là "WML_SRC_FILENAME", nhưng có phần mở rộng
đã bị tước.

WML_SRC_TIME
Lần sửa đổi cuối cùng của tập tin đầu vào ở định dạng "time ()". Chân trang bên trong hữu ích
khi định dạng ngày tùy chỉnh là cần thiết.

WML_SRC_CTIME
Lần sửa đổi cuối cùng của tập tin đầu vào ở định dạng "ctime ()". Chân trang bên trong hữu ích
bao gồm các tệp.

WML_SRC_ISOTIME
Lần sửa đổi cuối cùng của tập tin đầu vào ở định dạng ISO "yyyy-mm-dd hh: mm: ss". Có ích
bên trong chân trang bao gồm các tệp.

WML_SRC_USERNAME
Tên người dùng Unix của người dùng sở hữu tập tin đầu vào.

WML_SRC_REALNAME
Tên thật của người dùng sở hữu tập tin đầu vào.

WML_GEN_TIME
Thời gian hiện tại của thế hệ ở định dạng "time ()". Hữu ích bên trong chân trang khi
định dạng ngày tùy chỉnh là cần thiết.

WML_GEN_CTIME
Thời gian tạo hiện tại ở định dạng "ctime ()". Chân trang bên trong hữu ích bao gồm
các tập tin.

WML_GEN_ISOTIME
Thời điểm hiện tại tạo ở định dạng ISO "yyyy-mm-dd hh: mm: ss". Hữu ích bên trong
chân trang bao gồm các tệp.

WML_GEN_USERNAME
Tên người dùng Unix của người dùng chạy wml quá trình.

WML_GEN_REALNAME
Tên thật của người dùng chạy wml quá trình.

WML_GEN_HOSTNAME
Tên của máy chủ lưu trữ trên đó wml lệnh chạy.

WML_LOC_PREFIX
Tiền tố vị trí nơi WML đã được cài đặt tại thời điểm xây dựng.

WML_LOC_BINDIR
Thư mục nơi các tệp nhị phân của WML đã được cài đặt tại thời điểm xây dựng.

WML_LOC_LIBDIR
Thư mục nơi các tệp thư viện của WML đã được cài đặt tại thời điểm xây dựng.

WML_LOC_DATADIR
Thư mục nơi các tệp dữ liệu của WML đã được cài đặt tại thời điểm xây dựng.

WML_LOC_MANDIR
Thư mục nơi các trang thủ công của WML đã được cài đặt tại thời điểm xây dựng.

WML_VERSION
Chuỗi nhận dạng phiên bản của WML. Ví dụ: sử dụng điều này trong các nhận xét HTML
tiêu đề bên trong bao gồm để xác định phiên bản công cụ tạo.

ĐÃ SỬ DỤNG BIẾN
"WMLOPTS"
Biến này có thể chứa một chuỗi các tùy chọn. Thường thì cái này được Bourne-Shell sử dụng
người dùng thích

$ WMLOPTS = "- DNAME1 = VALUE2 -DNAME2 = VALUE2"
$ xuất WMLOPTS

và bởi những người dùng C-Shell như

$ setenv WMLOPTS "-DNAME1 = VALUE2 -DNAME2 = VALUE2"

để đảm bảo một số biến được xác định cho tất cả các lần chạy wml.

"PAGER"
Biến này chứa máy nhắn tin mà WML sẽ sử dụng. WML sử dụng một máy nhắn tin khi được gọi với
--verbose =NUM or -vNUM tùy chọn tương ứng và NUM là 3 hoặc cao hơn và do đó
hiển thị dữ liệu đã xử lý sau mỗi lần vượt qua. Mặc định là 'nhiều hơn'.

"TMPDIR"
Biến này chứa thư mục mà WML lưu trữ các tệp tạm thời của nó. Mặc định là
'/ Tmp'.

USER CÁC TẬP TIN

$ HOME / .wmlrc và (../)*.wmlrc
Các tệp này cũng có thể chứa các chuỗi tùy chọn, một tùy chọn trên mỗi dòng. Thường thì
nội dung là một hoặc nhiều -D các tùy chọn, đặc biệt là những tùy chọn được điều chỉnh tự động:

-DROOTREL ~.
-DROOTABS =http://thishost/thisarea/
:
-DNAME1 = VALUE1
-DNAME2 = VALUE2
:

TIÊU CHUẨN BAO GỒM CÁC TẬP TIN

WML được vận chuyển cùng với một bộ tệp bao gồm tiêu chuẩn. Bạn có thể bao gồm trực tiếp chúng qua

#use wml :: category :: name

và đọc tài liệu của riêng họ qua

$ man wml :: category :: name

Xem wml ::tất cả các(3) để biết mô tả của tất cả các tệp bao gồm sẵn có.

DÒNG MÁY CÁN BIÊN DẠNG ĐẶT BIỆT TÍNH NĂNG, ĐẶC ĐIỂM

Giao diện người dùng điều khiển WML tự cung cấp một số tính năng đặc biệt:

Hỗ trợ đường dây Shebang
WML nhận ra một công việc dòng (`` "#! wml" lựa chọn'') bên trong .wml tập tin và
tự động thêm lựa chọn vào dòng lệnh của nó. Dòng này cũng được sử dụng bởi WMk. Hai
các tính năng đặc biệt trái ngược với các dòng shebang cho bộ tải Unix có sẵn:
dòng shebang có thể được tiếp tục thông qua một ký tự gạch chéo ngược và cấu trúc% DIR và
% được nội suy (trong đó% DIR là đường dẫn đến thư mục nguồn trong khi
cư trú và% BASE là tên tệp của tệp nguồn không có bất kỳ phần mở rộng nào).

Ví dụ:

#! wml -o (ALL-LANG _ *) + LANG_EN:% BASE.en.html \
-o (ALL-LANG _ *) + LANG_DE:% BASE.de.html

Thẻ vùng chứa bảo vệ dữ liệu
WML cung cấp một thẻ vùng chứa nội bộ riêng có tên "
[pass = SPEC]> "..." "có thể được sử dụng để bảo vệ bất kỳ loại dữ liệu nào
được xử lý bởi bất kỳ đường chuyền WML nào. Khi không có thuộc tính "pass" nào được cung cấp ĐẶC BIỆT mặc định là "1-9".
Khi bạn sử dụng "pass" thì ĐẶC BIỆT có thể là "# -", "- #", "# - #" hoặc được phân tách bằng dấu phẩy
danh sách các đường chuyền, trong khi "#" có thể từ 1 đến 9.

Ví dụ:



hữu ích. Cảm ơn !
đầu ra = " "+ help_string +" "
hữu ích. Cảm ơn !



Cảnh báo:

Kể từ WML 2.0.3, vượt qua 1 bao gồm các công cụ bổ sung để giúp lưu giữ thông tin về dòng
số có liên quan (a la cpp). Vì vậy, khi viết


#include 'foo'


các lệnh bổ sung này sẽ không được giải thích trong quá trình truyền 2 và sẽ vẫn ở trên đầu ra.
Để ngăn chặn chúng, hãy biên dịch với cờ "-W1, -N" hoặc viết


#include 'foo' IPP_NOSYNCLINES

TÁC GIẢ

Ralf S. Engelschall
[email được bảo vệ]
www.engelschall.com

Denis Barbier
[email được bảo vệ]

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