Confluence 6 用户宏最佳实践
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Confluence 6 用户宏最佳实践相关的知识,希望对你有一定的参考价值。
这个页面为你在创建用户宏的最佳实践中包含了一些小技巧和建议。为你的宏添加一个简短的描述
我们鼓励你为你的宏在 模板(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
以上是关于Confluence 6 用户宏最佳实践的主要内容,如果未能解决你的问题,请参考以下文章