v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Editing Dwarf Fortress Wiki talk:Manual of Style

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.


The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
 
Discuss points of style, a few "threads" have been started to hit on some major issues. Please feel free to add new topics.
 
Discuss points of style, a few "threads" have been started to hit on some major issues. Please feel free to add new topics.
 
:Links to those threads would be helpful, since you're apparently referring to pre-existing discussions.--[[User:Albedo|Albedo]] 05:34, 3 April 2010 (UTC)
 
:Links to those threads would be helpful, since you're apparently referring to pre-existing discussions.--[[User:Albedo|Albedo]] 05:34, 3 April 2010 (UTC)
 
 
==Where to link a new page from?==
 
After a forum discussion here: http://www.bay12forums.com/smf/index.php?topic=84137.0, I decided my idea for a "Style Projects" category/page wasn't completely useless so I made a start of it: [[Style Project]]. Any thoughts? Where should it get linked from? I don't think the concept is in any way version specific. How should the page get categorized? Rated? There's a lot I don't know about starting a page. [[User:GhostDwemer|GhostDwemer]] 16:29, 14 May 2011 (UTC)
 
 
:Personally I'd say link it from [[DF2010:Design strategies]] under Aesthetics, and at the top if you want. If it's version independent then just put it in the main namespace and link to it from every version of the design strategies page. Then just look around the wiki and link to it from anywhere that seems appropriate. I don't think anyone cares too much... the only thing some people might care about is whether it needs to be linked from the main page and personally I'd say this is probably too narrow of a subject to be linked directly on the main page. As for categories, I usually look at how other pages are categorized. For example, Look at the Design strategies page and just copy it's category list if you find nothing else.
 
 
:So basically I'd say... look at the main page to see what articles linked directly from the main page might benefit from a link to your page. Then dig around elsewhere and add links from those pages. Copy the categories from the most applicable page and any other pages that seem like they might have reasonable categories. Basically you want people to find it easily when they're "drilling down" into the appropriate topics. Personally I'd say the more applicable pages you can find to link to it, the better. Like it might be worth linking to it from [[DF2010:Stupid dwarf trick]] --[[User:Ral|Ral]] 23:52, 14 May 2011 (UTC)
 
  
 
== Spelling ==
 
== Spelling ==
Line 64: Line 56:
 
:::::I'm confused on the "constants in 40d seem to have become variables" comment. Could you clarify please? --[[User:Soy|Soy]] 21:00, 7 April 2010 (UTC)
 
:::::I'm confused on the "constants in 40d seem to have become variables" comment. Could you clarify please? --[[User:Soy|Soy]] 21:00, 7 April 2010 (UTC)
 
::::::Re creatures? Did you play the prev version? There are only a few "constants" in a creature's template - most answer "what do you get when you butcher one?"  Used to be 100% predictable - now it seems highly ''un''predictable. Meat, fat - even bones. Look at any cv creature page - [[dragon]], for instance - see all those ? marks?  ''That's'' what I mean.--[[User:Albedo|Albedo]] 02:50, 8 April 2010 (UTC)
 
::::::Re creatures? Did you play the prev version? There are only a few "constants" in a creature's template - most answer "what do you get when you butcher one?"  Used to be 100% predictable - now it seems highly ''un''predictable. Meat, fat - even bones. Look at any cv creature page - [[dragon]], for instance - see all those ? marks?  ''That's'' what I mean.--[[User:Albedo|Albedo]] 02:50, 8 April 2010 (UTC)
:::::::That's what I wanted to clear up: you're talking about Template:CreatureInfo and I'm talking about [[Template:Creatures]]. I was thinking it would make sense to break it up into sub-templates for the categories contained in [[:Category:Creatures]] e.g.: one for humanoids, animals, megabeasts, etc. For Template:CreatureInfo (the one you were considering) it would be an extremely simple process to remove those static links and allow each editor to propagate them with whatever is appropriate, maybe even a range of numbers? I'm not really sure as I wasn't considering that particular area, sorry. --[[User:Soy|Soy]] 04:39, 8 April 2010 (UTC)
+
:::::::That's what I wanted to clear up: you're talking about [[Template:CreatureInfo]] and I'm talking about [[Template:Creatures]]. I was thinking it would make sense to break it up into sub-templates for the categories contained in [[:Category:Creatures]] e.g.: one for humanoids, animals, megabeasts, etc. For [[Template:CreatureInfo]] (the one you were considering) it would be an extremely simple process to remove those static links and allow each editor to propagate them with whatever is appropriate, maybe even a range of numbers? I'm not really sure as I wasn't considering that particular area, sorry. --[[User:Soy|Soy]] 04:39, 8 April 2010 (UTC)
 
