Help:Tutorial/Create an article - Revision history

Jeff at 19:13, 31 October 2014

2014-10-31T19:13:54Z

Jeff: /* Catalog your article: */

2014-10-31T18:37:31Z

‎Catalog your article:

Jeff at 20:12, 1 July 2014

2014-07-01T20:12:46Z

Jeff: Undo revision 1416 by Jeff (talk)

2014-06-25T15:00:35Z

Undo revision 1416 by Jeff (talk)

Jeff at 14:08, 25 June 2014

2014-06-25T14:08:08Z

Jeff at 15:25, 22 June 2014

2014-06-22T15:25:36Z

Jeff at 15:24, 22 June 2014

2014-06-22T15:24:28Z

Jeff at 14:58, 22 June 2014

2014-06-22T14:58:50Z

Jeff at 13:48, 22 June 2014

2014-06-22T13:48:50Z

Jeff at 13:44, 22 June 2014

2014-06-22T13:44:55Z

@@ Line 2: / Line 2: @@
 Civicwiki has attempted to make creating (and editing) articles easy.
 :This tutorial is a detailed set of instructions for using the SemanticWiki form we have created for article creation.
 ====Who may create an article====

@@ Line 20: / Line 20: @@
 ::[[Portal:American Independence|American Independence]]
 ::[[Portal:Federalism and Democracy|Federalism and Democracy]]
-::[[Portal:Wealth, Poverty, and Freedom|Wealth, Poverty, and Freedom]]
+::[[Portal:Economic Freedom|Economic Freedom]]
 ::[[Portal:The Issues|The Issues]]
 Select the intended category by clicking the circle next to the category name
@@ Line 31: / Line 31: @@
 :#Enter a category tag for each additional category desired.  Here is a sample category tag for a fictional category called "addcat":  &#91; &#91;Category''':'''addcat&#93; &#93;
 :#Save page
 ====Text boxes====
 Most of the rest of the article form is boxes for typing text.  Each 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.

@@ Line 3: / Line 3: @@
 :This tutorial is a detailed set of instructions for using the SemanticWiki form we have created for article creation.
-===="Users" and "Writers"====
+====Who may create an article====
-You must register as a "user" to edit an article on CW.  To register, [[Special:UserLogin|start here]].
+Anyone may create an article, but you must be a registered user to publish your own article.
-<br>A "user" has permission to edit an article and to submit new articles for approval.
+<br>A registered "user" may also edit an article.
-<br>A "writer" can approve his own articles.
+<br>Anyone may register.  To register, [[Special:UserLogin|start here]].
-<br>Users are promoted to writers after having one or two articles approved by an editor.
+<br>Any CW visitor may submit an article.  It must be approved by an editor before it is published.
-If you are a "user", click the "Add Article (user) to initiate your article.
+If you are a "user", click "Add Article(registered)" on the left sidebar to initiate your article. <br>If you are a visitor, click "Add Article (visitor) on the left sidebar.
 ====Catalog your article:====
-The window at the top of the form lists all the categories that currently exist.  It is important to select the proper category to catalog your article.
+The window at the top of the form lists all the categories (topics and subtopics) that currently exist.  It is important to select the proper category to catalog your article.
-:There will be instances in which you will want to catalog an article under more than one category.  That is discussed below.  The category selection box on the form allows assignment to only one category.
+:The category selection box on the form allows assignment to only one category and that is all that is required.  Select the best fit.  There will be a few instances in which you will want to catalog an article under more than one category.  That is your choice.  It is discussed below.
-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 category.
+To assign it correctly, you must be familiar with the top level categories.  For that matter, the fact that you want to write an article for CW assumes that you are familiar with the CW mission.  That familiarity can only be obtained by reading a few things - the [[Main Page|main page]], [[Civicwiki:Just the Facts Maam|about CW]], the [[Civicwiki:Mission|CW mission]], and the introductions on the portal pages for each top level category.
 :Links to the portals are visible on the top-right of the main page.  They are also listed here:
 ::[[Portal:Inalienable Rights|Inalienable Rights]]
@@ Line 37: / Line 37: @@
 <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.
+The body of the article itself is divided into sections.  It is not mandatory to have more than one section, but 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?
@@ Line 44: / Line 44: @@
 *Using the form, infoboxes can be inserted on the right side of each section. (see below)
 *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)
+Wikipedia inserts section breaks using 2nd level headings (see help menu above) and they appear as a bold heading underlined by a page-wide separating line.  That approach can be used in CW articles by simply inserting a 2nd level heading to indicate a new heading, but the CW article form provides a more 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' box.  That 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.
+#  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 (and probably should) give this, and any other section, a heading by inserting a 2nd level heading as described above.  Below the heading line, simply type the text for the section as you would any wiki page. <br>Add a section by clicking on the 'Add NEW section' box.  That will drop in a template for the new section (along with its two infobox templates) 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.
+#  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.
 ====Inserting infoboxes====

@@ Line 5: / Line 5: @@
 ===="Users" and "Writers"====
 You must register as a "user" to edit an article on CW.  To register, [[Special:UserLogin|start here]].
-<br>It is our intention to let "users" edit articles, on CW, but to require that the first articles they write be submitted for approval by an editor before being "published".  At this point in time, the Mediawiki software that we use is not capable of permitting a user group to edit a published article without also having permission to also approve their own articles for publication.  That capability is coming (we are told).  Until then, a user
+<br>A "user" has permission to edit an article and to submit new articles for approval.
 <br>A "writer" can approve his own articles.
 <br>Users are promoted to writers after having one or two articles approved by an editor.

@@ Line 5: / Line 5: @@
 ===="Users" and "Writers"====
 You must register as a "user" to edit an article on CW.  To register, [[Special:UserLogin|start here]].
-<br>A "user" has permission to edit an article and to submit new articles for approval.
+<br>It is our intention to let "users" edit articles, on CW, but to require that the first articles they write be submitted for approval by an editor before being "published".  At this point in time, the Mediawiki software that we use is not capable of permitting a user group to edit a published article without also having permission to also approve their own articles for publication.  That capability is coming (we are told).  Until then, a user
 <br>A "writer" can approve his own articles.
 <br>Users are promoted to writers after having one or two articles approved by an editor.

@@ Line 28: / Line 28: @@
 To assign to multiple categories:
 :#Edit the article by clicking the tab "Edit with form".
-:#Scroll to the last text box in the form.
+:#Scroll to the text box at the very bottom of the form.
-:#Enter a category tag for each additional category desired
+:#Enter a category tag for each additional category desired.  Here is a sample category tag for a fictional category called "addcat":  &#91; &#91;Category''':'''addcat&#93; &#93;
 ====Text boxes====
 Most of the rest of the article form is boxes for typing text.  Each 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.

← Older revision		Revision as of 13:44, 22 June 2014
Line 33:		Line 33:
	# 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' box. That 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.		# 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' box. That 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.		# 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.
		+
		+	=====Inserting infoboxes=====
		+	If you are familiar with Wikipedia articles, you are familiar with the infoboxes that appear on the right side of many of the articles that add image, graphic, and textual information to the article. The article form attempts to make this easy for you by providing an infobox template.
		+	*The article form provides templates for two infoboxes in each section.
		+	:*Each infobox will accommodate an image, a caption for the image, and descriptive text.
		+	::Note that an image is not required. You can leave that blank and simply type in descriptive text that can be formatted the same as the main text in the article.