5. 基于结构化文本~ 的图书工程¶
5.1. Shinx 说明¶
参考:
5.1.1. 本书行文体例¶
本书使用不同的体例来区分不同的情景.
5.1.1.1. 精巧地址¶
本书包含很多外部网站的URL地址,但是图书必竟不是网页,读者无法点击进入相关网站;所以,笔者尝试使用URL精简工具来帮助读者可以快速输入自动跳转到原有网站来访问;
- 比如说: 本书的维基入口 http://wiki.woodpecker.org.cn/moin/ObpLovelyPython
- 精巧地址: http://bit.ly/2QA425
- 输入的字符量少了三倍! 这是借助 http://bit.ly 提供的网址精简服务达到的效果;
- 提醒:毕竟这是借用外国的免费服务进行的精简,如果读者输入后不能自动跳转的话,可能是网络问题也可能是服务问题,那就只能麻烦读者重新使用原有的URL进入了;
5.1.1.2. 程序体例¶
使用有语法颜色的代码引用
def foo():
print "Love Python, Love FreeDome"
print "E文标点,.0123456789,中文标点,. "
外部包含:
@route('%s/'%ini.urlprefix)
def index():
__urlog("INFO","idx++")
return template('index.tpl',urlprefix=ini.urlprefix)
5.1.1.3. 文本体例¶
引用,题词:
No matter where you go, there you are.
—Buckaroo Banzai
技巧警示:
Note
(~_~)
- This icon signifies a tip, suggestion, or general note.
Warning
(#_#)
- 警告得注意的...
See also
(^.^)
- 指向参考的...
附加说明:
进一步的
包含题外的信息,笔者心路,等等和正文有关,但是不直接的信息
知识引用:
- 使用边注
- 追随正文
- 活动説明
- 效果如右
5.2. rST排版技巧¶
5.2.1. 线性表格¶
中文的非等宽性导致 rST 这种字符艺术式的图表很难作!
===== =====
A not A
===== =====
False True
True False
===== =====
所以,使用列表也可以方便的生成表格:
.. list-table:: 实例
:widths: 15 10 30
:header-rows: 1
* - Treat
- Quantity
- Description
* - Albatross
- 2.99
- On a stick!
* - Crunchy Frog
- 1.49
- If we took the bones out, it wouldn t be crunchy, now would it?
* - Gannet Ripple
- 1.99
- On a stick!
效果
Treat | Quantity | Description |
---|---|---|
Albatross | 2.99 | On a stick! |
Crunchy Frog | 1.49 | If we took the bones out, it wouldn’t be crunchy, now would it? |
Gannet Ripple | 1.99 | On a stick! |
5.2.2. 线内文字效果¶
除了常设见的斜体,加重,引用之外,还有几个可以方便的将评注和正文进行就地区分的效果:
下标(subscript)和上标(superscript):
H\ :sub:`2`\ O
E = mc\ :sup:`2`
效果:
H2O E = mc2
Note
技巧
这里其实也组合其它指令完成直觉的记述比如说:
水的化学成分是 |H2O|. .. |H2O| replace:: H\ :sub:`2`\ O
效果: 水的化学成分是 H2O
5.3. 段落层次约定¶
使用 reSTsections
最多分5级
大标题
#######################
小标题
**********************
二级标题
=======================
三级标题
-----------------------
四级标题
^^^^^^^^^^^^^^^^^^^^^^^
再小,就使用列表!:
- 列表项目1
- 列表项目2
- ...
效果: