Skip to content

Commit 15fd53b

Browse files
committed
started content revamp
1 parent 7caf27e commit 15fd53b

File tree

1 file changed

+119
-37
lines changed

1 file changed

+119
-37
lines changed

index.html

Lines changed: 119 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -4,41 +4,123 @@
44
---
55

66
<body>
7-
<h1>Introduction</h1>
8-
<p>
9-
"Where can I learn how to use pygame?" - one of the
10-
most commonly asked questions that I get. But we always struggle to
11-
answer. We sometimes point them to the docs and examples, but that
12-
isn't a comprehensive guide on building good pygame-based applications.
13-
There are many other tutorials and guides we have found, but we always
14-
find something lacking. There are many comments we give and many nitpicks we have
15-
- so much so that some of us gathered and decided to put all of them into a book.
16-
This book.
17-
</p>
18-
19-
<h1>Table of contents</h1>
20-
<h2>Working towards a simple platformer</h2>
21-
<ol>
22-
<li><a href="/guide/intro/setup">Base setup and opening a window</a></li>
23-
<li><a href="/guide/intro/shapes">Drawing shapes</a></li>
24-
<li><a href="/guide/intro/moving-things">Moving things</a></li>
25-
<li><a href="/guide/intro/images">Loading images and drawing them</a></li>
26-
<li><a href="/guide/intro/classes">Using classes to better contain our code</a></li>
27-
<li><a href="/guide/intro/audio">Loading and playing audio files</a></li>
28-
<li><a href="/guide/intro/platformer">Making a small game to demonstrate how these go together</a></li>
29-
</ol>
30-
31-
<h2>Important topics</h2>
32-
<ol>
33-
<li><a href="/guide/intro/fonts">Fonts in pygame</a></li>
34-
<li><a href="/guide/intro/colors">Colors in pygame</a></li>
35-
</ol>
36-
37-
<h2>Obscure but useful things</h2>
38-
<ol>
39-
<li><a href="/guide/obscure/pixelarray">PixelArray</a></li>
40-
<li><a href="/guide/obscure/blend-modes">Blend modes</a></li>
41-
<li><a href="/guide/obscure/set-mode-flags">pygame.display.set_mode flags</a></li>
42-
</ol>
43-
</body>
7+
<h1>Preface</h1>
8+
<p>
9+
"Where can I learn how to use pygame?" - one of the most commonly asked
10+
questions that we get. But we always struggle to answer. We sometimes point
11+
them to the docs and examples, but that isn't a comprehensive guide on
12+
building good pygame-based applications. There are many other tutorials and
13+
guides we have found, but we always find something lacking. There are many
14+
comments we give and many nitpicks we have - so much so that some of us
15+
gathered and decided to put all of them into a book. This book.
16+
</p>
17+
18+
<h1>Prerequisites</h1>
19+
<p>
20+
So this book is meant for people who already know a bit of Python. Here's
21+
what you need to know:
22+
</p>
23+
<ul>
24+
<li>Variables, loops and conditions</li>
25+
<li>Functions</li>
26+
<li>How objects work in Python</li>
27+
</ul>
28+
29+
<p>
30+
If you aren't familiar with the above, there are already some excellent
31+
pre-existing Python resources out there that we suggest depending on your
32+
situation
33+
</p>
34+
<h2>New to programming</h2>
35+
<p>
36+
If you're new to programming, here are some resources that are meant to
37+
teach you from the ground up
38+
</p>
39+
<h3>Text resources:</h3>
40+
<ul>
41+
<li>Automate The Boring Stuff</li>
42+
<li>A Byte of Python</li>
43+
</ul>
44+
<h3>Video resources:</h3>
45+
<ul>
46+
<li>Corey Schafer's Python basics series</li>
47+
<li>Introduction to Python by Mike Dane</li>
48+
</ul>
49+
50+
<h2>Familiar with programming</h2>
51+
<p>
52+
If you're already familiar with programming, you probably don't want
53+
variables, loops, conditions and the like explained to you again, the
54+
<a href="">Official Python Tutorial</a> acts as a schema to the language
55+
while still being more expressive than documentation and covers the features
56+
of the language nicely
57+
</p>
58+
59+
<h1>Table of contents</h1>
60+
<h2>Learning Pygame</h2>
61+
<ol>
62+
<li>
63+
<a href="/guide/intro/setup">Chapter 01: What Is Pygame</a>
64+
</li>
65+
<li>
66+
<a href="/guide/intro/setup">Chapter 02: Opening A Window</a>
67+
</li>
68+
<li>
69+
<a href="/guide/intro/setup"
70+
>Chapter 03: Surfaces And Positional Datatypes</a
71+
>
72+
</li>
73+
<li>
74+
<a href="/guide/intro/setup">Chapter 04: Implementing An Entity</a>
75+
</li>
76+
<li>
77+
<a href="/guide/intro/setup"
78+
>Chapter 05: Implementing A Collection For Entities</a
79+
>
80+
</li>
81+
<li>
82+
<a href="/guide/intro/setup">Chapter 06: Loading assets</a>
83+
</li>
4484

85+
<li>
86+
<a href="/guide/intro/setup">Chapter 07: Animation</a>
87+
</li>
88+
<li>
89+
<a href="/guide/intro/setup"
90+
>Chapter 08: The <code>pygame.draw</code> API</a
91+
>
92+
</li>
93+
<li>
94+
<a href="/guide/intro/setup">Chapter 09: Rects and collisions</a>
95+
</li>
96+
97+
<li>
98+
<a href="/guide/intro/setup">Chapter 10: The Pygame Input API</a>
99+
</li>
100+
101+
<li>
102+
<a href="/guide/intro/setup">Chapter 11: Game States</a>
103+
</li>
104+
<li>
105+
<a href="/guide/intro/setup">Chapter 12: Basic UI</a>
106+
</li>
107+
<li>
108+
<a href="/guide/intro/setup">Chapter 13: Basic File Structure</a>
109+
</li>
110+
</ol>
111+
112+
<h2>Higher Theory</h2>
113+
<ul>
114+
<li><a href="/guide/intro/fonts">Fonts in pygame</a></li>
115+
<li><a href="/guide/intro/colors">Colors in pygame</a></li>
116+
</ul>
117+
118+
<h2>Technical Concepts</h2>
119+
<ul>
120+
<li><a href="/guide/obscure/pixelarray">PixelArray</a></li>
121+
<li><a href="/guide/obscure/blend-modes">Blend modes</a></li>
122+
<li>
123+
<a href="/guide/obscure/set-mode-flags">pygame.display.set_mode flags</a>
124+
</li>
125+
</ul>
126+
</body>

0 commit comments

Comments
 (0)