{{ _('Search Results') }}
34 | {% if not search_results %} 35 |{{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}
36 | {% endif %} 37 | {% endif %} 38 |
39 | {% if search_results %}
40 |
50 | {% endblock %}
51 |
--------------------------------------------------------------------------------
/docs/html/_static/js/theme.js:
--------------------------------------------------------------------------------
1 | $( document ).ready(function() {
2 | // Shift nav in mobile when clicking the menu.
3 | $(document).on('click', "[data-toggle='wy-nav-top']", function() {
4 | $("[data-toggle='wy-nav-shift']").toggleClass("shift");
5 | $("[data-toggle='rst-versions']").toggleClass("shift");
6 | });
7 | // Close menu when you click a link.
8 | $(document).on('click', ".wy-menu-vertical .current ul li a", function() {
9 | $("[data-toggle='wy-nav-shift']").removeClass("shift");
10 | $("[data-toggle='rst-versions']").toggleClass("shift");
11 | });
12 | $(document).on('click', "[data-toggle='rst-current-version']", function() {
13 | $("[data-toggle='rst-versions']").toggleClass("shift-up");
14 | });
15 | // Make tables responsive
16 | $("table.docutils:not(.field-list)").wrap("");
17 | });
18 |
19 | window.SphinxRtdTheme = (function (jquery) {
20 | var stickyNav = (function () {
21 | var navBar,
22 | win,
23 | stickyNavCssClass = 'stickynav',
24 | applyStickNav = function () {
25 | if (navBar.height() <= win.height()) {
26 | navBar.addClass(stickyNavCssClass);
27 | } else {
28 | navBar.removeClass(stickyNavCssClass);
29 | }
30 | },
31 | enable = function () {
32 | applyStickNav();
33 | win.on('resize', applyStickNav);
34 | },
35 | init = function () {
36 | navBar = jquery('nav.wy-nav-side:first');
37 | win = jquery(window);
38 | };
39 | jquery(init);
40 | return {
41 | enable : enable
42 | };
43 | }());
44 | return {
45 | StickyNav : stickyNav
46 | };
47 | }($));
48 |
--------------------------------------------------------------------------------
/docs/source/_themes/sphinx_rtd_theme/static/js/theme.js:
--------------------------------------------------------------------------------
1 | $( document ).ready(function() {
2 | // Shift nav in mobile when clicking the menu.
3 | $(document).on('click', "[data-toggle='wy-nav-top']", function() {
4 | $("[data-toggle='wy-nav-shift']").toggleClass("shift");
5 | $("[data-toggle='rst-versions']").toggleClass("shift");
6 | });
7 | // Close menu when you click a link.
8 | $(document).on('click', ".wy-menu-vertical .current ul li a", function() {
9 | $("[data-toggle='wy-nav-shift']").removeClass("shift");
10 | $("[data-toggle='rst-versions']").toggleClass("shift");
11 | });
12 | $(document).on('click', "[data-toggle='rst-current-version']", function() {
13 | $("[data-toggle='rst-versions']").toggleClass("shift-up");
14 | });
15 | // Make tables responsive
16 | $("table.docutils:not(.field-list)").wrap("");
17 | });
18 |
19 | window.SphinxRtdTheme = (function (jquery) {
20 | var stickyNav = (function () {
21 | var navBar,
22 | win,
23 | stickyNavCssClass = 'stickynav',
24 | applyStickNav = function () {
25 | if (navBar.height() <= win.height()) {
26 | navBar.addClass(stickyNavCssClass);
27 | } else {
28 | navBar.removeClass(stickyNavCssClass);
29 | }
30 | },
31 | enable = function () {
32 | applyStickNav();
33 | win.on('resize', applyStickNav);
34 | },
35 | init = function () {
36 | navBar = jquery('nav.wy-nav-side:first');
37 | win = jquery(window);
38 | };
39 | jquery(init);
40 | return {
41 | enable : enable
42 | };
43 | }());
44 | return {
45 | StickyNav : stickyNav
46 | };
47 | }($));
48 |
--------------------------------------------------------------------------------
/docs/source/appetite.rst:
--------------------------------------------------------------------------------
1 | .. _tut-intro:
2 |
3 | **********************
4 | 开胃菜
5 | **********************
6 |
7 | 如果你要用计算机做很多工作，最后你会发现有一些任务你更希望用自动化的方式进行处理。 比如，你想要在大量的文本文件中执行查找/替换，或者以复杂的方式对大量的图片进行重命名和整理。 也许你想要编写一个小型的自定义数据库、一个特殊的 GUI 应用程序或一个简单的小游戏。
8 |
9 |
10 | 如果你是一名专业的软件开发者，可能你必须使用几种 C/C++/JAVA 类库，并且发现通常编写/编译/测试/重新编译的周期是如此漫长。 也许你正在为这些类库编写测试用例，但是发现这是一个让人烦躁的工作。 又或者你已经完成了一个可以使用扩展语言的程序，但你并不想为此重新设计并实现一套全新的语言。
11 |
12 |
13 | 那么 Python 正是你所需要的语言。
14 |
15 |
16 | 虽然你能够通过编写 Unix shell 脚本或 Windows 批处理文件来处理其中的某些任务，但 Shell 脚本更适合移动文件或修改文本数据，并不适合编写 GUI 应用程序或游戏；虽然你能够使用 C/C++/JAVA 编写程序，但即使编写一个简单的 first-draft 程序也有可能耗费大量的开发时间。相比之下，Python 更易于使用，无论在 Windows、Mac OS X 或 Unix 操作系统上它都会帮助你更快地完成任务。
17 |
18 |
19 | 虽然 Python 易于使用，但它却是一门完整的编程语言；与 Shell 脚本或批处理文件相比，它为编写大型程序提供了更多的结构和支持。另一方面，Python 提供了比 C 更多的错误检查，并且作为一门 *高级语言* ，它内置支持高级的数据结构类型，例如：灵活的数组和字典。因其具有更多的通用数据类型，同 Awk 甚至 Perl 相比较，Python 适用于更多领域，至少大多数事情在 Python 中与其他语言同样简单。
20 |
21 |
22 | Python 允许你将程序分割为不同的模块，以便在其他的 Python 程序中重用。Python 内置提供了大量的标准模块，你可以将其用作程序的基础，或者作为学习 Python 编程的示例。 这些模块提供了诸如文件 I/O、系统调用、Socket 支持，甚至类似 Tk 的用户图形界面(GUI)工具包接口。
23 |
24 |
25 | Python 是一门解释型语言，因为无需编译和链接，你可以在程序开发中节省宝贵的时间。Python 解释器可以交互地使用，这使得试验语言的特性、编写临时程序或在自底向上的程序开发中测试方法非常容易。 你甚至还可以把它当做一个桌面计算器。
26 |
27 |
28 | Python 让程序编写的紧凑和可读。用 Python 编写的程序通常比同样的 C、C++ 或 Java 程序更短小，这是因为以下几个原因：
29 |
30 | * 高级数据结构使你可以在一条语句中表达复杂的操作；
31 |
32 | * 语句组使用缩进代替开始和结束大括号来组织；
33 |
34 | * 变量或参数无需声明。
35 |
36 |
37 | Python 是 *可扩展* 的：如果你会 C 语言编程便可以轻易的为解释器添加内置函数或模块，或者为了对性能瓶颈作优化，或者将 Python 程序与只有二进制形式的库(比如某个专业的商业图形库)连接起来。一旦你真正掌握了它，你可以将 Python 解释器集成进某个 C 应用程序，并把它当作那个程序的扩展或命令行语言。
38 |
39 |
40 | 顺便说一句，这个语言的名字来自于 BBC 的 "Monty Python’s Flying Cirecus" 节目，和爬行类动物没有任何关系。在文档中引用 Monty Python 的典故不仅可行，而且值得鼓励！
41 |
42 |
43 | 现在你已经为 Python 兴奋不已了吧，迫不及待地想要领略更多的细节！ 学习一门语言最好的方法就是使用它，本指南推荐你边读边使用 Python 解释器练习。
44 |
45 |
46 | 下一节中，我们将解释 Python 解释器的用法。这是很简单的一件事情，但它有助于试验后面的例子。
47 |
48 |
49 | 本手册剩下的部分将通过示例介绍 Python 语言及系统的诸多特性，开始是简单的语法、数据类型和表达式，接着介绍函数与模块，最后涉及异常和自定义类这样的高级内容。
50 |
51 |
52 |
53 |
54 |
55 |
--------------------------------------------------------------------------------
/docs/html/_sources/appetite.txt:
--------------------------------------------------------------------------------
1 | .. _tut-intro:
2 |
3 | **********************
4 | 开胃菜
5 | **********************
6 |
7 | 如果你要用计算机做很多工作，最后你会发现有一些任务你更希望用自动化的方式进行处理。 比如，你想要在大量的文本文件中执行查找/替换，或者以复杂的方式对大量的图片进行重命名和整理。 也许你想要编写一个小型的自定义数据库、一个特殊的 GUI 应用程序或一个简单的小游戏。
8 |
9 |
10 | 如果你是一名专业的软件开发者，可能你必须使用几种 C/C++/JAVA 类库，并且发现通常编写/编译/测试/重新编译的周期是如此漫长。 也许你正在为这些类库编写测试用例，但是发现这是一个让人烦躁的工作。 又或者你已经完成了一个可以使用扩展语言的程序，但你并不想为此重新设计并实现一套全新的语言。
11 |
12 |
13 | 那么 Python 正是你所需要的语言。
14 |
15 |
16 | 虽然你能够通过编写 Unix shell 脚本或 Windows 批处理文件来处理其中的某些任务，但 Shell 脚本更适合移动文件或修改文本数据，并不适合编写 GUI 应用程序或游戏；虽然你能够使用 C/C++/JAVA 编写程序，但即使编写一个简单的 first-draft 程序也有可能耗费大量的开发时间。相比之下，Python 更易于使用，无论在 Windows、Mac OS X 或 Unix 操作系统上它都会帮助你更快地完成任务。
17 |
18 |
19 | 虽然 Python 易于使用，但它却是一门完整的编程语言；与 Shell 脚本或批处理文件相比，它为编写大型程序提供了更多的结构和支持。另一方面，Python 提供了比 C 更多的错误检查，并且作为一门 *高级语言* ，它内置支持高级的数据结构类型，例如：灵活的数组和字典。因其具有更多的通用数据类型，同 Awk 甚至 Perl 相比较，Python 适用于更多领域，至少大多数事情在 Python 中与其他语言同样简单。
20 |
21 |
22 | Python 允许你将程序分割为不同的模块，以便在其他的 Python 程序中重用。Python 内置提供了大量的标准模块，你可以将其用作程序的基础，或者作为学习 Python 编程的示例。 这些模块提供了诸如文件 I/O、系统调用、Socket 支持，甚至类似 Tk 的用户图形界面(GUI)工具包接口。
23 |
24 |
25 | Python 是一门解释型语言，因为无需编译和链接，你可以在程序开发中节省宝贵的时间。Python 解释器可以交互地使用，这使得试验语言的特性、编写临时程序或在自底向上的程序开发中测试方法非常容易。 你甚至还可以把它当做一个桌面计算器。
26 |
27 |
28 | Python 让程序编写的紧凑和可读。用 Python 编写的程序通常比同样的 C、C++ 或 Java 程序更短小，这是因为以下几个原因：
29 |
30 | * 高级数据结构使你可以在一条语句中表达复杂的操作；
31 |
32 | * 语句组使用缩进代替开始和结束大括号来组织；
33 |
34 | * 变量或参数无需声明。
35 |
36 |
37 | Python 是 *可扩展* 的：如果你会 C 语言编程便可以轻易的为解释器添加内置函数或模块，或者为了对性能瓶颈作优化，或者将 Python 程序与只有二进制形式的库(比如某个专业的商业图形库)连接起来。一旦你真正掌握了它，你可以将 Python 解释器集成进某个 C 应用程序，并把它当作那个程序的扩展或命令行语言。
38 |
39 |
40 | 顺便说一句，这个语言的名字来自于 BBC 的 "Monty Python’s Flying Cirecus" 节目，和爬行类动物没有任何关系。在文档中引用 Monty Python 的典故不仅可行，而且值得鼓励！
41 |
42 |
43 | 现在你已经为 Python 兴奋不已了吧，迫不及待地想要领略更多的细节！ 学习一门语言最好的方法就是使用它，本指南推荐你边读边使用 Python 解释器练习。
44 |
45 |
46 | 下一节中，我们将解释 Python 解释器的用法。这是很简单的一件事情，但它有助于试验后面的例子。
47 |
48 |
49 | 本手册剩下的部分将通过示例介绍 Python 语言及系统的诸多特性，开始是简单的语法、数据类型和表达式，接着介绍函数与模块，最后涉及异常和自定义类这样的高级内容。
50 |
51 |
52 |
53 |
54 |
55 |
--------------------------------------------------------------------------------
/docs/source/appendix.rst:
--------------------------------------------------------------------------------
1 | .. _tut-appendix:
2 |
3 | ********
4 | 附录
5 | ********
6 |
7 |
8 | .. _tut-interac:
9 |
10 | 交互模式
11 | ================
12 |
13 | .. _tut-error:
14 |
15 | 错误处理
16 | --------------
17 |
18 | 有错误发生时，解释器会打印一个错误信息和栈跟踪器。在交互模式下，它返回主提示符，如果从文件输入执行，它在打印栈跟踪器后以非零状态退出。(异常可以由 `try -
41 | {% for href, caption, context in search_results %}
42 |
-
43 | {{ caption }}
44 |
{{ context|e }}
45 |
46 | {% endfor %}
47 |
81 |
82 | {# SIDE NAV, TOGGLES ON MOBILE #}
83 |
104 |
105 |
106 |
107 | {# MOBILE NAV, TRIGGLES SIDE NAV ON TOGGLE #}
108 |
112 |
113 |
114 | {# PAGE CONTENT #}
115 |
126 |
127 |
128 | {% include "versions.html" %}
129 |
130 | {% if not embedded %}
131 |
132 |
141 | {%- for scriptfile in script_files %}
142 |
143 | {%- endfor %}
144 |
145 | {% endif %}
146 |
147 | {# RTD hosts this file, so just load on non RTD builds #}
148 | {% if not READTHEDOCS %}
149 |
150 | {% endif %}
151 |
152 | {# STICKY NAVIGATION #}
153 | {% if theme_sticky_navigation %}
154 |
159 | {% endif %}
160 |
161 | {%- block footer %} {% endblock %}
162 |
163 |
164 |
165 |
--------------------------------------------------------------------------------
/docs/Makefile:
--------------------------------------------------------------------------------
1 | # Makefile for Sphinx documentation
2 | #
3 |
4 | # You can set these variables from the command line.
5 | SPHINXOPTS =
6 | SPHINXBUILD = sphinx-build
7 | PAPER =
8 | BUILDDIR = build
9 |
10 | # User-friendly check for sphinx-build
11 | ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
12 | $(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
13 | endif
14 |
15 | # Internal variables.
16 | PAPEROPT_a4 = -D latex_paper_size=a4
17 | PAPEROPT_letter = -D latex_paper_size=letter
18 | ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
19 | # the i18n builder cannot share the environment and doctrees with the others
20 | I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) source
21 |
22 | .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
23 |
24 | help:
25 | @echo "Please use \`make
116 |
124 |
125 |
117 | {% include "breadcrumbs.html" %}
118 |
123 |
119 | {% block body %}{% endblock %}
120 |
121 | {% include "footer.html" %}
122 |
51 |
84 | {%- endif %}
85 | {%- endmacro %}
86 |
87 | {%- macro script() %}
88 |
97 | {%- for scriptfile in script_files %}
98 |
99 | {%- endfor %}
100 | {%- endmacro %}
101 |
102 | {%- macro css() %}
103 |
104 |
105 | {%- for cssfile in css_files %}
106 |
107 | {%- endfor %}
108 | {%- endmacro %}
109 |
110 |
111 |
112 |
113 | {{ metatags }}
114 | {%- block htmltitle %}
115 |
52 | {%- block sidebarlogo %}
53 | {%- if logo %}
54 |
57 | {%- endif %}
58 | {%- endblock %}
59 | {%- if sidebars != None %}
60 | {#- new style sidebar: explicitly include/exclude templates #}
61 | {%- for sidebartemplate in sidebars %}
62 | {%- include sidebartemplate %}
63 | {%- endfor %}
64 | {%- else %}
65 | {#- old style sidebars: using blocks -- should be deprecated #}
66 | {%- block sidebartoc %}
67 | {%- include "localtoc.html" %}
68 | {%- endblock %}
69 | {%- block sidebarrel %}
70 | {%- include "relations.html" %}
71 | {%- endblock %}
72 | {%- block sidebarsourcelink %}
73 | {%- include "sourcelink.html" %}
74 | {%- endblock %}
75 | {%- if customsidebar %}
76 | {%- include customsidebar %}
77 | {%- endif %}
78 | {%- block sidebarsearch %}
79 | {%- include "searchbox.html" %}
80 | {%- endblock %}
81 | {%- endif %}
82 |
83 |
164 | {%- block document %}
165 |
181 | {%- endblock %}
182 |
183 | {%- block relbar2 %}{{ relbar() }}{% endblock %}
184 |
185 | {%- block footer %}
186 |
201 |
166 | {%- if render_sidebar %}
167 |
176 | {%- endblock %}
177 |
178 | {%- block sidebar2 %}{{ sidebar() }}{% endblock %}
179 |
180 |
168 | {%- endif %}
169 |
174 | {%- endif %}
175 |
170 | {% block body %} {% endblock %}
171 |
172 | {%- if render_sidebar %}
173 | asdf asdf asdf asdf 22
202 | {%- endblock %} 203 | 204 | 205 | 206 | -------------------------------------------------------------------------------- /docs/html/_static/doctools.js: -------------------------------------------------------------------------------- 1 | /* 2 | * doctools.js 3 | * ~~~~~~~~~~~ 4 | * 5 | * Sphinx JavaScript utilities for all documentation. 6 | * 7 | * :copyright: Copyright 2007-2016 by the Sphinx team, see AUTHORS. 8 | * :license: BSD, see LICENSE for details. 9 | * 10 | */ 11 | 12 | /** 13 | * select a different prefix for underscore 14 | */ 15 | $u = _.noConflict(); 16 | 17 | /** 18 | * make the code below compatible with browsers without 19 | * an installed firebug like debugger 20 | if (!window.console || !console.firebug) { 21 | var names = ["log", "debug", "info", "warn", "error", "assert", "dir", 22 | "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", 23 | "profile", "profileEnd"]; 24 | window.console = {}; 25 | for (var i = 0; i < names.length; ++i) 26 | window.console[names[i]] = function() {}; 27 | } 28 | */ 29 | 30 | /** 31 | * small helper function to urldecode strings 32 | */ 33 | jQuery.urldecode = function(x) { 34 | return decodeURIComponent(x).replace(/\+/g, ' '); 35 | }; 36 | 37 | /** 38 | * small helper function to urlencode strings 39 | */ 40 | jQuery.urlencode = encodeURIComponent; 41 | 42 | /** 43 | * This function returns the parsed url parameters of the 44 | * current request. Multiple values per key are supported, 45 | * it will always return arrays of strings for the value parts. 46 | */ 47 | jQuery.getQueryParameters = function(s) { 48 | if (typeof s == 'undefined') 49 | s = document.location.search; 50 | var parts = s.substr(s.indexOf('?') + 1).split('&'); 51 | var result = {}; 52 | for (var i = 0; i < parts.length; i++) { 53 | var tmp = parts[i].split('=', 2); 54 | var key = jQuery.urldecode(tmp[0]); 55 | var value = jQuery.urldecode(tmp[1]); 56 | if (key in result) 57 | result[key].push(value); 58 | else 59 | result[key] = [value]; 60 | } 61 | return result; 62 | }; 63 | 64 | /** 65 | * highlight a given string on a jquery object by wrapping it in 66 | * span elements with the given class name. 67 | */ 68 | jQuery.fn.highlightText = function(text, className) { 69 | function highlight(node) { 70 | if (node.nodeType == 3) { 71 | var val = node.nodeValue; 72 | var pos = val.toLowerCase().indexOf(text); 73 | if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { 74 | var span = document.createElement("span"); 75 | span.className = className; 76 | span.appendChild(document.createTextNode(val.substr(pos, text.length))); 77 | node.parentNode.insertBefore(span, node.parentNode.insertBefore( 78 | document.createTextNode(val.substr(pos + text.length)), 79 | node.nextSibling)); 80 | node.nodeValue = val.substr(0, pos); 81 | } 82 | } 83 | else if (!jQuery(node).is("button, select, textarea")) { 84 | jQuery.each(node.childNodes, function() { 85 | highlight(this); 86 | }); 87 | } 88 | } 89 | return this.each(function() { 90 | highlight(this); 91 | }); 92 | }; 93 | 94 | /* 95 | * backward compatibility for jQuery.browser 96 | * This will be supported until firefox bug is fixed. 97 | */ 98 | if (!jQuery.browser) { 99 | jQuery.uaMatch = function(ua) { 100 | ua = ua.toLowerCase(); 101 | 102 | var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || 103 | /(webkit)[ \/]([\w.]+)/.exec(ua) || 104 | /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || 105 | /(msie) ([\w.]+)/.exec(ua) || 106 | ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || 107 | []; 108 | 109 | return { 110 | browser: match[ 1 ] || "", 111 | version: match[ 2 ] || "0" 112 | }; 113 | }; 114 | jQuery.browser = {}; 115 | jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; 116 | } 117 | 118 | /** 119 | * Small JavaScript module for the documentation. 120 | */ 121 | var Documentation = { 122 | 123 | init : function() { 124 | this.fixFirefoxAnchorBug(); 125 | this.highlightSearchWords(); 126 | this.initIndexTable(); 127 | 128 | }, 129 | 130 | /** 131 | * i18n support 132 | */ 133 | TRANSLATIONS : {}, 134 | PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, 135 | LOCALE : 'unknown', 136 | 137 | // gettext and ngettext don't access this so that the functions 138 | // can safely bound to a different name (_ = Documentation.gettext) 139 | gettext : function(string) { 140 | var translated = Documentation.TRANSLATIONS[string]; 141 | if (typeof translated == 'undefined') 142 | return string; 143 | return (typeof translated == 'string') ? translated : translated[0]; 144 | }, 145 | 146 | ngettext : function(singular, plural, n) { 147 | var translated = Documentation.TRANSLATIONS[singular]; 148 | if (typeof translated == 'undefined') 149 | return (n == 1) ? singular : plural; 150 | return translated[Documentation.PLURALEXPR(n)]; 151 | }, 152 | 153 | addTranslations : function(catalog) { 154 | for (var key in catalog.messages) 155 | this.TRANSLATIONS[key] = catalog.messages[key]; 156 | this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); 157 | this.LOCALE = catalog.locale; 158 | }, 159 | 160 | /** 161 | * add context elements like header anchor links 162 | */ 163 | addContextElements : function() { 164 | $('div[id] > :header:first').each(function() { 165 | $('\u00B6'). 166 | attr('href', '#' + this.id). 167 | attr('title', _('Permalink to this headline')). 168 | appendTo(this); 169 | }); 170 | $('dt[id]').each(function() { 171 | $('\u00B6'). 172 | attr('href', '#' + this.id). 173 | attr('title', _('Permalink to this definition')). 174 | appendTo(this); 175 | }); 176 | }, 177 | 178 | /** 179 | * workaround a firefox stupidity 180 | * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 181 | */ 182 | fixFirefoxAnchorBug : function() { 183 | if (document.location.hash) 184 | window.setTimeout(function() { 185 | document.location.href += ''; 186 | }, 10); 187 | }, 188 | 189 | /** 190 | * highlight the search words provided in the url in the text 191 | */ 192 | highlightSearchWords : function() { 193 | var params = $.getQueryParameters(); 194 | var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; 195 | if (terms.length) { 196 | var body = $('div.body'); 197 | if (!body.length) { 198 | body = $('body'); 199 | } 200 | window.setTimeout(function() { 201 | $.each(terms, function() { 202 | body.highlightText(this.toLowerCase(), 'highlighted'); 203 | }); 204 | }, 10); 205 | $('' + _('Hide Search Matches') + '
') 207 | .appendTo($('#searchbox')); 208 | } 209 | }, 210 | 211 | /** 212 | * init the domain index toggle buttons 213 | */ 214 | initIndexTable : function() { 215 | var togglers = $('img.toggler').click(function() { 216 | var src = $(this).attr('src'); 217 | var idnum = $(this).attr('id').substr(7); 218 | $('tr.cg-' + idnum).toggle(); 219 | if (src.substr(-9) == 'minus.png') 220 | $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); 221 | else 222 | $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); 223 | }).css('display', ''); 224 | if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { 225 | togglers.click(); 226 | } 227 | }, 228 | 229 | /** 230 | * helper function to hide the search marks again 231 | */ 232 | hideSearchWords : function() { 233 | $('#searchbox .highlight-link').fadeOut(300); 234 | $('span.highlighted').removeClass('highlighted'); 235 | }, 236 | 237 | /** 238 | * make the url absolute 239 | */ 240 | makeURL : function(relativeURL) { 241 | return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; 242 | }, 243 | 244 | /** 245 | * get the current relative url 246 | */ 247 | getCurrentURL : function() { 248 | var path = document.location.pathname; 249 | var parts = path.split(/\//); 250 | $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { 251 | if (this == '..') 252 | parts.pop(); 253 | }); 254 | var url = parts.join('/'); 255 | return path.substring(url.lastIndexOf('/') + 1, path.length - 1); 256 | }, 257 | 258 | initOnKeyListeners: function() { 259 | $(document).keyup(function(event) { 260 | var activeElementType = document.activeElement.tagName; 261 | // don't navigate when in search box or textarea 262 | if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT') { 263 | switch (event.keyCode) { 264 | case 37: // left 265 | var prevHref = $('link[rel="prev"]').prop('href'); 266 | if (prevHref) { 267 | window.location.href = prevHref; 268 | return false; 269 | } 270 | case 39: // right 271 | var nextHref = $('link[rel="next"]').prop('href'); 272 | if (nextHref) { 273 | window.location.href = nextHref; 274 | return false; 275 | } 276 | } 277 | } 278 | }); 279 | } 280 | }; 281 | 282 | // quick alias for translations 283 | _ = Documentation.gettext; 284 | 285 | $(document).ready(function() { 286 | Documentation.init(); 287 | }); -------------------------------------------------------------------------------- /docs/source/stdlib.rst: -------------------------------------------------------------------------------- 1 | .. _tut-brieftour: 2 | 3 | ********************************** 4 | Python 标准库概览 5 | ********************************** 6 | 7 | 8 | .. _tut-os-interface: 9 | 10 | 操作系统接口 11 | ========================== 12 | 13 | `osNov. 25, 09:43:32 PM EST 139 | 140 | >>> import smtplib 141 | >>> server = smtplib.SMTP('localhost') 142 | >>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org', 143 | ... """To: jcaesar@example.org 144 | ... From: soothsayer@example.org 145 | ... 146 | ... Beware the Ides of March. 147 | ... """) 148 | >>> server.quit() 149 | 150 | (注意第二个例子需要在 localhost 运行一个邮件服务器。) 151 | 152 | 153 | .. _tut-dates-and-times: 154 | 155 | 日期和时间 156 | =============== 157 | 158 | `datetime
Nov. 25, 09:43:32 PM EST 139 | 140 | >>> import smtplib 141 | >>> server = smtplib.SMTP('localhost') 142 | >>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org', 143 | ... """To: jcaesar@example.org 144 | ... From: soothsayer@example.org 145 | ... 146 | ... Beware the Ides of March. 147 | ... """) 148 | >>> server.quit() 149 | 150 | (注意第二个例子需要在 localhost 运行一个邮件服务器。) 151 | 152 | 153 | .. _tut-dates-and-times: 154 | 155 | 日期和时间 156 | =============== 157 | 158 | `datetime