Differences

This shows you the differences between two versions of the page.

--- development:wiki [2021/06/20 18:25] – Capitalization wdavery
+++ development:wiki [2021/07/12 18:08] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Wiki Guidelines for Editors ======
+====== Wiki Guidelines ======
 First of all, thank you for your efforts to make this wiki better. Seriously, with a lot of blocks and items it is near to impossible for developers to keep wiki up-to-date.
-\\
-===== Wiki Structure =====
+See our **[[development:wiki:templates|Page Templates]]** for use when creating and editing pages.
+==== Wiki Structure ====
 In order to have breadcrumbs we have 3 major sections:\\
 **Energy** - Any item or block that uses power. Including cables, generators, batteries, machines, and powered tools.\\
@@ Line 11: / Line 13: @@
 . A redirect page at its //mods:namespace:item_name// location (see below at #Minecraft_Items)\\
 . A content page in one of the three sections above
-===== Plugins =====
+==== Syntax ====
-There are two plugins that provide extra Minecraft specific features:
+Here are some syntax examples for the two [P]lugins that provide extra Minecraft-specific features, and for handy DokuWiki tools:
-==== Minecraft Items ====
+<tabs>
-Allows you to insert a fancy link to a block or item
+  * [[#tab-items|[P] Minecraft Items]]
+  * [[#tab-recipes|[P] Minecraft Recipes]]
+  * [[#tab-manual_items| Manual Links]]
+  * [[#tab-redirects| Redirects]]
+<pane id="tab-items">
+=== Minecraft Items Plugin ====
+**Allows you to insert a fancy link to a block or item**\\
 Syntax:
 <code> <mcitem>namespace:item_name</mcitem> </code>
-//namespace// is “minecraft” for vanilla or the mod name\\
+''namespace'' is either ''techreborn'' or ''minecraft'' for vanilla items\\
-//item_name// is the registry name for an item
+''item_name'' is the registry name for an item
 Example:
-<code><mcitem>minecraft:iron_ore</mcitem>
+<code>
+<mcitem>minecraft:iron_ore</mcitem>
 <mcitem>techreborn:copper_ore</mcitem>
 </code>
@@ Line 30: / Line 40: @@
 <mcitem>techreborn:copper_ore</mcitem>
-This will automatically generate a link to a page //mods:namespace:item_name//.
+<callout type="info" icon="true">
+If this produces something that is grammatically incorrect //(maybe you need plural or want "Cell" to refer to the "Empty Cell" page, etc)// see the **Manual Links** tab for custom names.
+</callout>
+This will automatically generate a link to the page ''mods:namespace:item_name''.
 That page requires a redirect to the page with real content following wiki structure.\\
-**There should be no content besides redirects under //mods://**
-Redirect syntax for items is:
+<callout type="warning" icon="true">
-<code>~~REDIRECT>namespace:item_name~~</code>
+**There should be no content besides redirects under the ''mods:'' namespace.** For an example page, see **[[development:wiki:templates]]**.
-Where //namespace// is likely “items”, “blocks” or “energy”.\\
+</callout>
-Can also be nested, like “energy:generators:generator”.
+</pane>
-==== Minecraft Recipes ====
+<pane id="tab-recipes">
-Allows for pretty formatted recipes
+=== Minecraft Recipe Plugin ===
+Allows for pretty formatted recipes.
-Example Crafting Table recipe:
 <code>
 <recipe>
-input techreborn:coal_dust minecraft:glass_pane techreborn:coal_dust
+size 3x3
-input minecraft:glass_pane techreborn:coal_dust minecraft:glass_pane
+input air air air
-input techreborn:electronic_circuit techreborn:solid_fuel_generator techreborn:electronic_circuit
+input air minecraft:coal air
-output techreborn:basic_solar_panel
+input air minecraft:stick air
+output minecraft:torch,4
+tool minecraft:crafting_table
 </recipe>
 </code>
-Produces:
 <recipe>
-input techreborn:coal_dust minecraft:glass_pane techreborn:coal_dust
+size 3x3
-input minecraft:glass_pane techreborn:coal_dust minecraft:glass_pane
+input air air air
-input techreborn:electronic_circuit techreborn:solid_fuel_generator techreborn:electronic_circuit
+input air minecraft:coal air
-output techreborn:basic_solar_panel
+input air minecraft:stick air
+output minecraft:torch,4
+tool minecraft:crafting_table
+</recipe>\\
+== Attributes ==
+^ Attribute ^ Default Value ^ Allowed Values ^ Description ^
+| ''size''  | Optional; ''3x3'' | Any positive integers. | Size of the crafting grid in width by height. |
+| ''input''  | Optional; ''air'' | Images from the :mods namespace. | Fills in the crafting grid with items. Use ''input'' for each row of items on the crafting table you wish to define. |
+| ''output'' | Optional; ''air'' | Images from the :mods namespace. | Fills in the output section of the crafting grid with an icon. |
+| ''tool'' | Optional; ''minecraft:crafting_table'' | Images from the :mods namespace. | Replaces the icon of the Crafting Table with another block or tool. |
+<callout type="info">
+=== Specifying Quantities ===
+Both commands ''input'' and ''output'' take item stacks as arguments in the form:
+<code>
+wiki_page,amount
+minecraft:torch,4
+minecraft:cobblestone,1
+</code>
+''wiki_page'' is prefixed with :mods: and therefore resolves the detail page and when suffixed again with .png the image of a block.
+''amount'' defines the quantity of an item that is used in the recipe. If omitted, exactly one is assumed. Only amounts larger than one are indicated with numbers.
+Note that tool also takes an item stack as an argument, but it will ignore any amounts.
+</callout>
+=== Additional Examples ===
+<code>
+<recipe>
+input air minecraft:stick air
+input minecraft:wood_planks minecraft:wood_planks minecraft:wood_planks
+input minecraft:wood_planks air air
+output techreborn:treetap
 </recipe>
+</code>
+<recipe>
+input air minecraft:stick air
+input minecraft:wood_planks minecraft:wood_planks minecraft:wood_planks
+input minecraft:wood_planks air air
+output techreborn:treetap
+</recipe>
 \\
 Example furnace recipe (note: size and tool are optional):
@@ Line 75: / Line 138: @@
 tool minecraft:furnace
 </recipe>
+</pane>
+<pane id="tab-manual_items">
+=== Manual Links ===
+Images and links can also be specified manually using this format:
+<code>{{:mods:techreborn:compressor.png?nolink&24}}**[[mods:techreborn:compressor|Manual Naming]]** </code>\\
+Which produces: {{:mods:techreborn:compressor.png?nolink&24}}**[[mods:techreborn:Compressor|Manual Naming]]**
+For a plain in-line link to a page you could use: <code>[[mods:techreborn:compressor|a plain link]]</code>
+Which would produce [[mods:techreborn:compressor|a plain link]]
+<callout type="info">
+Use links with images wherever it makes sense. You can use an image for non-item pages too, like an Insulated Copper Cable image {{:mods:techreborn:insulated_copper_cable.png?nolink&24}} to go with a link to the **[[energy:cables]]** page.
+</callout>
+</pane>
+<pane id="tab-redirects">
+=== Redirects ===
+<callout icon="true" type="info">To edit a page that already has a redirect simply add ''&do=edit'' to the end of the URL (eg. https://wiki.techreborn.ovh/doku.php?id=mods:techreborn:galena_ore&do=edit)</callout>
+Redirect syntax for items is:
+<code>~~REDIRECT>namespace:item_name~~</code>
+Where ''namespace'' is likely ''items'', ''blocks'' or ''energy''.\\
+Namespaces can also be nested, like <code>~~REDIRECT>namespace:subnamespace:item_name~~</code>
+**Contextual example:**\\
+On the page ''mods:techreborn:grinder'' there should be the following redirect: <code>~~REDIRECT>energy:machines:grinder~~</code>
+=== Vanilla Redirects ===
+Also works for external links for vanilla items, for example:
+<code>~~REDIRECT>http://minecraft.gamepedia.com/Iron_Ore~~</code>
+</pane>
+</tabs>