Skip to end of metadata
Go to start of metadata

中文标题【自定义空间布局】

你可以通过编辑布局文件来对 Confluence 的外观和表现进行编辑。这个页面将会告诉你如何来为空间自定义布局文件。你需要系统管理员的 全局权限(global permission) 和你希望进行修改空间的 空间管理员权限(space administrator)

具有系统管理员权限的用户可以对整个 Confluence 布局进行自定义和编辑。有关更多的信息,请参考页面 Customizing Site and Space Layouts 中的内容。在 Confluence 站点中针对全局布局的修改将会应用到所有使用默认布局的空间中。

任何空间布局的自定义修改将会覆盖全局配置的设置。

如果你通过下面的这些指南对 Confluence 的外观和布局进行修改,你需要在 Confluence 升级后对修改的内容重新进行编辑和修改。你对 Confluence 进行越深度的修改,那么在升级后需要修改的东西就越多,那么升级起来也就更加复杂和困难。

请在对 Confluence 进行定制和修改的时候将这个工作量考虑进去。

有关针对自定义进行更新的更多信息,请参考 Upgrading Customized Site and Space Layouts 页面中的内容。

Confluence 是使用开源的 SiteMesh 库进行构建的,一个 Web 页面布局能够在整个站点中提供完整和一致的外观和布局。SiteMesh 是通过 'decorators' 进行工作的,这个被定义在页面的布局和结构中。

希望对 Confluence 的布局进行修改,你需要修改这些 decorator 文件。一个decorator 文件是使用 .vmd 为后缀名的,这些文件是使用非常简单的程序语言进行编辑的。这个程序语言被称为 Velocity。有关Velocity 的更多的内容,请参考 more about Velocity 页面。一旦你对 Velocity 比较熟悉以后,你可以对 decorator  文件进行编辑,来让 Confluence 中显示更多的个性化内容。

Confluence 中的 decorator 文件按照下面的方式进行分类:

  • 站点布局(Site layouts:这些文件被用来针对全局站点定义每一个页面的控制和布局。例如,如果你希望对页头和页脚进行修改,你需要修改这些文件。
  • 内容布局(Content layouts:这个文件被用来对页面中的内容和博客页面的内容进行修改和控制。这个不会修改页面自己的显示方式,但是能够允许对包含的评论和附件的显示方式进行修改。
  • 导出布局(Export layouts:这个控制空间和页面导出为 HTML 格式的显示方式,如果你使用 Confluence 创建静态网站的话,你需要对这些布局文件进行修改。

有关更多布局的修改,请参考 decorators 中的内容。

希望编辑 decorator 文件:

  1. 进入空间后,然后从边栏的底部选择 空间工具(Space tools) > 外观和感觉(Look and Feel)

  2. 选择 布局(Layout )Layout 仅仅在你是 Confluence 系统管理员的时候才会显示)。
    你可以看到空间的布局列表
  3. 单击 创建自定义(Create Custom)来编辑默认的 vmd 文件。
    这个将会把 vmd 文件在编辑器模式中打开。如果你仅仅希望查看 vmd 文件,单击 查看默认(View Default)
  4. 进行必要的修改后,然后单击 更新(Update)


  • No labels