Clean up develop doc build to avoid clashes

This commit is contained in:
Griatch 2020-10-19 22:40:43 +02:00
parent 4fa9f12d65
commit dca88243f4
23 changed files with 82 additions and 83 deletions

View file

@ -1,7 +1,5 @@
# Our own commands
[prev lesson](./Searching-Things) | [next lesson](./More-on-Commands)
In this lesson we'll learn how to create our own Evennia _Commands_. If you are new to Python you'll
also learn some more basics about how to manipulate strings and get information out of Evennia.
@ -391,6 +389,4 @@ In this lesson we learned how to create our own Command, add it to a CmdSet and
We also upset a dragon.
In the next lesson we'll learn how to hit Smaug with different weapons. We'll also
get into how we replace and extend Evennia's default Commands.
[prev lesson](./Searching-Things) | [next lesson](./More-on-Commands)
get into how we replace and extend Evennia's default Commands.

View file

@ -1,7 +1,5 @@
# Using the game and building stuff
[prev lesson](./Starting-Part1) | [next lesson](./Tutorial-World-Introduction)
In this lesson we will test out what we can do in-game out-of-the-box. Evennia ships with
[around 90 default commands](api:evennia.commands.default#modules), and while you can override those as you please,
they can be quite useful.
@ -312,5 +310,3 @@ You will now find your new `History` entry in the `help` list and read your help
After this brief introduction to building and using in-game commands you may be ready to see a more fleshed-out
example. Evennia comes with a tutorial world for you to explore. We will try that out in the next section.
[prev lesson](./Starting-Part1) | [next lesson](./Tutorial-World-Introduction)

View file

@ -1,6 +1,5 @@
# Creating things
[prev lesson](./Learning-Typeclasses) | [next lesson](./Searching-Things)
We have already created some things - dragons for example. There are many different things to create
in Evennia though. In the last lesson we learned about typeclasses, the way to make objects persistent in the database.
@ -48,6 +47,3 @@ You can find the parent class for Accounts in `typeclasses/accounts.py`.
_TODO_
[prev lesson](./Learning-Typeclasses) | [next lesson](./Searching-Things)

View file

@ -1,7 +1,5 @@
# Django Database queries
[prev lesson](./Searching-Things) | [next lesson](../Part2/Starting-Part2)
```important:: More advanced lesson!
Learning about Django's queryset language is very useful once you start doing more advanced things
@ -397,5 +395,3 @@ query using Django is a powerful skill to have.
This concludes the first part of the Evennia starting tutorial - "What we have". Now we have a good foundation
to understand how to plan what our tutorial game will be about.
[prev lesson](./Searching-Things) | [next lesson](../Part2/Starting-Part2)

View file

@ -1,7 +1,5 @@
# Overview of the Evennia library
[prev lesson](./Python-classes-and-objects) | [next lesson](./Learning-Typeclasses)
```sidebar:: API
API stands for `Application Programming Interface`, a description for how to access
@ -125,5 +123,4 @@ to look it up in the docs:
5. You can now read what this does and what methods are on it. If you want to see the full source, click the
\[[source](src:evennia.objects.objects#DefaultObject)\] link.
[prev lesson](./Python-classes-and-objects) | [next lesson](./Learning-Typeclasses)

View file

@ -1,7 +1,5 @@
# Overview of your new Game Dir
[prev lesson](./Python-basic-introduction) | [next lesson](./Python-classes-and-objects)
Next we will take a little detour to look at the _Tutorial World_. This is a little solo adventure
that comes with Evennia, a showcase for some of the things that are possible.
@ -208,4 +206,3 @@ people change and re-structure this in various ways to better fit their ideas.
tell that Two goblins, while both of the class 'Goblin' (so they follow the same code logic), should have different
equipment, stats and looks.
[prev lesson](./Python-basic-introduction) | [next lesson](./Python-classes-and-objects)

View file

@ -1,7 +1,5 @@
# Persistent objects and typeclasses
[prev lesson](./Evennia-Library-Overview) | [next lesson](./Creating-Things)
Now that we have learned a little about how to find things in the Evennia library, let's use it.
In the [Python classes and objects](./Python-classes-and-objects) lesson we created the dragons Fluffy, Cuddly
@ -621,4 +619,3 @@ Typeclasses are a fundamental part of Evennia and we will see a lot of more uses
this tutorial. But that's enough of them for now. It's time to take some action. Let's learn about _Commands_.
[prev lesson](./Evennia-Library-Overview) | [next lesson](./Creating-Things)

View file

@ -1,7 +1,5 @@
# More about Commands
[prev lesson](./Adding-Commands) | [next lesson](./Creating-Things)
In this lesson we learn some basics about parsing the input of Commands. We will
also learn how to add, modify and extend Evennia's default commands.
@ -497,4 +495,3 @@ In this lesson we got into some more advanced string formatting - many of those
the future! We also made a functional sword. Finally we got into how to add to, extend and replace a default
command on ourselves.
[prev lesson](./Adding-Commands) | [next lesson](./Creating-Things)

View file

@ -1,7 +1,5 @@
# Starting to code Evennia
[prev lesson](./Tutorial-World-Introduction) | [next lesson](./Gamedir-Overview)
Time to dip our toe into some coding! Evennia is written and extended in [Python](http://python.org), which
is a mature and professional programming language that is very fast to work with.
@ -651,4 +649,3 @@ practice you will be writing most your code in Python modules.
To that end we also created a first new Python module in the `mygame/` game dir, then imported and used it.
Now let's look at the rest of the stuff you've got going on inside that `mygame/` folder ...
[prev lesson](./Tutorial-World-Introduction) | [next lesson](./Gamedir-Overview)

View file

@ -1,7 +1,5 @@
# Python Classes and objects
[prev lesson](./Gamedir-Overview) | [next lesson](./Evennia-Library-Overview)
We have now learned how to run some simple Python code from inside (and outside) your game server.
We have also taken a look at what our game dir looks and what is where. Now we'll start to use it.
@ -412,4 +410,3 @@ with one in the child class. We also used `super()` to good effect.
We have used pretty much raw Python so far. In the coming lessons we'll start to look at the extra bits that Evennia
provides. But first we need to learn just where to find everything.
[prev lesson](./Gamedir-Overview) | [next lesson](./Evennia-Library-Overview)

View file

@ -1,7 +1,5 @@
# Searching for things
[prev lesson](./Creating-Things) | [next lesson](./Django-queries)
We have gone through how to create the various entities in Evennia. But creating something is of little use
if we cannot find and use it afterwards.
@ -261,5 +259,3 @@ these tools will be all you need ...
... but not always. In the next lesson we will dive further into more complex searching when we look at
Django queries and querysets in earnest.
[prev lesson](./Creating-Things) | [next lesson](./Django-queries)

View file

@ -1,7 +1,5 @@
# Starting Tutorial (Part 1)
[Start](./Building-Quickstart)
```sidebar:: Tutorial Parts
**Part 1: What we have**
@ -23,23 +21,19 @@ and share with others!
## Lessons of Part 1 - "What we have"
```toctree::
:numbered:
:maxdepth: 1
Building stuff <Building-Quickstart>
The Tutorial World <Tutorial-World-Introduction>
Python basics <Python-basic-introduction>
Game dir overview <Gamedir-Overview>
Python classes and objects <Python-classes-and-objects>
Accessing the Evennia library <Evennia-Library-Overview>
Typeclasses and Persistent objects <Learning-Typeclasses>
Making first own Commands <Adding-Commands>
Parsing and replacing default Commands <More-on-Commands>
Creating things <Creating-Things>
Searching for things <Searching-Things>
Advanced searching with Django queries <Django-queries>
```
1. Introduction (you are here)
1. [Building stuff](./Building-Quickstart)
1. [The Tutorial World](./Tutorial-World-Introduction)
1. [Python basics](./Python-basic-introduction)
1. [Game dir overview](./Gamedir-Overview)
1. [Python classes and objects](./Python-classes-and-objects)
1. [Accessing the Evennia library](./Evennia-Library-Overview)
1. [Typeclasses and Persistent objects](./Learning-Typeclasses)
1. [Making first own Commands](./Adding-Commands)
1. [Parsing and replacing default Commands](./More-on-Commands)
1. [Creating things](./Creating-Things)
1. [Searching for things](./Searching-Things)
1. [Advanced searching with Django queries](./Django-queries)
In this first part we'll focus on what we get out of the box in Evennia - we'll get used to the tools,
and how to find things we are looking for. We will also dive into some of things you'll
@ -114,4 +108,22 @@ first enter that gamedir and run
You should now be good to go!
[Start](./Building-Quickstart)
```toctree::
:hidden:
Building-Quickstart
Tutorial-World-Introduction
Python-basic-introduction
Gamedir-Overview
Python-classes-and-objects
Evennia-Library-Overview
Learning-Typeclasses
Adding-Commands
More-on-Commands
Creating-Things
Searching-Things
Django-queries
../Part2/Starting-Part2
```

View file

@ -1,7 +1,5 @@
# The Tutorial World
[prev lesson](./Building-Quickstart) | [next lesson](./Python-basic-introduction)
The *Tutorial World* is a small and functioning MUD-style game world shipped with Evennia.
It's a small showcase of what is possible. It can also be useful for those who have an easier
time learning by deconstructing existing code.
@ -115,5 +113,3 @@ should hopefully have given you a little taste of some of the possibilities of
move on with how to access this power through code.
[prev lesson](./Building-Quickstart) | [next lesson](./Python-basic-introduction)