diff --git a/README.md b/README.md index c4bd016..b2780fb 100644 --- a/README.md +++ b/README.md @@ -17,13 +17,12 @@ This modpack contains: - towercrane: Simplifies the building of large techage plants - basic_materials: Needed items for many recipes - stamina: The "hunger" mod from "minetest-mods" -- doc: Ingame documentation mod, used for minecart and signs_bot - unified_inventory: Player's inventory with crafting guide, bags, and more. - tubelib2: Necessary library - networks: Necessary library - safer_lua: Necessary library - lcdlib: Necessary library -- datastorage: Necessary library +- doclib: Necessary library ### Techage Manual @@ -47,6 +46,25 @@ ta4_jetpack requires the modpack 3d_armor. 3d_armor is itself a modpack and can' ### History +#### 2023-08-25 + +Updated Mods: + +- techage v1.17: + - see readme.md +- autobahn: + - Make motor sound mono (Niklp09) +- lcdlib v1.02: + - see readme.md +- signs_bot v1.13: + - see readme.md +- minecart v2.05: + - see readme.md +- mod 'doc' removed +- mod 'doclib' v1.00 added + **The mod doclib is a new hard depenency !** +- mod 'datastorage' removed + #### 2023-05-09 Updated Mods: diff --git a/datastorage/README.md b/datastorage/README.md deleted file mode 100644 index b15b07a..0000000 --- a/datastorage/README.md +++ /dev/null @@ -1,22 +0,0 @@ -datastorage -=========== - -Helper mod to manage players data. -All the mods can acces a single file (container) and easily have the data saved/loaded for them. - -Usage ------ - - local data = datastorage.get(id, ...) - -Returns a reference to a data container. The id is normally a player name. -Following arguments are keys to recurse into, normally only one, a string -describing the type of data, is used. If the container doesn't exist it will -be created, otherwise it will contain all previously stored data. The table -can store any data. Player's containers will be saved to disk when the player -leaves, and all references to the player's data should be dropped. All of the -containers will be saved on server shutdown. To forcibly save a container's -data use: - - datastorage.save(id) - diff --git a/datastorage/init.lua b/datastorage/init.lua deleted file mode 100644 index 30677fc..0000000 --- a/datastorage/init.lua +++ /dev/null @@ -1,98 +0,0 @@ -datastorage = {data = {}} - -local DIR_DELIM = DIR_DELIM or "/" -local data_path = minetest.get_worldpath()..DIR_DELIM.."datastorage"..DIR_DELIM - -function datastorage.save(id) - local data = datastorage.data[id] - -- Check if the container is empty - if not data or not next(data) then return end - for _, sub_data in pairs(data) do - if not next(sub_data) then return end - end - - local file = io.open(data_path..id, "w") - if not file then - -- Most likely the data directory doesn't exist, create it - -- and try again. - if minetest.mkdir then - minetest.mkdir(data_path) - else - -- Using os.execute like this is not very platform - -- independent or safe, but most platforms name their - -- directory creation utility mkdir, the data path is - -- unlikely to contain special characters, and the - -- data path is only mutable by the admin. - os.execute('mkdir "'..data_path..'"') - end - file = io.open(data_path..id, "w") - if not file then return end - end - - local datastr = minetest.serialize(data) - if not datastr then return end - - file:write(datastr) - file:close() - return true -end - -function datastorage.load(id) - local file = io.open(data_path..id, "r") - if not file then return end - - local data = minetest.deserialize(file:read("*all")) - datastorage.data[id] = data - - file:close() - return data -end - --- Compatability -function datastorage.get_container(player, id) - return datastorage.get(player:get_player_name(), id) -end - --- Retrieves a value from the data storage -function datastorage.get(id, ...) - local last = datastorage.data[id] - if last == nil then last = datastorage.load(id) end - if last == nil then - last = {} - datastorage.data[id] = last - end - local cur = last - for _, sub_id in ipairs({...}) do - last = cur - cur = cur[sub_id] - if cur == nil then - cur = {} - last[sub_id] = cur - end - end - return cur -end - --- Saves a container and reomves it from memory -function datastorage.finish(id) - datastorage.save(id) - datastorage.data[id] = nil -end - --- Compatability -function datastorage.save_container(player) - return datastorage.save(player:get_player_name()) -end - -minetest.register_on_leaveplayer(function(player) - local player_name = player:get_player_name() - datastorage.save(player_name) - datastorage.data[player_name] = nil -end) - -minetest.register_on_shutdown(function() - for id in pairs(datastorage.data) do - datastorage.save(id) - end -end) - diff --git a/datastorage/mod.conf b/datastorage/mod.conf deleted file mode 100644 index 39a27d2..0000000 --- a/datastorage/mod.conf +++ /dev/null @@ -1,2 +0,0 @@ -name=datastorage -description=Helper mod to manage players data. diff --git a/doc/API.md b/doc/API.md deleted file mode 100644 index 49afeb3..0000000 --- a/doc/API.md +++ /dev/null @@ -1,539 +0,0 @@ -# API documentation for the Documentation System -## Core concepts -As a modder, you are free to write basically about everything and are also -relatively free in the presentation of information. There are no -restrictions on content whatsoever. - -### Categories and entries -In the Documentation System, everything is built on categories and entries. -An entry is a single piece of documentation and is the basis of all actual -documentation. Categories group multiple entries of the same topic together. - -Categories also define a template function which is used to determine how the -final result in the tab “Entry list” looks like. Entries themselves have -a data field attached to them, this is a table containing arbitrary metadata -which is used to construct the final formspec in the Entry tab. It may also -be used for sorting entries in the entry list. - -## Advanced concepts -### Viewed and hidden entries -The mod keeps track of which entries have been viewed on a per-player basis. -Any entry which has been accessed by a player is immediately marked as -“viewed”. - -Entries can also be hidden. Hidden entries are not visible or otherwise -accessible to players until they become revealed by function calls. - -Marking an entry as viewed or revealed is not reversible with this API. -The viewed and hidden states are stored in the file `doc.mt` inside the -world directory. You can safely delete this file if you want to reset -the player states. - -### Entry aliases -Entry aliases are alternative identifiers for entry identifiers. With the -exception of the alias functions themselves, for functions demanding an -`entry_id` you can either supply the original `entry_id` or any alias of the -`entry_id`. - -## Possible use cases -This section shows some possible use cases to give you a rough idea what -this mod is capable of and how these use cases could be implemented. - -### Simple use case: Minetest basics -Let's say you want to write in free form short help texts about the basic -concepts of Minetest or your game. First you could define a category -called “Basics”, the data for each of its entry is just a free form text. -The template function simply creates a formspec where this free form -text is displayed. - -This is one of the most simple use cases and the mod `doc_basics` does -exactly that. - -### Complex use case: Blocks -You could create a category called “Blocks”, and this category is supposed to -contain entries for every single block (i.e. node) in the game. For this use -case, a free form approach would be very inefficient and error-prone, as a -lot of data can be reused. - -Here the template function comes in handy: The internal entry data -contain a lot of different things about a block, like block name, identifier, -custom description and most importantly, the definition table of the block. - -Finally, the template function takes all that data and turns it into -sentences which are just concatenated, telling as many useful facts about -this block as possible. - -## Functions -This is a list of all publicly available functions. - -### Overview -The most important functions are `doc.add_category` and `doc.ad_entry`. All other functions -are mostly used for utility and examination purposes. - -If not mentioned otherwise, the return value of all functions is `nil`. - -These functions are available: - -#### Core -* `doc.add_category`: Adds a new category -* `doc.add_entry`: Adds a new entry - -#### Display -* `doc.show_entry`: Shows a particular entry to a player -* `doc.show_category`: Shows the entry list of a category to a player -* `doc.show_doc`: Opens the main help form for a player - -#### Query -* `doc.get_category_definition`: Returns the definition table of a category -* `doc.get_entry_definition`: Returns the definition table of an entry -* `doc.entry_exists`: Checks whether an entry exists -* `doc.entry_viewed`: Checks whether an entry has been viewed/read by a player -* `doc.entry_revealed`: Checks whether an entry is visible and normally accessible to a player -* `doc.get_category_count`: Returns the total number of categories -* `doc.get_entry_count`: Returns the total number of entries in a category -* `doc.get_viewed_count`: Returns the number of entries a player has viewed in a category -* `doc.get_revealed_count`: Returns the number of entries a player has access to in a category -* `doc.get_hidden_count`: Returns the number of entries which are hidden from a player in a category -* `doc.get_selection`: Returns the currently viewed entry/category of a player - -#### Modify -* `doc.set_category_order`: Sets the order of categories in the category list -* `doc.mark_entry_as_viewed`: Manually marks an entry as viewed/read by a player -* `doc.mark_entry_as_revealed`: Make a hidden entry visible and accessible to a player -* `doc.mark_all_entries_as_revealed`: Make all hidden entries visible and accessible to a player - -#### Aliases -* `doc.add_entry_alias`: Add an alternative name which can be used to access an entry - -#### Special widgets -This API provides functions to add unique “widgets” for functionality -you may find useful when creating entry templates. You find these -functions in `doc.widgets`. -Currently there is a widget for scrollable multi-line text and a -widget providing an image gallery. - - - -### `doc.add_category(id, def)` -Adds a new category. You have to define an unique identifier, a name -and a template function to build the entry formspec from the entry -data. - -**Important**: You must call this function *before* any player joins. - -#### Parameters -* `id`: Unique category identifier as a string -* `def`: Definition table with the following fields: - * `name`: Category name to be shown in the interface - * `description`: (optional) Short description of the category, - will be shown as tooltip. Recommended style (in English): - First letter capitalized, no punctuation at the end, - max. 100 characters - * `build_formspec`: The template function (see below). Takes entry data - as its first parameter (has the data type of the entry data) and the - name of the player who views the entry as its second parameter. It must - return a formspec which is inserted in the Entry tab. - * `sorting`: (optional) Sorting algorithm for display order of entries - * `"abc"`: Alphabetical (default) - * `"nosort"`: Entries appear in no particular order - * `"custom"`: Manually define the order of entries in `sorting_data` - * `"function"`: Sort by function defined in `sorting_data` - * `sorting_data`: (optional) Additional data for special sorting methods. - * If `sorting=="custom"`, this field must contain a table (list form) in which - the entry IDs are specified in the order they are supposed to appear in the - entry list. All entries which are missing in this table will appear in no - particular order below the final specified one. - * If `sorting=="function"`, this field is a compare function to be used as - the `comp` parameter of `table.sort`. The parameters given are two entries. - * This field is not required if `sorting` has any other value - * `hide_entries_by_default` (optional): If `true`, all entries - added to this category will start as hidden, unless explicitly specified otherwise - (default: `false`) - -Note: For function-based sorting, the entries provided to the compare function -will have the following format: - - { - eid = e, -- unique entry identifier - name = n, -- entry name - data = d, -- arbitrary entry data - } - -#### Using `build_formspec` -For `build_formspec` you can either define your own function which -procedurally generates the entry formspec or you use one of the -following predefined convenience functions: - -* `doc.entry_builders.text`: Expects entry data to be a string. - It will be inserted directly into the entry. Useful for entries with - a free form text. -* `doc.entry_builders.text_and_gallery`: For entries with text and - an optional standard gallery (3 rows, 3:2 aspect ratio). Expects - entry data to be a table with these fields: - * `text`: The entry text - * `images`: The images of the gallery, the format is the same as the - `imagedata` parameter of `doc.widgets.gallery`. Can be `nil`, in - which case no gallery is shown for the entry -* `doc.entry_builders.formspec`: Entry data is expected to contain the - complete entry formspec as a string. Useful if your entries. Useful - if you expect your entries to differ wildly in layouts. - -##### Formspec restrictions -When building your formspec, you have to respect the size limitations. -The help form currently uses a size of 15×10.5 and you must make sure -all entry widgets are inside a boundary box. The remaining space is -reserved for widgets of the help form and should not be used to avoid -overlapping. -Read from the following variables to calculate the final formspec coordinates: - -* `doc.FORMSPEC.WIDTH`: Width of help formspec -* `doc.FORMSPEC.HEIGHT`: Height of help formspec -* `doc.FORMSPEC.ENTRY_START_X`: Leftmost X point of bounding box -* `doc.FORMSPEC.ENTRY_START_Y`: Topmost Y point of bounding box -* `doc.FORMSPEC.ENTRY_END_X`: Rightmost X point of bounding box -* `doc.FORMSPEC.ENTRY_END_Y`: Bottom Y point of bounding box -* `doc.FORMSPEC.ENTRY_WIDTH`: Width of the entry widgets bounding box -* `doc.FORMSPEC.ENTRY_HEIGHT`: Height of the entry widgets bounding box - -Finally, to avoid naming collisions, you must make sure that all identifiers -of your own formspec elements do *not* begin with “`doc_`”. - -##### Receiving formspec events -You can even use the formspec elements you have added with `build_formspec` to -receive formspec events, just like with any other formspec. For receiving, use -the standard function `minetest.register_on_player_receive_fields` to register -your event handling. The `formname` parameter will be `doc:entry`. Use -`doc.get_selection` to get the category ID and entry ID of the entry in question. - -### `doc.add_entry(category_id, entry_id, def)` -Adds a new entry into an existing category. You have to define the category -to which to insert the entry, the entry's identifier, a name and some -data which defines the entry. Note you do not directly define here how the -end result of an entry looks like, this is done by `build_formspec` from -the category definition. - -**Important**: You must call this function *before* any player joins. - -#### Parameters -* `category_id`: Identifier of the category to add the entry into -* `entry_id`: Unique identifier of the new entry, as a string -* `def`: Definition table, it has the following fields: - * `name`: Entry name to be shown in the interface - * `hidden`: (optional) If `true`, entry will not be displayed in entry list - initially (default: `false`); it can be revealed later - * `data`: Arbitrary data attached to the entry. Any data type is allowed; - The data in this field will be used to create the actual formspec - with `build_formspec` from the category definition - -### `doc.set_category_order(category_list)` -Sets the order of categories in the category list. -The help starts with this default order: - - {"basics", "nodes", "tools", "craftitems", "advanced"} - -This function can be called at any time, but it recommended to only call -this function once for the entire server session and to only call it -from game mods, to avoid contradictions. If this function is called a -second time by any mod, a warning is written into the log. - -#### Parameters -* `category_list`: List of category IDs in the order they should appear - in the category list. All unspecified categories will be appended to - the end - - -### `doc.show_doc(playername)` -Opens the main help formspec for the player (“Category list” tab). - -#### Parameters -* `playername`: Name of the player to show the formspec to - -### `doc.show_category(playername, category_id)` -Opens the help formspec for the player at the specified category -(“Entry list” tab). - -#### Parameters -* `playername`: Name of the player to show the formspec to -* `category_id`: Category identifier of the selected category - -### `doc.show_entry(playername, category_id, entry_id, ignore_hidden)` -Opens the help formspec for the player showing the specified entry -of a category (“Entry” tab). If the entry is hidden, an error message -is displayed unless `ignore_hidden==true`. - -#### Parameters -* `playername`: Name of the player to show the formspec to -* `category_id`: Category identifier of the selected category -* `entry_id`: Entry identifier of the entry to show -* `ignore_hidden`: (optional) If `true`, shows entry even if it is still hidden - to the player; this will automatically reveal the entry to this player for the - rest of the game - -### `doc.get_category_definition(category_id)` -Returns the definition of the specified category. - -#### Parameters -* `category_id`: Category identifier of the category to the the definition - for - -#### Return value -The category's definition table as specified in the `def` argument of -`doc.add_category`. The table fields are the same. - -### `doc.get_entry_definition(category_id, entry_id)` -Returns the definition of the specified entry. - -#### Parameters -* `category_id`: Category identifier of entry's category -* `entry_id`: Entry identifier of the entry to get the definition for - -#### Return value -The entry's definition table as specified in the `def` argument of -`doc.add_entry`. The table fields are the same. - -### `doc.entry_exists(category_id, entry_id)` -Checks whether the specified entry exists and returns `true` or `false`. -Entry aliases are taken into account. - -#### Parameters -* `category_id`: Category identifier of the category to check -* `entry_id`: Entry identifier of the entry to check for its existence - -#### Return value -Returns `true` if and only if: - -* The specified category exists -* It contains the specified entry - -Otherwise, returns `false`. - -### `doc.entry_viewed(playername, category_id, entry_id)` -Tells whether the specified entry is marked as “viewed” (or read) by -the player. - -#### Parameters -* `playername`: Name of the player to check -* `category_id`: Category identifier of the category to check -* `entry_id`: Entry identifier of the entry to check - -#### Return value -`true`, if entry is viewed, `false` otherwise. - -### `doc.entry_revealed(playername, category_id, entry_id)` -Tells whether the specified entry is marked as “revealed” to the player -and thus visible and accessible to the player. - -#### Parameters -* `playername`: Name of the player to check -* `category_id`: Category identifier of the category to check -* `entry_id`: Entry identifier of the entry to check - -#### Return value -`true`, if entry is revealed, `false` otherwise. - -### `doc.mark_entry_as_viewed(playername, category_id, entry_id)` -Marks a particular entry as “viewed” (or read) by a player. This will -also automatically reveal the entry to the player for the rest of -the game. - -#### Parameters -* `playername`: Name of the player for whom to mark an entry as “viewed” -* `category_id`: Category identifier of the category of the entry to mark -* `entry_id`: Entry identifier of the entry to mark - -### `doc.mark_entry_as_revealed(playername, category_id, entry_id)` -Marks a particular entry as “revealed” to a player. If the entry is -declared as hidden, it will become visible in the list of entries for -this player and will always be accessible with `doc.show_entry`. This -change remains for the rest of the game. - -For entries which are not normally hidden, this function has no direct -effect. - -#### Parameters -* `playername`: Name of the player for whom to reveal the entry -* `category_id`: Category identifier of the category of the entry to reveal -* `entry_id`: Entry identifier of the entry to reveal - -### `doc.mark_all_entries_as_revealed(playername)` -Marks all entries as “revealed” to a player. This change remains for the -rest of the game. - -#### Parameters -* `playername`: Name of the player for whom to reveal the entries - -### `doc.add_entry_alias(category_id_orig, entry_id_orig, category_id_alias, entry_id_alias)` -Adds a single alias for an entry. If an entry has an alias, supplying the -alias to a function which demand `category_id` and `entry_id` will work as expected. -When using this function, you must make sure the category already exists. - -This function could be useful for legacy support after changing an entry ID or -moving an entry to a different category. - -#### Parameters -* `category_id_orig`: Category identifier of the category of the entry in question -* `entry_id_orig`: The original (!) entry identifier of the entry to create an alias - for -* `category_id_alias`: The category ID of the alias -* `entry_id_alias`: The entry ID of the alias - -#### Example - - doc.add_entry_alias("nodes", "test", "craftitems", "test2") - -When calling a function with category ID “craftitems” and entry ID “test2”, it will -act as if you supplied “nodes” as category ID and “test” as entry ID. - -### `doc.get_category_count()` -Returns the number of registered categories. - -#### Return value -Number of registered categories. - -### `doc.get_entry_count(category_id)` -Returns the number of entries in a category. - -#### Parameters -* `category_id`: Category identifier of the category in which to count entries - -#### Return value -Number of entries in the specified category. - -### `doc.get_viewed_count(playername, category_id)` -Returns how many entries have been viewed by a player. - -#### Parameters -* `playername`: Name of the player to count the viewed entries for -* `category_id`: Category identifier of the category in which to count the - viewed entries - -#### Return value -Amount of entries the player has viewed in the specified category. If the -player does not exist, this function returns `nil`. - -### `doc.get_revealed_count(playername, category_id)` -Returns how many entries the player has access to (non-hidden entries) -in this category. - -#### Parameters -* `playername`: Name of the player to count the revealed entries for -* `category_id`: Category identifier of the category in which to count the - revealed entries - -#### Return value -Amount of entries the player has access to in the specified category. If the -player does not exist, this function returns `nil`. - -### `doc.get_hidden_count(playername, category_id)` -Returns how many entries are hidden from the player in this category. - -#### Parameters -* `playername`: Name of the player to count the hidden entries for -* `category_id`: Category identifier of the category in which to count the - hidden entries - -#### Return value -Amount of entries hidden from the player. If the player does not exist, -this function returns `nil`. - -### `doc.get_selection(playername)` -Returns the currently or last viewed entry and/or category of a player. - -#### Parameter -* `playername`: Name of the player to query - -#### Return value -It returns up to 2 values. The first one is the category ID, the second one -is the entry ID of the entry/category which the player is currently viewing -or is the last entry the player viewed in this session. If the player only -viewed a category so far, the second value is `nil`. If the player has not -viewed a category as well, both returned values are `nil`. - - -### `doc.widgets.text(data, x, y, width, height)` -This is a convenience function for creating a special formspec widget. It creates -a widget in which you can insert scrollable multi-line text. - -#### Parameters -* `data`: Text to be written inside the widget -* `x`: Formspec X coordinate (optional) -* `y`: Formspec Y coordinate (optional) -* `width`: Width of the widget in formspec units (optional) -* `height`: Height of the widget in formspec units (optional) - -The default values for the optional parameters result in a widget which fills -nearly the entire entry page. - -#### Return value -Two values are returned, in this order: - -* string: Contains a complete formspec definition building the widget -* string: Formspec element ID of the created widget - -#### Note -If you use this function to build a formspec string, do not use identifiers -beginning with `doc_widget_text` to avoid naming collisions, as this function -makes use of such identifiers internally. - - -### `doc.widgets.gallery(imagedata, playername, x, y, aspect_ratio, width, rows, align_left, align_top)` -This function creates an image gallery which allows you to display an -arbitrary amount of images aligned horizontally. It is possible to add more -images than the space of an entry would normally held, this is done by adding -“scroll” buttons to the left and right which allows the user to see more images -of the gallery. - -This function is useful for adding multiple illustration to your entry without -worrying about space too much. Adding illustrations can help you to create -entry templates which aren't just lengthy walls of text. ;-) - -You can define the position, image aspect ratio, total gallery width and the -number of images displayed at once. You can *not* directly define the image -size, nor the resulting height of the overall gallery, those values will -be derived from the parameters. - -You can only really use this function efficiently inside a *custom* -`build_formspec` function definition. This is because you need to pass a -`playername`. You can currently also only add up to one gallery per entry; -adding more galleries is not supported and will lead to bugs. - -### Parameters -* `imagedata`: List of images to be displayed in the specified order. All images must - have the same aspect ratio. It's a table of tables with this format: - * `imagetype`: Type of image to be used (optional): - * `"image"`: Texture file (default) - * `"item"`: Item image, specified as itemstring - * `image`: What to display. Depending on `imagetype`, a texture file or itemstring -* `playername`: Name of the player who is viewing the entry in question -* `x`: Formspec X coordinate of the top left corner (optional) -* `y`: Formspec Y coordinate of the top left corner (optional) -* `aspect_ratio`: Aspect ratio of all the images (width/height) -* `width`: Total gallery width in formspec units (optional) -* `rows`: Number of images which can be seen at once (optional) -* `align_left`: If `false`, gallery is aligned to the left instead of the right (optional) -* `align_right`: If `false`, gallery is aligned to the bottom instead of the top (optional) - -The default values for the optional parameters result in a gallery with -3 rows which is placed at the top left corner and spans the width of the -entry and assumes an aspect ratio of two thirds. - -If the number of images is greater than `rows`, “scroll” buttons will appear -at the left and right side of the images. - -#### Return values -Two values are returned, in this order: - -* string: Contains a complete formspec definition building the gallery -* number: The height the gallery occupies in the formspec - -## Extending this mod (naming conventions) -If you want to extend this mod with your own functionality, it is recommended -that you put all API functions into `doc.sub.`. -As a naming convention, if you mod *primarily* depends on `doc`, it is recommended -to use a short mod name which starts with “`doc_`”, like `doc_items`, -`doc_minetest_game`, or `doc_identifier`. - -One mod which uses this convention is `doc_items` which uses the `doc.sub.items` -table. - - diff --git a/doc/README.md b/doc/README.md deleted file mode 100644 index 802701c..0000000 --- a/doc/README.md +++ /dev/null @@ -1,52 +0,0 @@ -# Documentation System [`doc`] -This mod provides a simple and highly extensible form in which the user -can access help pages about various things and the modder can add those pages. -The mod itself does not provide any help texts, just the framework. -It is the heart of the Help modpack, on which the other Help mods depend. - -Current version: 1.2.1 - -## For players -### Accessing the help -To open the help, there are multiple ways: - -- Use the `/helpform` chat command. This works always. -- If you use one of these mods, there's a help button in the inventory menu: - - Unified Inventory [`unified_inventory`] - - Simple Fast Inventory Buttons [`sfinv_buttons`] - - Inventory++ [`inventory_plus`] - -The help itself should be more or less self-explanatory. - -This mod is useless on its own, you will only need this mod as a dependency -for mods which actually add some help entries. - -### Hidden entries -Some entries are initially hidden from you. You can't see them until you -unlocked them. Mods can decide for themselves how particular entries are -revealed. Normally you just have to proceed in the game to unlock more -entries. Hidden entries exist to avoid spoilers and give players a small -sense of progress. - -Players with the `help_reveal` privilege can use the `/help_reveal` chat -command to reveal all hidden entries instantly. - -### Maintenance -The information of which player has viewed and revealed which entries is -stored in the world directory in the file `doc.mt`. You can safely reset -the viewed/revealed state of all players by deleting this file. Players -then need to start over revealing all entries. - -## For modders and game authors -This mod helps you in creating extensive and flexible help entries for your -mods or game. You can write about basically anything in the presentation -you prefer. - -To get started, read `API.md` in the directory of this mod. - -Note: If you want to add help texts for items and nodes, refer to the API -documentation of `doc_items`, instead of manually adding entries. -For custom entities, you may also want to add support for `doc_identifier`. - -## License of everything -MIT License diff --git a/doc/init.lua b/doc/init.lua deleted file mode 100644 index 9c612b3..0000000 --- a/doc/init.lua +++ /dev/null @@ -1,1220 +0,0 @@ -local S = minetest.get_translator("doc") -local F = function(f) return minetest.formspec_escape(S(f)) end - --- Compability for 0.4.14 or earlier -local colorize -if minetest.colorize then - colorize = minetest.colorize -else - colorize = function(color, text) return text end -end - -doc = {} - --- Some informational variables --- DO NOT CHANGE THEM AFTERWARDS AT RUNTIME! - --- Version number (follows the SemVer specification 2.0.0) -doc.VERSION = {} -doc.VERSION.MAJOR = 1 -doc.VERSION.MINOR = 2 -doc.VERSION.PATCH = 1 -doc.VERSION.STRING = doc.VERSION.MAJOR.."."..doc.VERSION.MINOR.."."..doc.VERSION.PATCH - --- Formspec information -doc.FORMSPEC = {} --- Width of formspec -doc.FORMSPEC.WIDTH = 15 -doc.FORMSPEC.HEIGHT = 10.5 - ---[[ Recommended bounding box coordinates for widgets to be placed in entry pages. Make sure -all entry widgets are completely inside these coordinates to avoid overlapping. ]] -doc.FORMSPEC.ENTRY_START_X = 0.2 -doc.FORMSPEC.ENTRY_START_Y = 0.5 -doc.FORMSPEC.ENTRY_END_X = doc.FORMSPEC.WIDTH -doc.FORMSPEC.ENTRY_END_Y = doc.FORMSPEC.HEIGHT - 0.5 -doc.FORMSPEC.ENTRY_WIDTH = doc.FORMSPEC.ENTRY_END_X - doc.FORMSPEC.ENTRY_START_X -doc.FORMSPEC.ENTRY_HEIGHT = doc.FORMSPEC.ENTRY_END_Y - doc.FORMSPEC.ENTRY_START_Y - ---TODO: Use container formspec element later - --- Internal helper variables -local DOC_INTRO = S("This is the help.") - -local COLOR_NOT_VIEWED = "#00FFFF" -- cyan -local COLOR_VIEWED = "#FFFFFF" -- white -local COLOR_HIDDEN = "#999999" -- gray -local COLOR_ERROR = "#FF0000" -- red - -local CATEGORYFIELDSIZE = { - WIDTH = math.ceil(doc.FORMSPEC.WIDTH / 4), - HEIGHT = math.floor(doc.FORMSPEC.HEIGHT-1), -} - -doc.data = {} -doc.data.categories = {} -doc.data.aliases = {} --- Default order (includes categories of other mods from the Docuentation System modpack) -doc.data.category_order = {"basics", "nodes", "tools", "craftitems", "advanced"} -doc.data.category_count = 0 -doc.data.players = {} - --- Space for additional APIs -doc.sub = {} - --- Status variables -local set_category_order_was_called = false - --- Returns the entry definition and true entry ID of an entry, taking aliases into account -local function get_entry(category_id, entry_id) - local category = doc.data.categories[category_id] - local entry - if category ~= nil then - entry = category.entries[entry_id] - end - if category == nil or entry == nil then - local c_alias = doc.data.aliases[category_id] - if c_alias then - local alias = c_alias[entry_id] - if alias then - category_id = alias.category_id - entry_id = alias.entry_id - category = doc.data.categories[category_id] - if category then - entry = category.entries[entry_id] - else - return nil - end - else - return nil - end - else - return nil - end - end - return entry, category_id, entry_id -end - ---[[ Core API functions ]] - --- Add a new category -function doc.add_category(id, def) - if doc.data.categories[id] == nil and id ~= nil then - doc.data.categories[id] = {} - doc.data.categories[id].entries = {} - doc.data.categories[id].entry_count = 0 - doc.data.categories[id].hidden_count = 0 - doc.data.categories[id].def = def - -- Determine order position - local order_id = nil - for i=1,#doc.data.category_order do - if doc.data.category_order[i] == id then - order_id = i - break - end - end - if order_id == nil then - table.insert(doc.data.category_order, id) - doc.data.categories[id].order_position = #doc.data.category_order - else - doc.data.categories[id].order_position = order_id - end - doc.data.category_count = doc.data.category_count + 1 - return true - else - return false - end -end - --- Add a new entry -function doc.add_entry(category_id, entry_id, def) - local cat = doc.data.categories[category_id] - if cat ~= nil then - local hidden = def.hidden or (def.hidden == nil and cat.def.hide_entries_by_default) - if hidden then - cat.hidden_count = cat.hidden_count + 1 - def.hidden = hidden - end - cat.entry_count = doc.data.categories[category_id].entry_count + 1 - if def.name == nil or def.name == "" then - minetest.log("warning", "[doc] Nameless entry added. Entry ID: "..entry_id) - end - cat.entries[entry_id] = def - return true - else - return false - end -end - --- Marks a particular entry as viewed by a certain player, which also --- automatically reveals it -function doc.mark_entry_as_viewed(playername, category_id, entry_id) - local entry, category_id, entry_id = get_entry(category_id, entry_id) - if not entry then - return - end - if doc.data.players[playername].stored_data.viewed[category_id] == nil then - doc.data.players[playername].stored_data.viewed[category_id] = {} - doc.data.players[playername].stored_data.viewed_count[category_id] = 0 - end - if doc.entry_exists(category_id, entry_id) and doc.data.players[playername].stored_data.viewed[category_id][entry_id] ~= true then - doc.data.players[playername].stored_data.viewed[category_id][entry_id] = true - doc.data.players[playername].stored_data.viewed_count[category_id] = doc.data.players[playername].stored_data.viewed_count[category_id] + 1 - -- Needed because viewed entries get a different color - doc.data.players[playername].entry_textlist_needs_updating = true - end - doc.mark_entry_as_revealed(playername, category_id, entry_id) -end - --- Marks a particular entry as revealed/unhidden by a certain player -function doc.mark_entry_as_revealed(playername, category_id, entry_id) - local entry, category_id, entry_id = get_entry(category_id, entry_id) - if not entry then - return - end - if doc.data.players[playername].stored_data.revealed[category_id] == nil then - doc.data.players[playername].stored_data.revealed[category_id] = {} - doc.data.players[playername].stored_data.revealed_count[category_id] = doc.get_entry_count(category_id) - doc.data.categories[category_id].hidden_count - end - if doc.entry_exists(category_id, entry_id) and entry.hidden and doc.data.players[playername].stored_data.revealed[category_id][entry_id] ~= true then - doc.data.players[playername].stored_data.revealed[category_id][entry_id] = true - doc.data.players[playername].stored_data.revealed_count[category_id] = doc.data.players[playername].stored_data.revealed_count[category_id] + 1 - -- Needed because a new entry is added to the list of visible entries - doc.data.players[playername].entry_textlist_needs_updating = true - -- Notify player of entry revelation - if doc.data.players[playername].stored_data.notify_on_reveal == true then - if minetest.get_modpath("central_message") ~= nil then - local cat = doc.data.categories[category_id] - cmsg.push_message_player(minetest.get_player_by_name(playername), S("New help entry unlocked: @1 > @2", cat.def.name, entry.name)) - end - -- To avoid sound spamming, don't play sound more than once per second - local last_sound = doc.data.players[playername].last_reveal_sound - if last_sound == nil or os.difftime(os.time(), last_sound) >= 1 then - -- Play notification sound - minetest.sound_play({ name = "doc_reveal", gain = 0.2 }, { to_player = playername }) - doc.data.players[playername].last_reveal_sound = os.time() - end - end - end -end - --- Reveal -function doc.mark_all_entries_as_revealed(playername) - -- Has at least 1 new entry been revealed? - local reveal1 = false - for category_id, category in pairs(doc.data.categories) do - if doc.data.players[playername].stored_data.revealed[category_id] == nil then - doc.data.players[playername].stored_data.revealed[category_id] = {} - doc.data.players[playername].stored_data.revealed_count[category_id] = doc.get_entry_count(category_id) - doc.data.categories[category_id].hidden_count - end - for entry_id, _ in pairs(category.entries) do - if doc.data.players[playername].stored_data.revealed[category_id][entry_id] ~= true then - doc.data.players[playername].stored_data.revealed[category_id][entry_id] = true - doc.data.players[playername].stored_data.revealed_count[category_id] = doc.data.players[playername].stored_data.revealed_count[category_id] + 1 - reveal1 = true - end - end - end - - local msg - if reveal1 then - -- Needed because new entries are added to player's view on entry list - doc.data.players[playername].entry_textlist_needs_updating = true - - msg = S("All help entries revealed!") - - -- Play notification sound (ignore sound limit intentionally) - minetest.sound_play({ name = "doc_reveal", gain = 0.2 }, { to_player = playername }) - doc.data.players[playername].last_reveal_sound = os.time() - else - msg = S("All help entries are already revealed.") - end - -- Notify - if minetest.get_modpath("central_message") ~= nil then - cmsg.push_message_player(minetest.get_player_by_name(playername), msg) - else - minetest.chat_send_player(playername, msg) - end -end - --- Returns true if the specified entry has been viewed by the player -function doc.entry_viewed(playername, category_id, entry_id) - local entry, category_id, entry_id = get_entry(category_id, entry_id) - if doc.data.players[playername].stored_data.viewed[category_id] == nil then - return false - else - return doc.data.players[playername].stored_data.viewed[category_id][entry_id] == true - end -end - --- Returns true if the specified entry is hidden from the player -function doc.entry_revealed(playername, category_id, entry_id) - local entry, category_id, entry_id = get_entry(category_id, entry_id) - local hidden = doc.data.categories[category_id].entries[entry_id].hidden - if doc.data.players[playername].stored_data.revealed[category_id] == nil then - return not hidden - else - if hidden then - return doc.data.players[playername].stored_data.revealed[category_id][entry_id] == true - else - return true - end - end -end - --- Returns category definition -function doc.get_category_definition(category_id) - if doc.data.categories[category_id] == nil then - return nil - end - return doc.data.categories[category_id].def -end - --- Returns entry definition -function doc.get_entry_definition(category_id, entry_id) - if not doc.entry_exists(category_id, entry_id) then - return nil - end - local entry, _, _ = get_entry(category_id, entry_id) - return entry -end - --- Opens the main documentation formspec for the player -function doc.show_doc(playername) - if doc.get_category_count() <= 0 then - minetest.show_formspec(playername, "doc:error_no_categories", doc.formspec_error_no_categories()) - return - end - local formspec = doc.formspec_core()..doc.formspec_main(playername) - minetest.show_formspec(playername, "doc:main", formspec) -end - --- Opens the documentation formspec for the player at the specified category -function doc.show_category(playername, category_id) - if doc.get_category_count() <= 0 then - minetest.show_formspec(playername, "doc:error_no_categories", doc.formspec_error_no_categories()) - return - end - doc.data.players[playername].catsel = nil - doc.data.players[playername].category = category_id - doc.data.players[playername].entry = nil - local formspec = doc.formspec_core(2)..doc.formspec_category(category_id, playername) - minetest.show_formspec(playername, "doc:category", formspec) -end - --- Opens the documentation formspec for the player showing the specified entry in a category -function doc.show_entry(playername, category_id, entry_id, ignore_hidden) - if doc.get_category_count() <= 0 then - minetest.show_formspec(playername, "doc:error_no_categories", doc.formspec_error_no_categories()) - return - end - local entry, category_id, entry_id = get_entry(category_id, entry_id) - if ignore_hidden or doc.entry_revealed(playername, category_id, entry_id) then - local playerdata = doc.data.players[playername] - playerdata.category = category_id - playerdata.entry = entry_id - - doc.mark_entry_as_viewed(playername, category_id, entry_id) - playerdata.entry_textlist_needs_updating = true - doc.generate_entry_list(category_id, playername) - - playerdata.catsel = playerdata.catsel_list[entry_id] - playerdata.galidx = 1 - - local formspec = doc.formspec_core(3)..doc.formspec_entry(category_id, entry_id, playername) - minetest.show_formspec(playername, "doc:entry", formspec) - else - minetest.show_formspec(playername, "doc:error_hidden", doc.formspec_error_hidden(category_id, entry_id)) - end -end - --- Returns true if and only if: --- * The specified category exists --- * This category contains the specified entry --- Aliases are taken into account -function doc.entry_exists(category_id, entry_id) - return get_entry(category_id, entry_id) ~= nil -end - --- Sets the order of categories in the category list -function doc.set_category_order(categories) - local reverse_categories = {} - for cid=1,#categories do - reverse_categories[categories[cid]] = cid - end - doc.data.category_order = categories - for cid, cat in pairs(doc.data.categories) do - if reverse_categories[cid] == nil then - table.insert(doc.data.category_order, cid) - end - end - reverse_categories = {} - for cid=1, #doc.data.category_order do - reverse_categories[categories[cid]] = cid - end - - for cid, cat in pairs(doc.data.categories) do - cat.order_position = reverse_categories[cid] - end - if set_category_order_was_called then - minetest.log("warning", "[doc] doc.set_category_order was called again!") - end - set_category_order_was_called = true -end - --- Adds an alias for an entry. Attempting to open an entry by an alias name --- results in opening the entry of the original name. -function doc.add_entry_alias(category_id_orig, entry_id_orig, category_id_alias, entry_id_alias) - if not doc.data.aliases[category_id_alias] then - doc.data.aliases[category_id_alias] = {} - end - doc.data.aliases[category_id_alias][entry_id_alias] = { category_id = category_id_orig, entry_id = entry_id_orig } -end - --- Returns number of categories -function doc.get_category_count() - return doc.data.category_count -end - --- Returns number of entries in category -function doc.get_entry_count(category_id) - return doc.data.categories[category_id].entry_count -end - --- Returns how many entries have been viewed by the player -function doc.get_viewed_count(playername, category_id) - local playerdata = doc.data.players[playername] - if playerdata == nil then - return nil - end - local count = playerdata.stored_data.viewed_count[category_id] - if count == nil then - playerdata.stored_data.viewed[category_id] = {} - count = 0 - playerdata.stored_data.viewed_count[category_id] = count - return count - else - return count - end -end - --- Returns how many entries have been revealed by the player -function doc.get_revealed_count(playername, category_id) - local playerdata = doc.data.players[playername] - if playerdata == nil then - return nil - end - local count = playerdata.stored_data.revealed_count[category_id] - if count == nil then - playerdata.stored_data.revealed[category_id] = {} - count = doc.get_entry_count(category_id) - doc.data.categories[category_id].hidden_count - playerdata.stored_data.revealed_count[category_id] = count - return count - else - return count - end -end - --- Returns how many entries are hidden from the player -function doc.get_hidden_count(playername, category_id) - local playerdata = doc.data.players[playername] - if playerdata == nil then - return nil - end - local total = doc.get_entry_count(category_id) - local rcount = playerdata.stored_data.revealed_count[category_id] - if rcount == nil then - return total - else - return total - rcount - end -end - --- Returns the currently viewed entry and/or category of the player -function doc.get_selection(playername) - local playerdata = doc.data.players[playername] - if playerdata ~= nil then - local cat = playerdata.category - if cat then - local entry = playerdata.entry - if entry then - return cat, entry - else - return cat - end - else - return nil - end - else - return nil - end -end - --- Template function templates, to be used for build_formspec in doc.add_category -doc.entry_builders = {} - --- Scrollable freeform text -doc.entry_builders.text = function(data) - local formstring = doc.widgets.text(data, doc.FORMSPEC.ENTRY_START_X, doc.FORMSPEC.ENTRY_START_Y, doc.FORMSPEC.ENTRY_WIDTH - 0.4, doc.FORMSPEC.ENTRY_HEIGHT) - return formstring -end - --- Scrollable freeform text with an optional standard gallery (3 rows, 3:2 aspect ratio) -doc.entry_builders.text_and_gallery = function(data, playername) - -- How much height the image gallery “steals” from the text widget - local stolen_height = 0 - local formstring = "" - -- Only add the gallery if images are in the data, otherwise, the text widget gets all of the space - if data.images ~= nil then - local gallery - gallery, stolen_height = doc.widgets.gallery(data.images, playername, nil, doc.FORMSPEC.ENTRY_END_Y + 0.2, nil, nil, nil, nil, false) - formstring = formstring .. gallery - end - formstring = formstring .. doc.widgets.text(data.text, - doc.FORMSPEC.ENTRY_START_X, - doc.FORMSPEC.ENTRY_START_Y, - doc.FORMSPEC.ENTRY_WIDTH - 0.4, - doc.FORMSPEC.ENTRY_HEIGHT - stolen_height) - - return formstring -end - -doc.widgets = {} - --- Scrollable freeform text -doc.widgets.text = function(data, x, y, width, height) - if x == nil then - x = doc.FORMSPEC.ENTRY_START_X - end - -- Offset to table[], which was used for this in a previous version - local xfix = x + 0.35 - if y == nil then - y = doc.FORMSPEC.ENTRY_START_Y - end - if width == nil then - width = doc.FORMSPEC.ENTRY_WIDTH - end - if height == nil then - height = doc.FORMSPEC.ENTRY_HEIGHT - end - -- Weird offset for textarea[] - local heightfix = height + 1 - - -- Also add background box - local formstring = "box["..tostring(x-0.175)..","..tostring(y)..";"..tostring(width)..","..tostring(height)..";#000000]" .. - "textarea["..tostring(xfix)..","..tostring(y)..";"..tostring(width)..","..tostring(heightfix)..";;;"..minetest.formspec_escape(data).."]" - return formstring -end - --- Image gallery --- Currently, only one gallery per entry is supported. TODO: Add support for multiple galleries in an entry (low priority) -doc.widgets.gallery = function(imagedata, playername, x, y, aspect_ratio, width, rows, align_left, align_top) - if playername == nil then return nil end -- emergency exit - - local formstring = "" - - -- Defaults - if x == nil then - if align_left == false then - x = doc.FORMSPEC.ENTRY_END_X - else - x = doc.FORMSPEC.ENTRY_START_X - end - end - if y == nil then - if align_top == false then - y = doc.FORMSPEC.ENTRY_END_Y - else - y = doc.FORMSPEC.ENTRY_START_Y - end - end - if width == nil then width = doc.FORMSPEC.ENTRY_WIDTH end - if rows == nil then rows = 3 end - - if align_left == false then - x = x - width - end - - local imageindex = doc.data.players[playername].galidx - doc.data.players[playername].maxgalidx = #imagedata - doc.data.players[playername].galrows = rows - - if aspect_ratio == nil then aspect_ratio = (2/3) end - local pos = 0 - local totalimagewidth, iw, ih - local bw = 0.5 - local buttonoffset = 0 - if #imagedata > rows then - totalimagewidth = width - bw*2 - iw = totalimagewidth / rows - ih = iw * aspect_ratio - if align_top == false then - y = y - ih - end - - local tt - if imageindex > 1 then - formstring = formstring .. "button["..x..","..y..";"..bw..","..ih..";doc_button_gallery_prev;"..F("<").."]" - if rows == 1 then - tt = F("Show previous image") - else - tt = F("Show previous gallery page") - end - formstring = formstring .. "tooltip[doc_button_gallery_prev;"..tt.."]" - end - if (imageindex + rows) <= #imagedata then - local rightx = buttonoffset + (x + rows * iw) - formstring = formstring .. "button["..rightx..","..y..";"..bw..","..ih..";doc_button_gallery_next;"..F(">").."]" - if rows == 1 then - tt = F("Show next image") - else - tt = F("Show next gallery page") - end - formstring = formstring .. "tooltip[doc_button_gallery_next;"..tt.."]" - end - buttonoffset = bw - else - totalimagewidth = width - iw = totalimagewidth / rows - ih = iw * aspect_ratio - if align_top == false then - y = y - ih - end - end - for i=imageindex, math.min(#imagedata, (imageindex-1)+rows) do - local xoffset = buttonoffset + (x + pos * iw) - local nx = xoffset - 0.2 - local ny = y - 0.05 - if imagedata[i].imagetype == "item" then - formstring = formstring .. "item_image["..xoffset..","..y..";"..iw..","..ih..";"..imagedata[i].image.."]" - else - formstring = formstring .. "image["..xoffset..","..y..";"..iw..","..ih..";"..imagedata[i].image.."]" - end - formstring = formstring .. "label["..nx..","..ny..";"..i.."]" - pos = pos + 1 - end - local bw, bh - - return formstring, ih -end - --- Direct formspec -doc.entry_builders.formspec = function(data) - return data -end - ---[[ Internal stuff ]] - --- Loading and saving player data -do - local filepath = minetest.get_worldpath().."/doc.mt" - local file = io.open(filepath, "r") - if file then - minetest.log("action", "[doc] doc.mt opened.") - local string = file:read() - io.close(file) - if(string ~= nil) then - local savetable = minetest.deserialize(string) - for name, players_stored_data in pairs(savetable.players_stored_data) do - doc.data.players[name] = {} - doc.data.players[name].stored_data = players_stored_data - end - minetest.log("action", "[doc] doc.mt successfully read.") - end - end -end - -function doc.save_to_file() - local savetable = {} - savetable.players_stored_data = {} - for name, playerdata in pairs(doc.data.players) do - savetable.players_stored_data[name] = playerdata.stored_data - end - - local savestring = minetest.serialize(savetable) - - local filepath = minetest.get_worldpath().."/doc.mt" - local file = io.open(filepath, "w") - if file then - file:write(savestring) - io.close(file) - minetest.log("action", "[doc] Wrote player data into "..filepath..".") - else - minetest.log("error", "[doc] Failed to write player data into "..filepath..".") - end -end - -minetest.register_on_leaveplayer(function(player) - doc.save_to_file() -end) - -minetest.register_on_shutdown(function() - minetest.log("action", "[doc] Server shuts down. Player data is about to be saved.") - doc.save_to_file() -end) - ---[[ Functions for internal use ]] - -function doc.formspec_core(tab) - if tab == nil then tab = 1 else tab = tostring(tab) end - return "size["..doc.FORMSPEC.WIDTH..","..doc.FORMSPEC.HEIGHT.."]tabheader[0,0;doc_header;".. - minetest.formspec_escape(S("Category list")) .. "," .. - minetest.formspec_escape(S("Entry list")) .. "," .. - minetest.formspec_escape(S("Entry")) .. ";" - ..tab..";false;false]" - -- Let the Game decide on the style, such as background, etc. -end - -function doc.formspec_main(playername) - local formstring = "textarea[0.35,0;"..doc.FORMSPEC.WIDTH..",1;;;"..minetest.formspec_escape(DOC_INTRO) .. "\n" - local notify_checkbox_x, notify_checkbox_y - if doc.get_category_count() >= 1 then - formstring = formstring .. F("Please select a category you wish to learn more about:").."]" - if doc.get_category_count() <= (CATEGORYFIELDSIZE.WIDTH * CATEGORYFIELDSIZE.HEIGHT) then - local y = 1 - local x = 1 - -- Show all categories in order - for c=1,#doc.data.category_order do - local id = doc.data.category_order[c] - local data = doc.data.categories[id] - local bw = doc.FORMSPEC.WIDTH / math.floor(((doc.data.category_count-1) / CATEGORYFIELDSIZE.HEIGHT)+1) - -- Skip categories which do not exist - if data ~= nil then - -- Category buton - local button = "button["..((x-1)*bw)..","..y..";"..bw..",1;doc_button_category_"..id..";"..minetest.formspec_escape(data.def.name).."]" - local tooltip = "" - -- Optional description - if data.def.description ~= nil then - tooltip = "tooltip[doc_button_category_"..id..";"..minetest.formspec_escape(data.def.description).."]" - end - formstring = formstring .. button .. tooltip - y = y + 1 - if y > CATEGORYFIELDSIZE.HEIGHT then - x = x + 1 - y = 1 - end - end - end - notify_checkbox_x = 0 - notify_checkbox_y = doc.FORMSPEC.HEIGHT-0.5 - else - formstring = formstring .. "textlist[0,1;"..(doc.FORMSPEC.WIDTH-0.2)..","..(doc.FORMSPEC.HEIGHT-2)..";doc_mainlist;" - for c=1,#doc.data.category_order do - local id = doc.data.category_order[c] - local data = doc.data.categories[id] - formstring = formstring .. minetest.formspec_escape(data.def.name) - if c < #doc.data.category_order then - formstring = formstring .. "," - end - end - local sel = doc.data.categories[doc.data.players[playername].category] - if sel ~= nil then - formstring = formstring .. ";" - formstring = formstring .. doc.data.categories[doc.data.players[playername].category].order_position - end - formstring = formstring .. "]" - formstring = formstring .. "button[0,"..(doc.FORMSPEC.HEIGHT-1)..";3,1;doc_button_goto_category;"..F("Show category").."]" - notify_checkbox_x = 3.5 - notify_checkbox_y = doc.FORMSPEC.HEIGHT-1 - end - local text - if minetest.get_modpath("central_message") then - text = F("Notify me when new help is available") - else - text = F("Play notification sound when new help is available") - end - formstring = formstring .. "checkbox["..notify_checkbox_x..","..notify_checkbox_y..";doc_setting_notify_on_reveal;"..text..";".. - tostring(doc.data.players[playername].stored_data.notify_on_reveal == true) .. "]" - else - formstring = formstring .. "]" - end - return formstring -end - -function doc.formspec_error_no_categories() - local formstring = "size[8,6]textarea[0.25,0;8,6;;" - formstring = formstring .. - minetest.formspec_escape( - colorize(COLOR_ERROR, S("Error: No help available.")) .. "\n\n" .. -S("No categories have been registered, but they are required to provide help.").."\n".. -S("The Documentation System [doc] does not come with help contents on its own, it needs additional mods to add help content. Please make sure such mods are enabled on for this world, and try again.")) .. "\n\n" .. -S("Recommended mods: doc_basics, doc_items, doc_identifier, doc_encyclopedia.") - formstring = formstring .. ";]button_exit[3,5;2,1;okay;"..F("OK").."]" - return formstring -end - -function doc.formspec_error_hidden(category_id, entry_id) - local formstring = "size[8,6]textarea[0.25,0;8,6;;" - formstring = formstring .. minetest.formspec_escape( - colorize(COLOR_ERROR, S("Error: Access denied.")) .. "\n\n" .. - S("Access to the requested entry has been denied; this entry is secret. You may unlock access by progressing in the game. Figure out on your own how to unlock this entry.")) - formstring = formstring .. ";]button_exit[3,5;2,1;okay;"..F("OK").."]" - return formstring -end - -function doc.generate_entry_list(cid, playername) - local formstring - if doc.data.players[playername].entry_textlist == nil - or doc.data.players[playername].catsel_list == nil - or doc.data.players[playername].category ~= cid - or doc.data.players[playername].entry_textlist_needs_updating == true then - local entry_textlist = "textlist[0,1;"..(doc.FORMSPEC.WIDTH-0.2)..","..(doc.FORMSPEC.HEIGHT-2)..";doc_catlist;" - local counter = 0 - doc.data.players[playername].entry_ids = {} - local entries = doc.get_sorted_entry_names(cid) - doc.data.players[playername].catsel_list = {} - for i=1, #entries do - local eid = entries[i] - local edata = doc.data.categories[cid].entries[eid] - if doc.entry_revealed(playername, cid, eid) then - table.insert(doc.data.players[playername].entry_ids, eid) - doc.data.players[playername].catsel_list[eid] = counter + 1 - -- Colorize entries based on viewed status - local viewedprefix = COLOR_NOT_VIEWED - local name = edata.name - if name == nil or name == "" then - name = S("Nameless entry (@1)", eid) - if doc.entry_viewed(playername, cid, eid) then - viewedprefix = "#FF4444" - else - viewedprefix = COLOR_ERROR - end - elseif doc.entry_viewed(playername, cid, eid) then - viewedprefix = COLOR_VIEWED - end - entry_textlist = entry_textlist .. viewedprefix .. minetest.formspec_escape(name) .. "," - counter = counter + 1 - end - end - if counter >= 1 then - entry_textlist = string.sub(entry_textlist, 1, #entry_textlist-1) - end - local catsel = doc.data.players[playername].catsel - if catsel then - entry_textlist = entry_textlist .. ";"..catsel - end - entry_textlist = entry_textlist .. "]" - doc.data.players[playername].entry_textlist = entry_textlist - formstring = entry_textlist - doc.data.players[playername].entry_textlist_needs_updating = false - else - formstring = doc.data.players[playername].entry_textlist - end - return formstring -end - -function doc.get_sorted_entry_names(cid) - local sort_table = {} - local entry_table = {} - local cat = doc.data.categories[cid] - local used_eids = {} - -- Helper function to extract the entry ID out of the output table - local extract = function(entry_table) - local eids = {} - for k,v in pairs(entry_table) do - local eid = v.eid - table.insert(eids, eid) - end - return eids - end - -- Predefined sorting - if cat.def.sorting == "custom" then - for i=1,#cat.def.sorting_data do - local new_entry = table.copy(cat.entries[cat.def.sorting_data[i]]) - new_entry.eid = cat.def.sorting_data[i] - table.insert(entry_table, new_entry) - used_eids[cat.def.sorting_data[i]] = true - end - end - for eid,entry in pairs(cat.entries) do - local new_entry = table.copy(entry) - new_entry.eid = eid - if not used_eids[eid] then - table.insert(entry_table, new_entry) - end - table.insert(sort_table, entry.name) - end - if cat.def.sorting == "custom" then - return extract(entry_table) - else - table.sort(sort_table) - end - local reverse_sort_table = table.copy(sort_table) - for i=1, #sort_table do - reverse_sort_table[sort_table[i]] = i - end - local comp - if cat.def.sorting ~= "nosort" then - -- Sorting by user function - if cat.def.sorting == "function" then - comp = cat.def.sorting_data - -- Alphabetic sorting - elseif cat.def.sorting == "abc" or cat.def.sorting == nil then - comp = function(e1, e2) - if reverse_sort_table[e1.name] < reverse_sort_table[e2.name] then return true else return false end - end - end - table.sort(entry_table, comp) - end - - return extract(entry_table) -end - -function doc.formspec_category(id, playername) - local formstring - if id == nil then - formstring = "label[0,0;"..F("Help > (No Category)") .. "]" - formstring = formstring .. "label[0,0.5;"..F("You haven't chosen a category yet. Please choose one in the category list first.").."]" - formstring = formstring .. "button[0,1;3,1;doc_button_goto_main;"..F("Go to category list").."]" - else - formstring = "label[0,0;"..minetest.formspec_escape(S("Help > @1", doc.data.categories[id].def.name)).."]" - local total = doc.get_entry_count(id) - if total >= 1 then - local revealed = doc.get_revealed_count(playername, id) - if revealed == 0 then - formstring = formstring .. "label[0,0.5;"..minetest.formspec_escape(S("Currently all entries in this category are hidden from you.").."\n"..S("Unlock new entries by progressing in the game.")).."]" - formstring = formstring .. "button[0,1.5;3,1;doc_button_goto_main;"..F("Go to category list").."]" - else - formstring = formstring .. "label[0,0.5;"..F("This category has the following entries:").."]" - formstring = formstring .. doc.generate_entry_list(id, playername) - formstring = formstring .. "button[0,"..(doc.FORMSPEC.HEIGHT-1)..";3,1;doc_button_goto_entry;"..F("Show entry").."]" - formstring = formstring .. "label["..(doc.FORMSPEC.WIDTH-4)..","..(doc.FORMSPEC.HEIGHT-1)..";"..minetest.formspec_escape(S("Number of entries: @1", total)).."\n" - local viewed = doc.get_viewed_count(playername, id) - local hidden = total - revealed - local new = total - viewed - hidden - -- TODO/FIXME: Check if number of hidden/viewed entries is always correct - if viewed < total then - formstring = formstring .. colorize(COLOR_NOT_VIEWED, minetest.formspec_escape(S("New entries: @1", new))) - if hidden > 0 then - formstring = formstring .. "\n" - formstring = formstring .. colorize(COLOR_HIDDEN, minetest.formspec_escape(S("Hidden entries: @1", hidden))).."]" - else - formstring = formstring .. "]" - end - else - formstring = formstring .. F("All entries read.").."]" - end - end - else - formstring = formstring .. "label[0,0.5;"..F("This category is empty.").."]" - formstring = formstring .. "button[0,1.5;3,1;doc_button_goto_main;"..F("Go to category list").."]" - end - end - return formstring -end - -function doc.formspec_entry_navigation(category_id, entry_id) - if doc.get_entry_count(category_id) < 1 then - return "" - end - local formstring = "" - formstring = formstring .. "button["..(doc.FORMSPEC.WIDTH-2)..","..(doc.FORMSPEC.HEIGHT-0.5)..";1,1;doc_button_goto_prev;"..F("<").."]" - formstring = formstring .. "button["..(doc.FORMSPEC.WIDTH-1)..","..(doc.FORMSPEC.HEIGHT-0.5)..";1,1;doc_button_goto_next;"..F(">").."]" - formstring = formstring .. "tooltip[doc_button_goto_prev;"..F("Show previous entry").."]" - formstring = formstring .. "tooltip[doc_button_goto_next;"..F("Show next entry").."]" - return formstring -end - -function doc.formspec_entry(category_id, entry_id, playername) - local formstring - if category_id == nil then - formstring = "label[0,0;"..F("Help > (No Category)") .. "]" - formstring = formstring .. "label[0,0.5;"..F("You haven't chosen a category yet. Please choose one in the category list first.").."]" - formstring = formstring .. "button[0,1;3,1;doc_button_goto_main;"..F("Go to category list").."]" - elseif entry_id == nil then - formstring = "label[0,0;"..minetest.formspec_escape(S("Help > @1 > (No Entry)", doc.data.categories[category_id].def.name)) .. "]" - if doc.get_entry_count(category_id) >= 1 then - formstring = formstring .. "label[0,0.5;"..F("You haven't chosen an entry yet. Please choose one in the entry list first.").."]" - formstring = formstring .. "button[0,1.5;3,1;doc_button_goto_category;"..F("Go to entry list").."]" - else - formstring = formstring .. "label[0,0.5;"..F("This category does not have any entries.").."]" - formstring = formstring .. "button[0,1.5;3,1;doc_button_goto_main;"..F("Go to category list").."]" - end - else - - local category = doc.data.categories[category_id] - local entry = get_entry(category_id, entry_id) - local ename = entry.name - if ename == nil or ename == "" then - ename = S("Nameless entry (@1)", entry_id) - end - formstring = "label[0,0;"..minetest.formspec_escape(S("Help > @1 > @2", category.def.name, ename)).."]" - formstring = formstring .. category.def.build_formspec(entry.data, playername) - formstring = formstring .. doc.formspec_entry_navigation(category_id, entry_id) - end - return formstring -end - -function doc.process_form(player,formname,fields) - local playername = player:get_player_name() - --[[ process clicks on the tab header ]] - if(formname == "doc:main" or formname == "doc:category" or formname == "doc:entry") then - if fields.doc_header ~= nil then - local tab = tonumber(fields.doc_header) - local formspec, subformname, contents - local cid, eid - cid = doc.data.players[playername].category - eid = doc.data.players[playername].entry - if(tab==1) then - contents = doc.formspec_main(playername) - subformname = "main" - elseif(tab==2) then - contents = doc.formspec_category(cid, playername) - subformname = "category" - elseif(tab==3) then - doc.data.players[playername].galidx = 1 - contents = doc.formspec_entry(cid, eid, playername) - if cid ~= nil and eid ~= nil then - doc.mark_entry_as_viewed(playername, cid, eid) - end - subformname = "entry" - end - formspec = doc.formspec_core(tab)..contents - minetest.show_formspec(playername, "doc:" .. subformname, formspec) - return - end - end - if(formname == "doc:main") then - for cid,_ in pairs(doc.data.categories) do - if fields["doc_button_category_"..cid] then - doc.data.players[playername].catsel = nil - doc.data.players[playername].category = cid - doc.data.players[playername].entry = nil - doc.data.players[playername].entry_textlist_needs_updating = true - local formspec = doc.formspec_core(2)..doc.formspec_category(cid, playername) - minetest.show_formspec(playername, "doc:category", formspec) - break - end - end - if fields["doc_mainlist"] then - local event = minetest.explode_textlist_event(fields["doc_mainlist"]) - local cid = doc.data.category_order[event.index] - if cid ~= nil then - if event.type == "CHG" then - doc.data.players[playername].catsel = nil - doc.data.players[playername].category = cid - doc.data.players[playername].entry = nil - doc.data.players[playername].entry_textlist_needs_updating = true - elseif event.type == "DCL" then - doc.data.players[playername].catsel = nil - doc.data.players[playername].category = cid - doc.data.players[playername].entry = nil - doc.data.players[playername].entry_textlist_needs_updating = true - local formspec = doc.formspec_core(2)..doc.formspec_category(cid, playername) - minetest.show_formspec(playername, "doc:category", formspec) - end - end - end - if fields["doc_button_goto_category"] then - local cid = doc.data.players[playername].category - doc.data.players[playername].catsel = nil - doc.data.players[playername].entry = nil - doc.data.players[playername].entry_textlist_needs_updating = true - local formspec = doc.formspec_core(2)..doc.formspec_category(cid, playername) - minetest.show_formspec(playername, "doc:category", formspec) - end - if fields["doc_setting_notify_on_reveal"] then - doc.data.players[playername].stored_data.notify_on_reveal = fields["doc_setting_notify_on_reveal"] == "true" - end - elseif(formname == "doc:category") then - if fields["doc_button_goto_entry"] then - local cid = doc.data.players[playername].category - if cid ~= nil then - local eid = nil - local eids, catsel = doc.data.players[playername].entry_ids, doc.data.players[playername].catsel - if eids ~= nil and catsel ~= nil then - eid = eids[catsel] - end - doc.data.players[playername].galidx = 1 - local formspec = doc.formspec_core(3)..doc.formspec_entry(cid, eid, playername) - minetest.show_formspec(playername, "doc:entry", formspec) - doc.mark_entry_as_viewed(playername, cid, eid) - end - end - if fields["doc_button_goto_main"] then - local formspec = doc.formspec_core(1)..doc.formspec_main(playername) - minetest.show_formspec(playername, "doc:main", formspec) - end - if fields["doc_catlist"] then - local event = minetest.explode_textlist_event(fields["doc_catlist"]) - if event.type == "CHG" then - doc.data.players[playername].catsel = event.index - doc.data.players[playername].entry = doc.data.players[playername].entry_ids[event.index] - doc.data.players[playername].entry_textlist_needs_updating = true - elseif event.type == "DCL" then - local cid = doc.data.players[playername].category - local eid = nil - local eids, catsel = doc.data.players[playername].entry_ids, event.index - if eids ~= nil and catsel ~= nil then - eid = eids[catsel] - end - doc.mark_entry_as_viewed(playername, cid, eid) - doc.data.players[playername].entry_textlist_needs_updating = true - doc.data.players[playername].galidx = 1 - local formspec = doc.formspec_core(3)..doc.formspec_entry(cid, eid, playername) - minetest.show_formspec(playername, "doc:entry", formspec) - end - end - elseif(formname == "doc:entry") then - if fields["doc_button_goto_main"] then - local formspec = doc.formspec_core(1)..doc.formspec_main(playername) - minetest.show_formspec(playername, "doc:main", formspec) - elseif fields["doc_button_goto_category"] then - local formspec = doc.formspec_core(2)..doc.formspec_category(doc.data.players[playername].category, playername) - minetest.show_formspec(playername, "doc:category", formspec) - elseif fields["doc_button_goto_next"] then - if doc.data.players[playername].catsel == nil then return end -- emergency exit - local eids = doc.data.players[playername].entry_ids - local cid = doc.data.players[playername].category - local new_catsel= doc.data.players[playername].catsel + 1 - local new_eid = eids[new_catsel] - if #eids > 1 and new_catsel <= #eids then - doc.mark_entry_as_viewed(playername, cid, new_eid) - doc.data.players[playername].catsel = new_catsel - doc.data.players[playername].entry = new_eid - doc.data.players[playername].galidx = 1 - local formspec = doc.formspec_core(3)..doc.formspec_entry(cid, new_eid, playername) - minetest.show_formspec(playername, "doc:entry", formspec) - end - elseif fields["doc_button_goto_prev"] then - if doc.data.players[playername].catsel == nil then return end -- emergency exit - local eids = doc.data.players[playername].entry_ids - local cid = doc.data.players[playername].category - local new_catsel= doc.data.players[playername].catsel - 1 - local new_eid = eids[new_catsel] - if #eids > 1 and new_catsel >= 1 then - doc.mark_entry_as_viewed(playername, cid, new_eid) - doc.data.players[playername].catsel = new_catsel - doc.data.players[playername].entry = new_eid - doc.data.players[playername].galidx = 1 - local formspec = doc.formspec_core(3)..doc.formspec_entry(cid, new_eid, playername) - minetest.show_formspec(playername, "doc:entry", formspec) - end - elseif fields["doc_button_gallery_prev"] then - local cid, eid = doc.get_selection(playername) - if doc.data.players[playername].galidx - doc.data.players[playername].galrows > 0 then - doc.data.players[playername].galidx = doc.data.players[playername].galidx - doc.data.players[playername].galrows - end - local formspec = doc.formspec_core(3)..doc.formspec_entry(cid, eid, playername) - minetest.show_formspec(playername, "doc:entry", formspec) - elseif fields["doc_button_gallery_next"] then - local cid, eid = doc.get_selection(playername) - if doc.data.players[playername].galidx + doc.data.players[playername].galrows <= doc.data.players[playername].maxgalidx then - doc.data.players[playername].galidx = doc.data.players[playername].galidx + doc.data.players[playername].galrows - end - local formspec = doc.formspec_core(3)..doc.formspec_entry(cid, eid, playername) - minetest.show_formspec(playername, "doc:entry", formspec) - end - else - if fields["doc_inventory_plus"] and minetest.get_modpath("inventory_plus") then - doc.show_doc(playername) - return - end - end -end - -minetest.register_on_player_receive_fields(doc.process_form) - -minetest.register_chatcommand("helpform", { - params = "", - description = S("Open a window providing help entries about Minetest and more"), - privs = {}, - func = function(playername, param) - doc.show_doc(playername) - end, - } -) - -minetest.register_on_joinplayer(function(player) - local playername = player:get_player_name() - local playerdata = doc.data.players[playername] - if playerdata == nil then - -- Initialize player data - doc.data.players[playername] = {} - playerdata = doc.data.players[playername] - -- Gallery index, stores current index of first displayed image in a gallery - playerdata.galidx = 1 - -- Maximum gallery index (index of last image in gallery) - playerdata.maxgalidx = 1 - -- Number of rows in an gallery of the current entry - playerdata.galrows = 1 - -- Table for persistant data - playerdata.stored_data = {} - -- Contains viewed entries - playerdata.stored_data.viewed = {} - -- Count viewed entries - playerdata.stored_data.viewed_count = {} - -- Contains revealed/unhidden entries - playerdata.stored_data.revealed = {} - -- Count revealed entries - playerdata.stored_data.revealed_count = {} - else - -- Completely rebuild viewed and revealed counts from scratch - for cid, cat in pairs(doc.data.categories) do - if playerdata.stored_data.viewed[cid] == nil then - playerdata.stored_data.viewed[cid] = {} - end - if playerdata.stored_data.revealed[cid] == nil then - playerdata.stored_data.revealed[cid] = {} - end - local vc = 0 - local rc = doc.get_entry_count(cid) - doc.data.categories[cid].hidden_count - for eid, entry in pairs(cat.entries) do - if playerdata.stored_data.viewed[cid][eid] then - vc = vc + 1 - playerdata.stored_data.revealed[cid][eid] = true - end - if playerdata.stored_data.revealed[cid][eid] and entry.hidden then - rc = rc + 1 - end - end - playerdata.stored_data.viewed_count[cid] = vc - playerdata.stored_data.revealed_count[cid] = rc - end - end - - -- Add button for Inventory++ - if minetest.get_modpath("inventory_plus") ~= nil then - inventory_plus.register_button(player, "doc_inventory_plus", S("Help")) - end -end) - ----[[ Add buttons for inventory mods ]] -local button_action = function(player) - doc.show_doc(player:get_player_name()) -end - --- Unified Inventory -if minetest.get_modpath("unified_inventory") ~= nil then - unified_inventory.register_button("doc", { - type = "image", - image = "doc_button_icon_hires.png", - tooltip = S("Help"), - action = button_action, - }) -end - --- sfinv_buttons -if minetest.get_modpath("sfinv_buttons") ~= nil then - sfinv_buttons.register_button("doc", { - image = "doc_button_icon_lores.png", - tooltip = S("Collection of help texts"), - title = S("Help"), - action = button_action, - }) -end - - -minetest.register_privilege("help_reveal", { - description = S("Allows you to reveal all hidden help entries with /help_reveal"), - give_to_singleplayer = false -}) - -minetest.register_chatcommand("help_reveal", { - params = "", - description = S("Reveal all hidden help entries to you"), - privs = { help_reveal = true }, - func = function(name, param) - doc.mark_all_entries_as_revealed(name) - end, -}) diff --git a/doc/locale/doc.de.tr b/doc/locale/doc.de.tr deleted file mode 100644 index 39fc725..0000000 --- a/doc/locale/doc.de.tr +++ /dev/null @@ -1,51 +0,0 @@ -# textdomain:doc -<=< ->=> -Access to the requested entry has been denied; this entry is secret. You may unlock access by progressing in the game. Figure out on your own how to unlock this entry.=Der Zugriff auf den angeforderten Eintrag wurde verweigert; dieser Eintrag ist geheim. Sie können durch weiteren Spielfortschritt den Zugriff freischalten. Finden Sie selbst heraus, wie Sie diesen Eintrag freischalten können. -All entries read.=Alle Einträge gelesen. -All help entries revealed!=Alle Hilfseinträge aufgedeckt! -All help entries are already revealed.=Alle Hilfseinträge sind schon aufgedeckt. -Allows you to reveal all hidden help entries with /help_reveal=Ermöglicht es Ihnen, alle verborgenen Hilfseinträge mit /help_reveal freizuschalten -Category list=Kategorienliste -Currently all entries in this category are hidden from you.=Momentan sind alle Einträge in dieser Kategorie vor Ihnen verborgen. -Unlock new entries by progressing in the game.=Schalten Sie neue Einträge frei, indem Sie im Spiel fortschreiten. -Help=Hilfe -Entry=Eintrag -Entry list=Eintragsliste -Error: Access denied.=Fehler: Zugriff verweigert. -Error: No help available.=Fehler: Keine Hilfe verfügbar. -Go to category list=Zur Kategorienliste -Go to entry list=Zur Eintragsliste -Help > (No Category)=Hilfe > (Keine Kategorie) -Help > @1=Hilfe > @1 -Help > @1 > @2=Hilfe > @1 > @2 -Help > @1 > (No Entry)=Hilfe > @1 > (Kein Eintrag) -Hidden entries: @1=Verborgene Einträge: @1 -New entries: @1=Neue Einträge: @1 -New help entry unlocked: @1 > @2=Neuen Hilfseintrag freigeschaltet: @1 > @2 -No categories have been registered, but they are required to provide help.=Es wurden keine Kategorien registriert, aber sie werden benötigt, um die Hilfe anbieten zu können. -The Documentation System [doc] does not come with help contents on its own, it needs additional mods to add help content. Please make sure such mods are enabled on for this world, and try again.=Das Dokumentationssystem [doc] bringt von sich aus keine eigenen Hilfsinhalte mit, es benötigt zusätzliche Mods, um sie hinzuzufügen. Bitte stellen Sie sicher, dass solche Mods für diese Welt aktiviert sind und versuchen Sie es erneut. -Number of entries: @1=Anzahl der Einträge: @1 -OK=OK -Open a window providing help entries about Minetest and more=Ein Fenster mit Hilfseinträgen über Minetest und mehr öffnen -Please select a category you wish to learn more about:=Bitte wählen Sie eine Kategorie, über die Sie mehr erfahren möchten, aus: -Recommended mods: doc_basics, doc_items, doc_identifier, doc_encyclopedia.=Empfohlene Mods: doc_basics, doc_items, doc_identifier, doc_encyclopedia. -Reveal all hidden help entries to you=Alle für Sie verborgenen Hilfseinträge freischalten -Show entry=Eintrag zeigen -Show category=Kategorie zeigen -Show next entry=Nächsten Eintrag zeigen -Show previous entry=Vorherigen Eintrag zeigen -This category does not have any entries.=Diese Kategorie hat keine Einträge. -This category has the following entries:=Diese Kategorie hat die folgenden Einträge: -This category is empty.=Diese Kategorie ist leer. -This is the help.=Dies ist die Hilfe. -You haven't chosen a category yet. Please choose one in the category list first.=Sie haben noch keine Kategorie gewählt, Bitte wählen Sie zuerst eine aus. -You haven't chosen an entry yet. Please choose one in the entry list first.=Sie haben noch keinen Eintrag gewählt. Bitte wählen Sie zuerst einen aus. -Nameless entry (@1)=Namenloser Eintrag (@1) -Collection of help texts=Sammlung von Hilfstexten -Notify me when new help is available=Benachrichtigen, wenn neue Hilfe verfügbar ist -Play notification sound when new help is available=Toneffekt abspielen, wenn neue Hilfe verfügbar ist -Show previous image=Vorheriges Bild zeigen -Show previous gallery page=Vorherige Galerieseite zeigen -Show next image=Nächstes Bild zeigen -Show next gallery page=Nächste Galerieseite zeigen diff --git a/doc/locale/doc.pt.tr b/doc/locale/doc.pt.tr deleted file mode 100644 index 52d6836..0000000 --- a/doc/locale/doc.pt.tr +++ /dev/null @@ -1,43 +0,0 @@ -# textdomain:doc -<= ->= -Access to the requested entry has been denied; this entry is secret. You may unlock access by progressing in the game. Figure out on your own how to unlock this entry.=O acesso à entrada solicitada foi negado; essa entrada é secreta. Você pode desbloquear o acesso progredindo no jogo. Descobrir por conta própria como desbloquear essa entrada. -All entries read.=Todas as entradas lidas. -All help entries revealed!=Todas as entradas de ajuda reveladas! -All help entries are already revealed.=Todas as entradas de ajuda já foram reveladas. -Allows you to reveal all hidden help entries with /help_reveal=Permite revelar todas as entradas de ajuda ocultas com /help_reveal -Category list=Lista de Categorias -Currently all entries in this category are hidden from you.\\nUnlock new entries by progressing in the game.=Atualmente, todas as entradas nessa categoria estão ocultas a você.\\nDesbloqueie novas entradas progredindo no jogo. -Help=Ajuda -Entry=Entrada -Entry list=Lista de Entradas -Error: Access denied.=Erro: Acesso negado. -Error: No help available.=Erro: Nenhuma ajuda disponível. -Go to category list=Ver categorias -Go to entry list=Ir para a lista de entradas -Help > @1=Ajuda > @1 -Help > @1 > @2=Ajuda > @1 > @2 -Help > @1 > (No Entry)=Ajuda > @1 > (Nenhuma Entrada) -Help > (No Category)=Ajuda > (Nenhuma Categoria) -Hidden entries: @1=Entradas ocultas: @1 -Nameless entry (@1)=Entrada sem nome (@1) -New entries: @1=Novas entradas: (@1) -New help entry unlocked: @1 > @2=Nova entrada de ajuda desbloqueada: @1 > @2 -No categories have been registered, but they are required to provide help.\nThe Documentation System [doc] does not come with help contents on its own, it needs additional mods to add help content. Please make sure such mods are enabled on for this world, and try again.=Nenhuma categoria foi registrada, mas é necessário fornecer ajuda.\nO Sistema de Documentação [doc] não vem com o conteúdo de ajuda, ele precisa de mods adicionais para adicionar conteúdo de ajuda. Por favor, certifique-se de que os mods estão habilitados para este mundo e tente novamente. -Number of entries: @1=Número de entradas: @1 -OK=OK -Open a window providing help entries about Minetest and more=Abra uma janela fornecendo entradas de ajuda sobre o Minetest e mais -Please select a category you wish to learn more about:=Por favor, selecione uma categoria sobre a qual você deseja saber mais: -Recommended mods: doc_basics, doc_items, doc_identifier, doc_encyclopedia.=Mods recomendados: doc_basics, doc_items, doc_identifier, doc_encyclopedia. -Reveal all hidden help entries to you=Revela todas as entradas de ajuda ocultas para você -Show entry=Ver entrada -Show category=Ver categoria -Show next entry=Ver próxima entrada -Show previous entry=Ver entrada anterior -This category does not have any entries.=Essa categoria não possui entradas. -This category has the following entries:=Essa categoria tem as seguintes entradas: -This category is empty.=Essa categoria está vazia. -This is the help.=Essa é a ajuda. -You haven't chosen a category yet. Please choose one in the category list first.=Você ainda não escolheu uma categoria. Por favor, escolha uma na lista de categorias primeiro. -You haven't chosen an entry yet. Please choose one in the entry list first.=Você ainda não escolheu uma entrada. Por favor, escolha uma na lista de entrada primeiro. -Collection of help texts=Coleção de textos de ajuda diff --git a/doc/locale/doc.pt_BR.tr b/doc/locale/doc.pt_BR.tr deleted file mode 100644 index 52d6836..0000000 --- a/doc/locale/doc.pt_BR.tr +++ /dev/null @@ -1,43 +0,0 @@ -# textdomain:doc -<= ->= -Access to the requested entry has been denied; this entry is secret. You may unlock access by progressing in the game. Figure out on your own how to unlock this entry.=O acesso à entrada solicitada foi negado; essa entrada é secreta. Você pode desbloquear o acesso progredindo no jogo. Descobrir por conta própria como desbloquear essa entrada. -All entries read.=Todas as entradas lidas. -All help entries revealed!=Todas as entradas de ajuda reveladas! -All help entries are already revealed.=Todas as entradas de ajuda já foram reveladas. -Allows you to reveal all hidden help entries with /help_reveal=Permite revelar todas as entradas de ajuda ocultas com /help_reveal -Category list=Lista de Categorias -Currently all entries in this category are hidden from you.\\nUnlock new entries by progressing in the game.=Atualmente, todas as entradas nessa categoria estão ocultas a você.\\nDesbloqueie novas entradas progredindo no jogo. -Help=Ajuda -Entry=Entrada -Entry list=Lista de Entradas -Error: Access denied.=Erro: Acesso negado. -Error: No help available.=Erro: Nenhuma ajuda disponível. -Go to category list=Ver categorias -Go to entry list=Ir para a lista de entradas -Help > @1=Ajuda > @1 -Help > @1 > @2=Ajuda > @1 > @2 -Help > @1 > (No Entry)=Ajuda > @1 > (Nenhuma Entrada) -Help > (No Category)=Ajuda > (Nenhuma Categoria) -Hidden entries: @1=Entradas ocultas: @1 -Nameless entry (@1)=Entrada sem nome (@1) -New entries: @1=Novas entradas: (@1) -New help entry unlocked: @1 > @2=Nova entrada de ajuda desbloqueada: @1 > @2 -No categories have been registered, but they are required to provide help.\nThe Documentation System [doc] does not come with help contents on its own, it needs additional mods to add help content. Please make sure such mods are enabled on for this world, and try again.=Nenhuma categoria foi registrada, mas é necessário fornecer ajuda.\nO Sistema de Documentação [doc] não vem com o conteúdo de ajuda, ele precisa de mods adicionais para adicionar conteúdo de ajuda. Por favor, certifique-se de que os mods estão habilitados para este mundo e tente novamente. -Number of entries: @1=Número de entradas: @1 -OK=OK -Open a window providing help entries about Minetest and more=Abra uma janela fornecendo entradas de ajuda sobre o Minetest e mais -Please select a category you wish to learn more about:=Por favor, selecione uma categoria sobre a qual você deseja saber mais: -Recommended mods: doc_basics, doc_items, doc_identifier, doc_encyclopedia.=Mods recomendados: doc_basics, doc_items, doc_identifier, doc_encyclopedia. -Reveal all hidden help entries to you=Revela todas as entradas de ajuda ocultas para você -Show entry=Ver entrada -Show category=Ver categoria -Show next entry=Ver próxima entrada -Show previous entry=Ver entrada anterior -This category does not have any entries.=Essa categoria não possui entradas. -This category has the following entries:=Essa categoria tem as seguintes entradas: -This category is empty.=Essa categoria está vazia. -This is the help.=Essa é a ajuda. -You haven't chosen a category yet. Please choose one in the category list first.=Você ainda não escolheu uma categoria. Por favor, escolha uma na lista de categorias primeiro. -You haven't chosen an entry yet. Please choose one in the entry list first.=Você ainda não escolheu uma entrada. Por favor, escolha uma na lista de entrada primeiro. -Collection of help texts=Coleção de textos de ajuda diff --git a/doc/locale/template.txt b/doc/locale/template.txt deleted file mode 100644 index fdeecfd..0000000 --- a/doc/locale/template.txt +++ /dev/null @@ -1,51 +0,0 @@ -# textdomain:doc -<= ->= -Access to the requested entry has been denied; this entry is secret. You may unlock access by progressing in the game. Figure out on your own how to unlock this entry.= -All entries read.= -All help entries revealed!= -All help entries are already revealed.= -Allows you to reveal all hidden help entries with /help_reveal= -Category list= -Currently all entries in this category are hidden from you. -Unlock new entries by progressing in the game.= -Help= -Entry= -Entry list= -Error: Access denied.= -Error: No help available.= -Go to category list= -Go to entry list= -Help > @1= -Help > @1 > @2= -Help > @1 > (No Entry)= -Help > (No Category)= -Hidden entries: @1= -Nameless entry (@1)= -New entries: @1= -New help entry unlocked: @1 > @2= -No categories have been registered, but they are required to provide help.= -The Documentation System [doc] does not come with help contents on its own, it needs additional mods to add help content. Please make sure such mods are enabled on for this world, and try again.= -Number of entries: @1= -OK= -Open a window providing help entries about Minetest and more= -Please select a category you wish to learn more about:= -Recommended mods: doc_basics, doc_items, doc_identifier, doc_encyclopedia.= -Reveal all hidden help entries to you= -Show entry= -Show category= -Show next entry= -Show previous entry= -This category does not have any entries.= -This category has the following entries:= -This category is empty.= -This is the help.= -You haven't chosen a category yet. Please choose one in the category list first.= -You haven't chosen an entry yet. Please choose one in the entry list first.= -Collection of help texts= -Notify me when new help is available= -Play notification sound when new help is available= -Show previous image= -Show previous gallery page= -Show next image= -Show next gallery page= diff --git a/doc/mod.conf b/doc/mod.conf deleted file mode 100644 index 302fd83..0000000 --- a/doc/mod.conf +++ /dev/null @@ -1,3 +0,0 @@ -name = doc -optional_depends = unified_inventory, sfinv_buttons, central_message, inventory_plus -description = A simple in-game documentation system which enables mods to add help entries based on templates. diff --git a/doc/screenshot.png b/doc/screenshot.png deleted file mode 100644 index 90946a9..0000000 Binary files a/doc/screenshot.png and /dev/null differ diff --git a/doc/sounds/doc_reveal.ogg b/doc/sounds/doc_reveal.ogg deleted file mode 100644 index 3fbe176..0000000 Binary files a/doc/sounds/doc_reveal.ogg and /dev/null differ diff --git a/doc/textures/doc_awards_icon_generic.png b/doc/textures/doc_awards_icon_generic.png deleted file mode 100644 index b33fa34..0000000 Binary files a/doc/textures/doc_awards_icon_generic.png and /dev/null differ diff --git a/doc/textures/doc_button_icon_hires.png b/doc/textures/doc_button_icon_hires.png deleted file mode 100644 index 25c9fe4..0000000 Binary files a/doc/textures/doc_button_icon_hires.png and /dev/null differ diff --git a/doc/textures/doc_button_icon_lores.png b/doc/textures/doc_button_icon_lores.png deleted file mode 100644 index 3df6195..0000000 Binary files a/doc/textures/doc_button_icon_lores.png and /dev/null differ diff --git a/doc/textures/inventory_plus_doc_inventory_plus.png b/doc/textures/inventory_plus_doc_inventory_plus.png deleted file mode 100644 index 3df6195..0000000 Binary files a/doc/textures/inventory_plus_doc_inventory_plus.png and /dev/null differ