Turbo Vision Theme

rating: +101+x

This is the Turbo Vision theme by JakdragonXJakdragonX and CroquemboucheCroquembouche, an aesthetic theme not associated with any in-universe premise, although it will invoke a painfully retro vibe.

To use this theme on your page, include the following code:

[[include :scp-wiki:theme:turbo-vision]]

This puts the Turbo Vision theme into 'theme mode'.


If you just want to be able to use Turbo Blocks but you don't want the rest of the theme, add "blocks=-":

[[include :scp-wiki:theme:turbo-vision blocks=-]]

This puts the Turbo Vision theme into 'component mode'. This is compatible with the Black Highlighter Theme.


'Theme mode' and 'component mode' will come up later, so make sure you know which one your page uses.

jak.png

Logo by AethrisAethris

The Turbo Vision theme is designed to appear similarly to a DOS terminal from the 90s — it's intended to look like it's made up of lots of ASCII characters. This is why the borders and drop shadows look clunky and asymmetric — they've been made to look like box-drawing characters, with the colors created by the font color and background color of individual tiles.

That being said, we're not fervently sticking to this guideline, and we've taken some creative liberties to make the experience slightly less painful.

The theme comes with Toggle Sidebar by default to facilitate having loads of horizontal vertical space to fill with offset blocks filled with whatever you like. On smaller screens, where there's very little horizontal space, these offset blocks will automatically be brought inwards to the middle of the page — mobile readers won't miss anything.

This theme is blocky, clunky, and colorful. Pages that use it may look cluttered like a bunch of stacked windows in a crowded interface, and that's part of the charm; but it doesn't have to be — it's up to you. This page has instructions for how to set it up any way you want.


The tabview below contains some examples of base Wikidot formatting in this theme.

Please note that while blockquote and table styling are available in 'component mode', tabview styling is only available in 'theme mode'.

A horizontal rule can be created with 5 hyphens "-----" and extends across the whole page if it's not placed inside anything (eg a blockquote). The lines separating sections of this document are horizontal rules.

This is bolded text.

This is italicized text.

This is monospaced text.


Now, a quick demonstration for how the Turbo Blocks work…


The following section of this page may look and seem terrifying. However, you shouldn't feel alarmed or threatened — every part can be broken down into easy chunks.


scpimage.png

Hello yes this is text

ITEM NUMBER

SCP-NUMBER

OBJECT CLASS

LIGMA

SPECIAL CONTAINMENT PROCEDURES

johnsmith12: uh, do you even know what you're doing?

me: lmao, no. I just need to draft something for this stupid-ass theme.

SCP-NUMBER is currently uncontained. Whether this can be attributed to its unidentified writing or if it's just too fucking annoying to hassle with remains unknown.

In the event that one observes SCP-NUMBER for any reason — which, doesn't really make much sense when you think about it — affected subjects must refer back to their on-site therapist for Treatment #104321. Such treatment may last upwards of several hours and may be excruciatingly painful to the affected subject. Because no one wants to go to the nurse's office, for some fuck-all reason.

wtf was I going to have for lunch again?

DESCRIPTION

SCP-NUMBER is nothing. Absolutely nothing at all. In fact, it is a lie. Just like you. You too are indeed a lie. Do not feel hurt or upset, as this applies to everyone universally. We condemn discrimination here at the Foundation.

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.


In fact, what can we describe as truth? Perhaps perception is a lie. A lie perpetrated amongst men upon other men, perhaps? Indeed, reality cannot be the same for you and me. We all have different truths and lies. We are, of course, three-dimensional creatures. We crave understanding. We desire knowledge and will seek it out despite some of our best intentions.

Perhaps you believe that I'm only typing nonsense because I just want to lengthen this more for an extra colored box? Perhaps, but regardless of such meager wishes, I only want to allow you the moment of self-reflection. Are you, in fact, real? No. As I've already said prior, you are just a false image. A false image of the world you're currently living on. That is all.


HOW TO USE

