Skip to content

Commit 87f7401

Browse files
committed
Website build
1 parent 2582171 commit 87f7401

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

62 files changed

+2489
-2515
lines changed

.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: 8449a797b2ae3fe81e52a0cea1a33ab7
3+
config: abadfc60ad7afb2b31d08feea92d83d7
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

0_preface.html

Lines changed: 32 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,18 @@
1-
21
<!DOCTYPE html>
32

4-
<html>
3+
<html lang="en" data-content_root="./">
54
<head>
65
<meta charset="utf-8" />
7-
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
6+
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
87

98
<title>Preface &#8212; Object-oriented Programming documentation</title>
10-
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
11-
<link rel="stylesheet" type="text/css" href="_static/fenics.css" />
9+
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=fa44fd50" />
10+
<link rel="stylesheet" type="text/css" href="_static/fenics.css?v=8c7d05f9" />
1211
<link rel="stylesheet" type="text/css" href="_static/proof.css" />
13-
<link rel="stylesheet" type="text/css" href="_static/graphviz.css" />
14-
<link rel="stylesheet" type="text/css" href="_static/panels-main.c949a650a448cc0ae9fd3441c0e17fb0.css" />
15-
<link rel="stylesheet" type="text/css" href="_static/panels-bootstrap.5fd3999ee7762ccc51105388f4a9d115.css" />
16-
<link rel="stylesheet" type="text/css" href="_static/panels-variables.06eb56fa6e07937060861dad626602ad.css" />
17-
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
18-
<script src="_static/jquery.js"></script>
19-
<script src="_static/underscore.js"></script>
20-
<script src="_static/doctools.js"></script>
12+
<link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=eafc0fe6" />
13+
<script src="_static/documentation_options.js?v=5929fcd5"></script>
14+
<script src="_static/doctools.js?v=888ff710"></script>
15+
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
2116
<script src="_static/proof.js"></script>
2217
<link rel="index" title="Index" href="genindex.html" />
2318
<link rel="search" title="Search" href="search.html" />
@@ -65,7 +60,7 @@
6560
<div class="body" role="main">
6661

