Help:For Authors

From RHESSI Wiki

(Difference between revisions)
Jump to: navigation, search
m
 
(30 intermediate revisions not shown)
Line 4: Line 4:
All pages on this wiki are articles including the RHESSI science nuggets.  In order to create a new article a title must first be chosen.  The title of an article cannot be changed so choose your article title carefully!  It is possible to move the content from one article to another with a different title but this is not a recommended practice.  There are two main ways to create an article.
All pages on this wiki are articles including the RHESSI science nuggets.  In order to create a new article a title must first be chosen.  The title of an article cannot be changed so choose your article title carefully!  It is possible to move the content from one article to another with a different title but this is not a recommended practice.  There are two main ways to create an article.
-
*Simply search for the title of the article you wish to create using the search bar on the left.  The wiki should confirm that no other articles have this title by not finding it and will give a choice to create this article.  Click the link and your new article will open in edit mode.
+
*Simply search for the title of the article you wish to create using the search bar on the left.  The wiki should confirm that no other articles have this title by not finding it and will give a choice to create this article.  Click the link (at "you searched for") and your new article will open in edit mode.
*Articles are organized through categories.  An article is added to a category by adding meta-data into the article text.  The next method for creating an article is to navigate to the category page and use the Form to create a new article in that category.  The RHESSI Science Nugget category page can be found [[:Category:Nugget|here]].  The category meta-data will then automatically be included in the article text.
*Articles are organized through categories.  An article is added to a category by adding meta-data into the article text.  The next method for creating an article is to navigate to the category page and use the Form to create a new article in that category.  The RHESSI Science Nugget category page can be found [[:Category:Nugget|here]].  The category meta-data will then automatically be included in the article text.
 +
 +
== Writing your article ==
 +
 +
Writing a wiki article is very straightforward.  Every article has an "edit" tab above it.  Clicking that will open in the article in an editable window.  Many formatting shortcuts can be found above the editing window.  Since each article on this wiki can be edited, it is easy to learn by example.  For more basic help with editing read the following [[Help:Editing|article]].
 +
 +
=== Adding Figures ===
 +
In order to add a figure it is first necessary to upload the image to the wiki.  This can be done by using the link on the left titled "Upload File".  Please use a descriptive name for the file and add a description of its contents.  Once uploaded the file can be added to articles using the following command
 +
'''<nowiki>[[Image:POF.jpg|200px|thumb|right|'''Figure 1''': This is the figure caption.]]</nowiki>'''
 +
whose results can be seen to the right.  Most of these parameters should be self explanatory.  The "thumb" parameters tells the wiki that this is a figure and therefore displays the figure caption.  The float parameters (in this case set to "right") tells the wiki where to float the image.  Possibilities include "left", "center", or "right". 
 +
 +
[[Image:POF.jpg|250px|thumb|right|'''Figure 1''': This is the figure caption. Note that the figure has properlyy appeared on the right, but that you can't really control how the text will wrap around it - that depends on the browser.]]
 +
 +
If you'd like to experiment with more advanced methods read this [http://en.wikipedia.org/wiki/Image_tutorial article] on Wikipedia's website.
 +
 +
=== Style and content ===
 +
 +
We try to write the Nuggets so that a technically literate reader won't be baffled.
 +
That means that the text should appear in plain English, and that jargon is a no-no.
 +
Many scientists don't realize they are writing gibberish so please be careful about this.
 +
On the plus side, you can freely use cgs units if you wish.
 +
Also please be aware that many of the audience are not native English speakers, so phrases like "X must have been a gutsy operator to have diagonalized those macrospicules" would not do so well.
 +
Writing as though for a newspaper, rather than as for a boring archival journal, would be best - there is no need really to have complete literature
 +
citation, since those ''really'' knowledgeable about the field will certainly know where to go (ADS).
 +
 +
==Meta data==
 +
 +
In order to provide better tools to organize and search for nugget topics, we encourage authors to use the following meta data tags in their articles.
 +
 +
* To note that an article discusses a particular event use the following <pre>[[Has event date:: November 09, 2002 13:12]]</pre>
 +
* To denote that an article makes use of data from a particular observatory add <pre>[[Has observation by:: EIT| ]]</pre> at the bottom of the article.
 +
* Subject topics should also be added. The syntax for that is <pre>[[Has article subject:: theory]]</pre>.
 +
The following subjects are available.
 +
 +
* theory
 +
* educational
 +
* microflares
 +
* CMEs
 +
 +
 +
 +
== Source Code ==
 +
If you'd like to add actual source code in your article please use the following syntax.
 +
 +
<source lang="csharp">
 +
// Hello World in Microsoft C# ("C-Sharp").
 +
 +
using System;
 +
 +
class HelloWorld
 +
{
 +
    public static int Main(String[] args)
 +
    {
 +
        Console.WriteLine("Hello, World!");
 +
        return 0;
 +
    }
 +
}
 +
</source>

Latest revision as of 02:15, 18 September 2018

This page describes the steps necessary to create and edit your own article. This information is generally valid for creating any kind of article on this wiki but may be particularly useful to new Nugget authors.

Contents

Creating an Article

All pages on this wiki are articles including the RHESSI science nuggets. In order to create a new article a title must first be chosen. The title of an article cannot be changed so choose your article title carefully! It is possible to move the content from one article to another with a different title but this is not a recommended practice. There are two main ways to create an article.

Writing your article

Writing a wiki article is very straightforward. Every article has an "edit" tab above it. Clicking that will open in the article in an editable window. Many formatting shortcuts can be found above the editing window. Since each article on this wiki can be edited, it is easy to learn by example. For more basic help with editing read the following article.

Adding Figures

In order to add a figure it is first necessary to upload the image to the wiki. This can be done by using the link on the left titled "Upload File". Please use a descriptive name for the file and add a description of its contents. Once uploaded the file can be added to articles using the following command

[[Image:POF.jpg|200px|thumb|right|'''Figure 1''': This is the figure caption.]]

whose results can be seen to the right. Most of these parameters should be self explanatory. The "thumb" parameters tells the wiki that this is a figure and therefore displays the figure caption. The float parameters (in this case set to "right") tells the wiki where to float the image. Possibilities include "left", "center", or "right".

Figure 1: This is the figure caption. Note that the figure has properlyy appeared on the right, but that you can't really control how the text will wrap around it - that depends on the browser.

If you'd like to experiment with more advanced methods read this article on Wikipedia's website.

Style and content

We try to write the Nuggets so that a technically literate reader won't be baffled. That means that the text should appear in plain English, and that jargon is a no-no. Many scientists don't realize they are writing gibberish so please be careful about this. On the plus side, you can freely use cgs units if you wish. Also please be aware that many of the audience are not native English speakers, so phrases like "X must have been a gutsy operator to have diagonalized those macrospicules" would not do so well. Writing as though for a newspaper, rather than as for a boring archival journal, would be best - there is no need really to have complete literature citation, since those really knowledgeable about the field will certainly know where to go (ADS).

Meta data

In order to provide better tools to organize and search for nugget topics, we encourage authors to use the following meta data tags in their articles.

The following subjects are available.


Source Code

If you'd like to add actual source code in your article please use the following syntax.

// Hello World in Microsoft C# ("C-Sharp").
 
using System;
 
class HelloWorld
{
    public static int Main(String[] args)
    {
        Console.WriteLine("Hello, World!");
        return 0;
    }
}
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox