diff --git a/_theme/gotgithub/static/sphinxdoc.css b/_theme/gotgithub/static/sphinxdoc.css index 1df3eec..bae42cb 100644 --- a/_theme/gotgithub/static/sphinxdoc.css +++ b/_theme/gotgithub/static/sphinxdoc.css @@ -384,7 +384,7 @@ table.classic { table.classic td, table.docutils th { padding: 1px 8px 1px 5px; - border: 1px solid #aaa; + border: 1px solid black; } table.classic th { diff --git a/appendix/markups.rst b/appendix/markups.rst index af94351..8085c40 100644 --- a/appendix/markups.rst +++ b/appendix/markups.rst @@ -84,13 +84,15 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | asc | | :: | 输出略。 | | | | | | | | | | - | | | | | | | 文档标题 | .. note:: AsciiDoc支持两种风格的标题。\ | - | | | | | | | ======== | 另一种单行标题风格参加下面的介绍。 | + | | | | | | | AsciiDoc 提供两种风格的标题。 | | | | | | | | | | | - | | | | | | | 一级标题 | 以点开始的块标题不生成目录。 | - | | | | | | | -------- | | + | | | | | | | 文档标题 | .. note:: 除了两种不同风格的标题外，\ | + | | | | | | | ======== | 还支持以点开始的块标题，\ | + | | | | | | | | 块标题不生成目录。如： | + | | | | | | | 一级标题 | | + | | | | | | | -------- | :: | | | | | | | | | | - | | | | | | | 二级标题 | | + | | | | | | | 二级标题 | .BlockTitle | | | | | | | | ~~~~~~~~ | | | | | | | | | | | | | | | | | | 三级标题 | | @@ -99,10 +101,7 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | 四级标题 | | | | | | | | | ++++++++ | | | | | | | | | | | - | | | | | | | .BlockTitle | | - | | | | | | | | | - | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ - | | | | | asc | | :: | 输出略。 | + | | | | | | | 或者使用下面单行标题风格进行定义。 | | | | | | | | | | | | | | | | | | = 文档标题 = | | | | | | | | | == 一级标题 == | | @@ -218,18 +217,23 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | p. 正常段落不再缩进。 | 正常段落不再缩进。 | | | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ + | | | | | | asc | | :: | | + | | | | | | | | | | + | | | | | | | | 四个或以上的下划线括起的区域为引言缩进。 | 四个或以上的下划线括起的区域为引言缩进。 | + | | | | | | | | | | + | | | | | | | | [quote, author, source] | 引言... | + | | | | | | | | ______________________________ | | + | | | | | | | | 引言... | source | + | | | | | | | | ______________________________ | | + | | | | | | | | | —— author | + | | | | | | | | | | + | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | | org | :: | | | | | | | | | | | | | | | | | | | | Org-mode式段落缩进： | Org-mode式段落缩进： | | | | | | | | | | | - | | | | | | | | #+BEGIN_QUOTE | 第一级段落缩进。 | - | | | | | | | | 第一级段落缩进。 | | - | | | | | | | | | 第二级段落缩进。 | - | | | | | | | | #+BEGIN_QUOTE | | - | | | | | | | | 第二级段落缩进。 | 返回一级段落缩进。 | - | | | | | | | | #+END_QUOTE | | - | | | | | | | | | | - | | | | | | | | 返回一级段落缩进。 | | + | | | | | | | | #+BEGIN_QUOTE | 段落缩进。 | + | | | | | | | | 段落缩进。 | | | | | | | | | | #+END_QUOTE | | | | | | | | | | | | +----------+-----------+-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ @@ -372,8 +376,8 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | | org | :: | | | | | | | | | | | | - | | | | | | | | 列表语法和Markdown、reST类似， | 列表语法和Markdown、reST类似， | - | | | | | | | | 因星号和列表语法冲突不建议使用。 | 因星号和列表语法冲突不建议使用。 | + | | | | | | | | 列表语法和Markdown、reST类似。 | 列表语法和Markdown、reST类似。 | + | | | | | | | | 星号和列表语法冲突需缩进，不建议使用。 | 星号和列表语法冲突需缩进，不建议使用。 | | | | | | | | | | | | | | | | | | | - 减号、加号开始列表。 | - 减号、加号开始列表。 | | | | | | | | | | | @@ -522,7 +526,7 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | -------- | | | | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ - | | | | | | asc | | :: | | + | | | | | | | org | :: | | | | | | | | | | | | | | | | | | | | 1. 列表项可以折行， | 1. 列表项可以折行， | | | | | | | | | 对齐则自动续行。 | 对齐则自动续行。 | @@ -565,6 +569,18 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | | Why not Git? | | | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ + | | | | | | asc | | :: | git | + | | | | | | | | | Simple and beautiful. | + | | | | | | | | git :: | | + | | | | | | | | Simple and beautiful. | hg | + | | | | | | | | hg :: Another DVCS. | Another DVCS. | + | | | | | | | | subversion :: VCS with many constrains. | | + | | | | | | | | + | subversion | + | | | | | | | | Why not Git? | VCS with many constrains. | + | | | | | | | | | | + | | | | | | | | | Why not Git? | + | | | | | | | | | | + | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | | org | :: | git | | | | | | | | | | Simple and beautiful. | | | | | | | | | - git :: Simple and beautiful. | | @@ -779,7 +795,7 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | 用\ **反斜线**\ 消除 | 用\ **反斜线**\ 消除 | | | | | | | | | | | +----------+-----------+-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ - | 链接 | URL\ | gfm | rst | | | org | :: | | + | 链接 | URL\ | gfm | rst | | asc | org | :: | | | | 自动链接 | | | | | | | | | | | | | | | | * 网址 http://github.com/ | * 网址 http://github.com/ | | | | | | | | | * 邮件 me@foo.bar | * 邮件 me@foo.bar | @@ -816,6 +832,12 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | [wh]http://www.worldhello.net | .. _WorldHello: http://www.worldhello.net | | | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ + | | | | | | asc | | :: | | + | | | | | | | | | | + | | | | | | | | * 访问 http://google.com[Google] | * 访问 `Google `__ | + | | | | | | | | * 访问 link:/index.html[首页] | * 访问 `首页 `__ | + | | | | | | | | | | + | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | | org | :: | | | | | | | | | | | | | | | | | | | | * 访问 [[http://google.com][Google]] | * 访问 `Google `__ | @@ -851,6 +873,19 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | 跳转至 "文内链接":#ttl-anchor 。 | 跳转至 `文内链接 <#ttl-anchor>`__ 。 | | | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ + | | | | | | asc | | :: | | + | | | | | | | | | | + | | | | | | | | 两种方式在这儿定义内部链接。 | 两种方式在这儿定义内部链接。 | + | | | | | | | | | | + | | | | | | | | [[alink1,链接标题1]] | .. _alink1: | + | | | | | | | | anchor:alink2[链接标题2] | .. _alink2: | + | | | | | | | | | | + | | | | | | | | 指向位置： | 指向位置： | + | | | | | | | | | | + | | | | | | | | - 跳转至 <> | - 跳转至 `内部链接1 <#alink1>`__ | + | | | | | | | | - 跳转至 xref:alink2[] | - 跳转至 `链接标题2 <#alink2>`__ | + | | | | | | | | | | + | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | | org | :: | | | | | | | | | | | | | | | | | | | | # <> | .. _org-anchor: | @@ -903,13 +938,23 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | fn4. http://goo.gl/rGyvs | .. [4] http://goo.gl/rGyvs | | | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ + | | | | | | asc | | :: | | + | | | | | | | | | | + | | | | | | | | - 内联方式 footnote:[此处定义] 定义的脚注。 | - 内联方式 [5]_ 定义的脚注。 | + | | | | | | | | - 定义脚注时可用一个ID标记 | - 定义脚注时可用一个ID标记 [6]_ 。 | + | | | | | | | | footnoteref:[note6, 可多次引用] 。 | - 引用已定义的脚注 [6]_ 。 | + | | | | | | | | - 引用已定义的脚注 footnoteref:[note6] 。 | | + | | | | | | | | | .. [5] 此处定义 | + | | | | | | | | | .. [6] 可多次引用 | + | | | | | | | | | | + | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | | org | :: | | | | | | | | | | | | - | | | | | | | | Twitter widget in Org homepage[fn:org] | Twitter widget in Org homepage[5]_ | + | | | | | | | | Twitter widget in Org homepage[fn:org] | Twitter widget in Org homepage [7]_ | | | | | | | | | cannot be accessed in Mainland China, which | cannot be accessed in Mainland China, which | | | | | | | | | caused the homepage load very slowly. >:[ | caused the homepage load very slowly. >:[ | | | | | | | | | | | - | | | | | | | | [fn:org] The link is: http://orgmode.org | .. [5] The link is: http://orgmode.org | + | | | | | | | | [fn:org] The link is: http://orgmode.org | .. [7] The link is: http://orgmode.org | | | | | | | | | | | +----------+-----------+-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | 图片 | md | | | | | :: | | @@ -954,6 +999,17 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | .. _imglink2: https://github.com/ | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ + | | | | | asc | | :: | | + | | | | | | | | .. figure:: /images/github.png | + | | | | | | | .GitHub Octocat | :width: 32 | + | | | | | | | image::/images/github.png["Logo",width=32] | | + | | | | | | | | 图：GitHub Octocat | + | | | | | | | - GitHub Logo: | | + | | | | | | | image:/images/github.png["Logo"] | * GitHub Logo: |ascimg| | + | | | | | | | | | + | | | | | | | | .. |ascimg| image:: /images/github.png | + | | | | | | | | | + | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | org | :: | | | | | | | | | | | | | | | | | | * GitHub Logo: [[file:/images/github.png]] | * GitHub Logo: |orgimg| | @@ -1006,6 +1062,20 @@ ttl为Textile，asc为AsciiDoc，org为Org-mode。 | | | | | | | | +---------+-----------------+ | | | | | | | | | | | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ + | | | | | asc | | :: | .. table:: | + | | | | | | | | :class: classic | + | | | | | | | | | + | | | | | | | [width="50%"] | +-----+-----+-----+-----+ | + | | | | | | | |============================ | | 1 | 2 | 3 | 4 | | + | | | | | | | |1 |2 |3 |4 | +-----+-----+-----+-----+ | + | | | | | | | |5 2.2+|6 .3+|7 | | 5 | | | | + | | | | | | | |8 | +-----+ 6 | 7 | | + | | | | | | | |9 2+|10 | | 8 | | | | + | | | | | | | |============================ | +-----+-----------+ | | + | | | | | | | | | 9 | 10 | | | + | | | | | | | | +-----+-----------+-----+ | + | | | | | | | | | + | +-----+-----+-----+-----+-----+-------------------------------------------------+-----------------------------------------------+ | | | | | | org | :: | .. table:: 示例表格 | | | | | | | | | :class: classic | | | | | | | | #+CAPTION: 示例表格 | |