免费:如何创建 Confluence 模板

免费:如何创建 Confluence 模板

创建一个 Confluence 模板只需要十分钟。让你的团队真正使用它才是失败的关键,而本指南主要就涵盖这一点。

创建一个 Confluence 模板只需要十分钟。让你的团队真正使用它才是失败的关键,而本指南主要就涵盖这一点。

使用此模板

使用此模板

Confluence 是全球使用最广泛的知识库之一——而优秀的 Confluence 模板正是让它具备可扩展性的关键。使用 Trupeer,您可以从我们的免费指南和模板库开始,在 Confluence 模板设计上节省数小时;再结合您的 品牌规范 进行定制,并将 Confluence 页面转换为视频演示,让文档栩栩如生。

大多数设置 Confluence 模板的团队最终都会走到同一个结果:空间里有四十个模板,只有三个会被使用,而其他人仍在复制上个季度的页面并删除内容。

创建模板很容易,Atlassian 的文档也讲得很清楚。真正决定它是否好用的,是您往里面放了什么、放在了哪里,以及是否有人能在需要的那一刻找到它。

什么是 Confluence 模板

可复用的页面结构,作为新页面的起点。当有人从模板创建页面时,页面会自动带上标题、布局、宏和说明性文字,因此他们是在填写内容,而不是从零开始设计。

一共有四种,知道自己面对的是哪一种,能避免混淆。

类型

创建者

可用范围

由你编辑

系统模板

Atlassian 内置

所有地方

不

蓝图

Atlassian 或应用

所有地方

不能直接

全局模板

你的管理员

所有空间

是,需管理员权限

空间模板

空间管理员

一个空间

是

团队构建的大部分内容都会是空间模板。全局模板用于每个空间都需要的内容,例如会议纪要格式或决策记录。

Confluence 蓝图 vs 模板

这是一个常见的混淆点,建议在尝试构建某种模板之前先了解清楚:因为有些东西模板做不到。

模板 是页面结构。您可以基于它创建页面,并获得该结构。

蓝图 是模板加上行为。蓝图可以在页面创建前通过对话框提示您、生成不止一个页面、创建一个索引页列出该类型下的所有页面,并应用普通模板无法实现的逻辑。Atlassian 的会议纪要蓝图和决策蓝图就是大家熟悉的例子,而它们维护的索引页正是模板无法复制的部分。

实际影响是:您可以自己创建并编辑模板,但如果不开发应用,就无法构建蓝图。如果您想要类似蓝图的行为但不想开发,通常的做法是:在父页面上组合使用 Create from Template 宏和一个模板,再通过页面属性报告来构建索引。

如果有人问“蓝图”,通常指的是他们想要索引页。

全局模板还是空间模板?

在构建之前先做决定,因为之后迁移意味着要重新创建。

全局 适用于:每个空间都需要它、组织内一致性很重要,或它支持全公司范围的流程。会议纪要、决策记录、事故报告、项目章程。

空间 适用于:它只适用于某个团队的工作方式、它会经常变化,或您仍在测试它是否真的有用。大多数模板从这里开始,部分会升级为全局。

陷阱在于把所有东西都设为全局,因为这样看起来更整齐。包含六十个模板的全局库难以浏览,而空间管理员也无法修复一个对他们来说不合适的全局模板。

如何在 Trupeer 中自定义此模板

步骤 1:打开模板区域

从主导航进入“模板”区域。

Open the Templates section in Trupeer

步骤 2:选择并打开模板

点击任意您想要操作的模板以将其打开。

Select and open a template in Trupeer

步骤 3:展开模板视图

如有需要,展开模板视图以清晰查看完整布局和细节。

Expand the template view in Trupeer

步骤 4:编辑模板

点击“编辑”开始修改所选模板。

Edit the template in Trupeer

在编辑器中,您可以:

  • 添加新的版块

  • 定义或更新格式规则

  • 添加徽标并调整其位置及相关设置

步骤 5:保存您的自定义模板

