pythonbook/readme.txt at master · xpurer/pythonbook · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
== 注意事项 ==

1.
工程的svn地址
https://pythonbook.googlecode.com/svn/trunk

截图工具
可以使用SnagIt
下载地址
http://ah.anwang.cn/yinyong521/SnagIt%20V8.02%BA%BA%BB%AF%C2%CC%C9%AB%CC%D8%B1%F0%B0%E6.rar
注册码：JVHZD-5DCCA-DUECC-5C5C4-A83M7

截图用jpg格式，质量选98%

2.写作方式
首先明确小节的主题
然后列出具体涉及的知识点

大家就写知识点吧，整个文章的串联我来解决


具体写知识点时注意以下事项：


    1.

    遵循先讲最常用，最实用的功能。

    高级用法，细节区别，可以提及，但是不需要展开。

    在列举知识点时就需要注意这一点。

    因为这本书的定位不是对某个工具进行深入剖析，而是让读者对网站开发涉及的方方面面树立基本的概念。

    重点在于让读者知道有可以这样去做，有这样的工具，以及这些工具最基本也是最常见的用法。

    简单是说，本书的目的在于“师傅领进门”，至于修行那要看个人了。

    2.

    语言尽量通俗，避免抽象的概念和描述,不要纠结于描述的精确性 --- 这毕竟不是发Paper。

    有一个简单的技巧就是让句子尽可能的短：）

    举例
    “
    版本管理是管理在电脑上的文档，程序和其它信息的一种机制。

    它把每次改动作一个编号，叫做版本号。每次提交一个新的改动的时候，版本管理系统会新建一个版本号，记录下每次的改动的内容和对应的修改时间，修改人等信息。

    除此之外，版本管理通常会支持比较，恢复，合并等操作。

    专业的软件开发都需要使用版本管理工具来管理开发的源码和文档，这样的好处有很多，最主要的是可以放心大胆地修改代码，万一误入歧途，可以随时回到之前的时间点，另外，对于多人协同工作，可以方便做代码比较和合并。

    ”

    这样写就是很像乏味无趣的教科书，让人犯困。

    可以改为下面这样

    “
    照相，能帮我们记录下那些美好的旧时光。

    版本管理，就是好像对文件照相。

    有了版本管理，我们就可以轻而易举的“Yesterday , Once More”

    另外，写代码，很多时候并不是一个人在战斗。

    这时候，就需要常常同步各自的改动。

    复制来复制去，麻烦不说，还经常一不小心，就把已有的改动覆盖掉。

    而有了版本管理，无痛同步，是那么的写意自然。
    ”

    3.
    链接用官方的链接
    比如
    """
    他发现最好用的客户端是Tortoisesvn，于是他去http://dl.pconline.com.cn/download/53122.html下载了一个，一路下一步安装起来。
    """

    首先这一段话逻辑有一点小问题，“发现最好用的客户端” -- 没有装怎么发现
    可以把“发现”改为“听说”

    如下
    """
    他听说最好用的客户端Tortoise Svn ,摸索到 http://tortoisesvn.net/downloads ，下载了软件和汉化包，一路Next便安装成功。

    下载Tortoise Svn svn_down.jpg
    """
    其中第二行 svn_down.jpg是配的截图，截取前面配的名字也应该规范，因为他会显示在图片下方。

    4.
    配合描述，多截图
    截图可以反映的，就可以不用重复（可以再截图中配上文字）
    比如

    提交代码需要将要提交的文件放入代码存放目录，点击右键，选择svn update，在窗口上面的消息输入框输入这次改动的内容描述，在窗口下面的改变文件列表中选择要提交的文件，点击确定。文件就被提交了。

    可以精简为，

    点击右键，选择 SVN提交，勾选需要的文件，即可上传改动。如图：


== 内容浏览 ==

打开 html/index.html 就可以浏览内容


== 环境配置 ==

下载安装
http://www.python.org/ftp/python/2.6/python-2.6.msi
http://www.technicalbard.com/files/MySQL-python-1.2.2.win32-py2.6.exe


下载运行
http://peak.telecommunity.com/dist/ez_setup.py

添加
C:\Python26\;C:\Python26\Scripts
到环境变量 PATH


进入命令行，复制粘贴以下命令（可以一次性复制进去）
easy_install -U mako

运行build.py，可以编译文本，生成的html在对于的html目录

文本放在book下面

== 文本格式 ==

小标题：
    == 这是h2 ==
    === 这是h3 ===

加粗:
    [[大规模]]减持美国国债

代码：
    {{{
    select * from user limit 100;
    delete from user where user_id = 1;
    }}}

图片:
    放到img目录,用png格式
    文中引用如

    测试用图 xxx.png


==>
人生啊
人生　　权重板块午后急挫，石化双雄掉头转跌，沪指午后跳水跌破2800点，各行业指数全线尽墨。地产、有色、钢铁板块成为重灾区，光大证券上市次日低开低走午后跌停。
<==