Forums › English Language Forums › General › Wiki Editors

Search

Wiki Abstraction

14 replies [Last post]
Thu, 12/02/2010 - 19:09
Chronus

----> Warning: Do not read unless you have time to waste. These issues have already been discussed, so don't bother replying to them anymore.

Alright. I know you guys are probably sick of my Wiki threads, but the problem is they get old a nobody looks at them, so I can't just go edit those ones. If you don't like it, then don't read it. :P

As I have said many times before, my ultimate goal for the Preview Event(s), and just everything before the official release in general, is to simply gather as much information as I can. I do not care about soloing the core or Vanaduke with no revives, nor do I care for getting a unique Ultra-Fiend-Damage Lv10 Khorovod. I care about collecting every piece of information I possibly can. This is why I buy energy, and this is why I am broke of crowns, hah.

I think it would be good if we could devise a perfectly consistent skeleton for the Archives section of the Wiki, except of course for the leaf pages. I think it would be better if I simply gave an example, rather than trying to explain in words... Please remember that this is an example, and not a literal representation:

  • Item
    • Equipment
      • Weapon     (Generalized)
        • Sword
          • Sword 1
          • Sword 2
          • Sword 3
          • ...
        • Handgun
          • Handgun 1
          • Handgun 2
          • Handgun 3
          • ...
        • Bomb
          • Bomb 1
          • Bomb 2
          • Bomb 3
          • ...
      • Gear     (Generalized)
        • Helmet
          • Helmet 1
          • Helmet 2
          • Helmet 3
          • ...
        • Armor
          • Armor 1
          • Armor 2
          • Armor 3
          • ...
        • Shield
          • Shield 1
          • Shield 2
          • Shield 3
          • ...
    • Mineral
      • Crimsonite
      • Dark Matter
      • Dusk Drop
      • Luminite
      • Moonstone
      • Valestone
    • Material
      • 0-Star
        • 0-Star Material 1
        • 0-Star Material 2
        • 0-Star Material 3
        • ...
      • 1-Star
        • 1-Star Material 1
        • 1-Star Material 2
        • 1-Star Material 3
        • ...
      • 2-Star
        • 2-Star Material 1
        • 2-Star Material 2
        • 2-Star Material 3
        • ...
      • 3-Star
        • ...
      • 4-Star
        • ...
      • 5-Star
        • ...
    • Recipe     (This would probably be redundant, maybe with redirections, because Recipes will be stored on the Equip's own page; as for Dusk Drop, it has it's own page as well)
    • Upgrade
      • ...
    • Travel Pass
      • ...

If you can see what I mean, everything is based on a strictly tree-shaped design, where each path describes some sort of sub-categorization. Every "directory" page (a page that has hierarchical sub-pages) links to either another directory page, or a leaf page. By leaf page, I mean a page that does not have any hierarchy below it. This is always arbitrary, of course, and it seems we have chose to actually add our own Weapon and Gear categories to the way it shows Equips in-game, otherwise Sword, Handgun, Helm, etc, would all be siblings of Material, Mineral, etc. I do like this idea, as it makes more sense and will be much more user-friendly. What I'm saying is, perhaps we should have two types of pages: a "directory" page, and a template for it, which basically lists only it's sub-pages with the "= Title =" format, for example, and a leaf page; which could be of arbitrary structure. However, arbitrary as far as relativity to other leaf pages goes. For example, each and every Weapon page should have the exact same template. This goes for every Gear page, every Material page (if needed), and so on... Each and every page that appears as a leaf page, at the lowest level of the tree, has a distinct template from other non-siblings, yet an identical template to it's siblings.

... Does anybody get what I'm saying?

Basically, I think it would be consistent, user-friendly, and very editor-friendly, if we could have an identical page-template for every Weapon, another identical page-template for every Gear, another identical page-template for every Material (if needed), and so on... where each of these is a sub-page of some sort of re-directional page, of which each are consistent with each other.

Based on the above, an example of user-navigation to find the Khorovod page would be this:

  1. Under Archives, click on "Items" - the user is taken to an "Items" page where it lists all Item types as described in the next step
  2. On the Items page, it has categorized links to each of: Weapon, Gear, Mineral, Material, etc... - click on "Weapon"
  3. Now, the same, except the Weapons page gives scope to the next sub-list of pages: Swords, Handguns, Bombs - click on Swords
  4. The same thing - except now it lists each Sword, as in here: Swords - click on Khorovod

