mirror of
https://github.com/evennia/evennia.git
synced 2026-04-04 23:17:17 +02:00
Clean up develop doc build to avoid clashes
This commit is contained in:
parent
4fa9f12d65
commit
dca88243f4
23 changed files with 82 additions and 83 deletions
|
|
@ -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.
|
||||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
|
|
|||
|
|
@ -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)
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
```
|
||||
|
|
@ -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)
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue