xwiki功能-文档生命周期

时间:2022-11-29 18:59:04

XWiki提供了对文档(即页面)执行多个动作。

创建

有三种方法来创建新的页面。

通过链接

你可以编辑已有的页面并创建一个链接到你的新页面(无论是在wiki模式或WYSIWYG模式)。由此产生的链接旁边会显示一个问号,其显示为不存在的页面。只需点击链接就能创建当前页面的子页面。

xwiki功能-文档生命周期

这将直接带你到不存在页面的编辑模式。这是推荐的方法,因为它会允许你在创建新页面的时候创建一个层次结构。

从XWiki 企业2.4开始,对于用户和应用程序能够提供模板来创建页面。新页面的内容(内容,对象和其他元数据)会从模板进行复制。当点击链接时,如果有可用的模板,你会被要求选择其中一个:

xwiki功能-文档生命周期

然后,你将进入所选页面模板的内联表单模式进行编辑。

使用页面新增动作

你可以通过使用位于页面标题右侧的加号图标来创建当前页面的一个新子页面。

xwiki功能-文档生命周期

这将打开创建页面向导,你可以指定新页面的标题。

默认情况下,新的页面将作为当前页面的子页面来创建。如果你不希望出现这种情况,那么你通过使用文档选择器(通过选择现有的父节点)更改目标页面的位置。

请注意:上述描述在wiki主页上创建新页面时(即点击首页加号图标),是一个例外情况。在这种情况下,默认是创建*页面,而不是当前页面(主页)的孩子页面。如果你目的是建立主页的孩子(主页通常没有这种情况),那么你可以使用文件选择器中选择首页作为新页面的父节点。

你也可以选择模板。

一旦你单击“创建”按钮,你就能直接进入新页面的编辑页面。

xwiki功能-文档生命周期

XWiki 7.2M3此前新增页面的动作是位于顶层菜单。

通过直接输入新页面URL

你也可以直接在浏览器输入新页面名称(及其路径)的URL。 例如http://localhost:8080/xwiki/bin/view/Movies/Thriller/Rear Window。如果目标页面不存在,那么你会得到一个消息,提示页面不存在,以及会有一个链接创建新页面:

xwiki功能-文档生命周期

编辑

详情请参见页面编辑教程。

显示

当你点击一个链接到一个页面,XWiki将自动以视图模式显示页面。这是默认模式。 XWiki还支持在特定的情况下的其他格式显示页面:

代码

你可以查看页面的内容,而无需对其进行编辑(因此你不需要编辑权限)。此选项仅显示在高级模式的用户。

当使用Flamingo皮肤查看代码,你必须点击更多操作菜单,然后单击查看源文件。

xwiki功能-文档生命周期

xwiki功能-文档生命周期

XML

XWiki允许在XML中暴露的页面。这通常不是很有用的,但是当你想要写一个工具,可以自动解析一个页面的内容,这将有用。由于所有页面明确界定XML格式,这比做屏幕抓取容易得多。此外,XML格式在XWiki内部执行页面的导入/导出时使用。

评论

有评论权限的用户可以在页面留下评论。这使他们能够提供反馈信息,而无需编辑权限。

xwiki功能-文档生命周期

在Flamingo皮肤
xwiki功能-文档生命周期

附件

一个页面可以包含附件。请参阅附件了解更多详情。

历史

显示页面的版本历史记录。查看版本控制了解更多细节。

打印

有几种打印选项(你所看到的可能会有所不同,这取决于所使用的皮肤)。

当使用Flamingo皮肤,通过点击“更多”来操作打印预览:

  • 打印预览:生成一个页面,该页面被格式化,这样就可以使用浏览器的打印功能来打印。

    xwiki功能-文档生命周期

导出

XWiki支持多种可能的导出格式:PDF, RTF, XAR, HTML。更多信息请参见导出功能

Flamingo皮肤:
xwiki功能-文档生命周期

xwiki功能-文档生命周期

删除

删除页面并丢入回收站

xwiki功能-文档生命周期

在删除前会要求确认。你可以决定是否同时删除当前文档的子文档。

xwiki功能-文档生命周期

注意:当删除一个非终端页以及当一个页面唯一的孩子是'WebPreferences'页面,'Affect children'复选框将默认被选中。通常情况下,此复选框是非选中的,但在这种情况下,我们很容易会忘记有关文档(隐藏或自动创建)和删除的页面可能依旧会在一些地方出现残留。

然后,你必须等待页面删除:

xwiki功能-文档生命周期

最后,将有成功的消息提示:

xwiki功能-文档生命周期

恢复

可以在文档索引应用程序恢复已删除的文件或从垃圾站中删除它(你需要有管理权限)。

复制

如果你想创建现有页面的副本,那么你必须导航到该页面(在查看模式下访问该页面),然后从页面菜单中选择复制操作(位于页面标题的右侧)。

xwiki功能-文档生命周期

这将带你到复制页面向导,你可以指定副本的名称和新的位置。

xwiki功能-文档生命周期

如果页面多种语言的翻译,那么你可以选择复制部分翻译,也可以复制所有翻译。如果页面有子页面,你一样可以复制(这种方式可以复制页面层次结构)。

xwiki功能-文档生命周期

一旦你点击复制按钮,你就会被带到拷贝状态页面,你可以看到你选择的选项和复制操作的进展。复制是异步进行的。进度条是为了让你知道这个操作是否成功或失败。你可以使用面包屑导航到新的页面或旧页面。

移动/重命名

如果要重命名或移动现有页面,你需要导航到该页面(在查看模式下访问该页面),然后从页面菜单中选择重命名操作(位于页面标题的右侧)。

xwiki功能-文档生命周期

这将带你到重命名页面向导,你可以指定新的页面标题(如果要重命名)或新的页面位置(如果你想将页面移动到不同的位置)。

xwiki功能-文档生命周期

如果页面有子页面,你一样可以选择将它们移动到新的位置。这种方式下,重命名操作页面的层级将被保留。如果你选择保留当前路径下的子页面,那么他们将成为“孤儿页面”:他们仍然会使用相同的URL访问,但他们将有一个缺失父页面(你可以通过创建父页面解决这个问题)。

你还可以选择是否更新有指向受影响的页面链接。

如果重命名的页面(或其子页面)有外部链接,他们重命名之后,地址将有可能会不可用,除非你选择“create an automatic redirect”来修复链接。

xwiki功能-文档生命周期

一旦你点击了重命名按钮,你将会被带到重命名状态页面,你可以看到你选择的选项和重命名操作的进展。如同复制操作,也是异步执行的。进度条是为了让你知道这个操作是否成功或失败。你可以使用面包屑导航到新的页面或旧页面。

限制

目前仍有重命名上的一些限制:

  • 反向链接必须开启(它们默认打开,但如果你已经把它们关闭,重命名操作将不会重命名反向链接)
  • 位于XObject对象和翻译内容的反向链接目前没办法重命名。你可以跟踪这个问题XWIKI-981的进度。
  • 当一个页面保存反向链接也保存,因此可能会发生一个干净XWiki数据库未保存反向链接。在这种特殊情况下,你可以调用在页面刷新所有链接如下(你需要admin来操作):
    $xwiki.refreshLinks()