|
|
| Line 1: |
Line 1: |
| Hey all. With the imminent release of ''[[Halo: Shadows of Reach]]'', ''[[Halo Infinite]]'' and whatever else ends up being announced soon, we're going to soon have a myriad of new info to add to the site. In this light, now seems like a good time to formally introduce the new sourcing system we've been working on (and by we, I mainly mean [[User:Dab1001|Dab1001]], who is responsible for all of the implementation of the following).
| | Deleted material, cut content or "the cutting room floor" refers to content created during the development of a game, film, book or other media and ultimately removed from the product before release. This can be done for a variety of reasons including simple issues such as time and technical limitations or more niche reasons such as needs for page formatting - in the case of a book. This page covers a standard of guidelines for writing articles about cut content on Halopedia. |
|
| |
|
| The new system we're working with is designed to do several things to improve on the standard <nowiki><ref></nowiki> tags you're no-doubt familiar with as standard on most wikis. In no particular order, this system is designed to be easier, quicker, more consistent and futureproof. For a detailed explanation, see below.
| | ==Does it need a page?== |
| | When creating a cut content article, first ask if the content in question ''needs'' a new page? Can it be covered in sufficient detail on an existing page's production notes section? For example, the article [[Guardian Forest]] discusses a lot of in-depth development information on the cut level, while a detail such as the [[:File:HReach-M392-DMR-Profile.png|Armalite logo]] found on an early rendition of the [[M392 DMR]] found in ''[[Halo: Reach]]'' can be easily surmised in a sentence or two on the page's production notes section. |
|
| |
|
| ==Overview== | | ==Cut content vs. concept art== |
| If you're familiar with using infobox templates already, the new sourcing system should come naturally to you. For a general jist, referencing works now by using a template to handle all layout, formatting and so forth of references - the only information you need to input is a link, a page name, chapter number or level. All bold and italic text, hyperlinking and placement of information is handled for you. As such, instead of having to write out;
| | A common misconception that often arises in fanbases is the nature of cut content vs. concept art. In media production, thousands of conceptual images are produced by dozens of concept artists over a multi-year period. At the beginning of a production, many of these concepts are simply sketches or quick paintings done to establish art direction, mood, tone, atmosphere and convey key aspects of the game's visuals. In this stage, illustrations may feature armour, weapons, vehicles and characters which do not appear in the final game - it is important to distinguish these elements from actual cut content. In these cases, these elements were likely never intended to make it into the final product, and wouldn't count as cut content due to having never been ''cut''. |
| :<code><nowiki><ref name="H5MeridianStation">''[[Halo 5: Guardians]]'', campaign level [[Meridian Station]]</ref></nowiki></code>
| |
| To render<ref name="H5MeridianStation1">''[[Halo 5: Guardians]]'', campaign level [[Meridian Station]]</ref>, you simply have to write;
| |
| :<code><nowiki>{{Ref/Level|Id=H5MeridianStation|H5G|Meridian Station}}</nowiki></code>
| |
| To render this.{{Ref/Level|Id=H5MeridianStation|H5G|Meridian Station}} Both methods produce the same outcome to the end reader, but the second option ensures that all citations use the exact same formatting and placement order for text and information, as a result making our pages look cleaner and more organised. For example, compare [[Guardian Forest|this page's]] reference section versus the one seen on [https://www.halopedia.org/index.php?title=United_Nations_Space_Command&oldid=1372609 this] revision of the UNSC page. With multiple editors employing slightly different styles for how references are formatted, things look messy - something this new system avoids entirely! Additionally, by using a lot of automation, we can ensure that reference formatting styles can be easily updated across the site in the future by updating the source template alone or using bots - something that massively helps with making the site as a whole adaptable for the future.
| |
|
| |
|
| If the stuff I've just written seems confusing or intimidating, that's fine. Below is written a deep-dive into some different referencing scenarios and what you'd do, but it doesn't cover anything. If you get stuck with anything, feel free to message me [[User talk:BaconShelf|here]], on the [[Halopedia:Discord Server|Discord server]] or in this thread and I'll get back to you as soon as possible.
| | In general, a good way to distinguish cut content is to consider whether any 3D assets, physical props, animations or footage exists of the content in question - or if it has been discussed in any capacity via interviews. |
| | |
| <code><nowiki>
| |
| | |
| </nowiki></code>
| |
| | |
| | |
| ==The crunch==
| |
| As explained prior, referencing is handled now via a template, the root of which can be found at [[Template:Ref]]. You may notice I said ''root'', that's because I lied. It's not a template, it's a system of several templates. Due to how many types of references we may want to do, we can't fit everything into one template, so it's broken into several specialist ones - luckily, they're all listed in the link I just provided. Additionally, typing <code><nowiki>{{Ref/</nowiki></code> in your wikitext editor will bring up a list of them in a little drop down menu, so you don't need to remember them all.
| |
| | |
| Some of the most common scenarios are listed below.
| |
| | |
| ===Referencing webpages===
| |
| This section covers referencing websites. In general, the method for referencing a webpage is fairly standard, and we have some nifty tools to make sure that even deadlinks are workable via the automatic generation of Archive.org links. To use an example, take the example at the end of this sentence.{{Ref/Site|Id=CFRaven|URL=https://www.halowaypoint.com/en-us/news/thats-so-raven|Site=Halo Waypoint|Page=Canon Fodder - That's So Raven|D=04|M=4|Y=2021}}
| |
| | |
| | |
| Here's how this is broken down;
| |
| <nowiki>{{Ref/Site
| |
| |Id=CFRaven - (This parameter is the name we want to store in case we want to reuse this reference - see the Reusing Citations section below)
| |
| |URL=https://www.halowaypoint.com/en-us/news/thats-so-raven - (The URL of the webpage we want to link to)
| |
| |Site=Halo Waypoint - (The name of the website hosting the article such as Bungie.net, Halo Waypoint, IGN, Gamespot etc..)
| |
| |Page=Canon Fodder - That's So Raven - (The name of the article being linked to)
| |
| |D=04 - (The day you are writing the article; most be two digits)
| |
| |M=4 - (The month you are writing the article)
| |
| |Y=2021 - (The year you are writing the article)
| |
| }}
| |
| </nowiki>
| |
| | |
| In this case, the <code>|D=|M=|Y=</code> parameters are there to provide date information to the template, allowing it to generate a link to Archive.org and the {{C|Retrieved on...}} text. This means that if the article being referenced is on a website that has since gone down, an auto-generated webarchive link will be provided without any input needed on the part of the user!
| |
| | |
| There are some other options available for citing websites such as quotations; these additional optional parameters are covered in the [[Template:Ref/Site|Ref/Site]] documentation. We also have some other templates for citing web media including [[Template:Ref/YouTube|Ref/YouTube]] and [[Template:Ref/Twitter|Ref/Twitter]].
| |
| | |
| ===Referencing media===
| |
| This section covers the most common referencing you'll likely do; books, novels, comics, games and such. In general, referencing of these media forms all follows the same basic idea, with some slight changes depending on what exactly you're doing. For example, take this reference;{{Ref/Novel|Id=HO15|Oblv|Chapter=15|Page=123-124}}
| |
| | |
| Here's now this reference is broken down, with accompanying notes in brackets to explain what's what.
| |
| | |
| <nowiki>{{Ref/Novel - (The specific reference template we want to use to cite this media)
| |
| |Id=HO15 - (This parameter is the name we want to store in case we want to reuse this reference - see the Reusing Citations section below)
| |
| |Oblv - (This is an Acronym that allows us to call this media title easily. See the Acronyms section below)
| |
| |Chapter=15 - (Should be self-explanatory - place your chapter number here)
| |
| |Page=123-124 - (Should be self-explanatory - place your page number(s) here. In general for novels, we prefer chapter numbers over page ones though.)
| |
| }}</nowiki>
| |
| | |
| Depending on circumstance, you'll need a different referencing template. For referencing novels, you'd use [[Template:Ref/Novel|Ref/Novel]]. For reference books (IE ''Warfleet'' or the EVGs) you'd use [[Template:Ref/Book|Ref/Book]], for comics [[Template:Ref/Comic|Ref/Comic]] and so forth - you get the idea. Notably, we have several for games including [[Template:Ref/Level|campaign levels]], [[Template:Ref/Map|Multiplayer maps]], [[Template:Ref/Mode|gamemodes]] and a generic [[Template:Ref/Game|Ref/Game]] for misc. info. Below, I'll cover some scenarios so you can get an idea of how to use these templates.
| |
| | |
| One important thing to note is that when referencing novels, Halopedia always prefers the use of simple chapter numbers over specific page numbers. Due to the prevalance of dozens of reissues of some books across the world and the growing presence of digital releases, managing page numbers is simply infeasible, whereas chapters are universal. When referencing hardback reference books, page numbers are still perfectly fine.
| |
| | |
| ====Acronyms====
| |
| As mentioned above, Acronyms are a system developed to make referencing media quicker than easier. As seen in the example used in the Overview section, this system essentially allows you to be <s>lazy</s>-efficient. Instead of having to write out particularly long source names such as ''Halo 5: Guardians'' or ''Halo 4: Forward Unto Dawn'', this system simply allows you to type in the acronym of the appropriate media and the automation handles the rest. For example, typing out <code>H5G</code> will automatically translate to the reference displaying ''[[Halo 5: Guardians]]''.
| |
| | |
| Pretty simple right? For a full list of all (and I do mean ''all'') supported acronyms, see [[Halopedia:Acronyms]]. It's a very comprehensive list.
| |
| | |
| ===Reusing citations===
| |
| Often times, you'll want to use the same citation to reference multiple pieces of information because you're a civilised person and understand the benefit of calling the same variable several times. As touched on above, this is handled easily in the new templates system. As a recap, how you're used to reusing citations right now is by typing out something like <code><nowiki><ref name="HO15"></nowiki></code>.
| |
| | |
| In the new system, all reference templates have a field called <code>Id=</code>. This works exactly the same way as our <code>name=</code>, except you type the name ''without'' quotation marks. To go back to our ''Halo: Oblivion'' citation{{Ref/Reuse|HO15}}, what we've got here in our field is this field; <code>|Id=HO15</code>
| |
| | |
| If we want to call the ''Halo: Oblivion'' citation later, all we need to use is following; <code><nowiki>{{Ref/Reuse|HO15}}</nowiki></code>. I'm not sure if there's much that needs explaining here - you simply add the tag of the reference you wish to call in the field.
| |
| | |
| ===Notes===
| |
| To create a note for a specific text, simply type in <code><nowiki>{{Ref/Note|Your Text Here!}}</nowiki></code> to generate the following;{{Ref/Note|Your Text Here!}}
| |
| | |
| To display notes the bottom of the article, simply enter the template <code><nowiki>{{Ref/Notes}}</nowiki></code>. Doing so will list all notes using the aforementioned notes template.
| |
| {{Ref/Notes}}
| |
| | |
| ===Citation lists===
| |
| To add a list of sources, you're likely used to typing out <code><nowiki><references/></nowiki></code> at the bottom of articles. This one is a pretty simple chance, as where you would type <code><nowiki><references/></nowiki></code> you now simply use the <code><nowiki>{{Ref/Sources}}</nowiki></code> tag. This is done so that we can customise reference list stylings consistently, should we need to. Typing <code><nowiki>{{Ref/Sources}}</nowiki></code> still gives you the below list;
| |
| {{Ref/Sources}}
| |
| | |
| {{Ref/Sources|2}}
| |
| | |
| ===Worked examples===
| |
| The below table covers a large variety of referencing scenarios for various forms of media. If you're stuck, try copying one of the below codes and replacing the information!
| |
| | |
| ====Games====
| |
| The below section covers referencing any game-related element. All quote and detail parameters are shared across all of these templates.
| |
| {| class="wikitable" width="75%"
| |
| ! Type of reference !! Wikitext !! What you see !! Reference template used
| |
| |-
| |
| | Generic game || <code><nowiki>{{Ref/Game|HFR|Detail=Ava Lang in-game model}}</nowiki></code> || {{Ref/Game|HFR|Detail=Ava Lang in-game model}} || [[Template:Ref/Game|Ref/Game]]
| |
| |-
| |
| | Campaign level || <code><nowiki>{{Ref/Level|H3ODST|Mombasa Streets}}</nowiki></code> || {{Ref/Level|H3ODST|Mombasa Streets}} || [[Template:Ref/Level|Ref/Level]]
| |
| |-
| |
| | Campaign level, in which the Halopedia article name does not match up with the level name || <code><nowiki>{{Ref/Level|HR|The Pillar of Autumn (Halo: Reach level)|The Pillar of Autumn}}</nowiki></code> || {{Ref/Level|HR|The Pillar of Autumn (Halo: Reach level)|The Pillar of Autumn}} || [[Template:Ref/Level|Ref/Level]]
| |
| |-
| |
| | Campaign level dialogue quote || <code><nowiki>{{Ref/Level|H2|Metropolis|Quote=This here is sixty-six tons of straight up, H-E-spewing dee-vine intervention!|Quotee=Avery Johnson}}</nowiki></code> || {{Ref/Level|H2|Metropolis|Quote=This here is sixty-six tons of straight up, H-E-spewing dee-vine intervention!|Quotee=Avery Johnson}} || [[Template:Ref/Level|Ref/Level]]
| |
| |-
| |
| | Multiplayer map || <code><nowiki>{{Ref/Map|HW|Beasley's Plateau}}</nowiki></code> || {{Ref/Map|HW|Beasley's Plateau}} || [[Template:Ref/Map|Ref/Map]]
| |
| |-
| |
| | Multiplayer map specific detail || <code><nowiki>{{Ref/Map|HCE|Blood Gulch|Detail=Red base Forerunner symbols}}</nowiki></code> || {{Ref/Map|HCE|Blood Gulch|Detail=Red base Forerunner symbols}} || [[Template:Ref/Map|Ref/Map]]
| |
| |-
| |
| | Firefight map || <code><nowiki>{{Ref/FFMap|HW2|The Last Bastion}}</nowiki></code> || {{Ref/FFMap|HW2|The Last Bastion}} || [[Template:Ref/FFMap|Ref/FFMap]]
| |
| |-
| |
| | Spartan Ops level || <code><nowiki>{{Ref/SpOps|Catherine|Shootout in Valhalla}}</nowiki></code> || {{Ref/SpOps|Catherine|Shootout in Valhalla}} || [[Template:Ref/SpOps|Ref/SpOps]]
| |
| |-
| |
| | Specific gametype || <code><nowiki>{{Ref/Mode|H4|Flood (gametype)|Flood|Detail=Infected Spartan in-game model}}</nowiki></code> || {{Ref/Mode|H4|Flood (gametype)|Flood|Detail=Infected Spartan in-game model}} || [[Template:Ref/Mode|Ref/Mode]]
| |
| |}
| |
| | |
| ====Books, comics and other print media====
| |
| The below section covers referencing any print-related element including novels, short stories, anthology collections, comics and reference books. All specific quote and detail parameters are done in the same way as the game examples above.
| |
| {| class="wikitable" width="75%"
| |
| ! Type of reference !! Wikitext !! What you see !! Reference template used
| |
| |-
| |
| | Novel chapter citation || <code><nowiki>{{Ref/Novel|TFOR|Chapter=22}}</nowiki></code> || {{Ref/Novel|TFOR|Chapter=22}} || [[Template:Ref/Novel|Ref/Novel]]
| |
| |-
| |
| | Reference book page || <code><nowiki>{{Ref/Book|Id=WF38|HWF|Section=Frigates|Page=38-39}}</nowiki></code> || {{Ref/Book|Id=WF38|HWF|Section=Frigates|Page=38-39}} || [[Template:Ref/Book|Ref/Book]]
| |
| |-
| |
| | Anthology short story || <code><nowiki>{{Ref/Anthology|Id=MonaLisa|Evo|Story=The Mona Lisa}}</nowiki></code> || {{Ref/Anthology|Id=MonaLisa|Evo|Story=The Mona Lisa}} || [[Template:Ref/Anthology|Ref/Anthology]]
| |
| |-
| |
| | Comic series issue || <code><nowiki>{{Ref/Comic|HE|Issue=17}}</nowiki></code> || {{Ref/Comic|HE|Issue=17}} || [[Template:Ref/Comic|Ref/Comic]]
| |
| |-
| |
| | Comic anthology story || <code><nowiki>{{Ref/Comic|HGN|Story=Breaking Quarantine}}</nowiki></code> || {{Ref/Comic|HGN|Story=Breaking Quarantine}} || [[Template:Ref/Comic|Ref/Comic]]
| |
| |}
| |
| | |
| ====Web-based citations====
| |
| The below section covers referencing any website, YouTube video or Twitter post. To easily write a Twitter citation, simply copy and paste the individual tweet URL, then delete all the information except the poster's username and the ID number at the end, then simply add the rest of the information as needed.
| |
| {| class="wikitable" width="75%"
| |
| ! Type of reference !! Wikitext !! What you see !! Reference template used
| |
| |-
| |
| | Webpage citation || <code><nowiki>{{Ref/Novel|Id=TFOR27|TFOR|Chapter=27}}{{Ref/Site|Id=CFLocalUnits|URL=https://www.halowaypoint.com/en-us/news/canon-fodder-local-units|Site=Halo Waypoint|Page=Canon Fodder - Local Units|D=19|M=3|Y=2021}}</nowiki></code> || {{Ref/Site|Id=CFLocalUnits|URL=https://www.halowaypoint.com/en-us/news/canon-fodder-local-units|Site=Halo Waypoint|Page=Canon Fodder - Local Units|D=19|M=3|Y=2021}} || [[Template:Ref/Site|Ref/Site]]
| |
| |-
| |
| | Twitter post || <code><nowiki>{{Ref/Twitter|Id=TwitterDLC1|zaphodgjd|727601612441559045|Graeme Devine|Y=2020|M=10|D=19|Quote=Found this old @halowarss email today with story ideas for the DLC expansion.}}</nowiki></code> || {{Ref/Twitter|Id=TwitterDLC1|zaphodgjd|727601612441559045|Graeme Devine|Quote=Found this old @halowarss email today with story ideas for the DLC expansion.|D=19|M=10|Y=2020}} || [[Template:Ref/Twitter|Ref/Twitter]]
| |
| |-
| |
| | YouTube video || <code><nowiki>{{Ref/YouTube|Id=H2CE|DWI7AhQFpTE|Bungie|Cutting Room Floor Weapons Vehicles and Characters|Y=2020|M=12|D=17|Detail=Official Bungie upload of the BTS video from the ''Halo 2'' Collector's Edition}}</nowiki></code> || {{Ref/YouTube|Id=H2CE|DWI7AhQFpTE|Bungie|Cutting Room Floor Weapons Vehicles and Characters|Y=2020|M=12|D=17|Detail=Official Bungie upload of the BTS video from the ''Halo 2'' Collector's Edition}} || [[Template:Ref/YouTube|Ref/YouTube]]
| |
| |-
| |
| | YouTube video with timestamp || <code><nowiki>{{Ref/YouTube|D=01|M=6|Y=2020|9BURsPjNKck|Time=3132|Channel=IGN|VideoName=Ex-Bungie Dev Shares Halo 2 Stories - Podcast Unlocked|Detail=52:12}}</nowiki></code> || {{Ref/YouTube|D=01|M=6|Y=2020|9BURsPjNKck|Time=3132|Channel=IGN|VideoName=Ex-Bungie Dev Shares Halo 2 Stories - Podcast Unlocked|Detail=52:12}} || [[Template:Ref/YouTube|Ref/YouTube]]
| |
| |}
| |
| | |
| ===Sources===
| |
| {{Ref/Sources}}
| |
