====== Editing tips ======

Here are some editing tips regarding some extensions we've added on top of DokuWiki's base.

===== When to italicize, when to quote, when to etc. =====
To ease up on some inconsistencies around here, this is the preferred style guide when mentioning content in-universe and out-of-universe:
  * When mentioning //On Cinema at the Cinema// episodes mid-article, don't refer to it by the episode title or by the wiki article title (like [[:s14e01]]), instead just call it [[:s14e01|S14E01]] or, if the article is related to something in [[:season14|that season]], [[:s14e01|episode 1]].
  * When mentioning //On Cinema// podcast titles, just say [[:pod1|episode 1]].
  * Italicize show titles: //[[:ocatc]]//
    * Season 13 and Season 14 should be referred to by their in-universe names, and therefore italicized: //[[:season13]]// and //[[:season14]]//
  * Italicize movie titles: //[[:misteramerica]]//, //Oh God!//
  * Italicize the individual seasons of //Decker//: //[[:decker1]]//, //[[:deckeranimated]]//
  * Italicize Oscar Specials when referred to by their full name: //[[:oscar10]]//
  * Put show segments in quotes except when listed in an infobox: "[[:onlocation]]"
  * Put //Decker// episode titles in quotes: "[[:d04e01|All Good Things...]]"
  * Put song titles in quotes: "[[:emptybottle]]"
  * Misc. content, like [[:major_dekkar_announcement]], should not be italicized or quoted. I think. We'll see.

===== <WRAP> is your friend =====

We extensively use the WRAP extension here, it's incredibly useful. Read [[https://www.dokuwiki.org/plugin:wrap#syntax|the plugin's page on DokuWiki]] for all the stuff it does by default.

We tend to use WRAP box, info, todo a lot, like so:

  <WRAP box>box</WRAP>
  <WRAP info>info box</WRAP>
  <WRAP todo>todo box</WRAP>

Which looks like:
<WRAP box>box</WRAP>
<WRAP info>info box</WRAP>
<WRAP todo>todo box</WRAP>

We've added more classes to the extension that will be covered here:

==== Quote boxes ====

For the quotes that you see at the top of almost every page, we tend to just use the standard WRAP box style, albeit with some alterations. **Bold the quote text**. On a new line, use WRAP attribution, enter three dashes (makes a long dash: ---) and then cite whoever said it unbolded.

  <WRAP box>
  **I WILL GO TO BED SLEEPING EVERY NIGHT**
  <WRAP attribution>--- Tim Heidecker</WRAP>
  </WRAP>

<WRAP box>
**I WILL GO TO BED SLEEPING EVERY NIGHT**
<WRAP attribution>--- Tim Heidecker</WRAP>
</WRAP>

==== Tweet boxes ====