:Oh - ''that!'' Yeah, no doubt - we'll need a new template, since the redirects go to diff creature articles. The style format should relate to how we present diff creature articles - the [[creature]] page is not to my satisfaction, and it's all inter-related. "Humanoids"? Aren't some animals half/half? In-game distinctions might be best, sim to how they're listed in the RAW's - "domestic animals" is one from 40d, and so on. Easier to list, too, since only one RAW file needs to be addressed at a time. Other approaches are certainly valid and possible.--[[User:Albedo|Albedo]] 18:52, 8 April 2010 (UTC)
 
:Oh - ''that!'' Yeah, no doubt - we'll need a new template, since the redirects go to diff creature articles. The style format should relate to how we present diff creature articles - the [[creature]] page is not to my satisfaction, and it's all inter-related. "Humanoids"? Aren't some animals half/half? In-game distinctions might be best, sim to how they're listed in the RAW's - "domestic animals" is one from 40d, and so on. Easier to list, too, since only one RAW file needs to be addressed at a time. Other approaches are certainly valid and possible.--[[User:Albedo|Albedo]] 18:52, 8 April 2010 (UTC)
  
Line 87: Line 79:
 
== Handling template breaking of redirects? ==
 
== Handling template breaking of redirects? ==
  
<s>How do we want to handle this? For example, [[Furnace Operator]] doesn't work; nor does [[pearlash]] - you have to use [[ash|pearlash]] to get it to go to the right place. Note that these examples don't work on this page; see [[40d:kiln]] for examples.</s> --[[User:Bombcar|Bombcar]] 17:56, 3 April 2010 (UTC)
+
<s>How do we want to handle this? For example, {{L|Furnace Operator}} doesn't work; nor does {{L|pearlash}} - you have to use {{L|ash|pearlash}} to get it to go to the right place. Note that these examples don't work on this page; see [[40d:kiln]] for examples.</s> --[[User:Bombcar|Bombcar]] 17:56, 3 April 2010 (UTC)
 
:''(This is not a style question - reposting on Current Events.)''--[[User:Albedo|Albedo]] 21:09, 3 April 2010 (UTC)
 
:''(This is not a style question - reposting on Current Events.)''--[[User:Albedo|Albedo]] 21:09, 3 April 2010 (UTC)
  
Line 141: Line 133:
  
 
:--[[User:Morlark|Morlark]]
 
:--[[User:Morlark|Morlark]]
 
: Shouldn't the capitalization reflect the capitalization of text in the game when referring directly to the game's interface? I would think the primary point of an article explaining game actions or interface is to make it as simple and clear as possible to the user. For example, the current page for Hot Keys is [[Hotkeys]], when it really should be [[Hot Keys]], since that's how it appears in the game. In some ways it's a proper noun, so any time you refer to the Hot Keys as a game object shouldn't it be capitalized exactly how the game has it?
 
 
:--[[User:Zetim|Zetim]]
 
 
::My opinion is that we should use normal English capitalization, as Mikaka described above. Terms are often capitalized in-game because they appear as standalone words in menus; that doesn't mean that they are proper nouns or that they should be capitalized in sentences. In fact, if you pull up the in-game help pages with {{k|?}}, they often follow this rule as well. Non-proper nouns like "metal", "profession", and "furnace" are only capitalized in section titles and links in lists, not in the middle of sentences. In essence, when referring to [https://dwarffortresswiki.org/index.php?title=DF2014:Plant_fiber&curid=32137&diff=258120&oldid=258119 this edit], I would agree with most of Silverwing235's changes. &mdash;[[User:Lethosor|<span style="color:#074">Lethosor</span>]] ([[User talk:Lethosor|<span style="color:#092">talk</span>]]) 17:07, 12 June 2021 (UTC)
 
  
 
== Footer ==
 
== Footer ==
Line 156: Line 142:
 
I have seen a bit of a conflict of plurals throughout the wiki. For example on the [[Military]] page in the "Current Reported Military-Related Bugs" section both terms are used in separate instances. From a grammatical standpoint both forms are correct plurals, but it seems a bit inconsistent to see them both used within a line or two of each other. Which is correct?
 
I have seen a bit of a conflict of plurals throughout the wiki. For example on the [[Military]] page in the "Current Reported Military-Related Bugs" section both terms are used in separate instances. From a grammatical standpoint both forms are correct plurals, but it seems a bit inconsistent to see them both used within a line or two of each other. Which is correct?
 
:Spellcheck might not think so, but every noun ending in one "f" (calf, leaf, wolf) has it's plural form ending with "ves" (calves, leaves, wolves). I would argue that ''"dwarves"'' is the correct way to write it. --[[User:DUMBELLS|dUMBELLS]] 00:49, 30 April 2011 (UTC)
 
