英语法语西班牙语

运行服务器 | Ubuntu > | Fedora > |


OnWorks 网站图标

ikiwiki - 云端在线

通过 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器在 OnWorks 免费托管服务提供商中运行 ikiwiki

这是 ikiwiki 命令,可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行,例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器

程序:

名称


ikiwiki - 一个 wiki 编译器

概要


ikiwiki [选项] 源目的地

ikiwiki --setup setupfile [选项]

商品描述


ikiwiki 是一个 wiki 编译器。 它从 wiki 中的源代码构建静态 HTML 页面
ikiwiki/Markdown 语言(或其他语言),并将其写到目的地。

请注意,大多数选项可以缩短为单个字母,布尔标志,例如 --verbose
可以用--no-verbose 否定,像--verbose 这样的选项也可以拼写为
- 冗长。

MODE 配置


这些选项控制 ikiwiki 的运行模式。

- 刷新
刷新 wiki,更新任何更改的页面。 如果没有,这是默认行为
指定了其他模式操作(但请注意 --setup 是模式操作,并且具有
不同的默认行为)。

- 重建
强制重建所有页面。

--setup 安装文件
从给定的安装文件加载选项。 如果没有指定其他模式动作,
生成包装器并重建维基,就像使用了 --rebuild --wrappers 一样。 如果
您只想构建任何更改的页面,您可以使用 --refresh 和 --setup。

--changesetup 设置文件
读取设置文件,添加其他选项指定的任何配置更改,
并将新配置写回安装文件。 还更新任何
配置的包装器。 在这种模式下,维基不会完全重建,除非你也
添加--重建。

例如,启用一些插件:

ikiwiki --changesetup 〜/ ikiwiki.setup --plugin 商品 --plugin 日历

--dumpsetup 安装文件
使 ikiwiki 写入指定的安装文件,转储其当前
组态。

--包装器
如果与 --setup --refresh 一起使用,这也会更新任何配置的包装器。

- 干净的
这使得 ikiwiki 通过删除它在目标中生成的任何文件来清理
目录,以及任何配置的包装器,以及 .ikiwiki 状态目录。
如果您在 Makefile 中运行 ikiwiki 来构建,这将非常有用
文档并想要一个相应的干净目标。

--cgi 启用 CGI 模式。 在 cgi 模式下 ikiwiki 作为 cgi 脚本运行,并支持编辑
页面、登录和注册。

要将 ikiwiki 用作 CGI 程序,您需要使用 --wrapper 或 --setup 来生成
包装纸。 包装器通常需要向拥有该文件的用户运行 suid 6755
源目录和目标目录。

--wrapper [文件]
生成一个硬编码的包装二进制文件来执行另一个指定的操作
选项,使用指定的输入文件和目标目录。 文件名到
用于包装器是可选的。

包装器被设计为安全的 suid 并由不受信任的用户运行,作为
提交后挂钩,或作为 CGI。

请注意,生成的包装器将忽略所有命令行参数。

- 总计的
如果启用了插件/聚合插件,则会配置 ikiwiki 投票
馈送并将新帖子保存到 srcdir。

请注意,要重建以前聚合的帖子,请使用 --rebuild 选项
有了这个。 --rebuild 也会强制对提要进行轮询,即使它们是
最近投票。

--渲染文件
呈现单个文件,输出结果 html。 不保存状态,所以这个
不能用于构建整个 wiki,但它对于预览编辑过的
命令行中的文件。 一般与--setup结合使用以加载到
维基的设置:

ikiwiki--设置 〜/ ikiwiki.setup --render foo.mdwn

--提交后
在 post-commit 模式下运行,就像被 post-commit 钩子调用一样。 这是
可能仅在将 ikiwiki 与一台主机和一台主机上的 Web 服务器一起使用时有用
存储库上的另一个,以允许存储库的真正提交后挂钩到 ssh
Web 服务器托管并手动运行 ikiwiki 以更新网站。

- 版
打印 ikiwiki 的版本号。