This is basically the same as it is now. The only thing is, it is not totally consistent... and you know me. For example, a bunch of pages have the categorization of "Weapon" - however there is no Weapon page; there exists such a categorization as far as the leaf-pages are concerned, but the categorization is only expressed via one single page: Equipment. There's also some other inconsistencies, as in the Upgrades and Trinkets section, as well as the Bound and Unbound section, for example.

I know most of you will probably roll your eyes, but that's probably because you're not understanding exactly what I mean. That is why I am going to go ahead and actually utilize this modification on a series of pages, as it is easy to undo if it really doesn't turn out well (which I don't see how it could). The only issue I can see so far is the consistency between pre-leaf pages, such as the Swords one: Swords. You see, this is not just simple directional links, as the other directory pages are. However, the way the previous editors have done this page is great, and I personally think it should stay that way, and not simply have a list of all the swords. This is why, perhaps, we should have another type of page: a pre-leaf directory page, much the same as the previously mentioned Swords one, and for other examples, these: Handguns, Shields. My only concern with these is that they should also have consistent pre-leaf pages. For example, each of these pre-leaf pages for Swords, GHandguns, and Bombs should all have the same fields, each table cell the same size, and so on... this goes for the 4 Gear types as well - and you see where I'm going.

Thu, 12/02/2010 - 19:34
#1
Chronus
Questions...

I am posting this in a separate reply for the sake of visual and editorial confusion.

Questions:

  • Is there some way to make Variables on the Wiki? For example, if I wanted to input a constant in many different places, but would only need to change it in one place for it to change everywhere. Also, string descriptions for items that might appear in two places - this would be tedious to have to copy and paste each time, especially if you have many occurrences.
Thu, 12/02/2010 - 19:37
#2
Dogrock's picture
Dogrock
I get what your saying.

I get what your saying. Thankfully many of the pages so far are starting to trend to a tree type hierarchy. Most of the weapon type pages give an overview of available equips and then link to leaf articles. However, the overview pages do not link upwards to an all weapons general page and the category:weapons remains a red link.

I would also like to see all the tables over the wiki uses a consistent styling. Especially since this uses a template for the file names to eliminate typos by manually creating every field. I think that Levonis's new table style from crafting could be adopted into the equipment listings.

Unfortunately I'm not so good at coming up with templates so much as I am just filling pages with data.

Thu, 12/02/2010 - 21:30
#3
Chronus
I have abstracted the Items page, as well as the Arsenals page.

I have abstracted the Items page, as well as the Arsenals page. I have not abstracted the Consumables and Pickups pages because I would consider them "leaf pages", and thus they do not have any subcategories. This is how I plan on re-modeling every single Archives page. However, like those just noted, the bottom-most (leaf) pages will not have the Subcategory section, as this is what makes them leaf pages - they are at the end of the tree (sorry, CS nerd). I don't think leaf pages should have any specific formatting requirements, however the (possibly) pre-leaf pages should. For example, the table listing all the swords on the Sword page. This would be a pre-leaf page, as we do not want to list every single sword as a Subcategory of Swords, but rather in a more explicit and visually pleasing manner. Hence, pre-leaf pages. However not every page that lists leafs must be a pre-leaf page; Items itself lists two leafs: Consumables and Pickups, yet it does not need to be a pre-leaf page.

I am currently working on the Equipment page, now.

Thu, 12/02/2010 - 22:12
#4
Pauling's picture
Pauling
Wikis avoid duplicated effort. In theory.

I notice that you re-did the items page on the wiki, but I really have to be honest with you: I like the old one better.

The main problem is that you're forcing everything and every page to be on one particular branch of the tree; as a result, a player who wants to find crafting items now has to dig down several links from the page, instead of one, and interpret somewhat odd terms like "arsenals". (is english your second language?)

Hint: category pages are more useful than you'd think. Although the link is red and it claims the page doesn't exist, under that warning on the blank category page is a list of everything in that category. It's a confusing setup, but alas.

The key advantage of a hypertext system, however, is that you do not need to follow the tree- everything can be freely inter-connected at every level. This property is what renders the internet, and wikis in particular, so very much more usable than the simple tree system you're proposing. It's nice to think about organization- and I agree that we definitely need to keep expanding the information on weapons upgrades and categories/ subcategories- but the proposed tree system isn't the best solution from a usability perspective. Some of the conventions that have grown around wikis have done so for a reason.

EDIT: On a related note, why was the equipment page moved to "equips"? That's not really even a word, so much as an odd and somewhat idiosyncratic shorthand abbreviation. If you are going to make huge and sweeping navigation changes to the public wiki, I'd suggest posting here for a public comment period first.

