Wiki:Page Structure/Puzzles: Difference between revisions
(→Example: Removing transclusion as it messes up categories and the like) Tag: 2017 source edit |
(don't include suppresstitle when importing from boilerplate) |
||
| (23 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{Infobox puzzle |
|||
The guide depicts the standard format for all puzzle pages currently on and to be added to this wiki. While some puzzles may require additional information, or reduced coverage in the described areas, we recommend future page creators begin with the following as a base. |
|||
|title = Puzzle Title |
|||
|hunt = Hunt Title |
|||
|round = Round Title |
|||
|image = <!-- Should start with File: --> |
|||
|image_width = <!-- include "px", defaults to 200px --> |
|||
|image_caption = |
|||
|author = <!-- If there are multiple authors, please also fill out author1, author2, ... fields with individual authors --> |
|||
|answer = <!-- All caps --> |
|||
|solves = |
|||
|guesses = <!-- total (correct and incorrect) --> |
|||
|link = <!-- puzzle link, these should all be plain URLs --> |
|||
|solution_link = |
|||
|checker_link = |
|||
|stats_link = |
|||
<noinclude>|suppresstitle = yes <!-- DELETE THIS LINE FOR ACTUAL PUZZLE PAGES --></noinclude> |
|||
}} |
|||
The introductory section of the article should include the '''Puzzle Name''' in bold, along with the following information: |
|||
* General puzzle type (Word? Logic? Etc.) |
|||
* [[Round Name]] |
|||
* [[Hunt Name]] |
|||
* A visual description of the puzzle, particularly any notable creative decisions (Is it presented as a series of images of Trebuchets? Is the page just blank?). |
|||
A brief, non-spoilery description of the puzzle may be included, if it is possible to discuss the puzzle without spoiling it. Think of this like a blurb for a novel; a successful one intrigues the reader without spoiling the plot. |
|||
| ⚫ | |||
Each puzzle is to be created as a subpage within a Hunt page (see [[Wiki_talk:Style_Guide#Request_for_comment:_Titling_puzzle_and_round_pages|here]] for discussions) and contains the following default layout: |
|||
== |
== Infobox == |
||
The infoboxes on puzzle pages should contain the following information: |
|||
[[Template:Infobox puzzle]] must be used at the top of each puzzle page in order to provide a standardised Infobox and categorisation of puzzle information. |
|||
* Puzzle, Round, and Hunt Title |
|||
===Opening Notes=== |
|||
* A relevant image to the puzzle (if applicable) and a descriptive caption |
|||
The opening sentence(s) for a puzzle page should introduce the puzzle as concisely as possible. For example: |
|||
** Note: Puzzle images will need to be uploaded to the wiki, so avoid spoiler-y images. |
|||
* The author(s') name(s) |
|||
** If there are multiple authors, also fill in the author1=, author2=, ... fields. Otherwise the page will go into a category containing all of the author names, rather than make a category for each author. There is a maximum of 9 authors allowed; add any additional authors beyond 9 manually (which should happen fairly rarely) |
|||
* The answer to the puzzle in all-caps |
|||
* The number of solves and guesses a puzzle had (if available) |
|||
* A link to the puzzle page, solution page, answer checker page (if separate from puzzle page), and statistics page (if available) |
|||
If the template used on this page is copied from the source onto any new pages and the notes are followed, the information filled in should be automatically formatted correctly. |
|||
'''[Puzzle Name]''' is a <code><nowiki>[[Puzzle Type]]</nowiki></code> from the <code><nowiki>[[../Round|Round name]]</nowiki></code> of <code><nowiki>[[Hunt]]</nowiki></code>. <Brief 1-2 sentence description of visual presentation and/or mechanics> |
|||
| ⚫ | |||
''Note:'' Ensure that the Round is specified in relative terms (i.e. with a leading "../" and a piped display name) to ensure robustness of intrawiki links. |
|||
'''NOTE:''' This section is optional. While it's up to the author whether or not they write a solve path, solve paths are best written for puzzles that fit one of the following criteria: |
|||
* The puzzle does not have a solution page available, or the provided solution page is lacking in sufficient detail. |
|||
* The puzzle requires many step-by-step deductions, such as minimetas or certain instruction-following puzzles. |
|||
* The puzzle contains red herrings or other information that would not otherwise be covered in the element list. |
|||
This section should be mostly spoiler-tagged, aside from surface observations about the puzzle itself that do not contribute to the solution. Things like "This puzzle is presented as series of circular grids", or "The clues are separated into two columns labelled BINGO and BONGO." |
|||
| ⚫ | |||
Solve Paths are an attempt to replicate the order of operations made by an actual solver. These are distinct, and should differ materially, from official puzzle solutions which are often written exclusively from the perspective of the author (and which are already linked via the puzzle infobox). |
|||
After that, use the following spoiler tag system... |
|||
While official solutions obviously provide useful reference material, solve paths deliberately place more emphasis on the information, clues or deductions pertinent to a solver's understanding of the puzzle. |
|||
{{spoiler|label=Solve Path}} to hide the majority of your solve path (click on it to reveal the text!) {{spoiler-end}} |
|||
As the goal of the Solve Path on a puzzle page is to provide a solver's perspective of a puzzle, and how someone may approach and ultimately solve it, it is recommended to avoid directly copying the solution page of a puzzle. Use it as a reference, particularly if a puzzle is difficult to understand, but attempt to write from your own perspective. |
|||
Solve Paths should involve liberal use of spoiler tags and benefit from separation into sequential steps (including a separate section for the final answer). While the intention of this wiki is not to provide alternate hint systems, this method of presenting information is simple enough to perform to be preferred. |
|||
While not everyone will share the same solve path, these pieces of writing should be constructive; if an alternate path is discovered, add it as an additional section of the solve path rather than replacing it entirely. |
|||
===Puzzle Elements=== |
|||
This section contains a list of the puzzle's '''[[Puzzle Elements|elements]]''' (often alternatively referred to as "Puzzle pieces" or "Puzzle tropes"). These are the identifiable components |
|||
== Track Differences == |
|||
Templates will be developed to provide consistent categorisation of these across the Wiki, though are currently specified in the form of a bulleted list containing the names/titles of the relevant elements (linking to their respective pages) followed by a short descriptions of how those elements apply to the puzzle in question. |
|||
'''Note: This section is only for hunts with multiple difficulty tracks.''' |
|||
Some hunts have multiple difficulty tracks for solvers to work through. Often, the higher difficulty track will be the default version of a puzzle while the lower difficulty will have additions to it, whether it be certain words getting highlighted in the flavortext, extra givens being provided for logic puzzles, or enumerations being added for crossword-style clues. |
|||
Judgement will be needed to determine which elements are material enough for inclusion, and it is expected that the breadth and specificity of these elements will be an ongoing, evolving process. |
|||
Puzzle pages should be written as if someone is solving the higher-difficulty path, with this section added where necessary to explain the differences between the two tracks. |
|||
===Images=== |
|||
Visual information for individual puzzles should be kept relatively minimum in case of spoilers, but as a rule we try to include flavorful images as a means to bring colour and visual context to a puzzle page. For example, if a hunt has an "overworld" or icons that represent individual puzzles, those icons can be presented on puzzle pages without fear of spoilers. These types of images should be accompanied by an explanatory caption that includes the connection between the puzzle and the image. |
|||
| ⚫ | |||
Should a puzzle not include such an icon, there is still a chance that it may involve non-spoilery visual elements. |
|||
Puzzle elements often contain just as many spoilers about a puzzle's solution as the solve path does, so this section should be mostly spoiler-hidden as well. Some elements will not need to be spoiler-tagged, particularly those that only cover the visual presentation of a puzzle. |
|||
Puzzle elements should be listed in order of ''first'' encounter when one is solving the puzzle. This means that most structural and flavor/theming elements will be listed first, as they will be the first thing most solvers encounter. Content and flavor/topic elements will be in the middle, with extraction-level elements and submission-based structural elements nearing the end. While exact order may be subjective, most of them should be able to be ordered consistently. |
|||
==Example== |
|||
See [[MIT Mystery Hunt (2020)/The Trebuchet]]. |
|||
Sometimes elements will need to be created to fill in a key part of a puzzle's structure. If this is the case, we recommend using the talk page and/or to discuss what elements are needed and whether particular elements have been created and named yet. |
|||
[[Category:Page Structure]] |
|||
{{DISPLAYTITLE: Puzzles}} |
|||
{{Element|Element Title|Description of how the element applies to this puzzle. Specific details are both allowed and recommended. This element isn't spoiled because it only talks about basic puzzle presentation}} |
|||
{{DEFAULTSORT: Puzzles}} |
|||
{{spoiler|label=Spoiler-y Elements}} |
|||
{{Element|Element Title|Description of how the element applies to this puzzle. Specific details are both allowed and recommended.}} |
|||
{{Element|Element Title|Description of how the element applies to this puzzle. Specific details are both allowed and recommended.}} |
|||
{{Element|Element Title|Description of how the element applies to this puzzle. Specific details are both allowed and recommended.}} |
|||
{{Element|Element Title|Description of how the element applies to this puzzle. Specific details are both allowed and recommended.}} |
|||
{{spoiler-end}} |
|||
<!-- Add any other applicable categories here (if you're unsure, just ask!), besides "Puzzles from Hunt Title, Element Title, and Puzzles by Puzzle Author, which should be automatically filled if the above templates and infobox are properly used--> <noinclude>[[Category:Page Structure]]</noinclude> |
|||
Latest revision as of 19:56, 31 August 2023
| Puzzle Title | |
|---|---|
| Hunt Title | |
| Round Title |
The introductory section of the article should include the Puzzle Name in bold, along with the following information:
- General puzzle type (Word? Logic? Etc.)
- Round Name
- Hunt Name
- A visual description of the puzzle, particularly any notable creative decisions (Is it presented as a series of images of Trebuchets? Is the page just blank?).
A brief, non-spoilery description of the puzzle may be included, if it is possible to discuss the puzzle without spoiling it. Think of this like a blurb for a novel; a successful one intrigues the reader without spoiling the plot.
Infobox[edit | edit source]
The infoboxes on puzzle pages should contain the following information:
- Puzzle, Round, and Hunt Title
- A relevant image to the puzzle (if applicable) and a descriptive caption
- Note: Puzzle images will need to be uploaded to the wiki, so avoid spoiler-y images.
- The author(s') name(s)
- If there are multiple authors, also fill in the author1=, author2=, ... fields. Otherwise the page will go into a category containing all of the author names, rather than make a category for each author. There is a maximum of 9 authors allowed; add any additional authors beyond 9 manually (which should happen fairly rarely)
- The answer to the puzzle in all-caps
- The number of solves and guesses a puzzle had (if available)
- A link to the puzzle page, solution page, answer checker page (if separate from puzzle page), and statistics page (if available)
If the template used on this page is copied from the source onto any new pages and the notes are followed, the information filled in should be automatically formatted correctly.
Solve Path[edit | edit source]
NOTE: This section is optional. While it's up to the author whether or not they write a solve path, solve paths are best written for puzzles that fit one of the following criteria:
- The puzzle does not have a solution page available, or the provided solution page is lacking in sufficient detail.
- The puzzle requires many step-by-step deductions, such as minimetas or certain instruction-following puzzles.
- The puzzle contains red herrings or other information that would not otherwise be covered in the element list.
This section should be mostly spoiler-tagged, aside from surface observations about the puzzle itself that do not contribute to the solution. Things like "This puzzle is presented as series of circular grids", or "The clues are separated into two columns labelled BINGO and BONGO."
After that, use the following spoiler tag system...
As the goal of the Solve Path on a puzzle page is to provide a solver's perspective of a puzzle, and how someone may approach and ultimately solve it, it is recommended to avoid directly copying the solution page of a puzzle. Use it as a reference, particularly if a puzzle is difficult to understand, but attempt to write from your own perspective.
While not everyone will share the same solve path, these pieces of writing should be constructive; if an alternate path is discovered, add it as an additional section of the solve path rather than replacing it entirely.
Track Differences[edit | edit source]
Note: This section is only for hunts with multiple difficulty tracks.
Some hunts have multiple difficulty tracks for solvers to work through. Often, the higher difficulty track will be the default version of a puzzle while the lower difficulty will have additions to it, whether it be certain words getting highlighted in the flavortext, extra givens being provided for logic puzzles, or enumerations being added for crossword-style clues.
Puzzle pages should be written as if someone is solving the higher-difficulty path, with this section added where necessary to explain the differences between the two tracks.
Puzzle Elements[edit | edit source]
Puzzle elements often contain just as many spoilers about a puzzle's solution as the solve path does, so this section should be mostly spoiler-hidden as well. Some elements will not need to be spoiler-tagged, particularly those that only cover the visual presentation of a puzzle.
Puzzle elements should be listed in order of first encounter when one is solving the puzzle. This means that most structural and flavor/theming elements will be listed first, as they will be the first thing most solvers encounter. Content and flavor/topic elements will be in the middle, with extraction-level elements and submission-based structural elements nearing the end. While exact order may be subjective, most of them should be able to be ordered consistently.
Sometimes elements will need to be created to fill in a key part of a puzzle's structure. If this is the case, we recommend using the talk page and/or to discuss what elements are needed and whether particular elements have been created and named yet.
Element Title - Description of how the element applies to this puzzle. Specific details are both allowed and recommended. This element isn't spoiled because it only talks about basic puzzle presentation
Element Title - Description of how the element applies to this puzzle. Specific details are both allowed and recommended.
Element Title - Description of how the element applies to this puzzle. Specific details are both allowed and recommended.
Element Title - Description of how the element applies to this puzzle. Specific details are both allowed and recommended.
Element Title - Description of how the element applies to this puzzle. Specific details are both allowed and recommended.
