Difference between revisions of "User:Voxel"

From Minetest Wiki
Jump to navigation Jump to search
(rewrote)
Line 3: Line 3:
 
Ambitious guy who just started to clean up this place a bit, to let it rise again. ;)
 
Ambitious guy who just started to clean up this place a bit, to let it rise again. ;)
  
[[Special:PrefixIndex/User:Voxel/|Workbench]]
+
[[Special:PrefixIndex/User:Voxel/|Voxels Workbench]]
  
 
__FORCETOC__
 
__FORCETOC__
  
 
== Description of my cleanup ==
 
== Description of my cleanup ==
 +
-----
 
<b>Updates for this text</b>  
 
<b>Updates for this text</b>  
* 2021-04-17 - [[#A_"choose_your_language"_page_as_the_first_page_wiki_users_will_see]]
+
-----
* 2021-04-14 - [[#Categories_for_Mod_and_Game_specific_content]]
+
=== Wikimedia compliance ===
 +
:One of the benefit of that is is that you just learn one way to do it and you can edit any wikimedia based wiki.
 +
:I geared at Wikipedia standards.
  
:Short: I will make this wiki that is based on wikimedia, wikimedia conform.  
+
=== Subpages ===
:I contribute to different wikimedia projects, like wikipedia since many years, so I am pretty familiar with it.  
+
:Structure here is Mainarticle -> Subpage.
:This wiki should match the <b>Best Practice</b> principles of the Wikipedia. In every wiki made with the media wiki software, it should always be the same way how to do things.  
+
:That's it, no more subpages of subpages, that's an unclear mess.
:All the following explained changes I will make, are not fully done yet and it will take some time to get them done.  
+
:Pages where this is the case will be merged to the main article or to one of its subpages.
:Oh and do not be afraid, I wont delete any content, except the outaded content (for example I deleted a sentence in one article that recommends downloading mods from Minetest Bower), also spam, adds, etc. if there is any.  
+
:Subpages must be linked in the main article.
 
+
:Main pages for games and mods are already subpages of [[Games]] or [[Mods]], this will stay as it is.
=== Restructuring pages ===
+
:Structure for game pages is:
:I've found many pages that do not fit to the wiki standards (look at the page source of a wikipedia page to compare).
+
::Games/NameOfTheGame/Recipes
:An example of a restructured article be me (nearly no new or modified content): [https://wiki.minetest.net/index.php?title=Mods&action=historysubmit&diff=25628&oldid=24478 Article:Mods]
+
::Games/NameOfTheGame/Items
 
+
::Games/NameOfTheGame/Nodes
=== The subpage of a subpage of a... ===
+
::Games/NameOfTheGame/Tools
:I decided to merge the subpages of articles into their main article, cause the most of these subpages containing nearly no content and it is just a waste of ressources on both sides, server and client.
+
:and optional:
:Also it is a mess to find all these pages without using the links in the main article linking to them (and I already saw examples where not all subpages of an article were linked in the main article...) or the page information link and after that the sublink for subpages (most wikimedia software users do not even know that these exist...).
+
::Games/NameOfTheGame/Tutorial
:I will make some exceptions for large tutorials like robots and stuff like that, cause else the main article would be bloated.
+
:No further subpages, all content must be distributed at those pages!
:I will set links to these these subpages in the main articles.
+
:Same structure for mod pages (replace in the example above the word "Game" with the word "Mod").  
 
::An example how that looks like for the page Simple Mobs:
 
::An example how that looks like for the page Simple Mobs:
 
::The old one was a subpage of the page [[Mods]], with even more subpages for every (!) single mob in that mod: [https://wiki.minetest.net/index.php?title=Mods/Simple_Mobs&oldid=18490 Mods/Simple Mobs(Old)]  
 
::The old one was a subpage of the page [[Mods]], with even more subpages for every (!) single mob in that mod: [https://wiki.minetest.net/index.php?title=Mods/Simple_Mobs&oldid=18490 Mods/Simple Mobs(Old)]  
Line 32: Line 35:
 
::By the way it is not my fault, that this article isn't complete and up to date.
 
::By the way it is not my fault, that this article isn't complete and up to date.
  
=== Inconsistent, redundant and unclear categories ===
+
=== Sourcecode structure of pages ===
:Further I noticed, that the categories are inconsistent and some of them are redundant (same topic different categories).  
+
==== Order of the content elements from top to bottom ====
:I decide to bring logic into these, like it is done in the wikipedia (correct and logical tree structures) and I will create some new categories and put a delete template in some others, after I moved their subcategories.
+
:At the top there are templates, files and datasheets, make at least a linebreak between every single one to keep that thing readable.
:Also the sorting of categories below an article should be from specific to general.
+
:After that the table of content (<nowiki>__toc__</nowiki>), always on the left side.
:So for that example page Simple mobs it must be like that:
+
:The main captions are always <nowiki>== Main caption ==</nowiki>, every subcaption needs to have one more = at both sides. One empty line between two main caption sections. Text of a caption section is direct under the caption, no empty line between them.
::<nowiki>[[Category:Mobs mods]]</nowiki><br><nowiki>[[Category:Mods]]</nowiki><br><nowiki>[[Category:Languages pages]]</nowiki>
+
:Medias are always at the right.
 +
:Navboxes are the second least and categories are the very least.
 +
:Categories are sorted from specific to generic.
 +
:When the template <nowiki>{{Languages}}</nowiki> is used at the top of the page, then it must be look like this: <nowiki>{{Languages|nocat=1}}</nowiki>, else it places the [https://wiki.minetest.net/Category:Languages pages Languages pages] at the beginning of the category list. Further the [https://wiki.minetest.net/Category:Languages pages Languages pages] must be placed at the bottom manually.
  
==== Categories bounded to templates ====
+
:An example of a restructured article be me (nearly no new or modified content): [https://wiki.minetest.net/index.php?title=Mods&action=historysubmit&diff=25628&oldid=24478 Article:Mods]
:In the context of this, it is important, that the template <nowiki>{{Languages}} mostly find at the top of an article, needs to be replaced with or edited to {{Languages|nocat=1}}</nowiki>, cause the first one contains the category <nowiki>[[Category:Languages_pages]]</nowiki>, (see here for details: [https://wiki.minetest.net/Template:Languages Template:Languages]) wich is then the first listed category in the order of categories at the bottom.
 
:Also import is to add the <nowiki>[[Category:Languages_pages]]</nowiki> manually.
 
:Categories should never be bound to templates anyway, except for important ones like delete, or need maintanence or similiar things.
 
 
 
=== Translations ===
 
==== Pages / Articles ====
 
:Further the translation pages are subpages, maybe we can not do it like it is at wikipedia (a real language menu), I don't know.
 
:If not, then we should move all language specific subpages to their own main pages, the actual state isn't wiki conform and annoying.
 
:For example, I can have the page "Examplepage" in German then it will be called "Examplepage/de", that's the pagetitle then, but that title is not german, it should have the name "Beispielseite".
 
:Also people started such subpages with the translated title like that:
 
:<b><nowiki>= '''Beispielseite''' =</nowiki></b>
 
:that's ugly and against the wiki syntax rules.
 
:For that we need to have a new type of that language template if possible.
 
:It is already possible to link a page inside that template, individual for each site you put that template:
 
:<b><nowiki>{{Languages|Pagelink|nocat=1}}</nowiki></b>
 
:but we need to have multiple links there, for all available languages.
 
:I don't know if that is possible, but it would solve that pagetitle issue.
 
 
 
=== A "choose your language" page as the first page wiki users will see ===
 
:Look here: [[User:Voxel/Test]]
 
:This will solve the problem and only pages with wiki related prefixes will stay english, like "Category", "Special", "Help".
 
 
 
==== Understandable Categories ====
 
:But there's another issue related to the categories again: people who can not read english, do not understand the categorie links at the bottom of the articles.
 
:Best would be, that we have an english article about education purpose for example, with the "Category:Education" and the same article as subpage in french for example, with the "Catégorie:Éducation" template in it. But that doesn't work, the french word <i>Catégory</i> isn't registered the same way as it is in english, it will always create a page and not a new category, same for any other languages of course.
 
:So we need a workarround.
 
:For now I just let the language specific category in the translated pages (or put them there if not existent, cause many articles miss them) and I create a new structure for the language specific categories, for <b>every</b> language that is present in this wiki, with at least one page.
 
:But before I give an example how this will look like, I need to say, that the [https://wiki.minetest.net/Category:Minetest_(Root_Category) root category] needs a new name and I recommend <nowiki>[[Category:Minetest_Wiki]]</nowiki>.
 
:Why this name? Because it is multilingual, when you visit a webpage called minetest.net you probably know what the word <i>minetest</i> means and it is called all the same in every language and even understandable if not written in the letters of other languages. That counts even more for the word <i>Wiki</i>
 
:I already created that category: [https://wiki.minetest.net/Category:Minetest_Wiki Category:Minetest_Wiki], that contains nothing at the moment, because all categories needs to moved from the actual root category to the new one.
 
:As everyone can see it contains that "switch language" banner at the top and that's because, every language will have it's own root category and own subcategories.
 
:At the moment just the german root category exists [https://wiki.minetest.net/Category:Minetest_Wiki/de Category:Minetest_Wiki/de] and some subcategories there.
 
:<b>Issue:</b> no matter what I tried, I can not linking back from the german root category to the english one *sigh* (this wiki drives me mad...).
 
  
==== Restructuring base work ====
+
=== Categories ===
:However, here's an example for the structure of the translated pages:
+
==== Renamed root category ====
::[https://wiki.minetest.net/Category:Translated_Pages Category:Translated_Pages] contains subcategories for all available languages named in their specific language (at the moment only for german, spanish, russian and japanese, to just show different kinds of letters and yes I know russian and japanese are not correct sorted in at that page, but that's something that can not be fixed and also yes I know, at the moment these are redundant because the old ones in english language are still there, but I need to move all their categories first before deleting them).
+
:The root category was renamed to [https://wiki.minetest.net/Category:Minetest_Wiki Category:Minetest_Wiki]
::After I put all the non-english pages in their correct subcategory (would be nice if the admin could do that with the "wikimedia magic something tool", cause I know that moving multiple subsites to other mainsites is possible), I will start to apply the new category structure for them. Ok in real I already do that synchron, cause I need an overview over the whole thing here.
+
:Why this name?
 +
:Because it is multilingual, when you visit a webpage called minetest.net you probably know what the word <i>minetest</i> means and it is called all the same in every language and even understandable if not written in the letters of other languages. That counts even more for the word <i>Wiki</i>.
 +
:The old root category [https://wiki.minetest.net/Category:Minetest_(Root_Category) Category:Minetest_(Root_Category)] does still exists, but only because I have not the permission to edit the main page at the moment.
 +
:Every supported language will get its own version of the new root category and subcategories in the letters of the particular language.
 +
:For example, the german version already exists and contains already some content: [https://wiki.minetest.net/Category:Minetest_Wiki/de Category:Minetest_Wiki/de]
 +
::<b>Issues</b>:
 +
::1. No matter what I try, I can not linking back from the german root category to the english one.
 +
::Solution: Someone who understand [https://wiki.minetest.net/Template:Languages pages Template:Languages pages], explain me why. ;)
 +
::2. Some categories needs a suffix, or they would have the same name as the original english category. This is mostly the case for languages that use the same or similar letters as other languages.
 +
:German <-> english is such a case for example, so the category Engine is called Engine/de in the german version.
 +
:Solution: The word "Category" in other letters (for example in french: Catégorie) must get reconized by the wikimedia software the same way as it does that for the english version of the word.
 +
==== No game or mod specific categories ====
 +
:Wiki categories exist, to help maintain a wiki and give a well structured register to overview the wiki content.
 +
:All content that a game or a mod contains must be put in the main- and subpages for that game or mod.
 +
:Anything else is just a huge mess and only insane people want to maintain categories filled with that stuff.
 +
:All games are in [https://wiki.minetest.net/Category:Games Category:Games] and all mods are in [https://wiki.minetest.net/Category:Mods Category:Mods], no further branching of categories.
 +
==== Redundant categories and such with unclear names ====
 +
:I move the content into other categories, rename existing categories and so on.
  
=== No own categories for mod or game specific content ===
+
=== A page for the url wiki.minetest.net ===
:Man it is really a mess...
+
:At the moment visitors will be redirected to the english main page.  
:There's so much game specific content in here and this stuff has its own pages and even its own categories for its components!
+
I suggest not to do that and have a simple page instead, that shows only "Minetest Wiki" and language buttons, that link to the main page in the choosen language.
:Theres a games category that's fine. That category must contain game specific pages (minetest_game for example), but the single games in it, should not contain subcategories for themselfs, games should not have their own categories at all (like Category:Minetest_Game for example), that's a huge amont of categories to mess with!
+
:Heres an example: [[User:Voxel/Test|wiki.minetest.net]]
:Also a content category and a ton of subcategories doesn't make any sense, all information about a game or a mod must be in the mainpage and the subpages of that mainpage for a game or a mod and that's it.  
+
:With this it is possible to have nearly a complete own wiki for each language and language specific pagenames.  
:If I have a Category:Items->Category:Organic items what is that good for?
+
:So for example the actual german page for games
:For nothing except a massive increase of maintenance work!
+
::wiki.minetest.net/Games/de -> will change to -> wiki.minetest.net/Spiele (try to navigate there ;D)
:Wiki categories exist to help maintain a wiki and give a well structured register for overview of the wiki content.
 
:A category wood isn't needed at all, it must contain <b>all</b> minetest content that is related to wood in any way, all content from all mods and games...
 
:That's insanity!
 
:Therefor it is another task, to move the content of these categories to pages or merge them into existing pages, but in my opinion it would be better to remove not just categories like Category:Wood, we should also remove pages like [[Wood]], because there is minetest_game related information on that site, that should only available in the page [[Games/Minetest_Game]], or we would have to add every possible use and recipes and so on from every mod or game that uses wood into that page or create even more subpages... please don't!
 
:Another example the page [[Cotton]]: different game different use for cotton, different ways to grow it, harvest it etc.
 
:Another issue are sites like [[Crafting]], it is specific, cause it doesn't contains other crafting methods, like in nodecraft or any other game that does not use the crafting mechanic as it is used in minetest_game.
 
:All that mod and game specific stuff must be moved into the specific mods/subpage or games/subpage and general pages (like [[Games]]) should only link to them and nothing more.
 
:Every game <b>one</b> page (and maybe subpages) and no own categories, that's the way how it must go.
 
  
=== Let the "rest" of the community participate ===
+
=== Participate ===
:I would welcome anyone who like to help me with these things, cause it is a lot of work!
+
:I would appreciate any help from other users, who would like to help me with these things, cause it is a lot of work!
 
:When most of the basic work is done, I will post in the different language subforums of forum.minetest.net and ask people to help with that stuff (I can not speak and read all these languages for example).  
 
:When most of the basic work is done, I will post in the different language subforums of forum.minetest.net and ask people to help with that stuff (I can not speak and read all these languages for example).  
:Also I will create a main topic, to tell the the wiki was cleaned up and that people should consider to partizipate and contribute in it.
+
:Also I will create a main topic, to tell the the wiki was renewed up and that people should consider to partizipate and contribute in it.
  
 
=== Further Ideas ===  
 
=== Further Ideas ===  
Line 114: Line 96:
 
[https://gitlab.com/voxel-minetest gitlab] (I use this only to report issues)<br>
 
[https://gitlab.com/voxel-minetest gitlab] (I use this only to report issues)<br>
 
[https://github.com/voxel-minetest github] (I use this only to report issues)
 
[https://github.com/voxel-minetest github] (I use this only to report issues)
 
  
 
[[Category:English speaking users]]
 
[[Category:English speaking users]]
 
[[Category:Deutschprachige Nutzer]]
 
[[Category:Deutschprachige Nutzer]]

Revision as of 02:35, 17 April 2021

File:Voxel.png

Ambitious guy who just started to clean up this place a bit, to let it rise again. ;)

Voxels Workbench


Description of my cleanup


Updates for this text


Wikimedia compliance

One of the benefit of that is is that you just learn one way to do it and you can edit any wikimedia based wiki.
I geared at Wikipedia standards.

Subpages

Structure here is Mainarticle -> Subpage.
That's it, no more subpages of subpages, that's an unclear mess.
Pages where this is the case will be merged to the main article or to one of its subpages.
Subpages must be linked in the main article.
Main pages for games and mods are already subpages of Games or Mods, this will stay as it is.
Structure for game pages is:
Games/NameOfTheGame/Recipes
Games/NameOfTheGame/Items
Games/NameOfTheGame/Nodes
Games/NameOfTheGame/Tools
and optional:
Games/NameOfTheGame/Tutorial
No further subpages, all content must be distributed at those pages!
Same structure for mod pages (replace in the example above the word "Game" with the word "Mod").
An example how that looks like for the page Simple Mobs:
The old one was a subpage of the page Mods, with even more subpages for every (!) single mob in that mod: Mods/Simple Mobs(Old)
Now it is stil a subpage of the page Mods, but I merged all the subpages for every single mob into the main article Mods/Simple Mobs(New)
By the way it is not my fault, that this article isn't complete and up to date.

Sourcecode structure of pages

Order of the content elements from top to bottom

At the top there are templates, files and datasheets, make at least a linebreak between every single one to keep that thing readable.
After that the table of content (__toc__), always on the left side.
The main captions are always == Main caption ==, every subcaption needs to have one more = at both sides. One empty line between two main caption sections. Text of a caption section is direct under the caption, no empty line between them.
Medias are always at the right.
Navboxes are the second least and categories are the very least.
Categories are sorted from specific to generic.
When the template {{Languages}} is used at the top of the page, then it must be look like this: {{Languages|nocat=1}}, else it places the pages Languages pages at the beginning of the category list. Further the pages Languages pages must be placed at the bottom manually.
An example of a restructured article be me (nearly no new or modified content): Article:Mods

Categories

Renamed root category

The root category was renamed to Category:Minetest_Wiki
Why this name?
Because it is multilingual, when you visit a webpage called minetest.net you probably know what the word minetest means and it is called all the same in every language and even understandable if not written in the letters of other languages. That counts even more for the word Wiki.
The old root category Category:Minetest_(Root_Category) does still exists, but only because I have not the permission to edit the main page at the moment.
Every supported language will get its own version of the new root category and subcategories in the letters of the particular language.
For example, the german version already exists and contains already some content: Category:Minetest_Wiki/de
Issues:
1. No matter what I try, I can not linking back from the german root category to the english one.
Solution: Someone who understand pages Template:Languages pages, explain me why. ;)
2. Some categories needs a suffix, or they would have the same name as the original english category. This is mostly the case for languages that use the same or similar letters as other languages.
German <-> english is such a case for example, so the category Engine is called Engine/de in the german version.
Solution: The word "Category" in other letters (for example in french: Catégorie) must get reconized by the wikimedia software the same way as it does that for the english version of the word.

No game or mod specific categories

Wiki categories exist, to help maintain a wiki and give a well structured register to overview the wiki content.
All content that a game or a mod contains must be put in the main- and subpages for that game or mod.
Anything else is just a huge mess and only insane people want to maintain categories filled with that stuff.
All games are in Category:Games and all mods are in Category:Mods, no further branching of categories.

Redundant categories and such with unclear names

I move the content into other categories, rename existing categories and so on.

A page for the url wiki.minetest.net

At the moment visitors will be redirected to the english main page.

I suggest not to do that and have a simple page instead, that shows only "Minetest Wiki" and language buttons, that link to the main page in the choosen language.

Heres an example: wiki.minetest.net
With this it is possible to have nearly a complete own wiki for each language and language specific pagenames.
So for example the actual german page for games
wiki.minetest.net/Games/de -> will change to -> wiki.minetest.net/Spiele (try to navigate there ;D)

Participate

I would appreciate any help from other users, who would like to help me with these things, cause it is a lot of work!
When most of the basic work is done, I will post in the different language subforums of forum.minetest.net and ask people to help with that stuff (I can not speak and read all these languages for example).
Also I will create a main topic, to tell the the wiki was renewed up and that people should consider to partizipate and contribute in it.

Further Ideas

We could "hire" testers, and let them editing the mod and game articles for example, after they tested them.
Or people who take photos of texture packs or scenes from games.

Notes

This text will probably gets updates, if this happens, I will mention this at the top, so people can check the History tab.

Where you can also find me

You can find me in the following places:
Minetest ContentDB
Minetest Forum
notabug.org
gitlab (I use this only to report issues)
github (I use this only to report issues)