撰写须知

目录

词条命名

请仔细思考每个词条的标题。Wiki的内容是以词条形式来组织的,本质上每个词条都是独立的单位,并且在一个空间中是唯一的。因此每个词条的标题都应该可以独立地完整描述自己的内容。特别地,不应该与其父页面形成依赖关系

正确的命名: 父页面: 技术支持知识库 子页面: LiteBean相关问题 (此标题可独立描述自身内容)
错误的命名: 父页面: 技术支持知识库 子页面: LiteBean (此标题必须结合其父页面标题,表示关于LiteBean的技术支持内容)

这样做有两个作用:
1. 避免页面命名冲突(一个空间中只能有一个"LiteBean"页面)
2. 用户搜索时,可以清晰地通过页面标题知道页面的大致内容。(搜索结果中不会同时显示页面的父页面标题)

保存

  • 在编辑过程中,系统会自动定时保存草稿。草稿可以在页面右上角用户下拉菜单(显示为当前登录用户的用户名)中访问。另外,每次进行预览时,都会即时保存草稿。
  • 既然具有保存草稿功能,请不要在编辑过程中频繁使用页面的"保存"按钮来保存未完成的页面。因为:1.保存页面将会形成一个新的历史版本 2.保存页面将导致订阅了RSS聚合的用户接收到一条新的更新信息。

删除和移动

除管理员外,普通撰写人无法删除页面和附件。在创建时请谨慎,如确实需要删除,请与管理员联系。普通撰写人可以自由移动页面和附件,改变其在页面树中的位置,或移动到其他空间中。

内容组织

  • 知识库产品规划空间中,如果希望在导航栏中添加新的子节点,只需要在父节点的页面中添加页面。
  • 由于导航栏是按照页面组织的,作为分类(父节点)的页面很可能没有合适的内容,这时只需要在此页面中加入{ls}即可在该页面中显示其所有子页面的目录。
  • 在页面代码中加入{toc-table},可以为页面加入一个内容目录

图形

  • 如果页面需要展示多个图形,可以在页面代码中加入{gallery}。即可列出页面附件中的所有图形文件。

JIRA整合

外部知识库快捷方式

在撰写内容时,对于某些与AOM关系不大的专业术语,可以使用快捷方式创建到中文维基百科英文维基百科的链接。写法为:

  • 中文维基:
    [XML@zhwiki]
    

    效果:XML

  • 英文维基
    [XML@enwiki]
    

    效果:XML

输入标签加入到本页面中
Please wait 
寻找标签吗?请输入搜索信息.