:Spellcheck might not think so, but every noun ending in one "f" (calf, leaf, wolf) has it's plural form ending with "ves" (calves, leaves, wolves). I would argue that ''"dwarves"'' is the correct way to write it. --[[User:DUMBELLS|dUMBELLS]] 00:49, 30 April 2011 (UTC)
:Tolkien wrote it "dwarves" as do most fantasy authors. I don't think I've ever seen "dwarfs" anywhere but this wiki. I've actually been changing it to "dwarves" in any document I do any extensive editing in. Also, it is written "dwarves" in the game. --[[User:Ral|Ral]] 01:10, 30 April 2011 (UTC)
+
:Tolkien wrote it "dwarves" as do most fantasy authors. I don't think I've ever seen "dwarfs" anywhere but this wiki. I've actually been changing it to "dwarves" in any document I do any extensive editing in. --[[User:Ral|Ral]] 01:10, 30 April 2011 (UTC)
I do believe there is a growing tendency to differentiate between "dwarfs" (people suffering from dwarfism) and "dwarves" (fantasy race group). Even the Great Compendium of All Undisputed Knowledge (aka Wikipedia) mentions this in a footnote.
 
:As Ral mentioned, "[NAME:dwarf:'''dwarves''':dwarven]" - I'd say that's definitive enough. --[[User:Quietust|Quietust]] 02:39, 30 April 2011 (UTC)
 
 
 
== Labor pages side table suggestion ==
 
 
 
I think it would be immensely helpful to include in the side table on all labor-description pages what the associated skill's level actually affects - whether it is the quality of the resulting item/work, speed of completion, both, or whatnot.
 
 
 
I would gladly do so, but I have just begun playing DF - which is possibly why people longer affiliated with it may not even realize this is quite a big consideration for a potential reader of the wiki pages. Needless to say, but included for the sake of completion, I am not fully certain which labors fall under which aforementioned category.
 
 
 
--[[User:Sheepify|Sheepify]] 01:37, 30 April 2011 (UTC)
 
