Update doc_items

mods/HELP/doc/doc_items/API.md

@@ -42,7 +42,7 @@ easy and quick manipulation of the item help entries. All fields are optional.
 * `_doc_items_hidden`: Whether entry is hidden (default: `false` for air and hand, `true` for everything else)
 * `_doc_items_create_entry`: Whether to create an entry for this item (default: `true`)
 * `_doc_items_entry_name`: The title of the entry. By default, this is the same as the `description` field
-  of the item. This field is required if the `description` is empty
+  of the item (discarding text after the first newline). This field is required if the `description` is empty
 * `_doc_items_durability`: This field is for describing how long a tool can be used before it breaks. Choose one data type:
    * It it is a `number`: Fixed number of uses before it breaks
    * If it is a `string`: Free-form text which explains how the durability works. Try to keep it short and only use it if the other types won't work

mods/HELP/doc/doc_items/README.md

@@ -1,4 +1,4 @@
-# Item Help [`doc_items`] (Version 1.1.2)
+# Item Help [`doc_items`] (Version 1.2.0)
 ## Description
 Automatically generated help texts of blocks, tools, weapons, crafting
 items and other items.
@@ -66,3 +66,8 @@ Read `API.md` to learn more.
 
 ## License
 Everything in this mod is licensed under the MIT License.
+
+## Translation credits
+French: Karamel
+German: Wuzzy
+Portuguese: BrunoMine

mods/HELP/doc/doc_items/init.lua

