Start writing the tutorial, but it's not finished yet

This commit is contained in:
Starbeamrainbowlabs 2021-06-20 02:22:25 +01:00
parent 4d24e4e884
commit f04deaad15
Signed by: sbrl
GPG key ID: 1BE5172E637709C2
3 changed files with 56 additions and 2 deletions

View file

@ -2,5 +2,5 @@
"layout": "content-generic.njk",
"title": "Cookbook",
"tags": "navigable",
"date": "2002-01-01"
"date": "2006-01-01"
}

54
.docs/Tutorial.md Normal file
View file

@ -0,0 +1,54 @@
---
layout: content-generic.njk
title: Tutorial
tags: navigable
date: 2004-01-01
---
# WorldEditAdditions Beginner's Tutorial
Welcome to the WorldEditAdditions beginners tutorial! There are a number of conventions used in the [chat command reference](/Reference) that may not be immediately obvious - this guide serves to explain in detail.
It is assumed that:
- You have both WorldEdit and WorldEditAdditions installed (see the [Download](/#download) section)
- You are already familiar the basics of [Minetest](https://www.minetest.net/)
Minetest supports the execution of _Chat Commands_ to manipulate the Minetest world. While in a Minetest world, simply type `/help` (the first forward slash `/` will automatically cause the chat window to appear) and hit <kbd>enter</kbd> to display a list of chat commands that are currently registered grouped by mod for example.
WorldEdit commands are, by convention, prefixed with an additional forward slash `/`. Here are some examples of WorldEdit chat commands:
```
//1
//2
//set dirt
```
Explaining core WorldEdit commands is out of scope of this tutorial, but you can find a complete list of them here: <https://github.com/Uberi/Minetest-WorldEdit/blob/master/ChatCommands.md>.
The purpose of _WorldEditAdditions_ is to extend _WorldEdit_ by adding additional commands. Example commands that have been implemented that are not present in core _WorldEdit_ include (but certainly aren't limited to):
- [`//maze`](/Reference/#maze-replace_node-path_length-path_width-seed): Create instant mazes
- [`//forest`](/Reference/#forest-density-sapling_a-chance_a-sapling_b-chance_b-sapling_n-chance_n-): Plant forests
- [`//torus`](http://localhost:8080/Reference/#torus-major_radius-minor_radius-node_name-axesxy-hollow): Generate [torus](https://en.wikipedia.org/wiki/Torus) shapes
- [`//scale`](/Reference/#scale-axis-scale_factor-factor_x-factor_y-factor_z-anchor_x-anchor_y-anchor_z): Scale things up and down - even both at the same time!
See a full list with complete explanations in the [chat command reference](/Reference).
## Regions
- Explain WorldEdit regions, points 1 & 2
## Command syntax
- Command syntax conventions:
- `<thing>`
- `a|b`
- `[optional_thing]`
- `<thing|other_thing>`
## Anything else?
- Make sure we have covered everything

View file

@ -116,7 +116,7 @@ nav ul {
nav a {
background: var(--bg-transcluscent-slight);
display: inline-block;
padding: 1.2em 3em;
padding: 1.2em 2em;
text-decoration: none;
font-weight: bold;
color: var(--text-main);