Automoderated users, Autopatrolled users, Bureaucrats, Comment administrators, Confirmed users, Moderators, Rollbackers, Administrators
213,357
edits
All The Tropes:Style Guide: Difference between revisions
→Internal Links (Wicks)
Looney Toons (talk | contribs) (→Adding Tropes to Works: expanded a ref note a little) |
|||
| (5 intermediate revisions by one other user not shown) | |||
Line 22:
Please also use italics, not all-caps, for emphasis. Since the days of [[UseNet]], all-caps has meant "shouting" on the 'net, and most people avoid shouting in casual conversation.
Also, be aware that we have a number of templates used to insert standard markup into trope pages, like the examples and tropelist banners and the top-of-page elements specific to the various page types. Many of these will be automatically inserted into pages created in the Trope Workshop or with the ATT Page creator, but there are others which you can use to add features to your pages which will automatically conform to this guide. If you want to find out more about these, and learn what other templates might be available to you, see our page [[All The Tropes:Our Custom Templates]].
=== Adding Examples to Tropes ===
Line 100 ⟶ 102:
Potholing ''part'' of a word is an accessibility sin, especially if different parts of the same word are potholed to different links. Not only is it difficult for somebody with less-than-perfect motor control to select a small target link in the middle of other links, it looks bad in the default wiki interface because the wiki flags external links. Multiple external links in a single word can make the word [https://www.example.com un][https://www.example.org read][https://www.example.net a][https://www.example.com ble], so don't do it.
Finally, '''don't link to TV Tropes for ''any'' reason'''. Some of the staff there still go into frothing apoplexy at the very thought of All The Tropes' mere existence, and we don't want to stress the poor dears any more than they already are. If we absolutely need to link to TV Tropes (such as on the work page for that site), a mod has already done so. If you want to list a trope they have and we don't, which you think is absolutely indispensable, create your own version of it in the [[:Category:Trope Workshop|Trope Workshop]] and link to ''that'' when it passes muster. And ''don't'' link to a TV Tropes page because you can't be bothered to find the page here because it's been renamed or we've capitalized or punctuated it differently.<ref>Don't laugh. This has happened.</ref>
== Internal Links (Wicks) ==
Line 107 ⟶ 109:
That said, when it comes to links to other pages on the wiki, the guidelines are a little different -- and for the most part, looser, mainly because you can't make an internal link quite as confusing or unintelligible as an external link can be without really ''working'' at it.<ref>No, that is not a challenge.</ref>
The only real style requirements exist for work names. Wherever possible, the first occurrence of a work name in an example or a description should also be a link. This requires that you use the name of a work as it appears on the work page, matching punctuation and capitalization exactly. That's usually not to hard to determine -- if you don't already know it off the top of your head, you can use the wiki's search function to find it. (However, always click through a search result. You may have found a disambiguation or franchise page or a redirect and not the actual work page; clicking through will make sure you get to the right name, eventually.)
Once you have the right name, insert it into your edit with the appropriate markup. Right off the bat, of course, it should be in link markup, as described above. Of course, we don't have a page for every existing work on the wiki. But even if there isn't a page for it here, we still want the work name to be a link -- it might inspire another troper to write that page. So even if you can't find a page, mark up the work name as a link anyway.
Line 113 ⟶ 115:
Most work names should then be put italics markup (two single quotes/apostrophes before and after the link markup). There are exceptions to this -- short stories, individual songs, and other short-format works get double quotes instead of italics -- but in general italics are a safe choice.
Sometimes you might think it's necessary (or more attractive) to use a pothole with a work name. For instance, the ''[[The Hitchhiker's Guide to the Galaxy]]'' novels are all described on subpages under [[The Hitchhiker's Guide to the Galaxy]], like ''[[The Hitchhiker's Guide to the Galaxy/So Long, And Thanks For All The Fish]]''; potholing that link to ''[[The Hitchhiker's Guide to the Galaxy/So Long, And Thanks For All The Fish|So Long, And Thanks For All The Fish]]'' just looks better. Go ahead and do that. Just be careful not to misspell or otherwise mangle the work name in the pothole. And once more, if you're not sure how to code a pothole, the markup is <code><nowiki>[[link|pothole text]]</nowiki></code> -- the link, a vertical bar, and then the text you want to have go to that link.
Again, [[Pothole]]s are good, while [[sinkhole]]s are bad. Potholes and Sinkholes where different parts of ''the same word'' link to different pages are horrid - there's no way for a casual reader to know (or even suspect) that there's more than one link in the word. Unless you happen to take advantage of the wiki's color-coded internal links, but then it looks [[It Gets Worse|rid]][[From Bad to Worse|icul]][[It Got Worse|ous.]] It's also an [http://blogaccessibility.com/sin-2-of-inaccessible-blogs-using-consecutive-one-worded-links/ accessibility sin].
Line 139 ⟶ 141:
** Punctuation and other symbols (#, @, etc.) that appear after the first character come after the space but before numerals.
* Numerals (0-9) come after symbols and before letters.
* It should go without saying, but the order is ''not'' case-sensitive. "AA" comes before "ab"; "aa" comes before "AB".<ref>The Windows application "Notepad++"
* Finally, ignore leading articles ("a", "an" and "the"). This means [[The Cape (trope)]] will sort between [[Can't Argue with Elves]] and [[Car Bomb]].
| |||