在技术文档的撰写过程中,如果存在一些需要在多个页面中保持一致和同步的介绍性内容,例如版本更新说明,使用 Confluence 的宏功能可以极大地提高效率。您可以使用 **Excerpt 宏**来定义一个可复用的内容片段(即“摘录”),然后在其他页面使用 **Excerpt Include 宏**或 **Include Page 宏**来引用它,从而实现“一处修改,全局生效”的效果。

**1. 使用 Excerpt 宏定义可复用内容:**
* 您可以在一个页面中使用 **Excerpt 宏**来包裹您希望复用的内容(可以是文字、图片或任何段落)。这个被包裹的内容就被定义为一个“摘录”。
* **Excerpt 宏**的作用是定义这个可复用的内容源。

**2. 在其他页面引用内容:**
* **使用 Excerpt Include 宏:** 当您需要在其他页面引用这个已定义的摘录内容时,可以使用 **Excerpt Include 宏**。这样,您引用的内容就是源 Excerpt 的内容。
* **自动同步效果:** 最大的优势在于,如果将来您需要修改原始的 Excerpt 内容,只需在定义该 Excerpt 的源页面进行修改,所有引用了该 Excerpt Include 的页面上的内容都会自动更新,无需手动修改每一个引用点。

**3. 另一种引用方式:Include Page 宏:**
* 除了 Excerpt 宏,您还可以使用 **Include Page 宏**来包含整个页面的内容。这在您需要引用一个结构完整、不希望被拆分成片段的独立内容块时非常有用。
* 使用 **Include Page 宏**的原理与 Excerpt 类似,它确保了内容源的唯一性。如果源页面内容发生变化,所有引用该页面的地方都会同步更新。

**总结:**
* 当您想复用一个**片段**时,推荐使用 **Excerpt 宏**定义,并在其他地方用 **Excerpt Include 宏**引用。
* 当您想复用一个**完整的、独立的页面内容**时,可以使用 **Include Page 宏**。

通过以上宏的使用,您可以确保技术文档中的关键信息(如版本说明、标准免责声明等)只在一个地方维护,从而保证了文档的准确性和维护的便捷性。

信息来源