Help for contributing an article

· Basics

· The contribute page

· Fields on the page

· Buttons

· Tags

· Overview

· Menu entry

· Levels

Basics

We welcome all articles that have a focus on REBOL. For more details on the types of article, please see the Articles FAQ.

To contribute a new Article, please click this link.

To update or edit an existing article of yours, please first view the article from here, and then click the edit/update link.

This page describes the mechanics of contributing or updating an article.

The contribute page

There are three fields on the page, and up to three buttons:

Fields on the page

Title -- the title you are giving the article. Please keep it short
Tags -- index tags so we can categorize the article. The article will appear indexed under these tags in the main menu. More on this below
Content -- the article itself, written using one of the supported markup languages

Buttons

check -- use this to see a preview of the article; also to see if the title and tags are acceptable. Clickingcheck does not update any files on REBOL.org: any existing version of the article saved on REBOL.org will be unchanged.
save -- use this to save the article without publishing it. Only you, any other owners, and the Librarians will be able to read it. This is a useful thing to do if you are writing an article online and have a flakey connection, or have to end your session. The last saved copy will be available when you next reconnect.
publish -- the article is immediately published. Any visitor to the Library will be able to read it.
Tags

Overview
Tags are short phrases uses to catalog and index an article. Surround each phrase by a pair of square brackets, eg:
```
    [CGI coding] [Online games] [Tutorial]
 
```
An article given those tags will be indexed under each of the three phrases: "CGI coding", "Online games" and "Tutorial"
An article must have at least one tag.
Menu entry
The menu entry (on the left of each page) will index under the first word of each tag.
Again, in the example, the article will have index entries for: "CGI", "Online" and "Tutorial"
However, the tag is ignored if the first word contains anything other than letters and digits. You will not get an index entry for any of these tags:
```
    [Object! creation] [$64 question] [C++ and REBOL]
 
```
Levels
This is mainly for future reference: levels are currently ignored.
A tag entry can have more than one level. Separate the levels with two forward slashes:
```
    [CGI//tutorial] [Community//future directions] [Datatypes//series//blocks and lists]
 
```
One day, when there are enough articles, we'll produce a proper multi-level index based on these tags.
Last updated: 8-Feb-2006