@@ -14,16 +14,8 @@ doc.sub.items.temp.eat_bad = S("Hold it in your hand, then leftclick to eat it.
 doc.sub.items.temp.rotate_node = S("This block's rotation is affected by the way you place it: Place it on the floor or ceiling for a vertical orientation; place it at the side for a horizontal orientation. Sneaking while placing it leads to a perpendicular orientation instead.")
 
 doc.sub.items.settings = {}
-doc.sub.items.settings.friendly_group_names = false
+doc.sub.items.settings.friendly_group_names = minetest.settings:get_bool("doc_items_friendly_group_names", false)
-local setting = minetest.settings:get_bool("doc_items_friendly_group_names")
+doc.sub.items.settings.itemstring = minetest.settings:get_bool("doc_items_show_itemstrings", false)
-if setting ~= nil then
-	doc.sub.items.settings.friendly_group_names = setting
-end
-doc.sub.items.settings.itemstring = false
-setting = minetest.settings:get_bool("doc_items_show_itemstrings")
-if setting ~= nil then
-	doc.sub.items.settings.itemstring = setting
-end
 
 -- Local stuff
 local groupdefs = {}
@@ -73,10 +65,14 @@ local groups_to_string = function(grouptable, filter)
 	end
 end
 
--- Replaces all newlines with spaces
+-- Removes all text after the first newline (including the newline)
 local scrub_newlines = function(text)
-	local new, x = string.gsub(text, "\n", " ")
+	local spl = string.split(text, "\n")
-	return new
+	if spl and #spl > 0 then
+		return spl[1]
+	else
+		return text
+	end
 end
 
 --[[ Append a newline to text, unless it already ends with a newline. ]]

mods/HELP/doc/doc_items/locale/doc_items.fr.tr

@@ -0,0 +1,142 @@
+# textdomain:doc_items
+Using it as fuel turns it into: @1.=L'utiliser comme combustible le transforme en : @1.
+@1 seconds=@1 secondes
+# Item count times item name
+%@1×@2=%@1×@
+# Itemname (25%)
+@1 (@2%)=@1 (@2%)
+# Itemname (<0.5%)
+@1 (<0.5%)=@1 (<0.5%)
+# Itemname (ca. 25%)
+@1 (ca. @2%)=@1 (ca. @2%)
+# List separator (e.g. “one, two, three”)
+, =, 
+# Final list separator (e.g. “One, two and three”)
+ and = et 
+1 second=1 seconde
+A transparent block, basically empty space. It is usually left behind after digging something.=Un bloc transparent, tout simplement un espace vide. Il apparaît généralement après avoir creusé quelque chose.
+Air=Air
+Blocks=Blocs
+Building another block at this block will place it inside and replace it.=Construire un autre bloc sur ce bloc le placera à l'intérieur et le remplacera.
+Building this block is completely silent.=Construire ce bloc est complètement silentieux
+Collidable: @1=Percutable : @1
+Description: @1=Description : @1
+Falling blocks can go through this block; they destroy it when doing so.=Les blocs en chute peuvent traverser ce bloc; ils le détruisent en faisant cela.
+Full punch interval: @1 s=Intervalle de frappe : @1
+Hand=Main
+Hold it in your hand, then leftclick to eat it.=Tenez-le en main, puis cliquez-gauche pour le manger.
+Hold it in your hand, then leftclick to eat it. But why would you want to do this?=Tenez-le en main, puis cliquez-gauche pour le manger. Mais pourquoi feriez-vous cela ?
+Item reference of all wieldable tools and weapons=L'index des outils et armes manipulables
+Item reference of blocks and other things which are capable of occupying space=L'index des blocs et autres choses qui peuvent occuper l'espace
+Item reference of items which are neither blocks, tools or weapons (esp. crafting items)=L'index des choses qui ne sont ni des blocs, ni des outils ou armes (particulièrement les objets d'assemblage)
+Liquids can flow into this block and destroy it.=Les liquides peuvent couler sur ce bloc et le détruire.
+Maximum stack size: @1=Taille maximum de pile : @1
+Mining level: @1=Niveau de minage : @1
+Mining ratings:=Notes de minage :
+• @1, rating @2: @3 s - @4 s=• @1, note @2 : @3s - @4s
+• @1, rating @2: @3 s=• @1, note @2 : @3s
+Mining times:=Temps de minage :
+Mining this block is completely silent.=Miner ce bloc est complètement silencieux.
+Miscellaneous items=Objets divers
+No=Non
+Pointable: No=Pointable : Non
+Pointable: Only by special items=Pointable : Seulement avec des objets spéciaux
+Pointable: Yes=Pointable : Oui
+Punches with this block don't work as usual; melee combat and mining are either not possible or work differently.=Les frappes avec ce bloc ne fonctionnent pas de la manière usuelle ; le combat au corps à corps et le minage ne sont soit pas possible ou fonctionnent différemment.
+Punches with this item don't work as usual; melee combat and mining are either not possible or work differently.=Les frappes avec cet objet ne fonctionnent pas de la manière usuelle ; le combat au corps à corps et le minage ne sont soit pas possible ou fonctionnent différemment.
+Punches with this tool don't work as usual; melee combat and mining are either not possible or work differently.=Les frappes avec cet outil ne fonctionnent pas de la manière usuelle ; le combat au corps à corps et le minage ne sont soit pas possible ou fonctionnent différemment.
+Range: @1=Portée : @1
+# Range: <Hand> (<Range>)
+Range: @1 (@2)=Portée : @1 (@2)
+Range: 4=Portée : 4
+# Rating used for digging times
+Rating @1=Note @1
+# @1 is minimal rating, @2 is maximum rating
+Rating @1-@2=Note @1-@2
+The fall damage on this block is increased by @1%.=Les domages de chute sur ce bloc sont augmentés de @1%.
+The fall damage on this block is reduced by @1%.=Les domages de chute sur ce bloc sont réduits de @1%.
+This block allows light to propagate with a small loss of brightness, and sunlight can even go through losslessly.=Ce bloc laisse passer la lumière avec une petite perte de luminosité, et la lumière du soleil peut la traverser sans perte.
+This block allows light to propagate with a small loss of brightness.=Ce bloc laisse passer la lumière avec une petite perte de luminosité.
+This block allows sunlight to propagate without loss in brightness.=The bloc laisse passer la lumière du soleil sans perte de luminosité.
+This block belongs to the @1 group.=Ce bloc appartient au groupe @1.
+This block belongs to these groups: @1.=Ce bloc appartient aux groupes : @1.
+This block can be climbed.=Ce bloc peut être escaladé.
+This block can be destroyed by any mining tool immediately.=Ce bloc peut être détruit pas n'importe quel outil de minage instantanément.
+This block can be destroyed by any mining tool in half a second.=Ce bloc peut être détruit pas n'importe quel outil de minage en une demi-seconde.
+This block can be mined by any mining tool immediately.=Ce bloc peut être miné avec n'importe quel outil de minage instantanément.
+This block can be mined by any mining tool in half a second.=Ce bloc peut être miné avec n'importe quel outil de minage en une demi-seconde.
+This block can be mined by mining tools which match any of the following mining ratings and its toughness level.=Ce bloc peut être miné avec les outils de minages qui ont les notes de minage et les niveaux de robustesse suivants :
+This block can not be destroyed by ordinary mining tools.=Ce bloc ne peut pas être détruit avec les outils de minage ordinaires.
+This block can not be mined by ordinary mining tools.=Ce bloc ne peut pas être miné avec les outils de minage ordinaires.
+This block can serve as a smelting fuel with a burning time of @1.=Ce bloc peut servir de combustible pendant @1.
+This block causes a damage of @1 hit point per second.=Ce bloc cause des domages de @1 point de vie par seconde.
+This block causes a damage of @1 hit points per second.=Ce bloc cause des domages de @1 points de vie par seconde.
+This block connects to blocks of the @1 group.=Ce bloc se connecte aux blocs du groupe @1.
+This block connects to blocks of the following groups: @1.=Ce bloc se connecte aux blocs des groupes suivants : @1
+This block connects to these blocks: @1.=Ce bloc se connecte à ces blocs : @1
+This block connects to this block: @1.=Ce bloc se connecte à ce bloc : @1.
+This block decreases your breath and causes a drowning damage of @1 hit point every 2 seconds.=Ce bloc réduit votre souffle et cause des domages de noyade de @1 point de vie toutes les 2 secondes.
+This block decreases your breath and causes a drowning damage of @1 hit points every 2 seconds.=Ce bloc réduit votre souffle et cause des domages de noyade de @1 points de vie toutes les 2 secondes.
+This block is a light source with a light level of @1.=Ce bloc est une source de lumière de niveau @1.
+This block glows faintly with a light level of @1.=Ce bloc brille xxx avec une lumière de niveau @1.
+This block is a building block for creating various buildings.=Ce bloc est un bloc de construction pour créer différentes bâtisses.
+This block is a liquid with these properties:=Ce bloc est un liquide aux proprités suivantes :
+This block is affected by gravity and can fall.=Ce bloc est affecté par la gravité et peut tomber.
+This block is completely silent when mined or built.=Ce bloc ne fait pas de bruit lorsque l'on le mine ou le construit.
+This block is completely silent when walked on, mined or built.=Ce bloc ne fait pas de bruit lorsque l'on marche dessus, le mine ou le construit.
+This block is destroyed when a falling block ends up inside it.=Ce bloc est détruit lorsqu'un autre bloc tombe dessus.
+This block negates all fall damage.=Ce bloc annule tous les domages de chute.
+This block points to liquids.=Ce bloc peut pointer les liquides.
+This block will drop as an item when a falling block ends up inside it.=Ce bloc se transformera en objet lorsqu'un autre bloc tombe dessus.
+This block will drop as an item when it is not attached to a surrounding block.=Ce bloc se transformera en objet lorsqu'il n'est plus rattaché à un bloc alentour.
+This block will drop as an item when no collidable block is below it.=Ce bloc se transformera en objet lorsqu'il n'y aura plus de bloc percutable en dessous.
+This block will drop the following items when mined: @1.=Ce bloc donnera les objets suivant lorsque miné : @1.
+This block will drop the following when mined: @1×@2.=Ce bloc donnera les objets suivant lorsque miné : @1×@2.
+This block will drop the following when mined: @1.=Ce bloc donnera les objets suivant lorsque miné : @1.
+This block will drop the following when mined: @1.=Ce bloc donnera les objets suivant lorsque miné : @1.
+This block will make you bounce off with an elasticity of @1%.=Ce bloc vous fera rebondir avec une élasticité de @1%.
+This block will randomly drop one of the following when mined: @1.=Ce bloc laissera tomber de manière aléatoire un des éléments suivants lorsque miné : @1.
+This block will randomly drop up to @1 drops of the following possible drops when mined: @2.=Ce bloc laissera tomber de manière aléatoire jusqu'à @1 des éléments suivants lorque miné :
+This block won't drop anything when mined.=Ce bloc ne donnera rien lorsque miné.
+This is a decorational block.=C'est un bloc de décoration.
+This is a melee weapon which deals damage by punching.=C'est une arme de mêlée qui inflige des dommages en frappant.
+Maximum damage per hit:=Dommages maximaux par frappe :
+This item belongs to the @1 group.=Cet objet appartient au groupe @1.
+This item belongs to these groups: @1.=Cet objet appartient aux groupes suivants : @1
+This item can serve as a smelting fuel with a burning time of @1.=Cet objet peut servir de combustible pendant @1.
+This item is primarily used for crafting other items.=Cet objet est principalement utilisé pour fabriquer d'autres objets.
+This item points to liquids.=Cet objet peut pointer les liquides.
+This tool belongs to the @1 group.=Cet outil appartient au groupe @1.
+This tool belongs to these groups: @1.=Cet outil appartient aux groupes suivants : @1.
+This tool can serve as a smelting fuel with a burning time of @1.=Cet outil peut servir de combustible pendant @1.
+This tool is capable of mining.=Cet outil peut miner.
+Maximum toughness levels:=Niveau de robustesse maximum :
+This tool points to liquids.=Cet outil peut pointer les liquides.
+Tools and weapons=Outils et armes
+Unknown Node=Nœud inconnu
+Usage help: @1=Aide d'utilisation : @1
+Walking on this block is completely silent.=Marcher sur ce bloc est silencieux.
+Whenever you are not wielding any item, you use the hand which acts as a tool with its own capabilities. When you are wielding an item which is not a mining tool or a weapon it will behave as if it would be the hand.=Quand vous ne maniez aucun objet, vous utilisez la main qui se comporte comme un outil avec ses propres capacités. Lorsque vous maniez un objet qui n'est pas un outil ou une arme il se comportera comme si c'était la main.
+Yes=Oui
+You can not jump while standing on this block.=Vous ne pouvez pas sauter en étant sur ce bloc.
+any level=Tous les niveaux
+level 0=Niveau 0
+level 0-@1=Niveau 0-@1
+unknown=inconnu
+Unknown item (@1)=Objet inconnu (@1)
+• @1: @2=• @1 : @2
+• @1: @2 HP=• @1 : @2 PV
+• @1: @2, @3=• @1 : @2, @3
+• Flowing range: @1=• Distance de flux : @1
+• No flowing=• Ne coule pas
+• Not renewable=• Ne se renouvelle pas
+• Renewable=• Renouvelable
+• Viscosity: @1=• Viscosité : @1
+Itemstring: "@1"=Identifiant d'objet : "@1"
+Durability: @1 uses=Durabilité : @1 utilisations
+Durability: @1=Durabilité : @1
+Mining durability:=Durabilité de minage :
+• @1, level @2: @3 uses=• @1, niveau @2 : @3 utilisations
+• @1, level @2: Unlimited=• @1, niveau @2 : Illimité
+This block's rotation is affected by the way you place it: Place it on the floor or ceiling for a vertical orientation; place it at the side for a horizontal orientation. Sneaking while placing it leads to a perpendicular orientation instead.=La manière dont vous placez ce bloc affecte sa rotation : placez-le au sol ou au plafond pour une orientation verticale ; placez-le sur un coté pour une orientation horizontale. Pour le placer de manière perpendiculaire, utilisez la touche déplacement discrêt en le plaçant.
+Toughness level: @1=Niveau de robustesse : @1

mods/HELP/doc/doc_items/settingtypes.txt

@@ -13,4 +13,4 @@ doc_items_friendly_group_names (Show “friendly” group names) bool false
 #with the “give” or “debug” privilege.
 #The itemstring is useful to power users and programmers and
 #is used e.g. for the /give and /giveme commands.
-doc_items_show_itemstrings (Show itemstrings) bool false
+doc_items_show_itemstrings (Always show itemstrings) bool false