diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 179c084..694724a 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -23,7 +23,7 @@ pages: stage: deploy interruptible: true script: - - bundle exec jekyll build -d public --baseurl /minetest_modding_book + - bundle exec jekyll build -d public artifacts: paths: - public diff --git a/_config.yml b/_config.yml index 2cc43fc..cad31ae 100644 --- a/_config.yml +++ b/_config.yml @@ -1,3 +1,6 @@ +url: "https://rubenwardy.com" +baseurl: "/minetest_modding_book" + sass: # nested (default), compact, compressed, expanded style: compressed diff --git a/_en/advmap/lvm.md b/_en/advmap/lvm.md index 9e4f726..c66f8cc 100644 --- a/_en/advmap/lvm.md +++ b/_en/advmap/lvm.md @@ -16,7 +16,7 @@ mapgen_object: ## Introduction -The functions outlined in the [Basic Map Operations](environment.html) chapter +The functions outlined in the [Basic Map Operations](../map/environment.html) chapter are convenient and easy to use, but for large areas they are inefficient. Every time you call `set_node` or `get_node`, your mod needs to communicate with the engine. This results in constant individual copying operations between the diff --git a/_en/map/environment.md b/_en/map/environment.md index cd26fc2..d167d6a 100644 --- a/_en/map/environment.md +++ b/_en/map/environment.md @@ -9,15 +9,16 @@ redirect_from: /en/chapters/environment.html ## Introduction -In this chapter, you will learn how to perform basic actions on the map. +In this chapter, you will learn how to perform basic actions on the map, such as +adding, removing, and finding nodes. - [Map Structure](#map-structure) - [Reading](#reading) - - [Reading Nodes](#reading-nodes) - - [Finding Nodes](#finding-nodes) + - [Reading Nodes](#reading-nodes) + - [Finding Nodes](#finding-nodes) - [Writing](#writing) - - [Writing Nodes](#writing-nodes) - - [Removing Nodes](#removing-nodes) + - [Writing Nodes](#writing-nodes) + - [Removing Nodes](#removing-nodes) - [Loading Blocks](#loading-blocks) - [Deleting Blocks](#deleting-blocks) diff --git a/_en/map/objects.md b/_en/map/objects.md index bd14f97..d02cd9c 100644 --- a/_en/map/objects.md +++ b/_en/map/objects.md @@ -21,6 +21,9 @@ own. - [Object Properties](#object-properties) - [Entities](#entities) - [Health and Damage](#health-and-damage) + - [Health Points (HP)](#health-points-hp) + - [Punch, Damage Groups, and Armor Groups](#punch-damage-groups-and-armor-groups) + - [Example Damage Calculation](#example-damage-calculation) - [Attachments](#attachments) - [Your Turn](#your-turn) @@ -153,7 +156,7 @@ print("entity is at " .. minetest.pos_to_string(object:get_pos())) ``` There are a number of available callbacks for use with entities. -A complete list can be found in [lua_api.txt](https://minetest.gitlab.io/minetest/minetest-namespace-reference/#registered-definition-tables). +A complete list can be found in [lua_api.md](https://minetest.gitlab.io/minetest/minetest-namespace-reference/#registered-definition-tables). ```lua function MyEntity:on_step(dtime) diff --git a/_en/players/formspecs.md b/_en/players/formspecs.md index c581a23..6e82cd6 100644 --- a/_en/players/formspecs.md +++ b/_en/players/formspecs.md @@ -77,7 +77,7 @@ on multiple lines, like so: Elements are items such as text boxes or buttons, or can be metadata such as size or background. You should refer to -[lua_api.txt](https://minetest.gitlab.io/minetest/formspec/) +[lua_api.md](https://minetest.gitlab.io/minetest/formspec/) for a list of all possible elements. @@ -319,7 +319,7 @@ There are three different ways that a formspec can be delivered to the client: ### Node Meta Formspecs `minetest.show_formspec` is not the only way to show a formspec; you can also -add formspecs to a [node's metadata](node_metadata.html). For example, +add formspecs to a [node's metadata](../map/storage.html). For example, this is used with chests to allow for faster opening times - you don't need to wait for the server to send the player the chest formspec. diff --git a/_en/players/hud.md b/_en/players/hud.md index 991c944..d31ad5c 100644 --- a/_en/players/hud.md +++ b/_en/players/hud.md @@ -14,15 +14,15 @@ Heads Up Display (HUD) elements allow you to show text, images, and other graphi The HUD doesn't accept user input; for that, you should use a [formspec](formspecs.html). - [Positioning](#positioning) - - [Position and Offset](#position-and-offset) - - [Alignment](#alignment) - - [Scoreboard](#scoreboard) + - [Position and Offset](#position-and-offset) + - [Alignment](#alignment) + - [Scoreboard](#scoreboard) - [Text Elements](#text-elements) - - [Parameters](#parameters) - - [Our Example](#our-example) + - [Parameters](#parameters) + - [Our Example](#our-example) - [Image Elements](#image-elements) - - [Parameters](#parameters-1) - - [Scale](#scale) + - [Parameters](#parameters-1) + - [Scale](#scale) - [Changing an Element](#changing-an-element) - [Storing IDs](#storing-ids) - [Other Elements](#other-elements) @@ -291,4 +291,4 @@ end) ## Other Elements -Read [lua_api.txt](https://minetest.gitlab.io/minetest/hud/) for a complete list of HUD elements. +Read [lua_api.md](https://minetest.gitlab.io/minetest/hud/) for a complete list of HUD elements. diff --git a/_en/players/player_physics.md b/_en/players/player_physics.md index e94c5fd..1270273 100644 --- a/_en/players/player_physics.md +++ b/_en/players/player_physics.md @@ -18,7 +18,7 @@ For example, a value of 2 for gravity would make gravity twice as strong. - [Basic Example](#basic-example) - [Available Overrides](#available-overrides) - - [Old Movement Behaviour](#old-movement-behaviour) + - [Old Movement Behaviour](#old-movement-behaviour) - [Mod Incompatibility](#mod-incompatibility) - [Your Turn](#your-turn) @@ -42,7 +42,7 @@ minetest.register_chatcommand("antigravity", { ## Available Overrides `player:set_physics_override()` is given a table of overrides.\\ -According to [lua_api.txt](https://minetest.gitlab.io/minetest/class-reference/#player-only-no-op-for-other-objects), +According to [lua_api.md](https://minetest.gitlab.io/minetest/class-reference/#player-only-no-op-for-other-objects), these can be: * speed: multiplier to default walking speed value (default: 1) diff --git a/_en/quality/readmore.md b/_en/quality/readmore.md index c140c08..2cbb338 100644 --- a/_en/quality/readmore.md +++ b/_en/quality/readmore.md @@ -12,8 +12,8 @@ After you've read this book, take a look at the following. ### Minetest Modding -* Minetest's Lua API Reference - [HTML version](https://minetest.gitlab.io/minetest/class-reference/#player-only-no-op-for-other-objects) | - [Text version](https://github.com/minetest/minetest/blob/master/doc/lua_api.txt). +* Minetest's Lua API Reference - [multiple page version](https://minetest.gitlab.io/minetest/class-reference/#player-only-no-op-for-other-objects) | + [single page version](https://github.com/minetest/minetest/blob/master/doc/lua_api.md). * Look at [existing mods](https://forum.minetest.net/viewforum.php?f=11). ### Lua Programming diff --git a/_it/advmap/lvm.md b/_it/advmap/lvm.md index c08acb8..2eb7140 100755 --- a/_it/advmap/lvm.md +++ b/_it/advmap/lvm.md @@ -16,7 +16,7 @@ mapgen_object: ## Introduzione -Le funzioni introdotte nel capitolo [Mappa: operazioni base](environment.html) sono comode e facili da usare, ma per le grandi aree non sono efficienti. +Le funzioni introdotte nel capitolo [Mappa: operazioni base](../map/environment.html) sono comode e facili da usare, ma per le grandi aree non sono efficienti. Ogni volta che `set_node` e `get_node` vengono chiamati da una mod, la mod deve comunicare con il motore di gioco. Ciò risulta in una costante copia individuale dei singoli nodi, che è lenta e abbasserà notevolmente le performance del gioco. Usare un Manipolatore di Voxel Lua (*Lua Voxel Manipulator*, da qui LVM) può essere un'alternativa migliore. @@ -142,7 +142,7 @@ vm:write_to_map(true) Per la luce e param2, invece si usano `set_light_data()` e `set_param2_data()`. -`write_to_map()` richiede un booleano che è `true` se si vuole che venga calcolata anche la luce. +`write_to_map()` richiede un booleano che è `true` se si vuole che venga calcolata anche la luce. Se si passa `false` invece, ci sarà bisogno di ricalcolarla in un secondo tempo usando `minetest.fix_light`. ## Esempio diff --git a/_it/map/objects.md b/_it/map/objects.md index 767682b..3f6f5c0 100644 --- a/_it/map/objects.md +++ b/_it/map/objects.md @@ -20,9 +20,9 @@ In questo capitolo imparerai come manipolare gli oggetti e come definirne di tuo - [Proprietà degli oggetti](#proprietà-degli-oggetti) - [Entità](#entità) - [Salute e danno](#salute-e-danno) - - [Punti vita (HP)](#punti-vita-hp) - - [Pugni, Gruppi Danno e Gruppi Armatura](#pugni-gruppi-danno-e-gruppi-armatura) - - [Esempi di calcolo del danno](#esempi-di-calcolo-del-danno) + - [Punti vita (HP)](#punti-vita-hp) + - [Pugni, Gruppi Danno e Gruppi Armatura](#pugni-gruppi-danno-e-gruppi-armatura) + - [Esempi di calcolo del danno](#esempi-di-calcolo-del-danno) - [Oggetti figli](#oggetti-figli) - [Il tuo turno](#il-tuo-turno) @@ -134,7 +134,7 @@ print("L'entità si trova a " .. minetest.pos_to_string(oggetto:get_pos())) ``` Ci sono diversi callback disponibili da usare per le entità. -Una lista completa può essere trovata in [lua_api.txt](https://minetest.gitlab.io/minetest/minetest-namespace-reference/#registered-definition-tables). +Una lista completa può essere trovata in [lua_api.md](https://minetest.gitlab.io/minetest/minetest-namespace-reference/#registered-definition-tables). ```lua function MiaEntita:on_step(dtime) diff --git a/_it/players/formspecs.md b/_it/players/formspecs.md index 46a9201..283a443 100644 --- a/_it/players/formspecs.md +++ b/_it/players/formspecs.md @@ -66,7 +66,7 @@ Si possono concatenare più elementi, piazzandoli eventualmente su più linee: bo[param1] Gli elementi sono o oggetti come i campi di testo e i pulsanti, o dei metadati come la grandezza e lo sfondo. -Per una lista esaustiva di tutti i possibili elementi, si rimanda a [lua_api.txt](https://minetest.gitlab.io/minetest/formspec/). +Per una lista esaustiva di tutti i possibili elementi, si rimanda a [lua_api.md](https://minetest.gitlab.io/minetest/formspec/). ### Intestazione @@ -74,7 +74,7 @@ L'intestazione di un formspec contiene informazioni che devono apparire prima di Questo include la grandezza del formspec, la posizione, l'ancoraggio, e se il tema specifico del gioco debba venir applicato. Gli elementi nell'intestazione devono essere definiti in un ordine preciso, altrimenti ritorneranno un errore. -L'ordine è dato nel paragrafo qui in alto e, come sempre, documentato in lua_api.txt. +L'ordine è dato nel paragrafo qui in alto e, come sempre, documentato in lua_api.md. La grandezza è in caselle formspec - un'unità di misura che è circa 64 pixel, ma varia a seconda della densità dello schermo e delle impostazioni del client. Ecco un formspec di 2x2: @@ -282,7 +282,7 @@ Ci sono tre diversi modi per far sì che un formspec sia consegnato al client: ### Formspec nei nodi -`minetest.show_formspec` non è l'unico modo per mostrare un formspec; essi possono infatti essere aggiunti anche ai [metadati di un nodo](node_metadata.html). +`minetest.show_formspec` non è l'unico modo per mostrare un formspec; essi possono infatti essere aggiunti anche ai [metadati di un nodo](../map/storage.html). Per esempio, questo è usato con le casse per permettere tempi più veloci d'apertura - non si ha bisogno di aspettare che il server invii il formspec della cassa al giocatore. ```lua diff --git a/_it/players/hud.md b/_it/players/hud.md index 899dfba..9602c19 100644 --- a/_it/players/hud.md +++ b/_it/players/hud.md @@ -13,15 +13,15 @@ Le HUD (Heads Up Display) ti permettono di mostrare testi, immagini e altri elem Le HUD, infatti, non accettano input dall'utente, lasciando quel ruolo ai [formspec](formspecs.html). - [Posizionamento](#posizionamento) - - [Posizione e scostamento](#posizione-e-scostamento) - - [Allineamento](#allineamento) - - [Esempio: tabellone segnapunti](#esempio-tabellone-segnapunti) + - [Posizione e scostamento](#posizione-e-scostamento) + - [Allineamento](#allineamento) + - [Esempio: tabellone segnapunti](#esempio-tabellone-segnapunti) - [Elementi di testo](#elementi-di-testo) - - [Parametri](#parametri) - - [Tornando all'esempio](#tornando-allesempio) + - [Parametri](#parametri) + - [Tornando all'esempio](#tornando-allesempio) - [Elementi immagine](#elementi-immagine) - - [Parametri](#parametri-1) - - [Tornando all'esempio](#tornando-allesempio-1) + - [Parametri](#parametri-1) + - [Tornando all'esempio](#tornando-allesempio-1) - [Cambiare un elemento](#cambiare-un-elemento) - [Salvare gli ID](#salvare-gli-id) - [Altri elementi](#altri-elementi) @@ -278,4 +278,4 @@ end) ## Altri elementi -Dai un occhio a [lua_api.txt](https://minetest.gitlab.io/minetest/hud/) per una lista completa degli elementi HUD. +Dai un occhio a [lua_api.md](https://minetest.gitlab.io/minetest/hud/) per una lista completa degli elementi HUD. diff --git a/_it/players/player_physics.md b/_it/players/player_physics.md index a59d3df..f5d5868 100644 --- a/_it/players/player_physics.md +++ b/_it/players/player_physics.md @@ -14,7 +14,7 @@ Per esempio, un valore di 2 sulla gravità, renderà la gravità di un utente du - [Esempio base](#esempio-base) - [Sovrascritture disponibili](#sovrascritture-disponibili) - - [Vecchio sistema di movimento](#vecchio-sistema-di-movimento) + - [Vecchio sistema di movimento](#vecchio-sistema-di-movimento) - [Incompatibilità tra mod](#incompatibilità-tra-mod) - [Il tuo turno](#il-tuo-turno) @@ -36,7 +36,7 @@ minetest.register_chatcommand("antigrav", { ## Sovrascritture disponibili -`set_physics_override()` è una tabella. Stando a [lua_api.txt](https://minetest.gitlab.io/minetest/class-reference/#player-only-no-op-for-other-objects), le chiavi possono essere: +`set_physics_override()` è una tabella. Stando a [lua_api.md](https://minetest.gitlab.io/minetest/class-reference/#player-only-no-op-for-other-objects), le chiavi possono essere: * `speed`: moltiplicatore della velocità di movimento (predefinito: 1) * `jump`: moltiplicatore del salto (predefinito: 1) diff --git a/_it/quality/readmore.md b/_it/quality/readmore.md index 512bcd9..d25c2cf 100644 --- a/_it/quality/readmore.md +++ b/_it/quality/readmore.md @@ -10,10 +10,10 @@ redirect_from: /it/chapters/readmore.html Dopo aver letto questo libro, se mastichi l'inglese dai un occhio a ciò che segue: -### Modding di Minetest +### Moddaggio di Minetest -* Riferimento alla API Lua di Minetest - [versione HTML](https://minetest.gitlab.io/minetest/) | - [versione solo testo](https://github.com/minetest/minetest/blob/master/doc/lua_api.txt). +* Riferimento alla API Lua di Minetest - [versione interattiva](https://minetest.gitlab.io/minetest/) | + [versione su pagina singola](https://github.com/minetest/minetest/blob/master/doc/lua_api.md). * Spulcia le [mod esistenti](https://forum.minetest.net/viewforum.php?f=11). ### Programmazione in Lua diff --git a/_layouts/base.html b/_layouts/base.html index 2458bad..59a6529 100644 --- a/_layouts/base.html +++ b/_layouts/base.html @@ -21,7 +21,7 @@ layout: compress - + {% assign oldSegment = "/" | append: language | append: "/" %} {% for other_lang in site.data.languages %} @@ -29,7 +29,7 @@ layout: compress {% assign newSegment = "/" | append: other_lang.code | append: "/" %} + href="{{ page.url | replace: oldSegment, newSegment | relative_url }}"> {% endunless %} {% endfor %} diff --git a/index.html b/index.html index 7dbdf8b..675e40d 100644 --- a/index.html +++ b/index.html @@ -5,7 +5,9 @@ layout: none Minetest Modding Book + +