continue with formspecs.md

This commit is contained in:
debiankaios 2022-08-31 21:33:54 +02:00
parent a994ffc078
commit 498669e55a
2 changed files with 60 additions and 50 deletions

View File

@ -23,19 +23,19 @@ submit_vuln:
</figcaption>
</figure>
In this chapter we will learn how to create a formspec and display it to the user.
A formspec is the specification code for a form.
In Minetest, forms are windows such as the player inventory and can contain a
variety of elements, such as labels, buttons and fields.
In diesem Kapitel werden wir lernen, wie man einen formspec erstellt und ihn dem Benutzer anzeigt.
Ein formspec ist der Spezifikationscode für ein Form.
In Minetest sind Forms Fenster wie das Spielerinventar und können eine
eine Vielzahl von Elementen wie Beschriftungen, Schaltflächen und Felder enthalten.
Note that if you do not need to get user input, for example when you only need
to provide information to the player, you should consider using
[Heads Up Display (HUD)](hud.html) elements instead of forms, because
unexpected windows tend to disrupt gameplay.
Beachten Sie, dass Sie, wenn Sie keine Benutzereingaben benötigen, zum Beispiel wenn Sie nur
Informationen für den Spieler bereitstellen möchten, Sie die Verwendung von
[Heads Up Display (HUD)](hud.html)-Elemente anstelle von Formularen verwenden sollten, da
unerwartete Fenster das Spielgeschehen stören können.
- [Real or Legacy Coordinates](#real-or-legacy-coordinates)
- [Anatomy of a Formspec](#anatomy-of-a-formspec)
- [Elements](#elements)
- [Reale oder Legacy-Koordinaten](#reale-oder-legacy-koordinaten)
- [Anatomie eines formspecs](#anatomie-eines-a-formspecs)
- [Elemente](#elemente)
- [Header](#header)
- [Guessing Game](#guessing-game)
- [Padding and Spacing](#padding-and-spacing)
@ -47,74 +47,74 @@ unexpected windows tend to disrupt gameplay.
- [Your Turn](#your-turn)
## Real or Legacy Coordinates
## Reale oder Legacy-Koordinaten
In older versions of Minetest, formspecs were inconsistent. The way that different
elements were positioned varied in unexpected ways; it was hard to predict the
placement of elements and align them. Minetest 5.1.0 contains a feature
called real coordinates which aims to rectify this by introducing a consistent
coordinate system. The use of real coordinates is highly recommended, and so
this chapter will use them exclusively.
In älteren Versionen von Minetest waren die formspecs inkonsistent. Die Art und Weise, wie verschiedene
Elemente auf unerwartete Art und Weise positioniert wurden; es war schwierig, die
Platzierung der Elemente vorherzusagen und auszurichten. Minetest 5.1.0 enthält eine Funktion
Koordinaten, die dieses Problem durch die Einführung eines konsistenten
Koordinatensystem. Die Verwendung von realen Koordinaten wird dringend empfohlen, und deshalb
dieses Kapitel ausschließlich diese verwenden.
Using a formspec_version of 2 or above will enable real coordinates.
Die Verwendung einer formspec_version von 2 oder höher aktiviert reale Koordinaten.
## Anatomy of a Formspec
## Anatomie eines formspecs
### Elements
### Elemente
Formspec is a domain-specific language with an unusual format.
It consists of a number of elements with the following form:
Formspec ist eine domänenspezifische Sprache mit einem ungewöhnlichen Format.
Sie besteht aus einer Reihe von Elementen mit der folgenden Form:
type[param1;param2]
The element type is declared and then any parameters are given
in square brackets. Multiple elements can be joined together, or placed
on multiple lines, like so:
Der Elementtyp wird deklariert und dann werden alle Parameter
in eckigen Klammern angegeben. Mehrere Elemente können miteinander verbunden werden, oder
auf mehrere Zeilen verteilt werden, etwa so:
foo[param1]bar[param1]
bo[param1]
Elements are items such as text boxes or buttons, or can be metadata such
as size or background. You should refer to
Elemente sind Elemente wie Textfelder oder Schaltflächen oder können Metadaten sein wie
wie Größe oder Hintergrund sein. Sie sollten nachschlagen in der
[lua_api.txt](https://minetest.gitlab.io/minetest/formspec/)
for a list of all possible elements.
für eine Liste aller möglichen Elemente.
### Header
The header of a formspec contains information which must appear first. This
includes the size of the formspec, the position, the anchor, and whether the
game-wide theme should be applied.
Der Header eines formspec enthält Informationen, die zuerst erscheinen müssen. Diese
umfasst die Größe des formspec, die Position, den Anker und ob das
spielweite Thema angewendet werden soll.
The elements in the header must be defined in a specific order, otherwise you
will see an error. This order is given in the above paragraph, and, as always,
documented in the Lua API reference.
Die Elemente im Header müssen in einer bestimmten Reihenfolge definiert werden, sonst
wird ein Fehler angezeigt. Diese Reihenfolge ist im obigen Absatz angegeben und, wie immer,
in der Lua-API-Referenz dokumentiert.
The size is in formspec slots - a unit of measurement which is roughly
around 64 pixels, but varies based on the screen density and scaling
settings of the client. Here's a formspec which is `2,2` in size:
Die Größe wird in formspec-Slots angegeben - eine Maßeinheit, die ungefähr
etwa 64 Pixel entspricht, jedoch abhängig von der Bildschirmdichte und den Skalierungs
Einstellungen des Clients ist. Hier ist ein formspec mit der Größe "2,2":
formspec_version[4]
size[2,2]
Notice how we explicitly defined the formspec language version.
Without this, the legacy system will instead be used instead - which will
prevent the use of consistent element positioning and other new feautures.
Beachten Sie, dass wir die formspec-Sprachversion ausdrücklich definiert haben müssen.
Ohne dies wird stattdessen das Altsystem verwendet - was
die Verwendung der konsistenten Elementpositionierung und anderer neuer Funktionen verhindert.
The position and anchor elements are used to place the formspec on the screen.
The position sets where on the screen the formspec will be, and defaults to
the center (`0.5,0.5`). The anchor sets where on the formspec the position is,
allowing you to line the formspec up with the edge of the screen. The formspec
can be placed to the left of the screen like so:
Die Elemente position und Anker werden verwendet, um das formspec auf dem Bildschirm zu platzieren.
Die Position legt fest, wo auf dem Bildschirm das formspec sein wird, und ist standardmäßig auf
die Mitte (`0,5,0,5`). Der Anker legt fest, wo auf dem formspec die Position ist,
so dass Sie das formspec mit dem Rand des Bildschirms ausrichten können. Das formspec
kann auf diese Weise links vom Bildschirm platziert werden:
formspec_version[4]
size[2,2]
position[0,0.5]
anchor[0,0.5]
This sets the anchor to the left middle edge of the formspec box, and then the
position of that anchor to the left of the screen.
Dadurch wird der Anker an den linken mittleren Rand des formspec-Feldes gesetzt, und die
Position dieses Ankers auf der linken Seite des Bildschirms.
## Guessing Game

View File

@ -1,6 +1,7 @@
Active Block Modifiers = Aktive Mapblock Modifikatoren
Admin = Admin
Administrator = Administrator
anchor = Anker
Armor Groups = Armor Groups
Attachment = Anhang
block = Mapblock
@ -21,19 +22,26 @@ detached inventory = freistehendes Inventar
dig = abbauen
Dig Types = Grabungstypen
drawtype = Zeichnungstyp
element = Element
Entities = Entities
Entity = Entity
false = falsch
Folder = Verzeichnis
form = Formular
form = Form
forms = Forms
formspec = formspec
formspec slot = formspec-Slot
formspec language version = formspec-Sprachversion
games = Spiele
getter = Getter
glasslike = Glasartig
grid = Raster
Header = Header
Heads Up Display = Heads Up Display
Health = Leben
HP = HP
Health Points = Lebenspunkte
HP = HP
hud = hud
initial properties = Erst-Eigenschaften
insecure environment = unsichere Umgebung
Introduction = Einleitung
@ -46,6 +54,7 @@ ItemStack = ItemStack
key = Schlüssel
key-value table = Schlüssel-Wert-Tabelle
large data = große Daten
Legacy Coordinates = Legacy-Koordinaten
Lua entity = Lua entity
main inventory = Hauptinventar
map = Karte
@ -83,6 +92,7 @@ privilege = Privileg
punch = schlagen
put = ablegen
Radians = Radiant
Real Coordinates = Reale Koordinaten
shout = shout
small data = kleine Daten
sneak elevators = Schleichfahrstühle