完成所有必要更改后,点击“保存”,将更新后的模板存为您自己的版本。

Save your customized template in Trupeer

步骤 6:预览并微调模板

当您想查看自定义模板的效果时,打开“预览”。

Preview and fine-tune the template in Trupeer

在预览界面中,如有需要,您仍可继续直接进行调整,确保模板呈现效果与您的预期完全一致。

借助此 Confluence 模板指南,您可以:

  • 在文档上节省时间:使用经过验证的 Confluence 模板模式,而不是从零开始。

  • 提升一致性:每个团队在编写相似文档时使用相同结构。

  • 保持品牌风格:使用 Trupeer 的品牌套件应用您的徽标、字体和颜色。

  • 覆盖每个使用场景:会议、项目、决策、复盘等模板一应俱全。

  • 添加视频演示:将视频教程直接嵌入 Confluence 页面。

  • 触达全球团队:一键将 Confluence 内容翻译为 65+ 种语言。

何时创建自己的模板

并不像人们想的那么频繁。Atlassian 会提供大量模板,而且 Marketplace 里还有更多。

当现有模板接近但包含错误的版块时;当您需要公司特定字段(例如成本中心或审批栏)时;当您希望为每周产出的内容保持一致结构时;或当同一页面被反复复制和编辑时,就该创建自己的模板。

不要为一年只产出两次的内容创建模板;也不要在真正的问题是“人们不知道怎么写文档”而不是“结构怎么安排”时创建。模板解决的是格式问题,而不是思考问题。

如何创建 Confluence 模板

Confluence Cloud 与 Data Center 的操作细节略有不同,而且 Atlassian 会定期调整界面,因此请查看 他们的最新文档 以获取准确的点击路径。流程的整体形态是稳定的。

  1. 进入空间设置:用于空间模板;或进入全局管理区域:用于全局模板。模板位于管理区域中创建,而不是从页面创建。

  2. 创建新模板,并为其命名清晰。

  3. 在模板编辑器中搭建结构:标题、布局、表格、宏。

  4. 添加变量:用于任何需要提示用户填写的内容。

  5. 添加占位文本:用于说明每个版块中应放什么。

  6. 添加标签:让从该模板创建的页面自动归类。

  7. 编写描述。 这是人们在选择模板时看到的内容,几乎总是被留空。

  8. 保存后,从中创建测试页面,看看用户实际会经历什么。

第八步能发现大多数问题。模板编辑器与生成后的页面看起来不同,而且在编辑器里看起来清晰的内容,往往并不清晰。

从现有页面创建模板

在 Confluence 中没有“一键将此页面转换为模板”的内置功能,这会让人感到意外。实践中可行的方法是:

打开现有页面,复制其内容,在空间或全局模板区域创建一个新模板,然后粘贴内容。接着移除所有与该实例相关的内容:名称、日期、真实数据、已完成的内容。用占位文本替换被移除的内容,说明这里应放什么,并为需要提示填写的字段添加变量。

出错通常就发生在“移除”这一步。基于真实页面创建的模板,在具体信息移除了一半的情况下,会生成包含他人数据的页面,而且在任何人注意到之前,这些页面会被无限期地向前复制。

一些 Marketplace 应用会提供直接的页面到模板转换功能,如果您经常这样做,值得考虑。

变量

当用户从模板创建页面时,需要填写的字段。它们会在页面打开前以表单形式出现。

将它们用于少量定义页面的关键值:项目名称、客户、日期、迭代编号、负责人。用户创建页面时只需填写一次,之后这些值会自动填充到变量出现的所有位置。

有两个限制值得了解。变量只在创建时填写,之后不能作为变量再编辑,它们会直接变成页面上的普通文本。并且最好控制在少数,因为页面创建时如果打开的是一个包含十二个字段的长表单,人们就会放弃填写,转而去复制旧页面。

三到五个变量是合理的最大值。

占位文本

在模板中以灰色显示的说明性文字,用户一旦在其上输入内容就会消失。Confluence 模板中最不常用、但最能提升采用率的功能。

