Loading...

Composing a Story for the SBP

Posted by garym on April 24, 2003 - 5:19pm

Writing for the Peninsular is open to anyone with an idea for a story, and your story can be a review, it can be news, thoughts, ideas, comments, poetry or prose, it's up to you. Our philosophy is that it will all sort itself out in the long run and we're mostly interested to see what happens when people tell their own stories.

But the technology, now that's a different issue. Authoring webpages frightens most people because they just don't want to get it wrong, and if you've ever tried to make a webpage, you know what can happen if you forget to close an emphasis tag or leave off the end of a table column. It's not a pretty sight.

welcome to Textile

Textile is Dean Allen's simple text-to-HTML converter, and by using Textile on all our stories, the Peninsular avoids the techie HTML issue entirely. Textile uses a common set of formatting rules that are natural and easy to remember, and best of all, harmless.

We know most of these codes already, we use them all the time in our email messages. For example, an underscore before or after a word is emphasis and two underscores before and after do the underlined.

  • an asterix in the first column is a bullet point
  • with the bullet text on the rest of the line

You can also do super and sub script, strikeout and inserts, teletype, citation and strong text.

  1. number signs (pound) do numbered lists
  2. and again, the text on the rest of the line

Images are included by placing the URL to the image between exclamation points hotlinks are quoted text followed immediately by a colon and the URL.

It's not perfect, and there are flaws. For one thing, it's not entirely obvious how you would make an image into a hotlink or make a link in strong type. But it's a start and as Textile improves, we'll add the new features to the Peninsular.

The Textile Sandbox

Rather than my going on and on about what Textile does and how it works, if you know a little HTML, you can play with it at Dean's very thoughtful Textile Sandbox The Sandbox lets you enter Textile and see in an instant how these codes translate; with a bit of practice, you'll find it's way easer than learning to code directly in the HTML.

Got Questions on Contributing to the Peninsular?

Post them here!



Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

Textile Versions

Leave it to the techies to make a confusing thing even more confusing -- this software we are using has now _enhanced_ the Textile support by offering no less than _three_ different flavours!

* when you select 'none' you really get the old method where the textile rules were applied to the entire story, title and all, and that sometimes caused problems, plus it just wasn't very efficient and as such it isn't recommended -- the default on the SBP is the 1.0 version.
* 1.0 Textile is pretty much what you expect if you use an email program or a chat program that recognizes little text format rules like putting a word between _underscores_ or doing these bullet marks by having an asterix in column one.
* 2.1b Textile just seems crazy -- for the life of me, I don't notice any difference, and what I do notice is that all the places where Textile 1.0 is broken (such as URL links that end in digits) the same holds true for Textile 2.1b

Anyway, don't let it discourage you -- you don't need to know _any_ of this so long as you just write, leave blank lines between paragraphs and really, _who cares if you use emphasis or not?_