配置 配置


这些选项配置维基。 注意插件可以添加额外的配置
他们自己的选择。 所有这些选项以及更多选项也可以使用
设置文件。

--wikiname 名称
wiki 的名称,默认为“wiki”。

--templatedir 目录
指定存储模板的目录。默认为
/usr/share/ikiwiki/templates,或构建时配置的其他位置。 如果
模板目录已更改,仍然会在模板中搜索丢失的模板
默认位置作为后备。 模板也可以放在“templates/”中
srcdir 的子目录。

请注意,如果您选择复制和修改 ikiwiki 的模板,您将需要
在升级到新版本的 ikiwiki 时,请注意保持它们是最新的。 老的
模板版本并不总是适用于新的 ikiwiki 版本。

--underlaydir 目录
指定用于底层源目录的目录。 源文件
除非被源目录中的文件覆盖,否则将从这里获取。
默认为 /usr/share/ikiwiki/basewiki 或构建时配置的其他位置
时间。

--wrappermode 模式
指定在创建包装器后将其 chmod 到的模式。

--wrappergroup 组
指定包装器应属于哪个 unix 组。 如果
包装器需要由默认组以外的组拥有。 例如,如果一个
项目有一个包含多个提交者的存储库,其访问权限由一个
组,让 ikiwiki 包装器运行 setgid 到该组是有意义的。

--rcs=svn|git|.., --no-rcs
启用或禁用修订控制系统的使用。

源目录将被假定为工作副本、克隆或其他任何内容
您选择的版本控制系统使用。

在 CGI 模式下,启用版本控制系统,通过网络编辑的页面将
做出承诺。

默认情况下不启用版本控制。

--svnrepo /svn/wiki
指定 wiki 的 svn 存储库的位置。

--svnpath 主干
指定 svn 存储库中 wiki 所在的路径。 这个
默认为中继; 如果您的 wiki 在其他路径中,请更改它
存储库。 如果您的 wiki 位于存储库的顶部,请将 svnpath 设置为“”。

--rss, --norss
如果设置了 rss,ikiwiki 将默认为内联的页面生成 RSS 提要
博客。

--allowrss
如果设置了allowrss,而没有设置rss,ikiwiki不会默认生成RSS
feeds,但是在 inline 指令中设置 rss=yes 可以覆盖这个默认值和
生成提要。

--atom, --noatom
如果设置了 atom,ikiwiki 将默认为内联页面生成 Atom 提要
一个博客。

--allowatom
如果设置了allowatom,而没有设置rss,ikiwiki不会默认生成
Atom 提要,但在内联指令中设置 atom=yes 可以覆盖此默认值
并生成一个提要。

--pingurl 网址
将此设置为 XML-RPC 服务的 URL,以便在 RSS 提要更新时进行 ping。 为了
例如,要 ping Technorati,请使用 URL http://rpc.technorati.com/rpc/ping

可以多次指定此参数以指定多个 URL
平。

--url 网址
指定 wiki 的 URL。 这是 CGI 模式下的必需参数。

--cgiurl http://example.org/ikiwiki.cgi
指定 ikiwiki CGI 脚本包装器的 URL。 构建时需要
wiki 链接到要生成的 cgi 脚本。

--historyurl 网址
指定要链接到页面历史记录浏览的 URL。 在 URL 中,“[[file]]”是
替换为要浏览的文件。 为此,通常使用 ViewVC。

--管理员邮箱 你@example.org
指定 ikiwiki 用于发送电子邮件的电子邮件地址。

--diffurl 网址
指定要链接到页面更改差异的 URL。 在网址中,
“[[file]]”替换为要浏览的文件,“[[r1]]”是旧版本
页,“[[r2]]”是新修订版。 为此,通常使用 ViewVC。

--排除正则表达式
指定要从处理中排除的源文件的 rexexp。 可以指定
多次添加到排除列表。

