Formatting Guide!

:speech_balloon: What is Discourse?

Collectives is built on top of Discourse, which is a hugely customisable open-source forum engine allowing for extensive functionality. Discourse is widely used across the web on a wide range of technical sites, such as the official Unity forums.

One of the key features of the Discourse formatting is that it allows for custom (safe) HTML and markdown to be input directly into posts. This is incredibly useful when creating custom promotional material for mixes and events!

What is Markdown?

Markdown allows for the use of custom formatting within posts, such as creating headers. It’s extremely useful for creating promotional text posts for events and mixes.

It has a wide range of customisable options!

Keep an eye on these blocks!
They will tell you how to format posts within the raw/unedited views.

Lists

  • For instance, we can create bullet point lists natively within posts.
  • This is done by preceding any text with a * character.
* For instance, we can created bullet point lists natively within posts.
* This is done by preceding any text with a * character.
  1. We can also make numbered item lists automatically by preceding these with a number in the edit view.

  2. The list will automatically update the number system if we want to add or remove items from the list.

    • Sub-lists are also possible if required!
1. We can also make numbered item lists automatically by
   preceding these with a number in the edit view.

2. The list will automatically update the number system if we
   want to add or remove items from the list.

* * Sub-lists are also possible if required!

Titles

Titles can range from Heading 1 (largest) to Heading 6 (smallest).

Heading 1 (Largest)

Heading 2 (Larger)

Heading 3 (Large)

Heading 4 (Small)

Heading 5 (Smaller)
Heading 6 (Smallest)

These can be formatted natively with # symbols preceding the title text.

# Heading 1 (Largest)
## Heading 2 (Larger)
### Heading 3 (Large)
#### Heading 4 (Small)
##### Heading 5 (Smaller)
###### Heading 6 (Smallest)

Posting Raw Text & Hidden Summaries

See the raw text blocks above? We can format text this way by enclosing it in the ` character. We can also format bigger blocks by enclosing the text in ``` (text here) ``` .

We can also hide extra content under a [details] tag, meaning it won’t be shown until a user clicks on it.

[details="This text will show with an expandable option..."]

...but this text will be hidden until a user clicks the triangle icon.

[/details]

This text will show with an expandable option...

…but this text will be hidden until a user clicks the triangle icon.


Quick Style Guide

**This text is bold** → This text is bold.

*This text is italics.* → This text is italics.

:speech_balloon: Quoting Posts

Quoting posts will provide a link to the source post, as well as a chain that allows you to reference the quote from the source post. This is really useful if you want to link e.g. a song you made to a post about a mix that includes that song!

To manually format a quote, you can use the following layout:

[quote="Collectives, post:7, topic:12, full:true"]

Quoting posts will provide a link to the source post, as well as a chain 
that allows you to reference the quote from the source post. This is really
useful if you want to link e.g. a song you made to a post about a mix that
includes that song!

[/quote]

But to make it easier - if you want to quote a post, just highlight the text in the post and hit ‘Quote’.


Block Quotes

Quoted text does not necessarily need to be linked to a post.

For instance, it is possible to display text in a block as seen here.

This is done by preceding your quote with a > character.

Quoted text does not necessarily need to be linked to a post.

> For instance, it is possible to display text in a block as seen here.

This is done by preceding your quote with a > character.

Editing Posts :pencil:

Posts are editable, should you make a spelling msitake!

Do you see the little pencil icon in the top right of this post?
Click on it to show any
revisions made!

Keep in mind that moderators can hide and delete old post revisions as necessary.

:broom: Keeping the server tidy

Don’t worry too much about this as the moderation team will often organise/re-categorise stuff to avoid confusions. Users are currently set to be able to make new topics, but keep in mind that any fast-moving discussions are probably better suited to the #general-discussion channel!

:chart_increasing: Making Polls

Yep, you can also make polls in Discourse! Poll creation may not work on mobile.

Do you like this server?

  • Yeah…
  • Hell yeah!
0 voters
  • You can set to allow seeing who voted for what, or even restrict your poll to various user groups!

This topic has been closed. Mods such as @Saen can still reply to closed posts!

:locked: Closing & Opening Topics


See how I just closed this topic to new replies?

Topic owners & moderators can close and open new replies on topics. Keep in mind that moderators and topic owners can override this setting and post replies even if the thread is closed.

Now, let’s reopen the topic again!

This topic has now been re-opened. Let’s continue discussing Discourse and it’s awesome features!

Topics can also be archived, unlisted, merged & split as appropriate!

That concludes the style guide!


Discourse also allows HTML editing, with some limitations.

The immense customisation of this platform will allow us to create promotional posts for events, mixes, new tracks, and so on.

Since the forum is public these threads can then be linked to various pages, etc as promotional material!
This is the main goal here.


Enjoy using this new forum!

This topic thread is now permanently closed. Enjoy the site!