To create a chunky shadowed Turbo Block like the one this text is in, create a div with the following classes:

  • "turbo-block"
  • a class that sets the background color
  • a class that sets the border color
  • a class that sets the text color

This theme provides all of these classes.

BLOCK

The "turbo-block" class creates the Turbo Block itself. You can use it by itself without any of the other classes, but it'll probably look weird (it won't have a background, for example).

[[div class="turbo-block"]]
Your text here
[[/div]]

BACKGROUND COLOR

This theme provides a bunch of background color utility classes, of the form "bg-[color]". Here are all of them:

[[div class="turbo-block bg-red"]]

[[div class="turbo-block bg-grey"]]

[[div class="turbo-block bg-green"]]

[[div class="turbo-block bg-cyan"]]

[[div class="turbo-block bg-orange"]]

[[div class="turbo-block bg-yellow"]]

[[div class="turbo-block bg-purple"]]

[[div class="turbo-block bg-black"]]

[[div class="turbo-block bg-white"]]

BORDER COLOR

There are two border color classes: "border-black" and "border-white". Turbo Blocks doesn't come with a border by default, so you'll have to pick one for each turbo-block.

Note that all divs created with the "turbo-block" class have a double-lined border. Blockquotes, tables and tabviews have a single-lined border.

TEXT COLOR

There are two text color classes: "text-black" and "text-white". They make the default text color in the turbo-block black and white respectively.

Each Turbo Block can have a title and a bunch of headings. The title is the text that appears right at the top — the title of this one is "HEADINGS". Do that by adding a "data-title" attribute to the block div:

[[div class="turbo-block ..." data-title="TITLE GOES HERE"]]

To match the original Turbo Vision program, block titles should be in capitals, but this isn't enforced — you can put any text there you like.

However, do try to keep them short, because they look weird if they overflow:

See what I mean?

The source code for that:

[[div class="turbo-block bg-grey border-black text-black" data-title="Whoops, Look at Me! I'm a Title That's Too Long!"]]
See what I mean?
[[/div]]

Think of the poor mobile readers — keep your titles short.

HEADINGS

Within a Turbo Block, you can create a subsection heading with the "heading" class — here's the code for the above one:

[[div class="heading"]]
HEADINGS
[[/div]]

If you want to add a line like a heading but without any text in it, just add a horizontal rule with 4 or 5 hyphens:


↑ Just like that.

You can put anything you like inside a Turbo Block, including images. To add an image, the best way is to make a Turbo Block div and put the standard image block component inside it.

Here's the one for the image turbo-block used in the example earlier in this page:

[[div class="turbo-block bg-orange border-white text-white" data-title="IMAGE"]]
[[include :scp-wiki:component:image-block
| name=scpimage.png
| caption=Hello yes this is text
]]
[[/div]]

So far, these instructions have covered how to create Turbo Blocks. You can put a Turbo Block inside another Turbo Block, but just doing that won't create a cluttered feel, like a messy pile of notes on a disorganized researcher's desk — to do that, some of them need to be moved to the left and right.

That can be done using offset classes. The Turbo Vision theme provides classes for moving something to the left:

  • "offset-left"
  • "left-1"
  • "left-2"
  • "left-3"
  • "left-4"
  • "left-5"

…and to the right:

  • "offset-right"
  • "right-1"
  • "right-2"
  • "right-3"
  • "right-4"
  • "right-5"

To move something to the left, wrap it in a div with two classes: "offset-left", and then one of "left-1" through "left-5", depending on how far to the left you want it moved. "left-1" will only move it a little bit, but "left-5" will move it a lot — all the way to the left-hand side of the screen.

To move something to the right, it's exactly the same, but swap out "left" for "right".

OFFSETS ON MOBILE

If you've worked with CSS before, you're probably thinking that using up too much horizontal screen space is a very dangerous game — these offset divs are going to look terrible on mobile.

Have no fear! On small screen sizes, offset divs will be placed closer to the middle of the page, and on very small screen sizes, the offset will be turned off altogether.