好的占位文本会告诉用户该版块里应放什么,并且最好还能说明“什么样才算好”。“描述这个决策、考虑过的选项,以及为什么选择了这个。两到三句话。”这比一个空标题要有用得多。

关键属性在于它不会保留。模板里保留的普通文本会发布到真实页面中,而您会发现说明文字永久地存在于一半的文档里。占位文本在被替换后会消失,页面在未触碰的情况下发布时也会消失。

将它用于每一个用户可能合理地想知道“这里应该放什么”的版块——而这几乎就是所有版块。

标签

模板可以自动为从中创建的每个页面应用标签。

这比看起来更重要,因为标签才是让 Confluence 内容可被查找、可被汇总的关键。一个会议纪要模板如果应用了 meeting-notes 标签,就意味着您可以在某个空间内为所有会议纪要建立索引、在搜索中按标签筛选,并使用页面属性报告。

在模板中设置好标签后,用户就不必记得添加。让用户手动添加标签,但大多数人几乎不会。

Create from Template 宏

这是在不开发应用的情况下实现蓝图行为的最接近方案,也是大多数人不知道存在的功能。

把宏放在某个页面上,指向一个模板,它就会渲染出一个按钮。任何点击它的人都会基于该模板创建一个新页面——可选地作为指定父页面的子页面。

这解决了“可发现性”问题,而这正是模板长期无人使用的主要原因。与其期待用户去模板选择器里导航并从列表中搜索,不如把按钮放在工作发生的地方:团队主页上的“新会议纪要”按钮,项目空间里的“提交决策记录”按钮。

再把它与同一页面上的页面属性报告结合起来,您就拥有了接近蓝图的效果:一个用于创建的按钮,以及一个自动维护的索引,汇总所有由此创建的内容。

如果您要从本指南里做一件事,就做这一件。

设计人们真的会用的模板

  • 更少的版块。十二个版块的模板会导致填写到一半就被放弃。六个通常就足够了。

  • 按人们知道的时间顺序排列。把用户能立刻填写的内容放在最上方,把需要进一步调查的内容放在更下方。

  • 每个版块都有占位文本,说明每个版块里应放什么。

  • 用表格承载结构化内容,因为在标题下直接写自由文本会导致内容不一致。

  • 不要点名特定人员。角色会变化,而模板不会。

  • 注意页面宽度。在大屏显示器上设计的模板,换到其他地方可能会显得拥挤;全宽布局也不适用于所有内容类型。

  • 宏要保守使用。并非每个宏在模板内的表现都与页面上一致,而复杂嵌套往往会让模板以难以排查的方式出问题。

  • 写好描述。这是人们在选择时会阅读的内容,而且几乎总是空白。

让模板更容易被找到

模板失败的真正原因,以及 Atlassian 文档里几乎没有人提到的内容。

默认路径要求某个人记得模板存在、打开选择器,并从名称列表中识别出正确的模板。在每一步里,复制上个季度的页面都更容易。

有效的方法:

  • 在用户开始工作的页面上放置 Create from Template 宏按钮。

  • 每个空间都有一个模板索引页:列出有哪些模板,以及每个模板何时使用。

  • 使用描述性名称。“每周团队会议纪要”,而不是“模板 3”或“TMPL_MTG”。

  • 把描述写完整,因为选择器会展示它们。

  • 减少模板数量。六个可被找到且维护良好的模板,比四十个不可被找到的模板更有价值。

  • 在流程中提到模板,而不仅仅是“可用”。如果您的入职清单写着“创建项目简报”,那就把按钮加上链接。

推动采用

  • 在构建之前,先问将要使用它的人需要哪些版块。由管理员为并非其所属团队设计的模板往往会被忽略。

  • 先用一个团队试点,再进行全局推广。

  • 现场演示一次。团队会议里三十秒的演示,比一次没人看的公告更有效。

  • 替换替代方案。如果有人在复制旧页面,就归档旧页面,或让按钮比“去找它”更方便。

  • 观察被删掉的内容。如果每个用户都会删除同一个版块,就把它移除。

  • 观察被添加的内容。如果用户总是会添加某个版块,就把它加入模板。

