Skip to content

Commit 1881eb5

Browse files
committed
Update the tutorial.
Main page has more general info. Added info on NumPy memory order. Added back links to tutorial sub-pages.
1 parent 718e078 commit 1881eb5

File tree

4 files changed

+32
-3
lines changed

4 files changed

+32
-3
lines changed

tutorials/python/2021/distribution.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -324,3 +324,5 @@ That's the end of the explanation on automated builds.
324324
Keep in mind that this doesn't check that executables actually run, and no other tests are run other than checking that the build succeeds.
325325

326326
{% endraw %}
327+
328+
[Return to the hub](.).

tutorials/python/2021/index.md

Lines changed: 24 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,32 @@
11
---
2-
title: "Yet Another Roguelike Tutorial 2021 - Written in Python 3 and python-tcod"
32
---
3+
# Another Roguelike Tutorial 2021
44

5-
#### Main Tutorial:
5+
This tutorial was made as a 2021 update to [RoguelikeDev Does The Complete Roguelike Tutorial](https://old.reddit.com/r/roguelikedev/wiki/python_tutorial_series).
6+
This version was designed for [Python](https://www.python.org/) 3.8+.
7+
8+
If you are following the tutorial and run into issues then you can ask for help on [Reddit at /r/roguelikedev](https://old.reddit.com/r/roguelikedev/) or on the [Discord #roguelikedev-help channel](https://discord.gg/jEgZtqB).
9+
10+
The event is still ongoing.
11+
It isn't unusual for tcod to be updated during the event, so you might have to upgrade it has you progress on this version of the tutorial.
12+
Earlier pages may also be updated at times.
13+
14+
## Main Tutorial:
615

716
- [Part 0 - Setting Up](part-0)
817
- [Part 1 - Drawing the ‘@’ symbol and moving it around](part-1)
18+
- Part 2 - The generic Entity, the render functions, and the map (July 6th)
19+
- Part 3 - Generating a dungeon
20+
- Part 4 - Field of view (July 13th)
21+
- Part 5 - Placing enemies and kicking them (harmlessly)
22+
- Part 6 - Doing (and taking) some damage (July 20th)
23+
- Part 7 - Creating the Interface
24+
- Part 8 - Items and Inventory (July 27th)
25+
- Part 9 - Ranged Scrolls and Targeting
26+
- Part 10 - Saving and loading (August 3rd)
27+
- Part 11 - Delving into the Dungeon
28+
- Part 12 - Increasing Difficulty (August 10th)
29+
- Part 13 - Gearing up
930

10-
#### Extras:
31+
## Extras:
1132
- [Distributing Python programs with PyInstaller](distribution)

tutorials/python/2021/part-0.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,3 +100,5 @@ There's a link there to the Discord channel as well.
100100
## Ready to go?
101101

102102
Once you're set up and ready to go, you can proceed to [Part 1](part-1).
103+
104+
[Return to the hub](.).

tutorials/python/2021/part-1.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -211,6 +211,8 @@ Contexts must be closed once you're done with them, but the `with` statement wil
211211

212212
Then a [tcod.Console](https://python-tcod.readthedocs.io/en/latest/tcod/console.html#tcod.console.Console) is created with the same size that was given to `tcod.context.new`,
213213
`order="F"` sets the console arrays to be indexed in `x, y` order.
214+
This is a convenient way to handle array indexes so we'll use `order="F"` a lot when working with NumPy.
215+
You might wonder why `order="F"` isn't the default [and there is an explanation for that](https://numpy.org/doc/stable/reference/internals.html#multidimensional-array-indexing-order-issues).
214216
These arrays are not being used yet.
215217

216218
Now with `while True:` the game-loop begins, with the only way of existing this loop normally being the `SystemExit` exceptions implemented earlier.
@@ -229,3 +231,5 @@ It can then unpack its values and checks if the destination is in the bounds of
229231
You can see the current progress of this code in its entirety [here](https://github.com/TStand90/tcod_tutorial_v2/tree/2021/part-1).
230232

231233
Part-2 isn't available yet, [but you can setup distribution in the meantime](distribution).
234+
235+
[Return to the hub](.).

0 commit comments

Comments
 (0)