From 31f37b06653b4b239967fba01e07e3704b736c45 Mon Sep 17 00:00:00 2001 From: Wuzzy Date: Mon, 2 Dec 2024 05:30:07 +0100 Subject: [PATCH] Add translator comments (form: "--~") --- src/chess.lua | 33 +++++++++++++++++++++++++-------- src/cooking.lua | 3 +++ src/enchanting.lua | 6 ++++++ src/hive.lua | 1 + src/itemframe.lua | 5 ++++- src/mailbox.lua | 3 ++- src/mechanisms.lua | 2 ++ src/nodes.lua | 1 + src/workbench.lua | 11 ++++++++--- 9 files changed, 52 insertions(+), 13 deletions(-) diff --git a/src/chess.lua b/src/chess.lua index e830821..6af3053 100644 --- a/src/chess.lua +++ b/src/chess.lua @@ -1680,17 +1680,17 @@ local function update_formspec(meta) local turnWhite = minetest.colorize("#000001", playerWhiteDisplay) -- several status words for the player - -- player is in check + --~ Chess: player is in check local check_s = minetest.colorize("#FF8000", "["..S("check").."]") - -- player has been checkmated + --~ Chess: player has been checkmated local mate_s = minetest.colorize("#FF0000", "["..S("checkmate").."]") - -- player has resigned + --~ Chess: player has resigned local resign_s = minetest.colorize("#FF0000", "["..S("resigned").."]") - -- player has won + --~ Chess: player has won local win_s = minetest.colorize("#26AB2B", "["..S("winner").."]") - -- player has lost + --~ Chess: player has lost local lose_s = minetest.colorize("#FF0000", "["..S("loser").."]") - -- player has a draw + --~ Chess: player has a draw local draw_s = minetest.colorize("#FF00FF", "["..S("draw").."]") local status_black = "" @@ -1735,6 +1735,7 @@ local function update_formspec(meta) if promotion == "black" then eaten_img = "" promotion_formstring = + --~ Chess: Shown when black player can promote a pawn. Space for text is limited. "label[10.1,6.35;"..FS("PROMOTION\nFOR BLACK!").."]" .. "animated_image[10.05,7.2;2,2;p_img_white;pawn_black_promo_anim.png;5;100]" if botColor ~= "black" and botColor ~= "both" then @@ -1750,6 +1751,7 @@ local function update_formspec(meta) elseif promotion == "white" then eaten_img = "" promotion_formstring = + --~ Chess: Shown when white player can promote a pawn. Space for text is limited. "label[10.1,6.35;"..FS("PROMOTION\nFOR WHITE!").."]" .. "animated_image[10.05,7.2;2,2;p_img_white;pawn_white_promo_anim.png;5;100]" if botColor ~= "white" and botColor ~= "both" then @@ -1767,8 +1769,10 @@ local function update_formspec(meta) local draw_claim_formstring = "" if drawClaim ~= "" and gameResult == "" then if lastMove == "black" or lastMove == "" then + --~ Chess: Shown when white player wants to claim a draw. Space for text is limited. draw_claim_formstring = "label[10.1,6.35;"..FS("DRAW CLAIM\nBY WHITE!").."]" else + --~ Chess: Shown when black player wants to claim a draw. Space for text is limited. draw_claim_formstring = "label[10.1,6.35;"..FS("DRAW CLAIM\nBY BLACK!").."]" end if drawClaim == "50_move_rule" then @@ -1792,6 +1796,7 @@ local function update_formspec(meta) if playerActionsAvailable and (playerWhite ~= "" and playerBlack ~= "") then game_buttons = game_buttons .. "image_button[14.56,9.7;0.8,0.8;chess_resign.png;resign;]" .. + --~ Resign in Chess "tooltip[resign;"..FS("Resign").."]" end @@ -1812,12 +1817,14 @@ local function update_formspec(meta) -- Will trigger "draw claim" mode in which player must do the final move that triggers the draw game_buttons = game_buttons .. "image_button[13.36,9.7;0.8,0.8;chess_draw_50move_next.png;draw_50_moves;]".. "tooltip[draw_50_moves;".. + --~ Chess FS("Invoke the 50-move rule for your next move").."]" elseif halfmoveClock >= DRAWCLAIM_LONGGAME_PLAYER then -- When the 50 moves without capture / pawn move have occured occur. -- Will insta-draw. game_buttons = game_buttons .. "image_button[13.36,9.7;0.8,0.8;chess_draw_50move.png;draw_50_moves;]".. "tooltip[draw_50_moves;".. + --~ Chess FS("Invoke the 50-move rule and draw the game").."]" end @@ -1830,12 +1837,14 @@ local function update_formspec(meta) -- Will insta-draw. game_buttons = game_buttons .. "image_button[12.36,9.7;0.8,0.8;chess_draw_repeat3.png;draw_repeat_3;]".. "tooltip[draw_repeat_3;".. + --~ Chess FS("Invoke the threefold repetition rule and draw the game").."]" elseif maxRepeatedPositions >= 2 then -- If the same position may be about to occur 3 times. -- Will trigger "draw claim" mode in which player must do the final move that triggers the draw. game_buttons = game_buttons .. "image_button[12.36,9.7;0.8,0.8;chess_draw_repeat3_next.png;draw_repeat_3;]".. "tooltip[draw_repeat_3;".. + --~ Chess FS("Invoke the threefold repetition rule for your next move").."]" end end @@ -1974,6 +1983,7 @@ local function update_game_result(meta, lastMove) meta:set_string("gameResult", "draw") meta:set_string("gameResultReason", "stalemate") add_special_to_moves_list(meta, "draw") + --~ Chess message send_message_2(playerWhite, playerBlack, S("The game ended up in a stalemate! It's a draw!"), botColor) minetest.log("action", "[xdecor] Chess: A game between "..playerWhite.." and "..playerBlack.." ended in a draw by stalemate") return @@ -1994,6 +2004,7 @@ local function update_game_result(meta, lastMove) meta:set_string("gameResult", "draw") meta:set_string("gameResultReason", "stalemate") add_special_to_moves_list(meta, "draw") + --~ Chess message send_message_2(playerWhite, playerBlack, S("The game ended up in a stalemate! It's a draw!"), botColor) minetest.log("action", "[xdecor] Chess: A game between "..playerWhite.." and "..playerBlack.." ended in a draw by stalemate") return @@ -2005,6 +2016,7 @@ local function update_game_result(meta, lastMove) meta:set_string("gameResult", "draw") meta:set_string("gameResultReason", "dead_position") add_special_to_moves_list(meta, "draw") + --~ Chess message send_message_2(playerWhite, playerBlack, S("The game ended up in a dead position! It's a draw!"), botColor) minetest.log("action", "[xdecor] Chess: A game between "..playerWhite.." and "..playerBlack.." ended in a draw by dead position") end @@ -2120,6 +2132,7 @@ local function update_game_result(meta, lastMove) meta:set_string("gameResult", "draw") meta:set_string("gameResultReason", "same_position_5") add_special_to_moves_list(meta, "draw") + --~ Chess message when the fivefold repetition has happened local msg = S("The exact same position has occured 5 times. It's a draw!") send_message_2(playerWhite, playerBlack, msg, botColor) minetest.log("action", "[xdecor] Chess: A game between "..playerWhite.." and "..playerBlack.." ended in a draw because the same position has appeared 5 times") @@ -2814,11 +2827,11 @@ local function timeout_format(timeout_limit) local seconds = time_remaining % 60 if minutes == 0 then - -- number of seconds + --~ number of seconds return S("@1 s", seconds) end - -- number of minutes and seconds + --~ number of minutes and seconds return S("@1 min @2 s", minutes, seconds) end @@ -2900,6 +2913,7 @@ function realchess.fields(pos, _, fields, sender) local lastMove = meta:get_string("lastMove") if (playerName == playerWhite and playerWhite == "") or (playerName == playerBlack and playerBlack == "") then -- Can't resign before the player name has been recorded + --~ Chess message when player tried to resign too early send_message(playerName, S("Resigning is not possible yet.")) return end @@ -3050,9 +3064,11 @@ function realchess.fields(pos, _, fields, sender) local pcolor = promo:sub(-5) local activePromo = meta:get_string("promotionActive") if activePromo == "" then + --~ Chess message send_message(playerName, S("This isn't the time for promotion.")) return elseif activePromo ~= pcolor then + --~ Chess message send_message(playerName, S("It's not your turn! This promotion is meant for the other player.")) return end @@ -3060,6 +3076,7 @@ function realchess.fields(pos, _, fields, sender) realchess.promote_pawn(meta, pcolor, promo:sub(1, -7)) return else + --~ Chess message send_message(playerName, S("It's not your turn! This promotion is meant for the other player.")) return end diff --git a/src/cooking.lua b/src/cooking.lua index 3e25a3a..ff1d62d 100644 --- a/src/cooking.lua +++ b/src/cooking.lua @@ -4,8 +4,11 @@ local S = minetest.get_translator("xdecor") -- Set to true to print soup ingredients and fire nodes to console local DEBUG_RECOGNIZED_ITEMS = false +--~ cauldron hint local hint_fire = S("Light a fire below to heat it up") +--~ cauldron hint local hint_eat = S("Use a bowl to eat the soup") +--~ cauldron hint local hint_recipe = S("Drop foods inside to make a soup") local infotexts = { diff --git a/src/enchanting.lua b/src/enchanting.lua index 81614eb..929137d 100644 --- a/src/enchanting.lua +++ b/src/enchanting.lua @@ -28,8 +28,11 @@ function enchanting:get_tooltip_raw(enchant, percent) sharp = "#ffff00", } local enchant_loc = { + --~ Enchantment fast = S("Efficiency"), + --~ Enchantment durable = S("Durability"), + --~ Enchantment sharp = S("Sharpness"), } @@ -92,8 +95,11 @@ function enchanting.formspec(pos, enchants) listring[context;mese] image[2,2.9;1,1;mese_layout.png] ]] + --~ Sharpness enchantment .."tooltip[sharp;"..FS("Your weapon inflicts more damage").."]" + --~ Durability enchantment .."tooltip[durable;"..FS("Your tool lasts longer").."]" + --~ Efficiency enchantment .."tooltip[fast;"..FS("Your tool digs faster").."]" ..default.gui_slots .. default.get_hotbar_bg(0.55, 4.5) diff --git a/src/hive.lua b/src/hive.lua index 72265dc..660cf84 100644 --- a/src/hive.lua +++ b/src/hive.lua @@ -121,6 +121,7 @@ end xdecor.register("hive", { description = S("Artificial Hive"), + --~ Tooltip of artificial hive _tt_help = S("Bees live here and produce honey"), tiles = {"xdecor_hive_top.png", "xdecor_hive_top.png", "xdecor_hive_side.png", "xdecor_hive_side.png", diff --git a/src/itemframe.lua b/src/itemframe.lua index 2903da6..fd7ec0e 100644 --- a/src/itemframe.lua +++ b/src/itemframe.lua @@ -73,7 +73,9 @@ function itemframe.set_infotext(meta) local owner = meta:get_string("owner") if itemstring == "" then if owner ~= "" then - meta:set_string("infotext", S("@1 (owned by @2)", S("Item Frame"), owner)) + --~ Item frame infotext. @1 = item frame name, @2 = owner name (player) + meta:set_string("infotext", S("@1 (owned by @2)", + S("Item Frame"), owner)) else meta:set_string("infotext", S("Item Frame")) end @@ -158,6 +160,7 @@ end xdecor.register("itemframe", { description = S("Item Frame"), + --~ Item frame tooltip _tt_help = S("For presenting a single item"), groups = {choppy = 3, oddly_breakable_by_hand = 2, flammable = 3}, is_ground_content = false, diff --git a/src/mailbox.lua b/src/mailbox.lua index b9223a3..4fe7f6f 100644 --- a/src/mailbox.lua +++ b/src/mailbox.lua @@ -61,7 +61,7 @@ function mailbox:formspec(pos, owner, is_owner) -- List of donors. A line looks like this: -- × giver = giver .. "#FFFF00," .. giver_name .. "," .. i .. - -- Times a certain item count; used for the mailbox donor list + --~ Used in the mailbox donor list. Will be displayed as item icon followed by this string. @1 = item count ",#FFFFFF," .. FS("× @1", stack_count) .. "," img = img .. i .. "=" .. @@ -180,6 +180,7 @@ end xdecor.register("mailbox", { description = S("Mailbox"), + --~ Mailbox tooltip _tt_help = S("Lets other players give you things"), tiles = {"xdecor_mailbox_top.png", "xdecor_mailbox_bottom.png", "xdecor_mailbox_side.png", "xdecor_mailbox_side.png", diff --git a/src/mechanisms.lua b/src/mechanisms.lua index 2f4094b..db8c611 100644 --- a/src/mechanisms.lua +++ b/src/mechanisms.lua @@ -57,6 +57,7 @@ end function plate.register(material, desc, def) xdecor.register("pressure_" .. material .. "_off", { description = def.description or (desc .. " Pressure Plate"), + --~ Pressure plate tooltip _tt_help = S("Opens doors when stepped on"), tiles = {"xdecor_pressure_" .. material .. ".png"}, use_texture_alpha = ALPHA_OPAQUE, @@ -98,6 +99,7 @@ plate.register("stone", "Stone", { xdecor.register("lever_off", { description = S("Lever"), + --~ Lever tooltip _tt_help = S("Opens doors when pulled"), tiles = {"xdecor_lever_off.png"}, use_texture_alpha = ALPHA_OPAQUE, diff --git a/src/nodes.lua b/src/nodes.lua index 1daacb1..157633a 100644 --- a/src/nodes.lua +++ b/src/nodes.lua @@ -940,6 +940,7 @@ xdecor.register("woodframed_glass", { local devices = { { "radio", S("Radio"), default.node_sound_metal_defaults() }, + --~ as in "loudspeaker" { "speaker", S("Speaker"), default.node_sound_metal_defaults() }, } for _, v in pairs(devices) do diff --git a/src/workbench.lua b/src/workbench.lua index 308312b..54eeaf2 100644 --- a/src/workbench.lua +++ b/src/workbench.lua @@ -38,7 +38,7 @@ end -- Tools allowed to be repaired function workbench:repairable(stack) - -- Explicitly registeded as repairable: Overrides everything else + -- Explicitly registered as repairable: Overrides everything else if custom_repairable[stack] then return true end @@ -112,11 +112,16 @@ function workbench:get_output(inv, input, name) inv:set_list("forms", output) end -local main_fs = "label[0.9,1.23;"..FS("Cut").."]" +local main_fs = "".. + --~ Verb shown in workbench form where you can cut a node + "label[0.9,1.23;"..FS("Cut").."]" + --~ Verb shown in workbench form where you can repair an item .."label[0.9,2.23;"..FS("Repair").."]" ..[[ box[-0.05,1;2.05,0.9;#555555] box[-0.05,2;2.05,0.9;#555555] ]] + --~ Button in workbench form .."button[0,0;2,1;craft;"..FS("Crafting").."]" + --~ Button in workbench form .."button[2,0;2,1;storage;"..FS("Storage").."]" ..[[ image[3,1;1,1;gui_arrow.png] image[0,1;1,1;worktable_saw.png] @@ -415,7 +420,7 @@ local function register_cut_raw(node, workbench_def) return false end minetest.register_node(":" .. cutnodename, { - -- @1: Base node description (e.g. "Stone"); @2: modifier (e.g. "Nanoslab") + --~ Format of the description of a cut node. @1: Base node description (e.g. "Stone"); @2: modifier (e.g. "Nanoslab") description = S("@1 @2", def.description, workbench_def[4]), paramtype = "light", paramtype2 = "facedir",