2
0
Fork 0
textout/docs/language/multimedia.rst

2.8 KiB

Multimedia elements

The following tags can be used to add complex elements.

Quotes

To quote someone visually, one can use the [quote] tag. This tag takes an optional value being the person or entity being quoted.

Some examples are:

[quote]Someone said that.[/]
[quote=Cakeisalie5]Ever realized that my name contained “Cake”?[/]

Code blocks or spans

There are two tags suitable for presenting code:

[code]

Block to present multiline code or isolate the code from the text.

[inlinecode] (or backquotes)

Inline code markup.

Example uses are:

[code]Some multiline code, with [center]tags shown as they are[/center].
Incredible, heh?[/code]
[inlinecode]Some inline code.[/inlinecode]
`Some more inline code.`

Images

In order to insert an image, the [img] tag can be used. It will make a new paragraph containing the image which the URL is given in the tag content. The tag can be bundled with some attributes, separated with the pipe (|) character:

  • <width>x<height>: set the dimensions to the image. If the width isn't given (i.e. if this attribute starts with x), the height will be set automatically. If the height isn't given (i.e. no x or nothing after the x), the width will be set automatically;
  • left, right, center: align the image accordingly;
  • float: make the image float, i.e. let the text be where the image isn't.

The following example is a right-aligned image, floating (which means text will be allowed on the left of the image), and with a height of 24 pixels and an automatic width:

[img=right|float|x24]https://example.org/image.jpg[/]

Planète Casio administrators can use the [adimg] tag which is equivalent to the [img] tag but adds the special admin image folder prefix to the image URLs, so this is possible:

[adimg]incredible.jpg[/]

Videos

Videos can be inserted as blocks using the [video] or [video tiny] tag. For example:

[video]https://www.youtube.com/watch?v=yhXpV8hRKxQ[/]
[video tiny]https://www.youtube.com/watch?v=yhXpV8hRKxQ[/]

Progress bars

In order to insert a progress bar, the [progress] tag can be used. This tag takes an integer value between 0 and 100 included representing the advancement.

For example:

[progress=50]Building a great wall…[/]
[progress=100][/]

Spoilers / Content Warnings

In order to hide something behind a deliberate action of the user, the [spoiler] tag can be used.

For example:

[spoiler]This is hidden![/]
[spoiler=Uncover the dark secrets of the night]Boo![/]
[spoiler=Uncover this!|Cover this quick!!]BOOO![/]