Help:Adding a new programming language

From Rosetta Code
Revision as of 16:06, 7 November 2007 by rosettacode>IanOsgood (list good starter examples)

If you're familiar with the language, adding a new programming language is simple enough.

Programming Example

You should probably start by examining the existing programming tasks, and finding one that you can complete with your language of choice. Good starter examples are Empty Program, Comments, User Output, and those in Category:Control Structures and Category:Basic Data Operations.

Then you need to add a programming example to that task. Find the place in the list of languages already applied where your language would fall, alphabetically. Then enter something like this:

 =={{header|C}}==
 '''Compiler:''' [[GCC]] 4.0.1
 
  int main ( void ) {
       // Some code here
  }

You don't have to use the C programming language, and your code example will probably be different. You need to make sure you create a link to your language of choice, and to your compiler, interpreter, or what-have-you. To create a link, surround the text with double square brackets. For example, GCC would be represented as [[GCC]].

Finally, note the importance of the extra space in front of the code. That creates a dashed box around the code sample, and puts it in a monospace font.

Language Page

If a programming example already exists for the language, creating a language page is extremely simple. Just click on the link to the language, and click "Create this article", on the resulting page. Add whatever information is appropriate, and end the article with the language template.

Language Template?

That's right. Each language page has the language template applied to it. The language template points out that the article describes a programming languages, and offers a link pointing back to any page that points to it. In this way, someone curious about a language can find all of the programming examples that use it.

The language template also adds the page to the Language category, so that people interested in seeing a complete list of languages at Rosetta Code can go to the Language Category index page to see the list.

To add the language template to a page, add the text {{Programming Language}} to the end of the page.

Click Preview Page, and you can see what your page will look like. Click Save Page, and you'll also see the page added to the Language category.

Cool, huh?

Conclusion

Thanks for showing an interest in adding information to Rosetta Code. With the help of people like you, Rosetta Code will become a true programmer's resource!