当你创建,编辑或为JIRA问题添加备注时, 某些字段可能会在文本区域右侧显示两个小图标: 一个蓝色显示屏图标 ( '预览' ) 和一个黄色问号图标 ( '帮助' )。 只要看到这些图标，表明这个字段支持JIRA的 文本格式标记语言, 允许你使用富文本的特性，例如:

  • 斜体, 加粗, 下划线。
  • 多层级标题。
  • 符号列表, 数字列表, 表格和引用一段文字.
  • 图像.
  • 宏 (请参见下面章节).

例如, 要在字段中包含一张图片, 你需要事先将图像文件上传到这个问题中, 然后在字段中输入下面的内容:

要预览保存后的显示效果, 点击 '预览' 图标:

点击 '帮助' 图标查看可以使用的 文本格式标记.

使用宏

JIRA 提供了一些可以使用的宏:

宏

说明

默认

锚点

允许用户直接跳转到一个页面的指定位置 用法: 

{anchor:bookmark1} 
... 文本内容 ... 
[#bookmark1]

是

代码

将源代码或XML代码括起来，便于阅读。 默认语言是Java，但是你也可以指定使用的语言类型为JavaScript, ActionScript, XML, HTML 以及 SQL。 用法: 

--- Java 代码 --- 
{code:title=Bar.java|borderStyle=solid} 
// 这里是注释 
public String getFoo() 
{ 
return foo; 
} 
{code} 
*--- XML 示例 ---* 
{code:xml} 
<test> 
<another tag="attribute"/> 
</test> 
{code}

是

引用

表明内容是从其他地方引用的。用法: 

{quote} 
这段文字引用自其它地方 
{quote}

是

无格式

被括起来的内容不是wiki标记语言。 用法: 

{noformat} 
This is text \#&@!@(*!&*@()#*@\ \\ 
{macros} _wont_work_here 
{noformat}

是

面板

使用下面的选项绘制一个面板:

  • title: 面板的标题
  • borderStyle: 面板使用的外框样式 (solid, dashed 以及其他有效的 CSS 边框样式)
  • borderColor: 面板使用的外框颜色
  • borderWidth: 面板使用的外框个宽度
  • bgColor: 面板的背景色
  • titleBGColor: 面板标题部分的背景色 
     
{panel}文字内容{panel} 
{panel:title=我的标题}文字内容{panel} 
{panel:title=我的标题| borderStyle=dashed| borderColor=#ccc| titleBGColor=#F7D6C1| bgColor=#FFFFCE} 
用 *面板* 括起来的内容 
yet _another_ line 
{panel}

是

颜色

改变所需文字的颜色。用法: 

{color:red} 
看啊，红色的文字! 
{color}

你可以直接使用HTML的16中标准颜色 ('aqua','black','blue','fuschia','green','gray','lime', 'maroon','navy','olive','purple','red','silver','teal','white','yellow'), 或16进制颜色代码 (例如 '#336699').

是

Lorem Ipsum

插入一段 "lorem ipsum" 填充的文字。用法: 

{loremipsum}

是

HTML

在JIRA问题中使用HTML语言。 用法: 

{html} 
<p>你可以在 <A href="chapter2.html">第二章</a> 中发现更多有趣的内容。 
请浏览 <a href="../images/map.gif"> 地图</A></p> 
{html}

否

只有当JIRA管理员配置了 '渲染模式' 后，你才能使用JIRA文本格式标记和宏功能。

  • 无标签

评论

  1. Weijing 韦京 [Unlimax] 发表：

    2012-05-29 
    {color:red} 
看啊，红色的文字! 
{color}