这个页面为你在创建用户宏的最佳实践中包含了一些小技巧和建议。 为你的宏添加一个简短的描述 我们鼓励你为你的宏在 模板（Template ）添加一个备注的描述，可以参考下面的显示的内容： ## Macro title: My macro name ## Macro has a body: Y or N ## Body processing: Selected body processing option ## Output: Selected output option ## ## Developed by: My Name ## Date created: dd/mm/yyyy ## Confluence version: Version it was developed for ## Installed by: My Name ## Short description of what the macro does 在宏浏览器中展示你的参数 宏浏览器是为你用户使用配置你的宏的最简单的方式。你可以指定你的宏的分类，图标的连接定义在宏浏览器中为用户展示的信息的参数等。 为宏参数提供默认值 一般来说你不能保证用户能够完整的提供用户的参数，一个让宏进行校验是否收到了正确的参数的话，你可以在你的宏中指定参数并在后面使用。 请参考下面的示例，在这个宏中有 3 个参数，当用户不提供参数的时候，这些参数的默认值将会被使用。 #set($spacekey= $paramspacekey) #set($numthreads= $paramnumthreads) #set($numchars= $paramnumchars) ## Check for valid space key, otherwise use current #if (!$spacekey) #set ($spacekey=$space.key) #end ## Check for valid number of threads, otherwise use default of 5 #if (!$numthreads) #set ($numthreads=5) #end ## Check for valid excerpt size, otherwise use default of 35 #if (!$numchars) #set ($numchars=35) #end 考虑安全提示 我们建议你为你定义的宏进行一些权限方面的测试。例如，限制页面和空间权限来避免没有权限的用户可能的不经意间的显示。请查看 Writing User Macros 页面中的内容。 https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros
编辑一个用户宏 希望对一个用户宏进行编辑： 进入 > 基本配置（General Configuration） > 用户宏（User Macros） 在相关的宏的边上，单击 编辑（Edit） 更新宏的详细信息 单击 保存（Save） 删除一个用户宏 希望删除一个用户宏： 进入 > 基本配置（General Configuration） > 用户宏（User Macros） 当前系统中定义的用户宏将会完全显示出来 在相关的用户宏上，单击 删除（Delete） 在删除一个用户宏之前，你应该查找使用了这个用户宏的所有页面和博客页面。如果你删除的用户宏还在页面中被引用了的话，你的用户将会在页面中看到 'unknown macro' 错误信息。 https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros
如果你想创建自定义的宏的话，用户宏能够帮你完成这个任务。这个可以在你系统中应用特定的操作，比如说应用自定义格式等。 用户用是在 Confluence 创建和和管理的，你需要有一定的编码基础才可以。 你需要具有系统管理员权限来创建和应用用户自定义宏。 希望创建一个新的用户宏： 进入 > 基本配置（General Configuration） > 用户宏（User Macros） 选择 创建一个用户宏（Create a User Macro） 输入宏的一些详细信息（请查看下面列表） 单击 添加（Add） 宏名称（Macro name） 宏的名字，将会出现在代码中。 可见（Visibility） 这个选项控制谁可以在宏浏览器中查看这个宏或者自动完成功能。选项有： 所有用户可见（Visible to all users） 仅系统管理员可见（Visible only to system administrators） 请注意，如果你选择仅系统管理员可见的话，用户任然可以看到用在页面中输出的结果，宏的占位符也还是在编辑页面中出现的，这个仅仅在宏浏览器和自动完成的时候隐藏了。 所有宏的信息都是可以找到的，包括宏的标题，描述，参数名称和其他元数据。尽管宏只能被系统管理员查看到，也请不要在用户宏中定义任何敏感信和保密信息。 宏标题（Macro Title） 在宏浏览器和自动完成功能中出现的宏标题。 描述（Description） 这个描述信息将会出现在宏浏览器中。宏浏览器的查找将会对查找字段在宏标题和描述中的文字进行匹配。 分类（Categories） 为你的宏在宏浏览器中选择一个或多个分类。 图标 URL（Icon URL） 如果你希望宏浏览器为你的宏显示图标的话，输入绝对地址（例如 http://mysite.com/mypath/status.png）或相对于 Confluence base URL 的相对地址（例如：/images/icons/macrobrowser/status.png） 。 文档 URL（Documentation URL） 如果你的宏有文档的话，请在这里输入文档的 URL。 宏内容处理（Macro Body Processing） 指定 Confluence 应该如何处理你的宏的内容。 宏的内容中包含了在 Confluence 页面中如何处理的信息。如果你的宏有一个内容，所有宏的内容将会在 $body 变量字段中可用。 处理宏内容字段选项包括有： No macro body 选择这个选项，如果你的宏没有任何内容的话。 Escaped Confluence 将会添加在 HTML 标记中添加转义字符。如果你希望显示 HTML 标记在生产的页面中的时候，你可以使用转义字符。例如：如果内容为 <b>Hello World</b> 那么将会在生成页面中显示 <b>Hello World</b>。 Unrendered 内容中的 HTML 将会在模板输出之前进行处理。请确定模板中的 HTML 是非再生的。 Rendered Confluence 将会对 HTML 宏内容的部分进行让浏览器进行解析。例如宏内容为 <b>Hello World</b> 这个内容将会显示 Hello World。 模板（Template ） 这里是你写的代码去确定宏应该是什么样子的。 在宏模板中使用 HTML 和 Confluence 自定义 XML 元素。 你可以使用 Velocity 模板语言。这里是有关 Velocity project 项目的相关信息。 如果你的宏有 body 内容，你的宏可以将 body 的文本引用为 '$body'。 每个参数变量必须有一个与之对应的元数据定义。在你的宏参数中使用 @param 来定义元数据。 当使用参数传递信息，请参考 $paramXXX 在 'XXX' 的参数，是你定义 @param 元数据后来引用的参数。 如果你的宏不能接受参数，请使用 @noparams 。 请查看 Writing User Macros 要么获得更多的信息和示例。 希望使用插件完成编辑？ 如果你希望将你的自定义宏按照插件进行分发的话，请参考 User Macro plugin module 页面中的内容。如果你希望使用更加复杂，更加程序化的宏的话，你需要写成 Macro plugin 宏。 https://www.cwiki.us/display/CONFLUENCEWIKI/Writing+User+Macros
I recently had the enviable task of reading nearly every story Richard Matheson ever wrote and selecting 33 tales to be included in Penguin Classics’ The Best of Richard Matheson. This turned out to be like stepping into a time machine, transported back to the age when I started reading him. I was fourteen. The year was 1986. My introduction to his fiction, his short novel I Am Legend, was one of the first books that made me run up to my friends and tackle them so they’d all check it out, too. If you haven’t read it (what the hell is wrong with you?), it manages to be a work of science fiction, a vampire story, a progenitor of the “biological plague” apocalyptic novel, and also an excellent thriller. All that in about 160 pages. I had to find out more. I dove into The Shrinking Man (the film added “Incredible”) and Hell House and wow. I wish I had a more sophisticated way to describe my reaction to the seismic effect of Richard Matheson on my young mind, but “wow” gets at the raw, awestruck nature of thing. And then I came to find out the man had written short stories. I tracked them down with gusto, with glee. And with time I began to relate to the man’s writing in a way that seemed damn near mystical. I want to explain exactly what I mean by that. There’s a lot I need to say about Matheson, and the importance of his fiction, the reasons why this collection…
I recently had the enviable task of reading nearly every story Richard Matheson ever wrote and selecting 33 tales to be included in Penguin Classics’ The Best of Richard Matheson. This turned out to be like stepping into a time machine, transported back to the age when I started reading him. I was fourteen. The year was 1986. My introduction to his fiction, his short novel I Am Legend, was one of the first books that made me run up to my friends and tackle them so they’d all check it out, too. If you haven’t read it (what the hell is wrong with you?), it manages to be a work of science fiction, a vampire story, a progenitor of the “biological plague” apocalyptic novel, and also an excellent thriller. All that in about 160 pages. I had to find out more. I dove into The Shrinking Man (the film added “Incredible”) and Hell House and wow. I wish I had a more sophisticated way to describe my reaction to the seismic effect of Richard Matheson on my young mind, but “wow” gets at the raw, awestruck nature of thing. And then I came to find out the man had written short stories. I tracked them down with gusto, with glee. And with time I began to relate to the man’s writing in a way that seemed damn near mystical. I want to explain exactly what I mean by that. There’s a lot I need to say about Matheson, and the importance of his fiction, the reasons why this collection…
I recently had the enviable task of reading nearly every story Richard Matheson ever wrote and selecting 33 tales to be included in Penguin Classics’ The Best of Richard Matheson. This turned out to be like stepping into a time machine, transported back to the age when I started reading him. I was fourteen. The year was 1986. My introduction to his fiction, his short novel I Am Legend, was one of the first books that made me run up to my friends and tackle them so they’d all check it out, too. If you haven’t read it (what the hell is wrong with you?), it manages to be a work of science fiction, a vampire story, a progenitor of the “biological plague” apocalyptic novel, and also an excellent thriller. All that in about 160 pages. I had to find out more. I dove into The Shrinking Man (the film added “Incredible”) and Hell House and wow. I wish I had a more sophisticated way to describe my reaction to the seismic effect of Richard Matheson on my young mind, but “wow” gets at the raw, awestruck nature of thing. And then I came to find out the man had written short stories. I tracked them down with gusto, with glee. And with time I began to relate to the man’s writing in a way that seemed damn near mystical. I want to explain exactly what I mean by that. There’s a lot I need to say about Matheson, and the importance of his fiction, the reasons why this collection…
I recently had the enviable task of reading nearly every story Richard Matheson ever wrote and selecting 33 tales to be included in Penguin Classics’ The Best of Richard Matheson. This turned out to be like stepping into a time machine, transported back to the age when I started reading him. I was fourteen. The year was 1986. My introduction to his fiction, his short novel I Am Legend, was one of the first books that made me run up to my friends and tackle them so they’d all check it out, too. If you haven’t read it (what the hell is wrong with you?), it manages to be a work of science fiction, a vampire story, a progenitor of the “biological plague” apocalyptic novel, and also an excellent thriller. All that in about 160 pages. I had to find out more. I dove into The Shrinking Man (the film added “Incredible”) and Hell House and wow. I wish I had a more sophisticated way to describe my reaction to the seismic effect of Richard Matheson on my young mind, but “wow” gets at the raw, awestruck nature of thing. And then I came to find out the man had written short stories. I tracked them down with gusto, with glee. And with time I began to relate to the man’s writing in a way that seemed damn near mystical. I want to explain exactly what I mean by that. There’s a lot I need to say about Matheson, and the importance of his fiction, the reasons why this collection…
I recently had the enviable task of reading nearly every story Richard Matheson ever wrote and selecting 33 tales to be included in Penguin Classics’ The Best of Richard Matheson. This turned out to be like stepping into a time machine, transported back to the age when I started reading him. I was fourteen. The year was 1986. My introduction to his fiction, his short novel I Am Legend, was one of the first books that made me run up to my friends and tackle them so they’d all check it out, too. If you haven’t read it (what the hell is wrong with you?), it manages to be a work of science fiction, a vampire story, a progenitor of the “biological plague” apocalyptic novel, and also an excellent thriller. All that in about 160 pages. I had to find out more. I dove into The Shrinking Man (the film added “Incredible”) and Hell House and wow. I wish I had a more sophisticated way to describe my reaction to the seismic effect of Richard Matheson on my young mind, but “wow” gets at the raw, awestruck nature of thing. And then I came to find out the man had written short stories. I tracked them down with gusto, with glee. And with time I began to relate to the man’s writing in a way that seemed damn near mystical. I want to explain exactly what I mean by that. There’s a lot I need to say about Matheson, and the importance of his fiction, the reasons why this collection…
I recently had the enviable task of reading nearly every story Richard Matheson ever wrote and selecting 33 tales to be included in Penguin Classics’ The Best of Richard Matheson. This turned out to be like stepping into a time machine, transported back to the age when I started reading him. I was fourteen. The year was 1986. My introduction to his fiction, his short novel I Am Legend, was one of the first books that made me run up to my friends and tackle them so they’d all check it out, too. If you haven’t read it (what the hell is wrong with you?), it manages to be a work of science fiction, a vampire story, a progenitor of the “biological plague” apocalyptic novel, and also an excellent thriller. All that in about 160 pages. I had to find out more. I dove into The Shrinking Man (the film added “Incredible”) and Hell House and wow. I wish I had a more sophisticated way to describe my reaction to the seismic effect of Richard Matheson on my young mind, but “wow” gets at the raw, awestruck nature of thing. And then I came to find out the man had written short stories. I tracked them down with gusto, with glee. And with time I began to relate to the man’s writing in a way that seemed damn near mystical. I want to explain exactly what I mean by that. There’s a lot I need to say about Matheson, and the importance of his fiction, the reasons why this collection…
I recently had the enviable task of reading nearly every story Richard Matheson ever wrote and selecting 33 tales to be included in Penguin Classics’ The Best of Richard Matheson. This turned out to be like stepping into a time machine, transported back to the age when I started reading him. I was fourteen. The year was 1986. My introduction to his fiction, his short novel I Am Legend, was one of the first books that made me run up to my friends and tackle them so they’d all check it out, too. If you haven’t read it (what the hell is wrong with you?), it manages to be a work of science fiction, a vampire story, a progenitor of the “biological plague” apocalyptic novel, and also an excellent thriller. All that in about 160 pages. I had to find out more. I dove into The Shrinking Man (the film added “Incredible”) and Hell House and wow. I wish I had a more sophisticated way to describe my reaction to the seismic effect of Richard Matheson on my young mind, but “wow” gets at the raw, awestruck nature of thing. And then I came to find out the man had written short stories. I tracked them down with gusto, with glee. And with time I began to relate to the man’s writing in a way that seemed damn near mystical. I want to explain exactly what I mean by that. There’s a lot I need to say about Matheson, and the importance of his fiction, the reasons why this collection…