最后两条是最有用的信号,但几乎没人会去看。

维护模板库

  • 为每个模板指定负责人,最好是明确的角色,而不是通常由空间管理员来负责。

  • 按季度复审,移除所有未使用的内容。Confluence 不会直接报告模板使用情况,因此只能用替代指标:统计带有模板标签的页面数量。

  • 为模板变更做版本管理,并更新模板描述,让人知道它已经迁移。

  • 大胆清理。如果有三分之一的模板已经过时,这会让人学会:没有任何模板是可信的。

  • 在 Confluence 更新后检查,因为编辑器的改动有时会影响模板的渲染方式。

已知限制

在您围绕无法实现的内容进行设计之前,值得先了解这些限制。

并非每个宏在模板中的表现都与页面一致,有些也无法干净地继承。通常无法在模板中包含附件。变量只在创建时生效,不是实时字段。没有内置的页面到模板转换功能。模板也无法强制完成度,因此不会阻止用户发布“每个版块都为空”的页面。而且如果不开发应用,就无法实现真正的蓝图行为,包括多页面创建和自动维护索引。

有一些 Marketplace 应用可以弥补这些缺口,如果这些限制阻碍了重要事项,值得进一步了解。

最佳实践

  • 默认使用空间模板,只有在所有内容都需要时才用全局。

  • 六个版块或更少。

  • 每个版块都有占位文本。

  • 最多三到五个变量。

  • 由模板应用标签,而不是由用户应用。

  • 写好描述。

  • 在工作开始的地方放置 Create from Template 宏按钮。

  • 先用一个团队试点,再推广。

  • 每个模板都有负责人,并按季度复审。

  • 清理所有未使用的内容。

常见错误

  • 在没有征求将要使用它的人意见的情况下就直接搭建模板。

  • 十二个版块,导致页面只能填一半。

  • 没有占位文本,因此没人知道这里应该放什么。

  • 把说明性文字当作普通文本输入,结果它会出现在每个已发布页面中。

  • 把从现有页面创建出来的真实数据留在模板里。

  • 把特定人员的姓名写死在模板中。

  • 描述为空,导致选择器毫无用处。

  • 所有内容都创建为全局模板。

  • 存在但没有从任何用户工作位置链接到的模板。

  • 四十个模板,只有三个在使用。

  • 没有负责人,因此没有人会更新。

  • 指望模板解决一个本质上与“人们不知道该写什么”有关的问题。

模板提供结构,而不是内容

Confluence 模板擅长解决结构类问题。它们无法解决更常见的另一个问题:人们知道文档需要哪些版块,但仍然无法填写,因为被记录的流程存在于某个人的脑海里。

这个缺口会体现在:模板每个版块只填一行就完成。结构是对的,但内容很薄,而且再多的占位文本也无法修复。

把流程记录一次,Trupeer AI 就会基于同一轮内容生成书面文档,并配套一段旁白 视频演示;您可以直接将其嵌入 Confluence 页面,而不是用散文描述一个系统。应用您的 品牌套件,让所有内容保持一致;翻译它 为分布式团队提供 65+ 种语言版本;并将这套内容保存在您的 知识库 中,与 Confluence 里已有的内容并行。

记录它。打造品牌。翻译它。用 Trupeer 来做。

常见问题解答

如何在 Confluence 中创建模板?

空间模板从空间设置创建,全局模板从全局管理创建,而不是从页面创建。在模板编辑器中搭建结构,为需要填写的字段添加变量,添加解释每个版块内容的占位文本,应用标签,并编写描述。Atlassian 的文档提供了当前的逐步点击说明,但会定期更新。

如何从现有页面创建 Confluence 模板?