EDIT2: Might I suggest learning to use wiki software a bit? You should almost never need to use HTML, including for spurious linebreaks or tables. (Tables are especially a problem: you do not want to use HTML tables in a wiki, because you lose access to special wikitable features, like sorting)

Thu, 12/02/2010 - 22:34
#5
Chronus
I don't really understand the problem you're pointing out...

Actually English is my first, and only, language. I thought that would be fairly obvious as my use of grammar and language is one of the top on here. I used "Arsenals" as a name-holder for now, for lack of a better word (same with a few other words).

I don't really understand the problem you're pointing out, pauling, can you be more specific? In reality, a player would either type in the Material if they want information on it, or simply go to the page of the weapon they perhaps need the Material for. I'm just not sure what issue you're trying to describe there.

The main reason that I proposed, and am testing, this tree system is because I think that Items, for example, can be organized in a totally hierarchical way. This renders the so-called tree system I've been trying out; a 100% consistent database-like storage system for said Items (except for leaf pages, which I have yet to justify).

 

Edit: Also, I never used tables (I don't think) except for my Existential Listing page - which I will fix another time being as it's not important right now. Plus, I have just started Wiki editing yesterday, so that might explain my... newbness? However, nothing of what I have done really requires any advanced knowledge of Wiki coding (aside from Categories, like you mentioned, but I have yet to decipher what exactly those do). As for these categories, most pages had redlinks before I even did anything, so honestly I don't feel very out of place when it comes to those.

Also, I posted this thread for the exact reason to publicize it. That being said, if it is really unpopular, it can be easily shot back. Therefore, it is no big deal, even if I were to accidentally delete a whole page. :P

And also... aside from the fact that some of the words I have used are not "Real", would that really matter? Is a Khorovod a real sword? Is a Wolver a real animal? But really, these are all relatively non-important issues, and plus simple name-holders - but I don't think people would complain about "Equips" not being in the dictionary.

Anyways... you seem like an honest and reasonable person, which is what I'd need for constructive criticism. What exactly do you think are issues with this style? I don't mean non-existent words or any little bits like that, I mean real issue people would complain about - that sort of thing.

Thu, 12/02/2010 - 22:42
#6
Pauling's picture
Pauling
And mind you, I use vi. For fun.

Chronus, your use of words like "arsenals" (instead of items), "equips" (instead of equipment), and "existential" (instead of extant) made me think you spoke a different language; I know that OOO has a wonderful following worldwide. My apologies for the confusion.

Per your wiki thoughts: Humans do not structure their brains like databases, and they may sometimes choose to browse category pages. I certainly did the first time I went to the wiki. Searching only works if you know what keyword to type in, which penalizes new users and those who do not know exactly what term they are looking for.

Your proposed tree system also renders browsing less usable by breaking information into much smaller chunks than necessary, spread across more discrete pages. A wiki should foster rich interconnections between topics, not shove everyone into one rigid path. I'm not trying to be harsh here- just pointing out that common, classic, and the seemingly elegant principles of computer science are rarely pillars of good user-centric design.

For the casual browser, it also forces them into ONLY being able to browse in hierarchical mode. If I start at the wiki main page, I used to be able to get to the Helmets page in three clicks. And if I was not familiar with game or wki terminology, the words were all intuitive and easy to understand:
Items / Equipment / Helmets

(Types of weapons vs armors still appeared as subcategories on the equipment page, so grouping was preserved, but I didn't need to go through an extra webpage to get there)

Now, with your new changes, I need a full five clicks, including through three separate quasi-sensical words:
Items / Arsenals / Equips / Gears / Helmets

You'd really need to make a better case for what the advantages of your proposal are, from the perspective of new users, casual browsers, and design of hypertext based information systems. Right now it breaks an awful lot of design conventions, and in computer science terms, that's a key constraint that needs to be incorporated into your final product.

Thu, 12/02/2010 - 23:20
#7
Chronus
I get what you're saying...

I get what you're saying, and respect the fact you are being honest and thus helpful. I suppose there are some extra branches/levels which I have added in for consistency sake, to be able to separate sibling branches/trees and such by distinct pages/nodes, rather than the content within them. I'm going to make a change to that now... and fixify the non-existent words just for you, pauling.

Upon the problem of these leaf-pages, I have realized that, regardless, maximal consistency cannot possibly be achieved. This has discouraged me, as always.

Aside from the point, I have already claimed the validity of the word Existential. Although the other two I do admit do not exist, a mere few words shouldn't suffice as to hinder my English-speaking capabilities. :P

... And apparently I'm not human, buahah.

 

Edit: Okay one thing that I really think needs to be differentiated is the Inventory-based Items (what I have called Arsenals as they go into your Arsenal/Inventory). I have just renamed this section to Inventory Items for the time being.

 

Edit 2: Okay I fixed it up, still with what I would consider pure consistency - just that the categorization skips over 2 places in some spots, but is made up for via the current page. It now takes the same "clicks" you were referring too, as well, and I have added the Category tab at the bottom to a bunch of pages. A few questions, though... why is "Weapons" listed on the page for Swords, for example, if no such page exists? Are Categories used solely for keywords, or do they have some sort of hierarchical meaning behind them? Lastly, should a Category tab list the current page? For example, should the Items page have the category Items included?

Thu, 12/02/2010 - 23:19
#8
Pauling's picture
Pauling
Never go up against a sicilian, when wikis are on the line

Existential: of or pertaining to existence. A word that is most commonly used in relation to existentialism, a branch of philosophy

Extant: currently or actually existing

...So even when a word exists, it may not be the one you want. ;)

On a more useful note, I chided you for using HTML in wiki pages, so to be helpful, here's some info on how to use wiki tables:
https://secure.wikimedia.org/wikipedia/en/wiki/Help:Table

As for the < br > tag? Just don't use it. It's unnecessary; you can force the desired linebreak by hitting enter twice. This is designed to encourage people to think about formatting a bit more carefully to conform to a single common visual standard and design, rather than tossing in linebreaks at random. Bullet points ( the * sign) or numbered lists ( the # symbol) are also good alternative ways to add linebreaks. But if you're not sure, please do NOT make massive changes without asking someone else first and waiting for a few replies. :)

Fri, 12/03/2010 - 00:53
#9
Chronus
Thanks for the link...

I did look up the meaning of both, and to be honest, I thought Existential made more sense, as the list itself obviously does exist. The list more pertains to existence, as it tells of existence, rather than stating that it, itself, does exist. Perhaps a better title would be simply be "List of Existing Items", hah. I guess it's a matter of opinion.

Thanks for the link, I'll do some practice on my (admittedly) messy list tomorrow, as I should get to sleep now.

As for the line break tags... it turns out that carriage returns don't always work. For example, directly underneath = Title = lines, the amount of blank lines doesn't seem to matter - at least for me. Anyways, I got rid of these instances anyways, with what I just did, so I'll go through and get rid of the line break tags as well (the rest of which were added for consistency). Is there anything that forces a line break? The fact that the * and # methods add a useless bullet/number is the only issue there.

 

Edit: Forgot to address this again, but, as I said before, the only reason I went ahead and did this was because I knew it could be undone with a few clicks. Plus, there's probably very few Wiki views within a 2-hour time span - but regardless, I'll try not to let my documentation-obsessed side get to me next time.

Also, your suggestion of the word Extant makes me want to rename it "Extant Item Listing" - which seems to make the most sense, and is the most readable, so far.

Annnnd... what does the |* do in the category tag? Also regarding questions from before: why is "Weapons" listed on the page for Swords, for example, if no such page exists? Are Categories used solely for keywords, or do they have some sort of hierarchical meaning behind them? Lastly, should a Category tab list the current page? For example, should the Items page have the category Items included?

Fri, 12/03/2010 - 04:50
#10
Shango
Legacy Username
Is there some way to make
Is there some way to make Variables on the Wiki? For example, if I wanted to input a constant in many different places, but would only need to change it in one place for it to change everywhere. Also, string descriptions for items that might appear in two places - this would be tedious to have to copy and paste each time, especially if you have many occurrences.
- Chronus

I tried this with equipment stats, and did this. It worked in such a way that an equipment page would transclude a template, which would then transclude the first page. Unfortunately, it would only take hold and recognize what was going on after the page was edited one more time after adding the code. It didn't even matter what the edit was. This was a pretty big flaw, so I shelved the idea.

I would have loved for it to have worked though. It would have made it so if you wanted a template to display the stats of an item all you would have to give it was the name, and it would look up the stats itself.

As a suggestion, I'd like to make an individual page for every recipe. Then, on the equipment page itself the recipe could be transcluded from its page. This would allow you to have an entire page to put things--like where to get the recipe--while allowing you to see the recipe from the item's page.

Edit: I did a tiny bit of reorganization and tidying up on the aforementioned page and I think it looks good now. Also, here's a page that has been very helpful to me and I thought you'd find it useful as well: Wiki Markup

Fri, 12/03/2010 - 11:00
#11
Chronus
Thanks Shango, and pauling. Sorry for the trouble earlier...

Thanks Shango, and pauling. Sorry for the trouble earlier, sometimes I just get a bit carried away with my "consistency" issues. Just as they say, with great power comes great responsibility. We are all given the great power of being able to freely edit almost every page on the Wiki, but should all be aware that certain responsibilities must be satisfied as to not disrupt the natural flow of things. As i have said many times before, I am ambitious in the sense that I feel my real purpose, aside from testing itself, is to record all of the information I possibly can. This may delude one of the responsibilities they must still maintain; as it goes for myself. That being said, I don't really have the responsibility part covered yet, for a few reasons.... one being I should probably accumulate more than 4 hours of Wiki coding experience before I go attempting something like a complete makeover, let alone waiting for intelligent replies about such a proposition to begin with. Not to mention more than a few hours of sleep, which is a common issue for University students. My basis of jumping into it so quickly was that it could be easily reverted. I think the main problem is, just as pauling stated, I am trying to force it into too much of a database-like structure; which is not the most user-friendly way to do so in reality. This is how it is done in code, and in an actual database, and so on... but not in an encyclopedia. I think what I should have done was, rather than attempting to morph the Wiki hierarchy itself, was morph the hierarchy of my own listing (EIL) into the form I wished instead. This would make a lot more sense being as this is exactly what the listing is intended for: structured and consistent look-up, all in one single spot. I feel pretty stupid now, to say the least. I'm not a very good group-worker at all, unless of course I am working in a group that thinks the same way I do (which isn't very typical, as you might have figured).

Next time I go off like this would someone please, for the love of all that is realistic, slap me.

Anyways, I would take comfort in knowing that you at least somewhat understand what my intentions were, as far as the whole consistency and categorization stuff goes. I am now going to implement this into the EIL so that it simply lists only the names of pages as leafs on the giant tree - being links to said pages. This way, it will be easy to see which specific pages are missing (redlinks), and which need to be updated, and so on... I am currently devising a plan to make this EIL actually useful not only for readers, but also for editors. Perhaps now that it is on the Wiki itself, I can use colour coding and more advanced formatting to signify which pages need to be updated, after releases, for example, among other seemingly useful objectives. I'm thinking it would be a good way to physically see how much needs to be done, updated, or whatever the case might be - as far as specific template-based leaf pages would go (Equipment, Materials, etc...). I suppose you could call it a giant all-in-one checklist. I'm only including Items (Arsenal Items, to be exact) for now since they are the biggest issue.

Fri, 12/03/2010 - 15:09
#12
Pauling's picture
Pauling
Find a niche and run with it

Don't feel bad for getting excited- that's a good trait! Part of being a student is to expose yourself to new ideas and different ways of doing things, and expand the toolbox you use to approach any problem. (with many classes on the same topic, it's easy to get "tunnel vision") If you learned something new... you're doing it right.

My biggest advice on the wiki is to work on the things that haven't been done yet, and need doing: add category/subcategory labels to existing pages, mark "stub" articles that need working on, or fill in areas (like trinkets) where no pages yet exist. It's great that you're organizing all this info on your own (like your massive item listing), but by combining your efforts with others, you can help to create something larger than your work, and in turn benefit from the contributions of others. For example, I'm working on building and testing the various bombs, while others are working on finding out where items drop from, or posting the exact stats for swords and armor.

Fri, 12/03/2010 - 15:29
#13
Chronus
As soon as I finish the list...

Thanks. As soon as I finish the list (of which others should feel free to update and confirm things on their own), I was thinking of getting to work on the Trinkets since they don't even exist yet. That shouldn't be too much work, but my real challenge will be the template issue as I have barely any idea how to create/manage them. At least the Trinket template should be relatively simple compared to other ones, once I learn the how-to's.

Fri, 12/03/2010 - 16:50
#14
Shango
Legacy Username
Sorry for the trouble
Sorry for the trouble earlier, sometimes I just get a bit carried away with my "consistency" issues. Just as they say, with great power comes great responsibility.
- Chronus

It's quite alright, after all, I essentially did exactly the same thing by changing all the equipment pages to new layout and started making individual pages for items without asking anyone. I just got lucky and no one complained. :P

Powered by Drupal, an open source content management system