Difference between revisions of "Help:Tutorial/Edit an article"

From Civicwiki
Jump to: navigation, search
Line 1: Line 1:
This tutorial presents the mechanics of editing (or creating) an article.  If you are creating an article, and it is your first, please read about creating your first article.
+
This tutorial presents the mechanics of editing (or creating) an article.   
Civicwiki has attempted to make editing (and creating) articles easy. 
 
:This tutorial is a detailed set of instructions for using the SemanticWiki form we have created for article creation and editing. 
 
First thing first:  You must be a registered user to edit an article on CW.  To register, [[Special:UserLogin|start here]].
 
  
=====Catalog your article:=====
+
The best way to learn how to edit an article is to read the tutorial on [[Help:Tutorial/Create an article|creating an article]].  Then come back here for a few additional instructions:
The window at the top of the form lists all the categories that currently exist.  Selecting the proper category is the way to catalog/assign your article. 
 
:There will be instances in which you will want to catalog an article under more than one category.  That is discussed below.  Using the category selection box on the form, you may only select one category. 
 
To assign it correctly, you must be familiar with the top level categories.  That familiarity can only be obtained by reading the introduction on the portal pages for each top level categories.
 
:Links to the portals are visible on the top-right of the main page.  They are also listed here:
 
::[[Portal:Inalienable Rights|Inalienable Rights]]
 
::[[Portal:America's Heritage|America's Heritage]]
 
::[[Portal:American Independence|American Independence]]
 
::[[Portal:Federalism and Democracy|Federalism and Democracy]]
 
::[[Portal:Wealth, Poverty, and Freedom|Wealth, Poverty, and Freedom]]
 
::[[Portal:The Issues|The Issues]]
 
Select the intended category by clicking the circle next to the category name
 
=====Text boxes=====
 
Most of the rest of the article form is boxes for typing textEach such text box has a help bar at the top of the box that provides buttons and drop-down lists of buttons and instructions for how to format your article, insert links, images, references, etc.  The best way to become familiar with it is to explore it.
 
=====Create a Summary=====
 
Next is the summary text box.  A summary is not mandatory, but is advisable.
 
<br>The Summary text box is for typing a short summary or abstract of the article.  The current use for summaries is to place them on the Civicwiki main page or on the portal page in the sample article box accompanied by a link to the article page.
 
=====Dividing the article into sections=====
 
The body of the article itself is divided into sections.  It is not mandatory to have more than one section, but for articles with more than one simple point to make will likely benefit from using sections.  If you are familiar with Wikipedia articles, you haves seen sections. 
 
  
Why use sections?
+
As for creating an article, you must be a registered user to edit an article. (see the tutorial on [[Help:Tutorial/Register|registering]].
*You may want others to be able to link to a specific paragraph or point that is buried in a long article.  If the article is divided into sections, others can link to a specific section using the url for the article with "#''sectionname''" appended to it. 
+
 
*An expandable table of contents is inserted at the top that shows the list of links to each section.
+
To edit an article, simply click on the tab: 'Edit with form'.  If you have read the tutorial on creating an article, you know what is needed to edit.
*Using the form, infoboxes can be inserted on the right side of each section.
 
*Section headers provide an easy visual way to find information in a long article.
 
Wikipedia inserts section breaks using 2nd level headings (see help menu above) and they appear as a bold heading with a page-wide separating line below.  That approach can be used in CW articles, but the CW article form provides a flexible approach. (see below)
 
<br>There are two ways to divide an article into sections. 
 
#  Using the form to add and rearrange sections.<br>The box for typing text for the first section is next below the summary box.  <br>You can give this, and any other section, a heading by inserting a 2nd level heading as described above.  Below that, simply type the text for the section as you would any wiki page. <br>Add a section by clicking on the 'Add NEW Section' boxThat will drop in a template for the new section and two infoboxes below the current section.  <br>You will see three buttons near the top-left of the 1st infobox template.  These allow you to <br>-  insert a new section above the current section, <br>-  delete the current section, or <br>-  rearrange the order of sections by sliding the current section up or down in the order.
 
#  Inserting a 2nd level heading as described above in the Help menu. <br>You can elect not to use the form for adding sections and simply insert 2nd level headings (see the help menu above).  These create new headings on wiki pages.  Unlike in Wikipedia, however, sections created this way in Civicwiki do not result in 'edit' buttons to the right of the section.  Also, the only option for editing an article is to 'edit using form'.  If you have not used 'Add NEW Section' to divide the article into sections, the form will treat the article as a single long section for editing purposes.
 

Revision as of 18:42, 18 June 2014

This tutorial presents the mechanics of editing (or creating) an article.

The best way to learn how to edit an article is to read the tutorial on creating an article. Then come back here for a few additional instructions:

As for creating an article, you must be a registered user to edit an article. (see the tutorial on registering.

To edit an article, simply click on the tab: 'Edit with form'. If you have read the tutorial on creating an article, you know what is needed to edit.