Edgewall Software

Changes between Initial Version and Version 1 of TranslationZh_CN/WikiFormatting


Ignore:
Timestamp:
Mar 17, 2016, 3:03:55 PM (6 years ago)
Author:
liubinan <liubinan@…>
Comment:

翻译 WikiFormatting 前半部分内容

Legend:

Unmodified
Added
Removed
Modified
  • TranslationZh_CN/WikiFormatting

    v1 v1  
     1= WikiFormatting
     2
     3[[TracGuideToc]]
     4[[TranslatedPages(revision=121)]]
     5
     6Wiki标记是Trac的核心特性,它和Trac的其它部分紧密结合在一起构成了一个灵活而又强大的整体。
     7
     8Trac拥有一个小而强大的wiki渲染引擎,它借鉴了许多其它流行wiki的标记命令,特别是[http://moinmo.in/ MoinMoin]和[trac:WikiCreole]。
     9
     10wiki标记可以出现在任何允许WikiFormatting的地方,本页将为你深入讲解这些wiki标记。
     11
     12下面的章节提供了最常见的语法的概述,''类别''列中的每一个链接指向该语法在本页后面的详细解释。
     13
     14Trac的wiki标记的一些高级特性在其它的页面中进行了更深入的描述:
     15 - TracLinks 涵盖了所有可以精确指向任何Trac资源或其中的一部分的方式。
     16 - WikiPageNames 涵盖了wiki页面的各种命名方式,无论是驼峰式(CamelCase)或其他方式。
     17 - WikiMacros 列出可用于生成动态内容的宏。
     18 - WikiProcessors 和 WikiHtml 详细描述了部分wiki文本如何可以进行特殊处理。
     19 - [trac:wiki:TracDev/Proposals/AdvancedWikiOperations AdvancedWikiOperations] 提供了一些不常用的或管理方面的操作。
     20
     21== 常用wiki标记
     22
     23||= '''类别''' =||= '''Wiki 标记''' =||= '''显示''' =||
     24|-----------------------------------------------------------
     25{{{#!th rowspan=3
     26[#字体样式 字体样式]
     27}}}
     28|| `'''粗体'''`, `''斜体''`, `'''''Wikipedia 样式'''''` || \
     29|| '''粗体''', ''斜体'', '''''Wikipedia 相识''''' ||
     30|| {{{`等宽字体 (''其他标记会被忽略'')`}}} || \
     31|| `等宽字体 (''其他标记会被忽略'')` ||
     32|| `**粗体**`, `//斜体//`, `**//!WikiCreole 样式//**` || \
     33|| **粗体**, //斜体//, **//!WikiCreole 央视//** ||
     34|-----------------------------------------------------------
     35||= [#Headings 标题] =||\
     36{{{#!td
     37 {{{
     38 == Level 2
     39 === Level 3 ^([#hn note])^
     40 }}}
     41}}}
     42{{{#!td style="padding-left: 2em"
     43== Level 2
     44=== Level 3 ^([#hn note])^
     45}}}
     46|-----------------------------------------------------------
     47||= [#段落 段落]  =||\
     48{{{#!td
     49 {{{
     50 写成多行的
     51 第一段。
     52
     53 第二段
     54 }}}
     55}}}
     56{{{#!td
     57 写成多行的
     58 第一段。
     59
     60 第二段
     61}}}
     62|-----------------------------------------------------------
     63||= [#列表 列表] =||\
     64{{{#!td
     65 {{{
     66 * 符号列表
     67   可以写成多行
     68   1. 嵌套列表
     69     a. 不同的编号
     70        样式
     71 }}}
     72}}}
     73{{{#!td
     74* 符号列表
     75  可以写成多行
     76  1. 嵌套列表
     77    a. 不同的编号
     78       样式
     79}}}
     80|-----------------------------------------------------------
     81{{{#!th
     82[#定义列表 定义列表]
     83}}}
     84{{{#!td
     85 {{{
     86  术语:: 定义内容
     87         可以写成多行
     88 }}}
     89}}}
     90{{{#!td
     91 术语:: 定义内容
     92        可以写成多行
     93}}}
     94|-----------------------------------------------------------
     95||= [#预格式化文本 预格式化文本] =||\
     96{{{#!td
     97 {{{
     98 {{{
     99 多行,''不进行wiki格式化''
     100       空 格 被 原 样 保 留
     101 }}}
     102 }}}
     103}}}
     104{{{#!td
     105 {{{
     106 多行,''不进行wiki格式化''
     107       空格 被 原样 保留
     108 }}}
     109}}}
     110|-----------------------------------------------------------
     111||= [#引用 引用] =||\
     112{{{#!td
     113 {{{
     114   如果行头包含空格
     115   会显示成引用文本
     116 }}}
     117}}}
     118{{{#!td
     119 如果行头包含空格
     120 会显示成引用文本
     121}}}
     122|-----------------------------------------------------------
     123||= [#讨论引文 讨论引文] =||\
     124{{{#!td
     125 {{{
     126 >> ... (我说的)
     127 > (他回复的)
     128 }}}
     129}}}
     130{{{#!td
     131>>... (我说的)
     132> (他回复的)
     133}}}
     134|-----------------------------------------------------------
     135||= [#表格 表格] =||\
     136{{{#!td
     137 {{{
     138 ||= 表头 =|| 单元格 ||
     139 ||||  (详细说明在下面)  ||
     140 }}}
     141}}}
     142{{{#!td
     143||= 表头 =|| 单元格 ||
     144||||  (详细说明在下面)  ||
     145}}}
     146|-----------------------------------------------------------
     147{{{#!th rowspan=2
     148[#链接 链接]
     149}}}
     150|| `http://trac.edgewall.org` ||\
     151|| http://trac.edgewall.org ||
     152|| `WikiFormatting (CamelCase)` ||\
     153|| WikiFormatting (CamelCase) ||
     154|-----------------------------------------------------------
     155{{{#!th rowspan=5
     156[#Trac链接 Trac链接]
     157}}}
     158|| `wiki:WikiFormatting`, `wiki:"WikiFormatting"` ||\
     159|| wiki:WikiFormatting, wiki:"WikiFormatting" ||
     160|| `#1 (任务单)`, `[1] (变更集)`, `{1} (报告)` ||\
     161|| #1 (任务单), [1] (变更集), {1} (报告) ||
     162|| `ticket:1, ticket:1#comment:1` ||\
     163|| ticket:1, ticket:1#comment:1 ||
     164|| `任务单 [ticket:1]`, `[ticket:1 任务单1]` ||\
     165|| 任务单 [ticket:1], [ticket:1 任务单1] ||
     166|| `任务单 [[ticket:1]]`, `[[ticket:1|任务单1]]` ||\
     167|| 任务单 [[ticket:1]], [[ticket:1|任务单1]] ||
     168|-----------------------------------------------------------
     169{{{#!th rowspan=2
     170[#设置锚点 设置锚点]
     171}}}
     172|| `[=#point1 (1)] 第一个...` ||\
     173|| [=#point1 (1)] 第一个... ||
     174|| `see [#point1 (1)]` ||\
     175|| see [#point1 (1)] ||
     176|-----------------------------------------------------------
     177{{{#!th rowspan=3
     178[#转义 转义标记]
     179}}}
     180|| `!'' 两个单引号` ||\
     181|| !'' 两个单引号 ||
     182|| `!wiki:WikiFormatting`, `!WikiFormatting` ||\
     183|| !wiki:WikiFormatting, !WikiFormatting ||
     184|| [[html(<code>`{{{-}}}` 三个大括号</code>)]] ||\
     185|| `{{{-}}}` 三个大括号 ||
     186|-----------------------------------------------------------
     187||= [#Images 图像] =|| `[[Image(`''图像链接''`)]]` || [[Image(htdocs:../common/trac_logo_mini.png)]] ||
     188|-----------------------------------------------------------
     189{{{#!th rowspan=2
     190[#宏 宏]
     191}}}
     192|| `[[MacroList(*)]]` ||  ''(所有可用宏的简短列表)''  ||
     193|| `[[Image?]]` ||  ''(Image的说明)''  ||
     194|-----------------------------------------------------------
     195||= [#Processors Processors] =||\
     196{{{#!td
     197 {{{
     198 {{{
     199 #!div style="font-size: 80%"
     200 代码高亮:
     201   {{{#!python
     202   hello = lambda: "world"
     203   }}}
     204 }}}
     205 }}}
     206}}}
     207{{{#!td style="padding-left: 2em"
     208 {{{
     209 #!div style="font-size: 80%"
     210 代码高亮:
     211   {{{#!python
     212   hello = lambda: "world"
     213   }}}
     214 }}}
     215}}}
     216|-----------------------------------------------------------
     217||= [#注释 注释] =||\
     218{{{#!td
     219 {{{
     220 {{{#!comment
     221 提示编辑人员: ...
     222 }}}
     223 }}}
     224}}}
     225{{{#!td style="padding-left: 2em"
     226 {{{#!comment
     227 提示编辑人员: ...
     228 }}}
     229}}}
     230|-----------------------------------------------------------
     231||= [#其他 其他] =||\
     232{{{#!td
     233 {{{
     234 分行 [[br]] 符
     235 分行 \\ 符
     236 ----
     237 }}}
     238}}}
     239{{{#!td style="padding-left: 2em"
     240分行 [[br]] 符
     241分行 \\ 符
     242----
     243}}}
     244
     245== 字体样式
     246
     247Trac的wiki支持以下字体样式:
     248||= Wiki 标记 =||= 显示 =||
     249{{{#!td
     250  {{{
     251   * '''粗体''',
     252     ''' 三重引号 !'''
     253     也可以加粗,只要前面加上叹号 ! ''',
     254   * ''斜体''
     255   * '''''粗斜体''''' 或者 ''斜体 和
     256     ''' 粗斜体 ''' ''
     257   * __下划线__
     258   * {{{等宽体}}} 或 `等宽体`
     259     (因此可以这样将等宽体标记字符显示成等宽体: `{{{` 或 {{{`}}} )
     260   * ~~删除线~~
     261   * ^上标^
     262   * ,,下标,,
     263   * **也是粗体**, //也是斜体//,
     264     和 **'' 粗斜体 **'' //(since 0.12)//
     265   * [[span(style=color: #FF0000, 红色文本 )]]
     266  }}}
     267}}}
     268{{{#!td
     269 * '''粗体''',
     270  ''' 三重引号 !'''
     271  也可以加粗,只要前面加上叹号 ! ''',
     272 * ''斜体''
     273 * '''''粗斜体''''' 或者 ''斜体 和
     274  ''' 粗斜体 ''' ''
     275 * __下划线__
     276 * {{{等宽体}}} 或 `等宽体`
     277  (因此可以这样将等宽体标记字符显示成等宽体: `{{{` 或 {{{`}}} )
     278 * ~~删除线~~
     279 * ^上标^
     280 * ,,下标,,
     281 * **也是粗体**, //也是斜体//,
     282  和 **'' 粗斜体 **'' //(since 0.12)//
     283 * [[span(style=color: #FF0000, 红色文本 )]]
     284}}}
     285
     286注意:
     287 * `{{{...}}}` 命令 {{{`...`}}} 不仅仅是选择使用等宽字体,同时也会将其内容原样输出,也就是说其文本内容不会做进一步的wiki处理。
     288 * {{{ ! }}} 告诉wiki解析器不要将接下来的字符当作wiki格式,注意要在 ! 后面加上空格。举例来说,当结束粗体时使用。(译者注:此段翻译没把握,原文是 tells wiki parser to not take the following characters as wiki format, so pay attention to put a space after !, e.g. when ending bold.)
     289 * 所有的字体样式标记应该成对使用,
     290   并且必须正确进行嵌套。特别要注意的是`''`斜体不能和`//`配对,`'''`不能和`**`配对。
     291
     292== 标题
     293
     294标题的格式是,在行头写一到六个''等号''字符("="),空一格,然后写标题文本。
     295
     296[=#hn]
     297标题文本后可以跟着同样数目的"="字符,这不是必须的。也就是说 `=== Section3 ===` 等价于 `=== Section3`。
     298
     299最后,标题后面可以选择带上一个显式定义的id,如果没有定义,也会隐含生成一个可读的id。
     300
     301||= Wiki标记 =||= 显示 =||
     302{{{#!td
     303  {{{
     304  = 标题 =
     305  == 子标题
     306  === About ''this'' ===
     307  === 显式定义id === #using-explicit-id-in-heading
     308  == 子标题 #sub2
     309}}}
     310}}}
     311{{{#!td style="padding: 1em;"
     312  {{{
     313  #!div
     314  = 标题 =
     315  == 子标题
     316  === About ''this'' ===
     317  === 显式定义id === #using-explicit-id-in-heading
     318  == 子标题 #sub2
     319  }}}
     320}}}
     321
     322== 段落
     323
     324段落是由空行分隔的一段文本。
     325
     326也可以插入一个强制的断行,使用:
     327||= Wiki标记 =||= 显示 =||
     328{{{#!td
     329  {{{
     330  第一行[[BR]]第二行
     331  }}}
     332  {{{
     333  第一
     334  段
     335
     336  第二
     337  段
     338  }}}
     339}}}
     340{{{#!td
     341  第一行[[BR]]第二行
     342
     343  第一
     344  段
     345
     346  第二
     347  段
     348}}}
     349
     350== 列表
     351
     352Trac的wiki支持有序(编号)和无序两种列表格式。
     353
     354示例:
     355||= Wiki 标记 =||= 显示 =||
     356{{{#!td
     357  {{{
     358   * Item 1
     359     * Item 1.1
     360        * Item 1.1.1   
     361        * Item 1.1.2
     362        * Item 1.1.3
     363     * Item 1.2
     364   * Item 2
     365  - 列表项从行头开始写,
     366    也可以分成多行
     367    - 分成多行写的时候,
     368    要注意使用正确的缩进,否则
     369  可能就新开始一个段落了(译者注:就像这句话这样)...
     370 
     371   1. Item 1
     372     a. Item 1.a
     373     a. Item 1.b
     374        i. Item 1.b.i
     375        i. Item 1.b.ii
     376   1. Item 2
     377  也可以使用特定的数字重新开始一个列表:
     378   3. Item 3
     379  }}}
     380}}}
     381{{{#!td
     382 * Item 1
     383   * Item 1.1
     384      * Item 1.1.1   
     385      * Item 1.1.2
     386      * Item 1.1.3
     387   * Item 1.2
     388 * Item 2
     389- 列表项从行头开始写,
     390  也可以分成多行
     391  - 分成多行写的时候,
     392  要注意使用正确的缩进,否则
     393可能就新开始一个段落了(译者注:就像这句话这样)...
     394
     395 1. Item 1
     396   a. Item 1.a
     397   a. Item 1.b
     398      i. Item 1.b.i
     399      i. Item 1.b.ii
     400 1. Item 2
     401也可以使用特定的数字重新开始一个列表:
     402 3. Item 3
     403}}}
     404
     405== 定义列表
     406
     407Trac的wiki还支持定义列表。
     408
     409||= Wiki 标记 =||= 显示 =||
     410{{{#!td
     411  {{{
     412   llama::
     413     一种哺乳动物,有毛
     414   ppython::
     415     一种爬行动物,没有毛
     416     (can you spot the typo?)
     417  }}}
     418}}}
     419{{{#!td
     420 llama::
     421   一种哺乳动物,有毛
     422 ppython::
     423   一种爬行动物,没有毛
     424   (can you spot the typo?)
     425}}}
     426
     427注意定义的术语前需要加空格。
     428
     429== 预格式化文本
     430
     431预格式化文本块适用于代码片段、注意事项和示例。使用三重''花括号''包含一段文本可以定义一个引用块,花括号要单独占一行。
     432 
     433||= Wiki 标记 =||= 显示 =||
     434{{{#!td
     435  {{{
     436  {{{
     437  def HelloWorld():
     438      print '''Hello World'''
     439  }}}
     440  }}}
     441}}}
     442{{{#!td
     443  {{{
     444  def HelloWorld():
     445      print '''Hello World'''
     446  }}}
     447}}}
     448
     449注意,这种块也用于选择需要WikiProcessors处理的行。
     450
     451== 引用
     452
     453使用两个空格缩进一个段落,可以将其标记为一个块引用。
     454
     455||= Wiki 标记 =||= 显示 =||
     456{{{#!td
     457{{{
     458段落
     459  这是引用别人的一段话。
     460}}}
     461}}}
     462{{{#!td
     463段落
     464  这是引用别人的一段话
     465}}}
     466
     467== 讨论引文
     468
     469在正在进行的讨论中描述一个引用(比如任务单注释区域),可以使用类似电子邮件那样的引用标记(">", ">>", 等等)。
     470
     471||= Wiki 标记 =||= 显示 =||
     472{{{#!td
     473  {{{
     474  >> 某人的原话
     475  > 别人回复的话
     476  >  - 可以使用任何wiki标记
     477  我的回复
     478  }}}
     479}}}
     480{{{#!td
     481>> 某人的原话
     482> 别人回复的话
     483>  - 可以使用任何wiki标记
     484我的回复
     485}}}
     486
     487== 表格
     488=== 简单表格
     489
     490简单表格可以像这样进行创建:
     491||= Wiki 标记 =||= 显示 =||
     492{{{#!td
     493  {{{
     494  ||Cell 1||Cell 2||Cell 3||
     495  ||Cell 4||Cell 5||Cell 6||
     496  }}}
     497}}}
     498{{{#!td style="padding: 2em;"
     499||Cell 1||Cell 2||Cell 3||
     500||Cell 4||Cell 5||Cell 6||
     501}}}
     502
     503可以通过将文本用一对'='字符括起来来指定单元格标题。
     504注意,'='字符应该紧挨着分隔符,就像这样:
     505||= Wiki 标记 =||= 显示 =||
     506{{{#!td
     507  {{{
     508  ||        ||= stable =||= latest =||
     509  ||= 0.10 =||  0.10.5  || 0.10.6dev||
     510  ||= 0.11 =||  0.11.6  || 0.11.7dev||
     511  }}}
     512}}}
     513{{{#!td style="padding: 2em;"
     514||        ||= stable =||= latest =||
     515||= 0.10 =||  0.10.5  || 0.10.6dev||
     516||= 0.11 =||  0.11.6  || 0.11.7dev||
     517}}}
     518
     519最后,指定一个空单元格意味着下一个非空单元格将跨越空单元格,例如:
     520||= Wiki 标记 =||= 显示 =||
     521{{{#!td
     522  {{{
     523  || 1 || 2 || 3 ||
     524  |||| 1-2 || 3 ||
     525  || 1 |||| 2-3 ||
     526  |||||| 1-2-3 ||
     527  }}}
     528}}}
     529{{{#!td style="padding: 2em;"
     530|| 1 || 2 || 3 ||
     531|||| 1-2 || 3 ||
     532|| 1 |||| 2-3 ||
     533|||||| 1-2-3 ||
     534}}}
     535
     536注意,如果单元格的内容"紧挨着"单元格的一侧,文本将向该侧对齐。例如:
     537||= Wiki 标记 =||= 显示 =||
     538{{{#!td
     539  {{{
     540  ||=文本 =||= 数字 =||
     541  ||左对齐    ||        1.0||
     542  ||  居中      ||        4.5||
     543  ||      右对齐||     4.5||
     544  || 默认对齐 ||   2.5||
     545  ||默认||         2.5||
     546  ||  默认 ||      2.5||
     547  || 默认 ||       2.5||
     548  }}}
     549}}}
     550{{{#!td style="padding: 2em;"
     551||=文本 =||= 数字 =||
     552||左对齐    ||        1.0||
     553||  居中      ||        4.5||
     554||      右对齐||     4.5||
     555|| 默认对齐 ||   2.5||
     556||默认||         2.5||
     557||  默认 ||      2.5||
     558|| 默认 ||       2.5||
     559}}}
     560
     561如果与上面的例子不同,您的表中的单元格中包含更多的文本,将表中的一行扩展为多行可能会更方便。只要将`\`字符放在一行的末尾,就表示下一行文本依然是属于当前行的。
     562
     563||= Wiki Markup =||
     564{{{#!td
     565  {{{
     566  || 这是第1列 [http://trac.edgewall.org/newticket new ticket] || \
     567  || 这是第2列 [http://trac.edgewall.org/roadmap the road ahead] || \
     568  || 这是第3列,也是最后一列 ||
     569  }}}
     570}}}
     571|-------------
     572||= Display =||
     573{{{#!td style="padding: 2em;"
     574|| 这是第1列 [http://trac.edgewall.org/newticket new ticket] || \
     575|| 这是第2列 [http://trac.edgewall.org/roadmap the road ahead] || \
     576|| 这是第3列,也是最后一列 ||
     577}}}
     578
     579=== 复杂表格
     580
     581如果通过简单竖线标记(`||`)创建的表格无法满足你的需要,你可以使用[#Processors-example-tables 基于WikiProcessor的表格]创建更复杂的表格。