For tweets, instead of WRAP box, use WRAP tweet. Do not bold the text. For the attribution part, we'd like a link to the tweet, with the link text being @username, MM/DD/YY ti:me p.m. PST, though admittedly that is not the most enforced and it might be simplified later on.

  <WRAP tweet>
  Tweet text
  <WRAP attribution>--- [[https://twitter.com/greggturkington/status/148901470241173504|@greggturkington, 12/19/11 3:04 p.m. PST]]</WRAP>
  </WRAP>

<WRAP tweet>
Tweet text
<WRAP attribution>--- [[https://twitter.com/greggturkington/status/148901470241173504|@greggturkington, 12/19/11 3:04 p.m. PST]]</WRAP>
</WRAP>

==== HEI Network comments ====

Since season 14, Tim and Gregg have for the most part abandoned [[:twitter]] and started using the comment section on HEI Network's videos and articles instead. We decided to make WRAP templates for both Tim and Gregg's comments. Use WRAP heitim for Tim, WRAP heigregg for gregg. If Tim replies to Gregg or vice versa, layer it inside the current WRAP statement. 

  <WRAP heitim>
  Tim statement!
  <WRAP attribution>--- T. Amato, 1/3/24 8:39 a.m. PST</WRAP>
  </WRAP>
  
  <WRAP heigregg>
  Gregg statement!
  <WRAP attribution>--- Gregg Turkington, 1/3/24 4:18 p.m. PST</WRAP>
  <WRAP heitim>
  Mean Tim reply
  <WRAP attribution>--- T. Amato replying to Gregg Turkington, 1/5/24 4:20 a.m. PST</WRAP>
  </WRAP>
  </WRAP>

<WRAP heitim>
Tim statement!
<WRAP attribution>--- T. Amato, 1/3/24 8:39 a.m. PST</WRAP>
</WRAP>

<WRAP heigregg>
Gregg statement!
<WRAP attribution>--- Gregg Turkington, 1/3/24 4:18 p.m. PST</WRAP>
<WRAP heitim>
Mean Tim reply
<WRAP attribution>--- T. Amato replying to Gregg Turkington, 1/5/24 4:20 a.m. PST</WRAP>
</WRAP>
</WRAP>

Generally, we won't highlight any random user's comments unless Tim or Gregg reply to it. If that's the case, use a standard WRAP box for the user.

==== Oscar Trivia ====

<WRAP todo>Still not done with the code just yet.</WRAP>

===== Images =====

While we use Alwaysdata's free plan, storage is quite limited, at just 100mb. We're already halfway over the limit so the last thing we need to do right now is upload images. Instead, we've been using Imgur to host images. Just upload an image to Imgur and then embed it like so:

  {{https://i.imgur.com/rIyCkjp.jpeg?250%}}

{{https://i.imgur.com/rIyCkjp.jpeg?250%}}

Note the "?250%" at the end. That resizes the image to a healthy size. You can go smaller if you think it looks too big still.

We use another addition to WRAP, WRAP figure, to have an image in a box with a caption similar to Wikipedia. To do this...

  <WRAP figure right>
  {{https://i.imgur.com/rIyCkjp.jpeg?250%}}
  Gregg holding a movie
  </WRAP>

<WRAP figure right>
{{https://i.imgur.com/rIyCkjp.jpeg?250%}}
Gregg holding a movie
</WRAP>

Note the addition of "right", that forces the figure to align to the right of the page. Left works too, but might look a little funky sometimes.

Here's some padding for the next section.

Here's some padding for the next section.

Here's some padding for the next section.

Here's some padding for the next section.

Here's some padding for the next section.

Here's some padding for the next section.

Here's some padding for the next section.

Here's some padding for the next section.

===== Infoboxes =====

<WRAP todo> section tbd</WRAP>

===== Templates =====

We have templates similar to those you see at the bottom of Wikipedia articles thanks to another extension, [[https://www.dokuwiki.org/plugin:wst|WST]]. You can see the current templates we have [[https://oncinema.alwaysdata.net/template/chaplin?do=index|here]]. There's more work to be done there, to say the least.

Linking a template is simple. Just use the page id for the template and this:

  {{wst>chaplin}}

{{wst>chaplin}}

If you need to edit a template, remember when linking articles you have to link outside of the /template/ namespace. That just means adding a colon before the page name.

  [[:tim]] will work, [[tim]] will not

WST has support for modular templates, but we do not have any templates that support that yet.

===== Tags =====

Another plugin helps us with tags. You'll see them at the bottom of the page. Except this one.

  {{tag>popcorn movie_time}}

Tags with multiple words (like "gregg turkington") must have underscores in lieu of spaces.

===== Citations =====

Another plug-in helps us with citations. I forget what its called.

We use two citation labels, cite and fn (footnote). Use cite for citing sources, fn for misc. content.

  [(cite:label>The citation goes here.)]
  [(fn:label2>The footnote goes here.)]

Make sure to give your citation/footnote a label, name it something brief yet precise. The features will act weird otherwise, and it helps you reuse a citation later on. To do that...

  [(cite:label)]
  [(fn:label2)]

  Quaker Oats fed radioactive cereal to mentally disabled children as an experiment.[(cite:oatmeal>[[https://www.snopes.com/fact-check/fernald-quaker-oats/]])][(fn:oscar11>This fun fact was stated during the //[[:oscar11]]//.)]

Quaker Oats fed radioactive cereal to "mentally disabled" children as an experiment.[(cite:oatmeal>[[https://www.snopes.com/fact-check/fernald-quaker-oats/]])][(fn:oscar11>This fun fact was stated during the //[[:oscar11]]//.)]