CZ:Start Article: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Hayford Peirce
(replaced a bunch of -- with emdashes)
m (linking to how to create articles with subpages)
(48 intermediate revisions by 17 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
== The Easy Way ==
=Start it—two ways=
'''''A video demonstration of this method is available [http://www.trailbrain.com/wikihelpvideos/create_an_article/create_an_article.html Here]!'''''
''For [[CZ:Eduzendium|Eduzendium]] articles, there are [[Template:R EZ/doc/How to start your articles|separate instructions]] for setting them up in a course-specific format.''
 
{| class="wikitable"
|-
|width=33%|
<center><font size="4">1. The easy way</font></center>
|width=33%|
Type the title of your new article in the box to the right, click on the bar below it, and you've begun!  You can use the search box (menu panel, left, this page, top) to check for related articles that already exist. See [[CZ:Topic Choice|Topic Choice]] and [[CZ:Naming Conventions|Naming Conventions]] if you need to.
|width=33%|
<inputbox>
<inputbox>
  type=create
  type=create
Line 8: Line 16:
  buttonlabel=Start a new encyclopedia article
  buttonlabel=Start a new encyclopedia article
</inputbox>
</inputbox>
If you don't like long instructions and you learn by doing, just type in the title of the encyclopedia article you want to start, and get to work!  That is the kind of [[CZ:Be Bold|boldness]] we like.
|-
 
|width=33%|
Do use the search box (upper left) to check for related articles that already exist, though.
<center><font size="4">2. The complete way, with subpages</font></center>
 
|width=33%|
Let's begin with the mechanical procedure of making a new page, for folks who haven't used the software before.  If you want to follow along, open a new window or print out a copy of this page first.
Do you want to start an article with [[CZ:Subpages|subpages]]?
 
|width=33%|
# Let's make a test article, not a real article.  Start in the [[CZ:Sandbox|Sandbox]].  Notice the "edit" tab near the top of the page?  You can click that.  Go ahead and click it.  That big text box that pops up is where you can edit the page, about as easily as you edit an e-mail.
'''[[Special:MetadataForm|Click here to start]].''' (''currently not working'')
# To create a new article, all you have to do is type "test article" (or the name of the article you want to create), but place <nowiki>[[</nowiki> and <nowiki>]]</nowiki> around it, so you get something like this: <nowiki>[[test article]]</nowiki> That will create a link.  (For pointers on article naming, see [[CZ:Topic Choice|Topic Choice]] and [[CZ:Naming Conventions|Naming Conventions]].)
<br>(''but you can do it anyway, with patience'')
# Next, look (or scroll) down below the text box you're writing in.  Look for the "Save page" button.  Press it.  Voila, you have edited the Sandbox!  You have also created a link to an as-yet nonexistent article.  On the Sandbox page, look for the text you added.  It should be there as a red link.
<br>[[CZ:Creating_an_article_with_subpages]]
# Click on the red link.  This pulls up another text box, just like the one you saw before, except that it is completely empty.  So now you can go to town writing your new article.  Then press "Save page."
|}
# Add the checklist.  (If you're brand new to the ''Citizendium,'' you can skip this—someone else will help, and we don't want to overwhelm you.)  Add [[CZ:The Article Checklist|The Article Checklist]] to the talk page.
 
When you start new pages, please make a habit of doing it ''from'' other pages, just as the above demonstrates.  For example, if I wanted to start an article about a famous philosopher, I might add a link to the (as-yet nonexistent) page from the [[philosophy]] article.  Then, to start the page, I click on the link I just added.  Of course, a link to the page I want might already exist.
 
== Using Subpages ==
 
For the hard way—which you'll learn eventually, but don't have to learn right away—see [[CZ:Start article with subpages|Start article with subpages]].  Or you can just get started with them—see [[CZ:Using the Subpages template|Using the Subpages template]] or go right to the [http://en.citizendium.org/wiki/CZ:Using_the_Subpages_template#Instructions_for_placing_the_Subpages_template instructions.]
 
== Markup basics ==
When you work on your article, you'll be typing pretty much as if you were writing an e-mail.  But to make text '''bold''' or ''italicized,'' or to create [[Biology|links]], you'll be using wiki "markup."  If you've never used this before, don't worry—it's not complicated!
 
There are just a few bits of code you need to learn, which you'll be using over and over again:
* To start a new paragraph, simply skip down ''two'' lines.  Skipping down ''one'' line has no effect on presentation.
* To make text '''bold,''' put three single quotation marks around the text: <code><nowiki>'''bold'''</nowiki></code>
* To ''italicize'' text, use two single quotes: <code><nowiki>''italicize''</nowiki></code>
* To [[link]] to a page, surround the text to be linked with left and right double brackets: <code><nowiki>[[link]]</nowiki></code>
* To make a [[Biology|link]] that points to an article that is ''different'' from the text of the link, you use a "pipe," like this: <code><nowiki>[[Biology|link]]</nowiki></code>
* To start a new section, surround the section title on both sides by two equals signs (flush left): <code><nowiki>== My New Section ==</nowiki></code>
* To make a bulleted list, precede a list item with * and make sure it's flush left: <code><nowiki>* My bullet point</nowiki></code>
* To make a numbered list, do the same but with #, like this: <code><nowiki># My numbered point</nowiki></code>
 
Here's a handy hint: if you see some bit of formatting you'd like to replicate, click the "edit" button and look to see how it's done.  This is how many of us learned the code—which, again, isn't hard!
 
See [[CZ:How to edit an article|How to edit an article]] for a more complete list.
 
== What's a good article like? ==


Here are some basics about [[Citizendium_Pilot:Policy_Outline#Authoring_Articles|content]] and [[CZ:Article Mechanics|formatting]] of articles.  There are many small issues here, but here are a few important ones you should know about.
= Write it =
{| class="wikitable" style="background:lightyellow"
|-
|width=33%|
<center><font size="4">What should you write?</font></center>
|width=33%|
An accurate, interesting and readable encyclopedia article on just about any topic.
|width=33%|
'''[[CZ:Approval Standards|Learn more here]].'''


A good article [[Citizendium_Pilot:Policy_Outline#Article_Standards|satisfies many standards]]. It is an encyclopedia article, first of all, and it is accurate, neutral, coherent, comprehensive, well-written, pitched at the university student level, not original research, family-friendly, and legal and responsible.
|-
|width=33%|
<center><font size="4">Learn the code</font></center>
|width=33%|
If you've never edited a wiki page before, read a little about the wiki code - it's not hard.
|width=33%|
'''[[CZ:How to edit an article|Learn more here]].'''


Here are some essential points:
|-
|width=33%|
<center><font size="4">Learn our standards</font></center>
|width=33%|
We're writing coherent narratives, not grab-bags of facts.
|width=33%|
'''[[CZ:Article mechanics|Learn more here]].'''


* The article title should be uppercase for the first word, then lowercase for the following words unless it is typically written uppercase when used in a regular sentence.  So: [[Computational complexity theory]]; but [[American Chemical Society]].  Unless there is a compelling reason not to, articles about people should begin with the person's first name first, e.g., [[Albert Einstein]].
|-
* Copy and paste the following text onto the bottom of any new articles: <code><nowiki>[[Category:CZ Live]]</nowiki></code>.  This adds the article to the "live articles" category (which you can view by clicking "Live articles" on the left).  This helps mark articles we've actively worked on.
|width=33%|
* The first use of the title word, phrase, or name should be '''bold.'''  For example: "'''Biology''' is the science of life."
<center><font size="4">Get some tips</font></center>
* Start the article with a ''definition,'' if it concerns a concept or general category, or else an explanation of what the person, place, event, etc., is best known for.  For example: "'''Achillea''' is a genus of flowering plants, commonly referred to as yarrow, that are frequently used in garden borders and beds in ornamental horticulture."
|width=33%|
* Link words and phrases (by surrounding the phrases with left and right double brackets: <nowiki>[[</nowiki> <nowiki>]]</nowiki>) where, and only where, the links are relevant to the point being made in a sentence, and where following a link will shed important light on the subject of the article.
A few things every Citizen should know.
* Remember that we employ a [[CZ:Neutrality Policy|Neutrality Policy]]. The policy requires that we include all significant viewpoints on a subject, stated as fairly and sympathetically as possible.  It does not mean that we take a mainstream, scientific, skeptical, or "intermediate/compromise" point of view; it means we write neutrally.  So we "take a step back" if necessary, and ''describe'' any controversies fairly, rather than trying to settle them in any way at all.
|width=33%|
'''[[CZ:Essentials|Learn more here]].'''


For other tips, see [[CZ:Dozen Essentials|Dozen Essentials]], [[CZ:Approval Standards|Approval Standards]], and [[CZ:Article Mechanics|Article Mechanics]].
|}


{{Getting Started}} [[Category:Getting Started]]
{{Getting Started}}

Revision as of 15:24, 31 March 2022

Start it—two ways

For Eduzendium articles, there are separate instructions for setting them up in a course-specific format.

1. The easy way

Type the title of your new article in the box to the right, click on the bar below it, and you've begun! You can use the search box (menu panel, left, this page, top) to check for related articles that already exist. See Topic Choice and Naming Conventions if you need to.


2. The complete way, with subpages

Do you want to start an article with subpages?

Click here to start. (currently not working)
(but you can do it anyway, with patience)
CZ:Creating_an_article_with_subpages

Write it

What should you write?

An accurate, interesting and readable encyclopedia article on just about any topic.

Learn more here.

Learn the code

If you've never edited a wiki page before, read a little about the wiki code - it's not hard.

Learn more here.

Learn our standards

We're writing coherent narratives, not grab-bags of facts.

Learn more here.

Get some tips

A few things every Citizen should know.

Learn more here.


Citizendium Getting Started
Join | Quick Start | About us | Help system | How to start a new article | For Wikipedians
How to Edit
Getting Started Organization Technical Help
Policies Content Policy
Welcome Page