:I assume you're referring to '''Skill''' pages, since there are no labor pages (aside from Cleaning) for version 0.31.xx or even 40d (23a does have them, though, and I've been planning to create them for the sake of completeness). --[[User:Quietust|Quietust]] 02:38, 30 April 2011 (UTC)
 
:: The page at http://df.magmawiki.com/index.php/Labor
 
::With
 
 
 
::DF2010:Labor
 
::From Dwarf Fortress Wiki
 
::(Redirected from Labor)
 
 
 
::in caption.
 
 
 
::Decided to make an addition to the discussion, though my suckage at wikiediting is of the highest... Myeah.
 
::--[[User:Sheepify|Sheepify]] 03:12, 30 April 2011 (UTC)
 
::P.S. Hah. Yes. The '''Skill''' pages that the Labor page links to. I'm slow, but I get there... occasionally :D
 
 
 
== New layout and information included for the Workshop pages ==
 
 
 
The workshop pages don't include any description of what the orders actually accomplish, or, for that matter, what is required to accomplish a specific task. This is most problematic for the Farmer's Workshop. In order to find out what each of the orders do, you have to click on the related labors listed at the top of the page. There is no indication that those links will tell you what the orders do. I'd like to propose a new layout for the Workshop pages, and then implement that across the board.
 
 
 
There is a workshop template on the right of every page, but it doesn't cover the actions in enough detail for new users. This is acceptable in some workshops, like Carpenter's Workshop, where everything is pretty straight-forward. You don't need a descriptive line of text underneath "Make wooden barrel" saying "This requires one piece of wood and produces a wooden barrel." In Farmer's Workshop, however, you DO need a line under "Process Plants (to barrel)" that tells you that this means you'll be making dwarven syrup, you'll need some sweet pods and an empty barrel. Or for "Process Plants (to bag)," which means that you'll need an empty bag, Quarry Bushes, and end up with Quarry Bush Leaves, a Rock nut, and that the bag will be filled with the Leaves, and can then be stored in a barrel.
 
 
 
So can I whip up a new format (possibly using tables) for the workshops and try it out? Who's in charge around here? ;)
 
 
 
Oh, and what brought me to this conclusion was that I'm relatively new to DF, and the most logical thing for me to do as a new player was to look at all the fun workshops I could make, and see what they did. The Workshop articles had me bouncing around the wiki too much. And my background is in information design and visual communications. So, hello!
 
 
 
Looking forward to input. [[User:Darchitect|Darchitect]] 23:15, 23 February 2012 (UTC)Darchitect
 
 
 
== Suggestion: Add entity raws to civilized creature pages ==
 
 
 
We already have the creature raws on each page. Why not add the entity raws for the applicable creatures, namely <s>Dwarfs</s> <s>Dwarves</s> [http://valarguild.org/varda/Tolkien/encyc/articles/d/dwarves/dwarfpluralof.htm Dwarrows], Elves, Humans, Goblins, Kobolds. All animal people civs use the same raws, so for them it may be better to create a seperate [[Animal Peoples]] page. [[User:Monkeyfetus|Monkeyfetus]] 01:52, 1 March 2012 (UTC)
 
 
 
== <nowiki>{{av}}</nowiki> template placement (and general article layout/order) ==
 
 
 
Not all templates place the <code><nowiki>{{av}}</nowiki></code> template at the top of the article, leading to an inconsistent look. Example: [[DF2012:Ivory]] vs [[DF2012:Animal caretaker]].
 
Which should we use?
 
 
 
In my opinion, articles look best with the av template above any notice boxes. This also prevents the version box from jumping around if another version didn't have a notice box. My proposal:
 
 
 
# First, include the quality template (usually automatic). This prevents a layout problem.
 
# Include the av template, if applicable. [[Dwarf_Fortress_Wiki:Community_portal|Some]] pages don't need it.
 
# Include any notice boxes, like [[Template:Image rules notice]], [[Template:buggy]], [[Template:old]], etc
 
# Include content
 
# Categories (probably doesn't matter, since placement is irrelevant)
 
 
 
--[[User:Lethosor|Lethosor]] ([[User_talk:Lethosor|talk]]) 02:11, 13 February 2013 (UTC)
 
 
 
== List of useful templates / new editor help? ==
 
 
 
Are there such things? As a somewhat experienced wiki editor, I'm mostly interested in the specific templates used around this wiki and their documentation. I already found out about [[Template:RT]] and its various subtemplates. Are there any templates for inserting large DF tile maps, formatted simply with <nowiki><pre></nowiki> instead of wikitables? Like in [[DF2012:Exploratory_mining]], for example. -[[Special:Contributions/91.156.198.36|91.156.198.36]] 10:07, 20 April 2013 (UTC)
 
 
 
:I was looking to correct the formatting on some misaligned text maps (like [[Workshop_design#3x3_rooms]]'s second example), but it looks like it should be triggering <nowiki><pre></nowiki> formatting already because of the leading space. Is there some other magic I should employ?--[[User:Subjunctive|Subjunctive]] ([[User talk:Subjunctive|talk]]) 00:42, 26 June 2014 (UTC)
 
 
 
::Actually, it might be a font issue for the high-ASCII characters on iPhone. That would be annoying!-[[User:Subjunctive|Subjunctive]] ([[User talk:Subjunctive|talk]]) 00:47, 26 June 2014 (UTC)
 
 
 
:::They look properly-aligned to me (not on mobile), but I'll change them to use diagrams instead. &mdash;[[User:Lethosor|<span style="color:#074">Lethosor</span>]] ([[User talk:Lethosor|<span style="color:#092">talk</span>]]) 00:55, 26 June 2014 (UTC)
 
 
 
::::Yeah, just discovered <nowiki><diagram></nowiki>. I'll see about converting all the ones I can find.-[[User:Subjunctive|Subjunctive]] ([[User talk:Subjunctive|talk]]) 01:22, 26 June 2014 (UTC)
 
 
 
== DF community vernacular (fun): clarity of use? ==
 
 
 
I was editing an article recently, and there were many repeated references to doing things that were 'fun'. The first reference was linked to the wikipedia article on the community vernacular use of the term, but it was a long article and I would expect many new players looking for information to skip to a later section covering what they were looking for. I assume it is wiki policy not to link every repeated reference in an article. This did leave me wondering if new players might actually think an article might be suggesting a course of action that was litterally fun, in the mainstream sense, rather than a catastrophic, fort-ending decision.
 
 
 
Might it be a good idea to intorduce an editing style that makes it clearer when 'fun' is being used in the traditional sense, or in the DF community sense, as is the case with '!!SCIENCE!!'? E.g. 'FUN' or 'fun!'. [[User:Alpacalypse|Alpacalypse]] ([[User talk:Alpacalypse|talk]]) 18:44, 11 February 2023 (UTC)
 
 
 
:Upon reflection, it appears that there isn't a clear 'no multiple-linking' editing convention. If so, maybe the simplest approach to this would be just to link 'fun' to that page whenever it is being used in the vernacular sense. [[User:Alpacalypse|Alpacalypse]] ([[User talk:Alpacalypse|talk]]) 19:20, 11 February 2023 (UTC)
 
 
 
:For reference: a good example of where this might be misleading to new players is the [[necromancer]] page.<br>There is no link to the "losing is [[losing|fun]]" page, despite the word being mention 4 times in three different sections. Although, from context, it might seem obvious that fun means dangerous/challenging; newer players are unlikely to know this DF vernacular. If nothing else, it doesn't seem like best practice stylistically, outside of a '''D for Dwarf''' section. [[User:Alpacalypse|Alpacalypse]] ([[User talk:Alpacalypse|talk]]) 16:11, 10 March 2023 (UTC)
 

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

Please sign comments with ~~~~

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)