Help:Adding a new programming example: Difference between revisions

m
Update syntax highlighting
(Updated example for new code-tags)
m (Update syntax highlighting)
 
(6 intermediate revisions by 4 users not shown)
Line 1:
{{#set:is contribution page=true}}So you want to contribute code, eh? If you've used wikis before, it's actually very easy. If not, then you'll need a few pointers to get started.
 
==Every page is editable (almost)==
Line 9:
==Navigation==
 
To add your own programming example, you must [[:Category:Solutions by Programming Task|navigate]] to the programming task to which you wish to add a solution to. Once you find your task, go ahead and click the Edit tab at the top of the page, find the place in the list of languages already applied where your language would fall alphabetically, and make your changes.
 
In order to maintain the readability, searchability and browseability of Rosetta Code, we need you to follow certain formatting rules. Please ensure that your contributed code conforms to one of these [[Help:Programming Example Prototypes|programming example prototypes]]. A simple example should look something like this:
 
<nowiki>=={{header|C}}==
{{works with|gcc|4.0.1}}
=={{header|C}}==
{{libheader|SDL}}
{{works with|gcc|4.0.1}}
{{libheader|SDL}}
 
Optional text explaining stuff
 
<codesyntaxhighlight lang="Cc">
int main ( void ) {
// Some code here
}
</syntaxhighlight>
</code>
{{out}}
</nowiki>
<pre>
Output, if desired or necessary
</pre></nowiki>
 
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 using the "works with" template. You should also note any special [[libraries]] you use with the "libheader" template.
 
The &lt;code&gt;<nowiki><syntaxhighlight></nowiki> tags enclose the actual example, and allow [[Help::Syntax_highlighting |syntax highlighting]], which includes proper formatting for white space. Some languages don't have syntax highlighting support, but using the syntaxhighlight tags will not break anything. If your language is not supported, it will be as if you used pre tags. If support is added later, your example will automatically be highlighted, so add the lang tags no matter what. It is not necessary the the language parameter of the syntax highlighter match the actual language name. Even if your language is not specifically supported you may find a different language syntax highlighter is close enough.
 
The output section is only necessary if desired, or if the task requires to show output.
 
==Formatting==
10,327

edits