Table of contents
Introduction
This site uses a bespoke markup language for formatting.
It is distinct from HTML, BBCode, and Wikitext, though it shares many features with the latter (Wikitext being the markup for MediaWiki, the Wiki system that you're probably most familiar with).
The markup described here applies to submission notes, wiki articles... everything on the site besides forum posts, which use a variant of BBCode.
This page explains all of the features of this customized markup
language, which is developed with simplicity of editing in mind.
Paragraphs
- Words wrap and fill automatically. You do not need to bother with manually inserting line breaks..
- keep lines short to make diffs (page history) more easily readable.
- Separate paragraphs with a blank line.
Example: This is paragraph one.
This is paragraph two. There is a blank
line in between.
You can force a line break without making a new paragraph with %%%,
but it is not recommended. Example:
This paragraph
uses line breaks
excessively.
This paragraph
uses line breaks
excessively.
However, if your lines begin with a space, none of this happens.
See preformatted text.
Lists
- This is a bulleted list.
- In order to create a bulleted list, put * at the start of each line.
- You can get deeper hierarchy by placing ** for second level, *** for third etc.
- This is a numbered list.
- In order to create a numbered list, put # at the start of each line.
- You can use ## and ### as in the previous example.
- You can also mix # and *.
- New line stops the list, but you can use %%% (see above).
- ;Term:def makes a definition list:
Example:
;Term to be defined: Your explanation appears here.
;TAS: A tool-assisted speedrun.
Turns into:
;Term to be defined: Your explanation appears here.
;TAS: A tool-assisted speedrun.
Turns into:
- Term to be defined
- Your explanation appears here.
- TAS
- A tool-assisted speedrun.
Hint: See the source code of this page to see how the markup works.
Headings
- ‘! ’ at the start of a line makes a small heading.
- ‘!!’ at the start of a line makes a medium heading.
- ‘!!!’ at the start of a line makes a large heading.
- ‘!!!!’ at the start of a line makes a main heading. Because the system automatically creates a main heading for normal pages, this markup is only usable for system pages.
- The command %%TOC%% creates a table of contents consisting of the headings.
- Usage of headings for structuring the document is recommended.
Four or more minus signs at the start of a line make a horizontal ruler. Example:
Emphasis
- Use doubled single-quotes ('') for emphasis (italics).
- Use doubled underscore (__) for strong emphasis (bold).
- Use doubled parentheses (( and )) for smaller text. (Can be nested)
- Use doubled braces {{ and }} for
teletype text
. - Use triple dashes (---) for
overstrike effect(when you wish to emphasize that something has been changed/removed from the page). - Use double square quotes «« and »» for
inline quotations (
.Can be nested
) - Use right angle bracket (>) for indented quotes:
This is an example quote.
- Use double top half brackets ⸢⸢ and ⸣⸣ for superscript. Useful to write
X4 = X22
in math. - Use double bottom half brackets ⸤⸤ and ⸥⸥ for subscript. Useful to write
log2X
in math. - Emphasis can cross line boundaries, so be careful – a rogue “---” for example can cause the entire page appear in strike-over.
Preformatted text
In order to use preformatted text, such as indented code, use space as the first character of a line (monospace font).
Example: This is standard text
This is preformatted text using a monospace font (space as first character). Here is an action scene: +__-+- “One image says more than a thousand words.” -- \__| _____ _: _____ ____ - -- | | |_ - - --- / |__\__ -- _/ |__\|_ - O ~ | \ _ - __ `-o----o-'__ `-o-----o-' __ `-oo--^--o-'
Notice the usage of '''' (four successive apostrophes) to break long strings of underscores to prevent them being interpreted as bold on/off.
Please use preformatted text for program source code and such only.
Preformatted text does not line wrap and can break page layout if used incorrectly.
References (Links)
- Internal links (to other wiki pages here)
- Do NOT link to the fully qualified url i.e do NOT prefix with https://tasvideos.org
- Link to wiki page names by enclosing them in brackets: [RecentChanges] or [recent changes].
- It is possible to give your link a different name by using square brackets and ‘|’ like this: [FAQ|Questions and answers] produces Questions and answers.
- To output brackets as-is, put them in doubles: [[ and ]]
- External links (automatically gets a icon)
- URLs with
http:
,ftp:
ormailto:
are automatically linked: http://www.google.com/ . - URLs can be named in the same way as internal links: [http://www.google.com|Google it!] produces Google it!
- You can suppress automatic hyperlink parsing by preceding the link with a ‘!’, e.g. !http://not.linked.to/.
- URLs with
- Images
- URLs ending in
.png
,.gif
,.jpg
, and.svg
are inlined if put in square brackets (embedded images).
(But when you embed images, please make sure that you have the permission to do so from the server where the image is being loaded from!) - To suppress image embedding, use a space after the URL, it will act as a regular link.
- For internal links (relative), prefix the image's URL with a =.
- To left- or right-align an embedded picture, the link text can be “left” or “right” respectively. [https://files.tasvideos.org/guidelines/entertain.gif|right] produces the image above.
- To include
alt
ortitle
attributes in an image usealt=text
ortitle=text
. - To include
width
orheight
attributes in an image usew=width
orh=height
respectively. Ex: [https://files.tasvideos.org/common/Forum/21792/bizhawk_mame_tutorial/Karnov-cover.jpg|w=480|h=360] - You can combine multiple image options by using '|' like this: [=image.png|alt=Image of cows|title=Coolest image ever|left] or this: [http://images.google.com/image.png|alt=Image of cows|title=Coolest image ever|left]
- You can create image links like this: [http://www.google.com|=googlelogo.png|alt=Google's Logo] or this: [http://www.google.com|http://www.google.com/googlelogo.png|alt=Google's Logo]
- URLs ending in
Linking to submissions
Construct the link from the movie ID and "S". For example, Rockman submission is #1032, so the link is written as: [1032S].
To add a custom description, write for example: [1032S|rockman submission]. The internal description can be seen when hovering over the link.
To add a custom description, write for example: [1032S|rockman submission]. The internal description can be seen when hovering over the link.
You can find the number from the URL of the submission.
Linking to movies
Construct the link from the movie ID and "M". For example, Rockman movie is movie 515, so the link is written as: [515M].
To add a custom description, write for example: [515M|rockman movie]. The internal description can be seen when hovering over the link.
To add a custom description, write for example: [515M|rockman movie]. The internal description can be seen when hovering over the link.
You can find the number at in the URL of a publication page, or from a link on the movie module for the movie.
Linking to forum topics
Construct the link from "Forum/Topics/" and the topic ID. For example, the Gradius topic is written as [Forum/Topics/629|Gradius topic].
Linking to forum posts
Construct the link from "Forum/Posts/" and post ID. For example, the forum rules is written as [Forum/Posts/227916|forum rules].
Linking to forum profiles
Construct the link to the users profile simply use the user module with the user's username. For example for feos link with [user:feos]
Linking to other internal pages
To link to any other page, take the URL and replace “https://tasvideos.org/” with “=” (for simple links, the "=" can be omitted)
e.g. [Forum/Subforum/2], [=Wiki/PageHistory?path=TODO], [UserFiles/Info/637936906469759936]
e.g. [Forum/Subforum/2], [=Wiki/PageHistory?path=TODO], [UserFiles/Info/637936906469759936]
- Footnotes: create links to footnotes with [#1] or any other number (i.e. square brackets + hash + number), and precede the footnote itself with [1] (i.e. square brackets + number). Example: [1]
Tables
Tables are created with lines that begin with vertical bars. ( | )
Double vertical bars ( || ) create headers.
Double vertical bars ( || ) create headers.
Example:
||header1||header2||header3||header4|| |field1a|field2a| |field4a| |field1b|field2b with [|] vertical bar|field3b with%%%a few words|field4b|
becomes:
header1 | header2 | header3 | header4 |
---|---|---|---|
field1a | field2a | field4a | |
field1b | field2b with | vertical bar | field3b with a few words | field4b |
To output a literal vertical bar in a table, surround it in brackets: [|]. To output empty cells, put a space between the cell edges.
To ensure that the table format and appearance is consistent (white lattice with border), every row should have one more vertical bar separator than the number of cells in a table row.
Mark-Up Language (HTML)
- Do not try to use HTML. HTML markup does not work.
-
&
and<
have no special meaning and will give a literal & or <, respectively;>
has a special meaning only at the beginning of a line (for a note-style block), and otherwise gives a literal >.
Table of contents
- You can insert a table of contents to the page with the %%TOC%% macro. (See the top of this page for an example of its use.)
- The table of contents must come before any headers or else it will not work.
Tabs
To create tab entries, write as follows:
%%TAB header_text1%% entry1 %%TAB header_text2%% entry2 ... %%TAB header_textn%% entryn %%TAB_END%%
For example:
%%TAB Table of Pokémon%% Bulbasaur, Venusaur, Ivysaur, and hundreds of others. %%TAB Minimize tab%% %%TAB_END%%
produces:
Bulbasaur, Venusaur, Ivysaur, and hundreds of others.
Important: There must be a newline after %%TAB_END%% or else it will not work.
Note: Headings can not be embedded in tabs
Directives:
%%TAB_START%%
Start a tabset. Usually only needed if you want nested tabs.
%%TAB_HSTART%%
Start a tabset with tabs on left side instead of top.
%%TAB <name>%%
Create a new tab. Starts a tabset if there isn't one.
%%TAB_END%%
End the innermost tabset.
Start a tabset. Usually only needed if you want nested tabs.
%%TAB_HSTART%%
Start a tabset with tabs on left side instead of top.
%%TAB <name>%%
Create a new tab. Starts a tabset if there isn't one.
%%TAB_END%%
End the innermost tabset.
-
%%TAB_
END%%
is important. If it is missing, odd things happen. - Tabs can be nested.
- There must be no headings in the tabs.
- Ending a tab ends any nested quotes and divs.
Note: In the current implementation of the site, tabs are implemented
with Javascript. It is not recommended to use them, because the tabs
are not usable with Javascript-challenged browsers.
Source code
%%SRC_EMBED <hilighting>
Start block of code with specified hilighting type. Wiki markup is not processed inside this block.
%%END_EMBED
End a block of code.
Start block of code with specified hilighting type. Wiki markup is not processed inside this block.
%%END_EMBED
End a block of code.
function factorial(n)
local x = 1
for i = 2, n do
x = x * i
end
return x
end
Quotations
%%QUOTE [<name>]
Start a quote block (If <name> is specified, that is shown to be quoted).
%%QUOTE_END
End a quote block. Automatically ends any nested tabs and divs.
Start a quote block (If <name> is specified, that is shown to be quoted).
%%QUOTE_END
End a quote block. Automatically ends any nested tabs and divs.
Divs
%%DIV <class>
Start a div block with given class <class>.
%%DIV_END
End a div block. Automatically ends any nested tabs and quotes.
Start a div block with given class <class>.
%%DIV_END
End a div block. Automatically ends any nested tabs and quotes.
Example card div header
Example card div body
Comments and if macros
- To write something in the source without having it show up in the page, surround the comment with [if:0]...[endif].
- Surrounding anything with [if:1]...[endif] does nothing to the text.
- The wiki reserves some variables which evaluate to 1 if true and 0 if false:
- UserIsLoggedIn
- CanEditPages (1 if user is an editor)
- UserHasHomepage
- CanViewSubmissions (as for now, always 1)
- CanSubmitMovies (as for now, same as UserIsLoggedOn)
- CanJudgeMovies
- CanPublishMovies
- CanRateMovies (as for now, same as UserIsLoggedOn)
e.g. [if:!UserIsLoggedIn]
(The ! reverses 1 and 0)
(The ! reverses 1 and 0)
Other macros
- [expr:UserGetWikiName] returns the reader's wiki username (if logged on).
- [user:user_name] links to the user profile of the user (if there is one).
- [module:xxx] inserts a module which performs some function. See the list of modules for more information. Some modules are restricted.
Character set
- This server uses unicode with UTF-8 encoding. This means that you can use all characters supported by unicode, including the Japanese characters. But please note that not everyone can read them.
[1]: This is an example of a footnote.