For authors, this means that while mobile users will always see all of the content you put into offset divs, it might not look as cluttered as you intended it. Always test your design on mobile before you publish it to check that the reading experience is solid for everyone.

CREATING OFFSET BLOCKS

To create an offset block, combine two of the above classes, to determine the offset direction and intensity:

[[div class="offset-left left-3"]]

[[/div]]

If you want to offset a Turbo Block, put it inside the offset block (don't add the offset classes to the Turbo Block directly):

[[div class="offset-left left-3"]]
[[div class="turbo-block bg-white border-black text-black"]]
hello!
[[/div]]
[[/div]]

hello!

If you're on a wide browser (e.g. desktop), the above example is on the left. If you're on a thin browser (e.g. mobile), the above example is above this text.

Because the offset block is a different element to the Turbo Block, this means that you can actually offset anything you like, just by putting it inside a div with offset classes. Try offsetting an image turbo-block!

CLEARING THE FLOAT

Offset blocks work using the CSS "float" property. When a HTML element is floating, stuff underneath it is pulled upwards to fill the space that it leaves behind.

This isn't always desirable. Maybe you want a floating offset block, but you want the text underneath it to appear where it would be if the offset block wasn't floating. This would leave a big gap for you to put something else there, if you like.

You can do this using the CSS "clear" property — a practice that's commonly referred to as a "clearfix". Wikidot lets you do this with 4 tilde characters (~~~~):

[[div class="offset-left left-3"]]
[[div class="turbo-block bg-white border-black text-black"]]
hello!
[[/div]]
[[/div]]

~~~~

hello!

This text isn't pulled upwards to fill the space, resulting in a big gap on desktop. On mobile, of course, there is no change.

EXAMPLES

Here are examples for all the different offset combinations.

Your browser has a wide screen (or at least CSS says so), so take a look at the examples below and adjust your window size to see how the offset divs react.

Your browser has a thin screen (or at least CSS says so), which means you're likely on a mobile device. The offset examples below will appear as a bunch of boring, center-aligned divs. Try looking at this page in a wider browser later to see the offsets.

[[div class="offset-left left-5"]]

[[div class="offset-left left-4"]]

[[div class="offset-left left-3"]]

[[div class="offset-left left-2]]

[[div class="offset-left left-1"]]

[[div class="offset-right right-1"]]

[[div class="offset-right right-2"]]

[[div class="offset-right right-3"]]

[[div class="offset-right right-4"]]

[[div class="offset-right right-5"]]

There are certain circumstances in which you shouldn't use some of the offset classes. You still can, of course, but it will have an adverse effect on your page.

Which classes are available to you depends on the position of the sidebar and whether or not the page content is center-aligned with respect to the browser viewport. It also depends on whether you are using this theme in 'theme mode' or 'component mode' — please review the usage instructions at the very top of the page for a reminder of which is which.

THEME MODE

If you are using the Turbo Vision theme in 'theme mode', it comes with Toggle Sidebar, which center-aligns the page content and frees up as much horizontal space as possible. You may freely use all of the offset classes.

COMPONENT MODE

If you are using the Turbo Vision theme in 'component mode', it does not come with Toggle Sidebar by default. This limits the horizontal space.

If you are using Toggle Sidebar anyway, your page body is center-aligned. You may freely use all of the offset classes.

If you are not using Toggle Sidebar, the page body is on the right-hand side of the page. You should avoid using any of the right-hand offset classes, as they may go off the edge of the screen. You should also avoid using any left-hand offset classes near the start of the page, as they may overlap with the sidebar.

If you are using Black Highlighter Theme, the page body is centered, so you may freely use the right-hand offset classes. However, the sidebar is present throughout the entire document, so you should avoid using any of the left-hand offset classes.

If you are using BHL and Toggle Sidebar BHL, this frees up the space on the left, so you may freely use the left-hand offset classes as well.

TL;DR

In short: avoid offsetting to the left if there is a sidebar, and avoid offsetting to the right if the page content is not centered.

And that's the whole theme.

Source code

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License