6762
<section id="preface">
68-
<h1>Preface<a class="headerlink" href="#preface" title="Permalink to this headline"></a></h1>
63+
<h1>Preface<a class="headerlink" href="#preface" title="Link to this heading"></a></h1>
6964
<p>Computers have revolutionised mathematics and the many scientific, engineering,
7065
and economic fields in which mathematics is applied. In the applications of
7166
mathematics the role of computation has long been obvious and prominent. Now,
@@ -90,7 +85,7 @@ <h1>Preface<a class="headerlink" href="#preface" title="Permalink to this headli
9085
need to make effective use of computers in their further studies or working
9186
careers.</p>
9287
<section id="what-is-this-book-for">
93-
<h2>What is this book for?<a class="headerlink" href="#what-is-this-book-for" title="Permalink to this headline"></a></h2>
88+
<h2>What is this book for?<a class="headerlink" href="#what-is-this-book-for" title="Link to this heading"></a></h2>
9489
<p>This book is the result of a significant change in the mathematics curriculum
9590
at Imperial College London. Rather than assume that students will somehow
9691
acquire programming skills along the way, we have introduced first and second
@@ -119,7 +114,7 @@ <h2>What is this book for?<a class="headerlink" href="#what-is-this-book-for" ti
119114
the converse.</p>
120115
</section>
121116
<section id="who-is-this-book-for">
122-
<h2>Who is this book for?<a class="headerlink" href="#who-is-this-book-for" title="Permalink to this headline"></a></h2>
117+
<h2>Who is this book for?<a class="headerlink" href="#who-is-this-book-for" title="Link to this heading"></a></h2>
123118
<p>This book is for anyone with mathematical, scientific, or engineering interests
124119
who would like to learn to be a more capable programmer. The mathematical
125120
examples assume that you know how to differentiate functions of one variable,
@@ -142,22 +137,22 @@ <h2>Who is this book for?<a class="headerlink" href="#who-is-this-book-for" titl
142137
scratch in <a class="reference internal" href="2_programs_in_files.html#programs-files"><span class="std std-numref">Chapter 2</span></a>.</p>
143138
</section>
144139
<section id="how-to-use-this-book">
145-
<h2>How to use this book<a class="headerlink" href="#how-to-use-this-book" title="Permalink to this headline"></a></h2>
140+
<h2>How to use this book<a class="headerlink" href="#how-to-use-this-book" title="Link to this heading"></a></h2>
146141
<p>You can, of course, simply sit down and read this book from cover to cover,
147142
or dip in to see what it has to say on particular subjects. However,
148143
reading a book about programming will not teach you to program. For that,
149144
you need to get your hands dirty writing code and debugging your mistakes.
150145
The videos and exercises throughout the book are designed to help you do
151146
this.</p>
152147
<section id="the-videos">
153-
<h3>The videos<a class="headerlink" href="#the-videos" title="Permalink to this headline"></a></h3>
148+
<h3>The videos<a class="headerlink" href="#the-videos" title="Link to this heading"></a></h3>
154149
<p>The videos were created to accompany the course at Imperial College London.
155150
They’re not primarily lecture videos but are instead practical demonstrations
156151
of the programming concepts being introduced at the relevant point. Usually
157152
it’s better to watch the video <em>after</em> reading the relevant section.</p>
158153
</section>
159154
<section id="the-exercises">
160-
<h3>The exercises<a class="headerlink" href="#the-exercises" title="Permalink to this headline"></a></h3>
155+
<h3>The exercises<a class="headerlink" href="#the-exercises" title="Link to this heading"></a></h3>
161156
<p>At the end of each chapter are exercises. These usually depend on a skeleton
162157
code which is available on GitHub. Sometimes you might be asked to complete a
163158
piece of code while on other occasions you’ll need to write a whole Python
@@ -167,12 +162,12 @@ <h3>The exercises<a class="headerlink" href="#the-exercises" title="Permalink to
167162
feedback and enable you to know how you are doing. Links to the skeleton code
168163
for each chapter are provided at:</p>
169164
<blockquote>
170-
<div><p><a class="reference external" href="https://object-oriented-python.github.io/edition2/exercises.html">https://object-oriented-python.github.io/edition2/exercises.html</a></p>
165+
<div><p><a class="reference external" href="https://object-oriented-python.github.io/edition3/exercises.html">https://object-oriented-python.github.io/edition3/exercises.html</a></p>
171166
</div></blockquote>
172167
</section>
173168
</section>
174169
<section id="conventions-employed">
175-
<h2>Conventions employed<a class="headerlink" href="#conventions-employed" title="Permalink to this headline"></a></h2>
170+
<h2>Conventions employed<a class="headerlink" href="#conventions-employed" title="Link to this heading"></a></h2>
176171
<p>Each chapter starts by introducing new material, supported by the videos and
177172
exercises. At the end of each chapter is a glossary containing many of the key
178173
concepts introduced in that chapter. Terms to be found in a glossary are given
@@ -196,15 +191,15 @@ <h2>Conventions employed<a class="headerlink" href="#conventions-employed" title
196191
</div>
197192
</section>
198193
<section id="teaching-this-course-elsewhere">
199-
<h2>Teaching this course elsewhere<a class="headerlink" href="#teaching-this-course-elsewhere" title="Permalink to this headline"></a></h2>
194+
<h2>Teaching this course elsewhere<a class="headerlink" href="#teaching-this-course-elsewhere" title="Link to this heading"></a></h2>
200195
<p>The course of which this book forms the text has been given to master’s
201196
students at the University of Oxford, as well as to undergraduate students at
202197
Imperial College London. Instructors are welcome to use this material to teach
203198
elsewhere, and are encouraged to contact the author for assistance with access
204199
to materials.</p>
205200
</section>
206201
<section id="acknowledgements">
207-
<h2>Acknowledgements<a class="headerlink" href="#acknowledgements" title="Permalink to this headline"></a></h2>
202+
<h2>Acknowledgements<a class="headerlink" href="#acknowledgements" title="Link to this heading"></a></h2>
208203
<p>The course Principles of Programming, and the notes on which this book is
209204
based, were first delivered in spring 2020, when university teaching was
210205
completely online during the COVID pandemic. I’d like to thank teaching fellow
@@ -228,15 +223,21 @@ <h2>Acknowledgements<a class="headerlink" href="#acknowledgements" title="Permal
228223
single source. Thanks are due to its authors as well as those of the underlying
229224
LaTeX and TeX typesetting systems.</p>
230225
</section>
231-
<section id="changes-in-the-second-edition">
232-
<h2>Changes in the second edition<a class="headerlink" href="#changes-in-the-second-edition" title="Permalink to this headline"></a></h2>
233-
<p>The second edition is a minor update correcting numerous small issues that have
234-
been pointed out over the last year. A more substantive change is that the
235-
explanation of packaging in <a class="reference internal" href="2_programs_in_files.html#programs-files"><span class="std std-numref">Section 2</span></a> has been modernised to use
226+
<section id="changes-in-the-second-and-third-editions">
227+
<h2>Changes in the second and third editions<a class="headerlink" href="#changes-in-the-second-and-third-editions" title="Link to this heading"></a></h2>
228+
<p>The second edition was a minor update correcting numerous small issues that have
229+
been pointed out over the last year. A more substantive change was that the
230+
explanation of packaging in <a class="reference internal" href="2_programs_in_files.html#programs-files"><span class="std std-numref">Section 2</span></a> was modernised to use
236231
<code class="file docutils literal notranslate"><span class="pre">pyproject.toml</span></code> in place of <code class="xref py py-obj docutils literal notranslate"><span class="pre">setup.py</span></code>.
237-
<a class="reference internal" href="3_objects.html#assignment-and-instantiation"><span class="std std-numref">Section 3.5</span></a> has been added in response to confusion
232+
<a class="reference internal" href="3_objects.html#assignment-and-instantiation"><span class="std std-numref">Section 3.5</span></a> was added in response to confusion
238233
expressed by a number of students about the distinction between instantiating
239234
new objects and assigning new variable names to existing objects.</p>
235+
<p>The third edition is similarly a minor update. In documents Visual Studio Code
236+
workspaces in <a class="reference internal" href="2_programs_in_files.html#workspaces"><span class="std std-numref">Section 2.2.1</span></a>, and the Flake8 extension in
237+
<a class="reference internal" href="4_style.html#flake8-extension"><span class="std std-numref">Section 4.2.2</span></a>. Together, these provide correctly integrated code
238+
linting. It also consistently uses <code class="xref py py-obj docutils literal notranslate"><span class="pre">python</span> <span class="pre">-m</span></code> to invoke tools such as <code class="xref py py-obj docutils literal notranslate"><span class="pre">pip</span></code>,
239+
<a class="reference external" href="https://docs.pytest.org/en/latest/index.html#module-pytest" title="(in pytest v0.1.dev171+gb73b4c4)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">pytest</span></code></a> and <code class="xref py py-obj docutils literal notranslate"><span class="pre">flake8</span></code>. This is less error-prone for students. The description
240+
of <a class="reference external" href="https://docs.python.org/3/reference/compound_stmts.html#finally" title="(in Python v3.11)"><code class="xref std std-keyword docutils literal notranslate"><span class="pre">finally</span></code></a> in <a class="reference internal" href="6_exceptions.html#else-finally"><span class="std std-numref">Section 6.5.2</span></a> has been also improved.</p>
240241
</section>
241242
</section>
242243

@@ -248,8 +249,8 @@ <h2>Changes in the second edition<a class="headerlink" href="#changes-in-the-sec
248249
<div class="clearer"></div>
249250
</div>
250251
<div class="footer" role="contentinfo">
251-
&#169; Copyright 2019-2023, David A. Ham.
252-
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 4.5.0.
252+
&#169; Copyright 2019-2023, David A. Ham.
253+
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.2.6.
253254
</div>
254255
</body>
255256
</html>

0 commit comments

Comments
 (0)