没有内置的一键转换。复制页面内容,创建一个新模板并粘贴进去,然后移除所有与该实例相关的内容:名称、日期、真实数据和已完成的内容。用占位文本替换被移除的部分。移除这一步通常最容易出错,残留的真实数据会被无限期地复制向前。

Confluence 模板是免费的吗?

Confluence 在所有计划中都包含大量内置模板和蓝图,您也可以在不增加额外费用的情况下创建自己的模板。一些 Marketplace 应用提供模板功能(例如页面到模板转换或批量管理),这些通常是付费的。

Confluence 蓝图和模板有什么区别?

模板是您创建页面所依据的页面结构。蓝图是模板加上行为:它可以通过对话框提示、创建多个页面,并维护一个索引页,列出由它创建的所有内容。您可以自己创建模板,但蓝图需要应用开发。如果有人问蓝图,他们通常想要的是索引页;您可以用 Create from Template 宏和页面属性报告来近似实现。

如何在 Confluence 中使用模板?

创建页面时,选择模板而不是从空白开始。如果模板包含变量,页面打开前会提示您填写。或者,点击放置在页面上的 Create from Template 宏按钮——这条路径更可靠,因为它把模板放在用户已经开始工作的地方。

什么是 Create from Template 宏?

这是一个放在页面上的宏,会渲染出按钮。点击后会基于指定模板创建新页面,可选地作为指定父页面的子页面。它是解决模板采用率低的最有效方案,因为它消除了用户寻找模板选择器的需求。将它与同一页面上的页面属性报告配合使用,就能获得接近蓝图行为的效果。

什么是 Confluence 模板占位文本?

模板中以灰色显示的说明性文字:用户一旦在其上输入内容就会消失;如果不触碰就直接发布,已发布页面中也不会出现。用它来解释每个版块里应放什么。它不同于在模板中输入的普通文本:普通文本会保留并最终发布到真实页面中。

如何制作漂亮的 Confluence 页面模板?

克制比装饰更重要。少用复杂的多列表格布局,因为在较小屏幕上渲染效果会很差。对结构化内容使用表格,而不是自由文本。添加信息和备注宏,突出最重要的两到三个点,而不是把所有内容都堆进去。版块数量要少。并且在普通浏览器宽度下检查效果,而不是只在您设计时使用的大屏上查看。

一个团队应该有多少个 Confluence 模板?

通常比大多数团队最终拥有的更少。六个可被找到且维护良好的模板,比四十个没人会滚动去找的模板更有价值。如果您的模板库在一个季度后有三分之一未被使用,就清理它们,因为过时的模板库会让人不再信任其中任何内容。

为什么没人使用我们的 Confluence 模板?

通常不是因为质量,而是因为可发现性。默认路径要求记得模板存在、打开选择器并识别正确模板;而在每一步里,复制旧页面都更容易。把 Create from Template 按钮放在工作开始的位置,写好描述,并确保模板在流程中被提及,而不仅仅是“可用”。

在从模板创建页面之后,还能编辑 Confluence 模板吗?

可以,而且编辑模板不会改变已经基于它创建的页面。模板是起点,而不是实时链接,因此现有页面会保留创建时的结构。这意味着模板修复只会改善未来创建的页面,而已经错误的内容仍会保持错误。

Confluence 模板变量是什么?

当用户从模板创建页面时,需要填写的字段,例如项目名称或日期。值会填充到变量出现的所有位置。它们只在创建时填写,之后会变成页面上的普通文本,而不是仍可编辑的字段。将变量控制在三到五个以内,因为页面创建时如果是一个长表单,人们就会回到复制旧页面的习惯。

相关模板

需要视频剪辑师、翻译和编剧吗?

免费试用 Trupeer

预约演示

需要视频剪辑师、翻译和编剧吗?

免费试用 Trupeer

预约演示

需要视频剪辑师、翻译和编剧吗?

免费试用 Trupeer

预约演示

了解工作如何发生。
将其带入你的下一次转型。

开始免费试用

预约演示

了解工作如何发生。
将其带入你的下一次转型。

开始免费试用

预约演示