How To Twine

Twine | RecentChanges | Preferences | Login | Logout | Help

Showing revision 70
Twine is Profusion and MoonBurnt's encyclopaedia and reference tool.

How to Twine is a help page and list of guidelines for the wiki. You should also make sure you understand Twine copyright before editing pages.

Quick picks

Contents

1. Basic formatting and links
2. Editing guidelines
2.1. What to name a new article
2.2. Starting to write a new article
2.3. Using notes and asides
2.4. Writing style
2.5. Images
3. Appropriate topics
4. Collaborative editing guidelines
4.1. Editing other people's stuff
4.2. Cleaning up a page
5. Using Twine Encyclopaedia at Pro and Moonburnt

1. Basic formatting and links

Here is an example page. It's not a 'sandbox', but you're welcome to practise editing it and preview your results without saving them.

2. Editing guidelines

It's helpful to set your name under [preferences], so your edits will be attributed in RecentChanges. If you don't add a name, you will show up as an IP address instead.

2.1. What to name a new article

Page titles should be singular: Hellhound, not Hellhounds. (Exception: organisations or other concepts that are always known by plurals, eg Five Races.)

For terms used by more than one person, make a disambiguation page (as has been done for Hell) and call the individual pages things like [Hades (Mutt)]? and [Hades (nightclub)]?.

Don't know what to call a page? Say you want a separate page for a character's history - should you call it "History (Keith)" or "Keith's History"? It's not clear-cut, but here's the basic idea:

To answer the "History (Keith)" / "Keith's History" question, it should probably be "Keith's History" for a character. If you were writing the history of a world and also wanted to make a history index to list all the planet histories in Twine, it could be "History (planetname)".

Subpages are not allowed. If you don't know what those are, don't worry. (The one exception to this rule is the By Author page.)

2.2. Starting to write a new article

Bold the title, the first time you use it on the page.

You should link to your new page from another article before editing it (see above for how to do that), because this will prevent 'orphan' pages that aren't findable from anywhere. However, you can get to any blank page by visiting its URL, for example http://twine.hellhound.net/Twine.

2.3. Using notes and asides

Sometimes it's useful to add a note at the top of an article (eg: there is another article with a similar name and people might confuse the two: example). Format the aside with an indent and italics.
Please note: Do this sparingly and only if appropriate.

2.4. Writing style

In Twine Encyclopaedia pages, write reasonably impersonally ("It has been suggested..." rather than "I think..."). The Twine Encyclopaedia is intended to be 'factual' in tone and content, such as you might get from a real encyclopaedia, because the impersonal voice is funny.

The Twine Encyclopaedia is intended to be humorous. [Wikipedia's Neutral POV] guidelines are helpful, but do not take them as inviolable.

2.5. Images

It is possible to include images in your post by just adding the URL. Obviously, please do not add ridiculous numbers of pics. All pics should be less than 300px wide and tall. (100x100 is ideal.) The total file size of images in any article should not be more than 20-25Kb.

There is a little leeway with these rules, but if a picture is big, please link to it (using the same procedure you would use to link to a web page).

3. Appropriate topics

Twine is not an encyclopaedia of everything. (For that, try [Wikipedia].) Real World topics are usually not appropriate to add.

In some cases, there might be something realworldly that isn't well known, or that is used by Pro and Moonburnt members in a different way. This may be enough justification to add a short article about it. We don't need anything more than a short definition and an explanation of how the topic is relevant to our groups. For anything else, add an external link.

The page about Gender is an example of a good Real World article.

Don't make pages about commercial or copyrighted topics or characters. See Twine Copyright.

4. Collaborative editing guidelines

4.1. Editing other people's stuff

As a general rule, don't remove text unless you're replacing or rewriting it. Deletions and nuisance edits can be tracked and reversed, but since the wiki is members-only, this seems unlikely to become an issue.

If there is information on a page with which you disagree, which needs clarification or which you suspect to be inaccurate but aren't certain enough to edit, start a discussion at the foot of the page. Separate discussions from the article with a horizontal rule, wiki-format ----. Do not start a new page for discussions.

4.2. Cleaning up a page

Be aware that discussion sections and authors' comments may be removed when articles are 'cleaned up'. (If you're the one doing the cleaning, take a look to see if there's anything useful in there to salvage.)

5. Using Twine Encyclopaedia at Pro and Moonburnt

When posting at [Pro], you can use a formatting tag like \twine{How_To_Twine,any link text} to link directly to a Twine Encyclopaedia page. (For multi-word titles, you must put underscores instead of spaces or the wiki won't understand you.)

On [Moonburnt]: [twine=Article_name]any link text[/twine]. (Same proviso about underscores.)


Twine | RecentChanges | Preferences | Login | Logout | Help
This page is read-only | View other revisions | View current revision
Edited September 16, 2006 11:45 pm by Mutt
Search: