Vanilla 1.1.10 is a product of Lussumo. More Information: Documentation, Community Support.

  1.  
    Minion
    Is there a way to get some BBCode examples in the discussion posting form? I have no clue what the code is for doing a break to put spaces between my paragraphs; never know when I'll need to make a list in a post. I could just type in Text Mode, and I have no idea what Markdown is. Sorry for being such a Neanderthal.
    •  
      CommentAuthorKJToo
    • CommentTimeFeb 19th 2010 edited
     
    Overlord

    I'll do two separate posts: one for BBCode and one for Markdown.

    Like HTML, BBCode consists of "tags" that bookend sections of text. BBCode uses square brackets to enclose tags.

    Italics

    Tags: [i][/i] 
    
    Example: I [i]really[/i] want a death ray.
    

    I really want a death ray.

    Bold

    Tags: [b][/b]
    
    Example: I [b]really[/b] want a death ray.
    

    I really want a death ray.

    Underline

    Tags: [u][/u]
    
    Example: I [u]really[/u] want a death ray.
    

    Alas, I can't show the result of this, because I had to write the BBCode guide in Markdown, which doesn't support underlining.

    Links

    Tags: [url][/url]
    
    Example (with link text): [url=http://www.thesecretlair.com]The Secret Lair[/url]
    

    The Secret Lair

    Tags: [url=http://some.link.com/][url]
    
    Example (without link text): [url]http://www.thesecretlair.com[/url]
    

    http://www.thesecretlair.com/

    Images

    Tags: [img][/img]
    
    Example: [img]http://www.thesecretlair.com/main/wp-content/uploads/2008/02/overlordkris75.jpg[/img]
    

    Overlord Johnson

    Quotes

    Tags: [quote][/quote]
    
    Example: [quote]The only thing we have to fear is death rays.[/quote]
    

    The only thing we have to fear is death rays.

    Unordered Lists

    Tags: [list][/list][*]
    
    Note that the [*] tag, used to denote a list item, does not have to be closed.
    
    Example:
    
    [list]
    [\*]Death Ray
    [\*]Sonic Disruptor
    [\*]Croctopus
    [/list]
    
    • Death Ray
    • Sonic Disruptor
    • Croctopus

    Ordered Lists

    Tags: [list=1][/list] [*]
    
    Example:
    
    [list=1]
    [*]Death Ray
    [*]Sonic Disruptor
    [*]Croctopus
    [/list]
    
    1. Death Ray
      • Sonic Disruptor
      • Croctopus

    NOTE: It appears that the CSS for our chosen Vanilla theme handles lists in rather a wonky fashion, so you may want to forgo them for the time being.

    Tables

    Hahahahahaha! No.

    •  
      CommentAuthorKJToo
    • CommentTimeFeb 19th 2010 edited
     
    Overlord
    I'm curious to see how (or if) attributed quotes (which BBCode does, but Markdown does not) will appear here, so this comment uses BBCode and the following quote should be attributed to "Overlord Johnson".
    The only thing we have to fear is death rays.
    Okay, so attributed quotes don't work properly. This is likely an issue with Vanilla and/or the BBCode plugin for Vanilla. Ditto for the fact that carriage-returns are being ignored and all of this text is lumped into a single block here. One more thing: the hoops that must be jumped through to "escape" BBCode (so you can show examples of BBCode within a message that uses BBCode formatting) are straight up stupid and, quite frankly, reveal a complete lack of foresight on the part of whoever defined the codes. It can be done, but the recommended method I've seen involves the insertion of unprintable characters into the BBCode tags. Yes, really. That's why I wound up using Markdown to write the BBCode guide. Underline Tags: [≡u][≡/u] Example: I [≡u]really[≡/u] want a death ray. (Wrapping this in "code" tags doesn't strip out BBCode formatting, by the way.) I really want a death ray. Oh, would you look at that. The "unprintable" characters can be printed (at least by my browser) after all. FAIL.
    •  
      CommentAuthorKJToo
    • CommentTimeFeb 19th 2010 edited
     
    Overlord

    Okay, here's the Markdown guide, which I can write in Markdown, because it supports proper escaping of its own tags—which are probably not technically tags, if you want to get all semantical about it.

    Italics

    Format: *Some text* 
    
    Example: I *really* want a death ray.
    

    I really want a death ray.

    Bold

    Format: **Some text**
    
    Example: I **really** want a death ray.
    

    I really want a death ray.

    Links

    Format: [Link Text](http://some.link.com/ "Alternate Text")
    
    Example [The Secret Lair](http://www.thesecretlair.com] "Submit to the Overlords!")
    

    The Secret Lair

    Format: <http://some.link.com/>
    
    Example: <http://www.thesecretlair.com/>
    

    http://www.thesecretlair.com/

    Images

    Format: ![Alternate Text](http://some.link.com/image.jpg)
    
    Example: ![Overlord Johnson](http://www.thesecretlair.com/main/wp-content/uploads/2008/02/overlordkris75.jpg)
    

    Overlord Johnson

    Quotes

    Format: > Some text.
    
    Example: > The only thing we have to fear is death rays.
    

    The only thing we have to fear is death rays.

    Unordered Lists

    Format: * List Item 1
            * List Item 2
            * List Item 3
    
    Example:
    
    * Death Ray
    * Sonic Disruptor
    * Croctopus
    
    • Death Ray
    • Sonic Disruptor
    • Croctopus

    Ordered Lists

    Format: 1. List Item 1
            + List Item 2
            + List Item 3
    
    Example:
    
    1. Death Ray
    + Sonic Disruptor
    + Croctopus
    
    1. Death Ray
      • Sonic Disruptor
      • Croctopus

    NOTE: It appears that the CSS for our chosen Vanilla theme handles lists in rather a wonky fashion, so you may want to forgo them for the time being.

    Code/Pre-formatted Text

    Format: `some text`
    Alternately, precede each line of the code block with four or more spaces.
    
    Example: `This text is in a code block.`
    

    This text is in a code block.

    Headings

    Format: #Level 1 Heading
            ##Level 2 Heading
            ###Level 3 Heading
            ####Level 4 Heading
    Example: #Death Rays
             ##LASER Death Rays
             ###Blue LASER Death Rays
             ####Known Side Effects of Blue LASER Death Rays
    

    Death Rays

    Overview of death rays in general. As an aside, I wasn't aware that Level 1 Headings caused subsequent text to be indented. I'm quite curious as to whether all subsequent text until the next heading will be indented in this manner, or just the first paragraph.

    There's only one way to find out, and now I'm sorry I'm not talking about Death Rays anymore.

    LASER Death Rays

    How awesome are death rays that use LASERs?

    Note to self: Test LASER Death Ray on whoever decided that the text of a Level 2 Heading ought to be larger than the text of a Level 1 Heading. That's just counter-intuitive.

    Blue LASER Death Rays

    Everyone knows that blue LASERs are cooler than red LASERs.

    Known Side Effects of Blue LASER Death Rays

    Prolonged exposure to Blue LASER Death Rays will result in death. Actually, so will very brief exposure to Blue LASER Death Rays.

    Horizontal Rules (or, We're Not Talking About Headings Anymore)

    Format: - - -
    
    Example: - - - 
    

    Tables

    Hahahahahaha! No.