--包含正则表达式
指定源文件的 rexexp,通常会被排除,但您
希望包括在处理中。 可以多次指定以添加到包含
名单。

--管理员用户名
指定用户名(或者,如果启用了 openid,则为 openid)
维基管理员的权力。 目前允许锁定任何页面,并禁止用户,因为
以及启用的插件授予的权力(例如 [[moderating
评论|插件/审核评论]] 和插件/网络设置。 可以指定
多个管理员多次。

对于 openid 用户,请指定登录的完整 URL,包括“http://”。

--插件名称
允许在 wiki 中使用指定的插件。 请注意,插件名称是
区分大小写。

--disable-plugin 名称
禁用插件的使用。 例如“--disable-plugin htmlscrubber”来取消
使用 HTML 清理。

--libdir 目录
使 ikiwiki 在常规位置之前先在指定目录中查找
加载库文件和插件时。 例如,如果您将 libdir 设置为
“/home/you/.ikiwiki/”,你可以安装一个 foo.pm 插件作为
“/home/you/.ikiwiki/IkiWiki/Plugin/foo.pm”。

--讨论,--不讨论
启用或禁用“讨论”链接被添加到每个
页。 默认情况下启用链接。

--numbacklinks n
控制应在页面底部显示多少个反向链接。 过量的
反向链接将隐藏在弹出窗口中。 默认值为 10。设置为 0 以禁用此功能
功能。

--userdir 子目录
(可选)允许指向 wiki 用户的链接链接到
维基的子目录。 默认是链接到顶级目录中的页面
维基的。

--htmlext html
配置用于生成的 html 文件的扩展名。 默认为“html”。

--timeformat 格式
指定如何显示时间或日期。 格式字符串传递给
时间(3) 功能。

--verbose, --no-verbose
详细说明正在做的事情。

--系统日志,--无系统日志
登录 系统日志(3)。

--usedirs, --no-usedirs
切换创建名为 page/index.html(默认)而不是 page.html 的输出文件。

--prefix-directives, --no-prefix-directives
为预处理器指令切换新的 '!' 前缀语法。 目前 ikiwiki
默认为 --prefix-directives。

--w3mmode, --no-w3mmode
启用 w3mmode,它允许 w3m 将 ikiwiki 用作本地 CGI 脚本,而无需
网络服务器。

--sslcookie
仅通过 SSL 连接发送 cookie。 这应该可以防止他们被
拦截。 如果启用此选项,则必须至少运行 CGI 部分
ikiwiki 通过 SSL。

--gettime, --no-gettime
从修订版中提取每个新页面的创建和修改时间
控制日志。 这是在第一次构建 wiki 时自动完成的,
所以你通常不需要使用这个选项。

--set var=值
这允许设置任意配置变量,就好像它被设置一样
通过安装文件。 由于最常用的选项可以使用配置
命令行开关,您很少需要使用它。

--set-yaml 变量=值
这类似于 --set,但它允许设置使用复杂的配置变量
数据结构,通过传入 YAML 文档。

示例


ikiwiki --setup my.setup

使用指定的安装文件完全(重新)构建 wiki。

ikiwiki --setup my.setup --refresh
使用 my.setup 中的设置刷新 wiki,并避免重建任何页面
没有改变。 这更快。

ikiwiki --setup my.setup --refresh --wrappers
刷新 wiki,包括重新生成所有包装程序,但不要重建
所有页面。 如果您更改了安装文件中的某些内容而不是
需要一个完整的 wiki 重建来更新所有页面,但你想立即采取
效果。

ikiwiki --rebuild srcdir destdir
使用 srcdir 作为源并在 destdir 中构建 HTML,而不使用安装文件。

ikiwiki srcdir 目标目录
使用 srcdir 作为源来更新 destdir 中更改页面的 HTML,而不使用
设置文件。

环境


CC

这控制了使用什么 C 编译器来构建包装器。 默认值为“cc”。

CFLAGS 这可用于在构建包装器时将选项传递给 C 编译器。

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


Ad


Ad