wml - 云端在线

程序：

您的姓名

WML - 网站元语言

VERSION

2.0.12（16 年 2008 月 XNUMX 日）

概要

微信 [-I PATH[-i PATH[-D 您的姓名=STR[-D 您的姓名~PATH[-n[-r[-O 水平[-o
[切片术语":"]PATH[@CHMODOPT]][-P PATH[-E PATH[-t[-p STR[-W STR[-s[-v [民]]
[-q[输入文件]

微信 [-V [民]][-h]

商品描述

这是控制程序 您的网站 目标 语言 (WML)，免费的 HTML 生成
Unix 工具包，内部由 9 种独立语言组成。

WML 的主要思想是一种顺序过滤方案，其中每种语言提供一种
9道加工工序。 所以 微信 读 输入文件 （或来自 标准输入 if 输入文件 是破折号或
完全丢失），应用 1-9 次（或仅由 -p），最后
产生一个或多个 输出文件s.

有关此处理方案的更多详细信息，请阅读 WML 介绍 下 wml_介绍(7)
和 WML 教程 下 wml_教程（7）。

配置

-I, --包括=PATH
添加一个 目录 到用户包含路径列表。 使用此选项设置运行时
pass 1 的环境。见 wml_p1_ipp(3) 了解更多详情。

-i, --包含文件=PATH
预加载特定的包含 文件, 即实际上增加了一个

#include "路径"

在顶部 输入文件. 使用它来自动包含默认用户包含文件。
如果要包含系统包含文件，则必须将 PATH 带角度
括号，例如使用``"-i" " "'' 包含文件 foo/bar.wml
从系统包括区域。 或者，您可以使用特殊语法
``"wml::foo::bar"'' 与“#use”指令一样。

-D, --定义=您的姓名=STR
定义一个变量，该变量可以通过“$(NAME)”在 pass 1 (IPP) 中插入，在 pass 2
(mp4h) 通过 <"get-var NAME">，在 pass 3 (ePerl) 通过 "<:=$NAME:>" 和 pass 4 (GNU m4)
通过“m4_NAME”。 一个特殊的变种 --定义=您的姓名=UNDEF 相反，它删除
以前的定义（可能与取消定义这些变量不同，例如
与系统定义的变量）。

-D, --定义=您的姓名~PATH
与上述类似，但定义了一个保存自动调整的路径名的变量
（见下文）。 它可以以与“NAME=STR”变体相同的方式插入
以上。

-n, --诺舍邦
这迫使 WML 忽略中可能包含的 shebang 行 输入文件。 这是
通常由 WMk 使用，因为 WMk 已经解析了这一行并提供了选项
WML。

-r, --norc文件
这迫使 WML 忽略所有 .wmlrc 文件。

-c, --nocd
当 WML 处理来自另一个目录的输入文件时，它会跳转到该目录
解析前 .wmlrc 文件，然后跳回当前目录。 如果这个选项
设置，不进行目录更改，并且 .wmlrc 相对于当前读取文件
工作目录。

-O, --优化=民
这是直接传递给 pass 8 (htmlfix）。 它
控制应用于生成的 HTML 的优化/剥离量
标记代码。

-o, --输出文件=切片术语:输出文件[@CHMODOPT]
这会将输出重定向到一个文件。 通常整个文件将被发送到 标准输出
（与“所有：-”相同）。 您可以多次使用此选项以输出多个
使用文件时 切片术语 作为切片的集合论项来确定哪个
内容将包含在每个特定的输出文件中。 可选的 CHMODOPT is
用于指定最终应用的选项 CHMOD 命令。 例如使用
``"u+x"'' 创建一个设置了执行位的文件（Apache 的 XBitHack 功能）。
我们 片(1) 了解更多详情。

-P, --序言=PATH
在输入文件上运行 prolog 过滤器。 该程序接收数据以采取行动
作为 STDIN 并且必须在 STDOUT 上生成过滤后的数据。

-E, --结语=PATH
在最终生成的输出文件上运行结语程序。 目前，
以下 WML 特定程序是已知的： html信息, 链接, 整洁 和 网络工具。但是品牌对其自身难以衡量的部分，无法做出有效提升
您可以指定“PATH”中可用的任何程序。 本节目收到
要用作其第一个命令行参数的文件。 请注意，输出不是
重定向到这个文件，所以你必须使用包装器或程序特定的标志，如果你
想修改输出文件。

-t, - 设置时间
这将所有输出文件的修改时间设置为
输入文件 加1秒。 这很有用，因为 Web 服务器会生成
“Last-Modified”标题和编辑时间比编辑时间更重要
世代时间。 1 秒偏移量用于 Makefile 的依赖项。

-M, - 依靠[=配置]
输出一个适合“make”的规则来描述每个输出文件的依赖关系，如
`gcc' 可以。 只有当 -o 选项被使用。 没有进行任何处理
除了第一关。

D flag 选项将规则写入依赖文件。 这个文件的名字是
通过用“.d”替换输出文件的后缀获得。

M flag 选项从依赖项列表中删除系统文件。

-p, --通过=STR
指定在运行时实际应用上述哪些传递。 这
论点 STR 是一个以逗号分隔的通行号码列表，有一个特殊情况：您可以
为所有通行证“X ... Y”写下“XY”。 当第 9 关不属于 STR 结果
输出写入 标准输出. 默认是字符串“"1-9"”。

-W, --密码选项=民,STR
设置选项 STR 通行证 民.

-s, - 安全的
这禁用了 WML 中的一些 Perl hacks，它们通过减少
运行各种通行证时分叉开销。

如果没有这个选项，WML 会预编译传递 1,5,6,7,8、XNUMX、XNUMX、XNUMX、XNUMX（它们是用 Perl 编写的！）
进入当前运行的 Perl 解释器的不同命名空间，而不是
通过“system()”在外部运行它们。 效果是这些程序是从
在同一个 Perl 解释器中，从而节省了五个 CPU 和时间密集型的“fork()”。
实际增益在 2 到 4 秒的处理时间之间。 虽然经历
表明它工作得很好，理论问题仍然是，这种方法是
由于内部 Perl 变量冲突，有些风险。

使用此选项通过强制 WML 使用安全的“fork()”来禁用这些加速
的方法。

-v, --详细[=民]
这将设置详细模式（从 1 到 9），其中将提供一些处理信息
在控制台上。 用于调试。 这个选项也被传递给一些
过滤程序。 默认是没有冗长的，只是 -v 手段 -v1.

-q, - 安静的
这将设置不再显示处理道具的安静模式。 用这个
运行时的选项 微信 作为批处理作业。 此选项在以下情况下自动强制
输入文件 不见了。 然后 WML 自动从 标准输入 在安静模式下。

-V, - 版[=民]
提供版本标识字符串和免责声明（没有 民 or 民 >= 1)，WML
构建信息（民 >= 2) 和 Perl 构建信息 (民 >= 3)。 用这个
获取已安装 WML 系统的简要描述的选项，尤其是在
向作者报告错误。

-h, - 帮帮我
打印使用情况摘要页。

环境

定义 变数
以下变量总是由 微信 在运行时，通常是
通过 Pass 2 中的 <"get-var NAME"> 和 Pass 3 中的 $NAME 插入。

WML_SRC_DIRNAME
当前工作目录来自哪里 微信 开始了。 绝对的 Unix 文件系统
路径。

WML_SRC_FILENAME
的名字 输入文件 从命令行。 运行时有用 微信 在大部分
files 和 includefile 必须确定它们包含在哪个中。

WML_SRC_BASENAME
的基本名称 输入文件，即“WML_SRC_FILENAME”，但带有扩展名
已经剥了。

WML_SRC_TIME
最后修改时间为 输入文件 以“时间（）”格式。 有用的内页脚
当需要自定义日期格式时。

WML_SRC_CTIME
最后修改时间为 输入文件 以“ctime()”格式。 有用的内页脚
包含文件。

WML_SRC_ISOTIME
最后修改时间为 输入文件 ISO“yyyy-mm-dd hh:mm:ss”格式。 有用
页脚内包含文件。

WML_SRC_USERNAME
拥有的用户的 Unix 用户名 输入文件.

WML_SRC_REALNAME
拥有的用户的真实姓名 输入文件.

WML_GEN_TIME
“time()”格式的当前生成时间。 有用的内页脚，当
需要自定义日期格式。

WML_GEN_CTIME
“ctime()”格式的当前生成时间。 有用的内部页脚包括
文件。

WML_GEN_ISOTIME
ISO“yyyy-mm-dd hh:mm:ss”格式的当前生成时间。 有用的里面
页脚包括文件。

WML_GEN_USERNAME
运行该用户的 Unix 用户名 微信 的过程。

WML_GEN_REALNAME
运行用户的真实姓名 微信 的过程。

WML_GEN_HOSTNAME
主机名 微信 命令运行。

WML_LOC_PREFIX
WML 在构建时安装到的位置前缀。

WML_LOC_BINDIR
WML 二进制文件在构建时安装到的目录。

WML_LOC_LIBDIR
WML 的库文件在构建时安装到的目录。

WML_LOC_DATADIR
WML 数据文件在构建时安装到的目录。

WML_LOC_MANDIR
WML 手册页在构建时安装到的目录。

WML_VERSION 版本
WML 的版本标识字符串。 例如在 HTML 注释中使用它
内部标头包括标识生成工具版本。

用过的 变数
“WMLOPTS”
该变量可以包含一串选项。 通常这被 Bourne-Shell 使用
用户喜欢

$ WMLOPTS="-DNAME1=VALUE2 -DNAME2=VALUE2"
$ 出口WMLOPTS

并受到 C-Shell 用户的喜欢

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

确保为所有运行定义了一些变量 微信.

“寻呼机”
此变量包含 WML 将使用的寻呼机。 WML 在调用时使用寻呼机
--详细=民 or -v民 选项分别和 民 是 3 或更高，因此
显示每次通过后处理的数据。 默认值为“更多”。

“TMPDIR”
此变量包含 WML 存储其临时文件的目录。默认值为
'/ tmp目录'.

USER FILES

$HOME/.wmlrc 和 (../)*.wmlrc
这些文件还可以包含选项字符串，每行一个选项。 通常情况下
内容是一个或多个 -D 选项，尤其是自动调整的选项：

-DROOTREL~。
-DROOTABS=http://thishost/thisarea/
:
-DNAME1=值1
-DNAME2=值2
:

标准 包括 FILES

WML 附带了一组标准的包含文件。 您可以通过以下方式直接包含它们

#使用 wml::category::name

并通过阅读他们自己的文档

$ man wml::类别::名称

我们 .wml::所有(3) 所有可用的包含文件的描述。

特别 特点

WML 控件前端本身提供了一些特殊功能：

社帮线支持
WML 识别一个 家当 行 (``"#!wml" 选项''） 在里面 .wml 文件和
自动添加 选项 到它的命令行。 WMk 也使用此行。 二
与 Unix 加载程序的 shebang 行相比的特殊功能是可用的：WML's
shebang 行可以通过反斜杠字符和结构 %DIR 和
% 被插入（其中 %DIR 是源目录的路径，而
驻留，%BASE 是源文件的文件名，没有任何扩展名）。

示例：

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

数据保护容器标签
WML 提供了一个自己的内部容器标签，名为“
[pass=SPEC]>"..." " 可用于保护任何类型的数据不被
由任何 WML 传递处理。 当没有给出“pass”属性时 SPEC 默认为“1-9”。
当你使用“pass”时 SPEC 可以是“#-”、“-#”、“#-#”或逗号分隔
通过列表，而“#”可以在 1 到 9 之间。

示例：



...
输出 = " " + help_string + " ”
...



警告：

从 WML 2.0.3 开始，pass 1 包含额外的内容来帮助保存有关行的信息
相关数字（a la cpp）。 所以写的时候


#include 'foo'


这些额外的命令不会在第 2 轮期间被解释，并将保留在输出中。
要抑制它们，请使用“-W1，-N”标志进行编译，或编写


#include 'foo' IPP_NOSYNCLINES

作者

拉尔夫·S·恩格尔沙尔
[电子邮件保护]
www.engelschall.com

丹尼斯·巴比尔
[电子邮件保护]

使用 onworks.net 服务在线使用 wml