Difference between revisions of "Help:Contents"

From CIPedia
Jump to navigation Jump to search
(General)
(Adding a Category)
 
(21 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== General ==
 
== General ==
CIPedia© is organized as a collection of terms. For each term, a page has been created, which contains one or more definitions, references, related terms and discussion regarding the term.
+
CIPedia© is organized as a collection of terms with standard definitions extracted from different sources.  
 +
Each term has a corresponding wiki page or article, which contains one or more definitions, references, related terms and discussions related to the term.
  
 
== Creating a new article  ==
 
== Creating a new article  ==
A new article reflects the addition of a new term in CIPedia(c). There are three ways to create a new article:
+
A new article reflects the addition of a new term in CIPedia. There are three ways to create a new article:
* By linking a wiki article using a standard syntax. If you (or anyone else) create a link to an article that doesn't exist yet, the link will be coloured red. Clicking a red link will take you to the edit page for the new article. Simply type your text, click save and the new article will be created. Once the article has been created, the link will change from red to blue (purple for pages you've visited) indicating that the article now exists.  
+
* By linking to a non-existing wiki article using a standard syntax. If you (or anyone else) create a link to an article that doesn't exist yet, the link will be coloured with red. Clicking a this red link will take you to the edit page of the new article. Simply type your text, click save and the new article will be created. Once the article has been created, the link will change from red to blue (or purple for pages you've visited) indicating that the article is now created in CIPedia.  
 
* If you search for a page that doesn't exist (using the search box and “Go” button on the left of the page) then you will be provided with a link to create the new page.  
 
* If you search for a page that doesn't exist (using the search box and “Go” button on the left of the page) then you will be provided with a link to create the new page.  
* You can use the wiki's URL for creating a new article. The URL to a new article of the wiki is usually something like this: www.cipedia.eu/New_Term _Name
+
* You can use the wiki's URL for creating a new article. The URL to a new article of the wiki is usually something like this: www.cipedia.eu/New_Term_Name.
 +
 
 +
More details about adding new pages can be found at MediaWiki http://www.mediawiki.org/wiki/Help:Starting_a_new_page.
  
 
== Adding content in a new article ==
 
== Adding content in a new article ==
=== Using the template ===
+
=== Applying the template ===
The articles (terms) in CIPedia(c) follow a common format. Start with the introduction, a few paragraphs summarizing the page. Make the first mention of the page's subject bold. Place the article's content in level 2 headers like {{nowrap|1=<code><nowiki>== Section title here ==</nowiki></code>}}, only capitalizing the first word unless there are subsequent proper nouns. The last sections can add information such as ''See also'', ''References'', and ''External links'', in that order. Place those sections in level 2 headers as well.
+
The articles (terms) in CIPedia follow a common format. They start with a short introduction, followed by available definitions for the term: European, International, National or Standard ones. A ''Discussion'' section follows summarizing the page. The last sections can also contain information such as ''See also'' (links to related terms), ''Notes'' (the sources of the article), and ''References'' (additional references), in that order.
 +
 
 +
The template that should be used for creating the content of a new article can be found [https://publicwiki-01.fraunhofer.de/CIPedia/index.php/Template here].
 +
 
 +
=== Adding a Category ===
 +
Moreover, each article needs to be assigned to at least one Category. The categories and subcategories which are currently used in CIPedia are listed below:
  
The template that should be used for creating the content of a new page can be found [https://publicwiki-01.fraunhofer.de/CIPedia/index.php/Template here].
+
<categorytree mode=categories>Main</categorytree>
 +
Press "+" for expanding.
  
=== Adding the article to a Category ===
+
To add an article into a category, please enclose the category name inside of double brackets like <code><nowiki>[[Category:Resilience]]</nowiki></code>. More details see the MediaWiki http://www.mediawiki.org/wiki/Help:Categories#Adding_a_page_to_a_category
  
 
== Basic editing ==  
 
== Basic editing ==  
Editing a page is fairly simple. The steps are:
+
Editing a page is fairly simple. Every page on CIPedia has an edit link on it, either in the page itself or at the top left of the screen.  The steps are:
* Click the "Edit" page tab at the top of the page (you are now on Edit mode).
+
* Click the [edit] page tab at the top of the page (you are now on Edit mode).
* Make changes to the text.
+
* You'll see a place where you can type and make changes.
* Click the "Save page" button.
+
* Click the [Save page] button.
 
 
 
For advanced editing help, press [http://meta.wikimedia.org/wiki/Help:Advanced_editing here].
 
For advanced editing help, press [http://meta.wikimedia.org/wiki/Help:Advanced_editing here].
 
 
Editing most Wikipedia pages is easy. Wikipedia uses two methods of editing: the new [[Wikipedia:VisualEditor|VisualEditor]] (VE), and classic editing through [[Help:Wiki markup|wiki markup]] (wikitext). The explanations on this page deal with wikitext editing (the method most used). For instructions on using  VisualEditor see the [[Wikipedia:VisualEditor/User guide|VisualEditor user guide]].
 
  
 
=== Formatting ===
 
=== Formatting ===
  
[[File:Edit-this-page-large.png|thumb|Click here!]]
+
* '''Basic markup'''. Markup language is a very simple way to add formatting with symbols. These can be inserted using the editing tool bar or manually. Otherwise, just type normally.
 
 
* '''[[HELP:editing|Edit]]'''. Nearly every page on Wikipedia has an edit link on it, either in the page itself or at the top left of the screen. Click [edit] and you'll see a place where you can type and make changes. It will look a little different since Wikipedia uses a language called "markup". Don't worry if it looks intimidating. Just try a few small changes and copy what others do that gets the result you want.
 
* '''[[WP:cheat|Basic markup]]'''. Markup language is a very simple way to add formatting with symbols. These can be inserted using the editing tool bar or manually. Otherwise, just type normally.
 
 
** ''Looks''
 
** ''Looks''
 
*** For ''italics'', type two apostrophes ( <code>'</code> ) around the word like this <code><nowiki>''italics''</nowiki></code>.   
 
*** For ''italics'', type two apostrophes ( <code>'</code> ) around the word like this <code><nowiki>''italics''</nowiki></code>.   
Line 38: Line 40:
 
*** For '''''bold and italics''''' use five: <code><nowiki>'''''italics and bold''''' </nowiki></code>.
 
*** For '''''bold and italics''''' use five: <code><nowiki>'''''italics and bold''''' </nowiki></code>.
 
** ''Sections and lists''
 
** ''Sections and lists''
*** Section headers are made with the equals sign ( <code>=</code> ) on each side. {{nowrap|1=<code><nowiki>== This is a level 2 header ==</nowiki></code>}}. More equals signs make smaller sub-sections. {{nowrap|1=<code><nowiki>=== This is a level 3 header ===</nowiki></code>}}, and so on. You won't use a level 1 header, since that is the title of the page itself.
+
*** Section headers are made with the equals sign ( <code>=</code> ) on each side. More equals signs make smaller sub-sections, and so on. You won't use a level 1 header, since that is the title of the page itself.
 
*** Bulleted lists are made by putting <code>*&#32;</code> at the beginning of each line.
 
*** Bulleted lists are made by putting <code>*&#32;</code> at the beginning of each line.
 
*** Numbered lists are made by putting <code>#&#32;</code> at the beginning of each line.
 
*** Numbered lists are made by putting <code>#&#32;</code> at the beginning of each line.
 
** ''Links''
 
** ''Links''
*** Links from one Wikipedia page to another are made with two brackets on each side of the word like <code><nowiki>[[wikilink]]</nowiki></code>. To make a link go to a different page than the word it shows, use a pipe: <code><nowiki>[[Page|word]]</nowiki></code>.
+
*** Links from one CIPedia page to another are made with two brackets on each side of the word like <code><nowiki>[[wikilink]]</nowiki></code>. To make a link go to a different page than the word it shows, use a pipe: <code><nowiki>[[Page|word]]</nowiki></code>.
*** Links to external websites are made with one bracket on each side like <code><nowiki>[external link]</nowiki></code>. These are used in the ''External links'' section of an article.
+
*** Links to external websites are made with one bracket on each side like <code><nowiki>[external link]</nowiki></code>.  
*** [[Help:Introduction_to_uploading_images/1|Images are added]] with <code><nowiki>[[File: IMAGENAME|thumb|Image caption]]</nowiki></code>. The "thumb" part is just a size and should be left in.
 
 
** ''Paragraphs and references''
 
** ''Paragraphs and references''
 
*** Line breaks and paragraphs require hitting [return] or [enter] twice (showing an empty line in between).
 
*** Line breaks and paragraphs require hitting [return] or [enter] twice (showing an empty line in between).
Line 52: Line 53:
 
=== Communication ===
 
=== Communication ===
  
* '''[[HELP:TALK|Talk pages]]'''.  In addition to the pages you read for information, for almost every Wikipedia page there is a corresponding talk page where discussion happens among editors. To use the talk page, click [edit] and add your comments. To create a new topic, click [new section] at the top of the page, give the section a title, and leave your comment. New topics go at the end of the page.
+
* '''Talk pages'''.  In addition to the pages you read for information, for almost every CIPedia page there is a corresponding talk page where discussion happens among editors. To use the talk page, click [edit] and add your comments. To create a new topic, click [new section] at the top of the page, give the section a title, and leave your comment. New topics go at the end of the page.
 
* '''Indenting'''.  To make conversations easier to follow, place your comments below the one you are responding to and indent it using a colon (:). Each colon moves the comment farther to the right, so if the person above you used 3 colons <code>:::</code> you should use 4 <code>::::</code>. To start a new talk page topic, click [new section] at the beginning of the page and type a title with your comment, or start a new level 2 heading for the same effect.
 
* '''Indenting'''.  To make conversations easier to follow, place your comments below the one you are responding to and indent it using a colon (:). Each colon moves the comment farther to the right, so if the person above you used 3 colons <code>:::</code> you should use 4 <code>::::</code>. To start a new talk page topic, click [new section] at the beginning of the page and type a title with your comment, or start a new level 2 heading for the same effect.
 
* '''Signatures'''.  On talk pages but ''not'' article pages, all comments should be signed with <code><nowiki>~~~~</nowiki></code>. Once saved, this will turn into your username or IP address with a timestamp.
 
* '''Signatures'''.  On talk pages but ''not'' article pages, all comments should be signed with <code><nowiki>~~~~</nowiki></code>. Once saved, this will turn into your username or IP address with a timestamp.
 
* '''Edit summaries'''.  Leave a brief note about what you did and why any time you make an edit. Place it in the edit summary box before you click Save.
 
* '''Edit summaries'''.  Leave a brief note about what you did and why any time you make an edit. Place it in the edit summary box before you click Save.
  
=== [[Help:Introduction_to_referencing/1|Adding references]] ===
+
=== Adding references ===
  
* '''[[WP:sources|Good sources]]''': Newspapers, books, journals, magazines, industry publications, and expert websites; independent of the subject, with a reputation for fact-checking and accuracy; somewhere or someone you would trust if you read it, knowing that they did their homework and don't want to get the information wrong.
+
* '''Manual references''': Use reference tags after the period: ''...end of sentence.''<code><nowiki><ref>Reference info here: author, publication, date, title, place, web address, etc.</ref></nowiki></code> Place at the end of the sentence after the punctuation.
* '''[[Wikipedia:Referencing_for_beginners|Manual references]]''': Use reference tags after the period: ''...end of sentence.''<code><nowiki><ref>Reference info here: author, publication, date, title, place, web address, etc.</ref></nowiki></code> Place at the end of the sentence after the punctuation.
+
* '''Notes section''': References should appear at the end of the page. You don't have to type out the references there; instead, place them ''inside'' the article after the sentence they support. They'll appear automatically. You can add additional references manually to the '''References section'''.
* '''[[Wikipedia:Referencing_for_beginners_with_citation_templates|Better references with templates]]''': These are thorough and easy to use. Click [edit], and place the cursor at the end of the sentence you want to reference. Using the editing toolbar, click [cite] or {{ }} and choose the source type (web, book, television…). Fill out the fields you know, click [enter], and [save] when ready.
 
* '''Reference section''': References should appear at the end of the page. Make a level 2 header: {{nowrap|1=<code><nowiki>== References ==</nowiki></code>}}. Then place <code><nowiki>{{reflist}}</nowiki></code> below the header. You don't have to type out the references there; instead, place them ''inside'' the article after the sentence they support. They'll appear automatically.
 
  
=== [[Help:Introduction_to_uploading_images/1|Adding images]] ===
+
=== Navigating CIPedia ===
  
To use a picture on Wikipedia, you need permission from the owner/photographer:
+
* '''Article''': Where the various definitions and their sources are listed.  
* If it is your ''own'' picture, then you can just upload it yourself, from [[WP:UPLOAD]], saying "It is entirely my own work". This link will take you to [[WP:COMMONS|Commons]], where free files are hosted.
+
* '''Talk''': Where talk happens. Every article page has one, linked at the beginning of the page. Use them for collaboration and dispute resolution by clicking [Talk] at the beginning of the page.
* If it is ''not yours'', then you need permission from the owner one of two ways:
+
* '''History''': Where prior versions of an article are stored (talk pages have them too). Click [View history] at the beginning of a page and you'll see all prior edits to the page.
*# They could put it on a website like [[Flickr]], or their own website with a compatible license that permits commercial reuse and modification — meaning others can replicate it, change it, and even sell it, as long as others down the line agree to the same and to give attribution to the original owner. A Flickr compatible license is Creative Commons Share Alike (CC-BY-SA 2.0). Then we can upload it.
+
* '''User''': Your personal page (or someone else's). Linked at the top right of every page, with a blue link and your name. Put stuff here to explain what you are about and why you are here.
*# Have the owner [[Wikipedia:Contact_us - Licensing|email permission]] with the attached picture to: permissions-commons@wikimedia.org saying they permanently release it to Wikipedia under an open license which allows commercial reuse and modification with attribution. Releasing it under Creative Commons Share Alike is an easy way to do that. The e-mail should say that they are the creator and/or sole owner of the exclusive copyright of the photograph(s) of the attached photo (or the photo at EXACTWEBSITEADDRESSHERE), give the name of the uploaded file on Wikipedia (File:EXACTNAMEHERE), and be signed and dated. Then we can host it.
+
* '''User talk''': Your personal talk page. Use this to facilitate discussions and collaboration. Also used for notices and warnings.
* After uploading, put the file in a Wikipedia page by adding <code><nowiki> [[File:FILENAME|thumb|FILEDESCRIPTION]]</nowiki></code> to any Wikipedia page.
+
* '''Special pages''': Specific functions such as Recent changes, and Page logs. You can spot them because they don't have talk pages.
  
=== [[Help:Introduction_to_navigating_Wikipedia/1|Navigating Wikipedia]] ===
+
=== Finding terms and articles===
  
* '''[[WP:ARTICLE|Article]]''': Where content happens. These contain encyclopedic material which must be backed up by sources. Don't sign your name on these.
+
* '''Search''': Type your query (key words) in the text box at the top right. The system will provide you with some suggestions. You can pick one from the suggested results by clicking on them or pressing Enter.
* '''[[HELP:TALK|Talk]]''': Where talk happens. Every article page has one, linked at the beginning of the page. Use them for collaboration and dispute resolution by clicking [Talk] at the beginning of the page.
 
* '''[[HELP:HISTORY|History]]''': Where prior versions of an article are stored (talk pages have them too). Click [View history] at the beginning of a page and you'll see all prior edits to the page.
 
* '''[[WP:USERPAGE|User]]''': Your personal page (or someone else's). Linked at the top right of every page, with a blue link and your name. Put stuff here to explain what you are about and why you are here. 
 
* '''[[WP:USERTALK|User talk]]''': Your personal talk page. Use this to facilitate discussions and collaboration. Also used for notices and warnings. 
 
* '''[[WP:WIKIPEDIA|Wikipedia]]''': Information about policies, guidelines and advice for editing. These are quite detailed. They come in handy eventually.
 
* '''[[WP:FILE|File]]''': Where images are. These store all of the details about photographs and other media. The name of the file page is also the name of the file.
 
* '''[[WP:SPECIAL|Special pages]]''': Specific functions such as Recent changes, and Page logs. You can spot them because they don't have talk pages.
 
  
=== Finding pages ===
+
==Notes==
 +
Further instructions can be found in [http://www.mediawiki.org/wiki/Help:Contents MediaWiki’s help pages].
  
* '''[[HELP:Search|Search]]''':  The easiest way to get around. Type your query in the box at the top right and pick from the results.
+
This text has been based on [http://en.wikipedia.org/wiki/Wikipedia:Plain_and_simple Wikipedia User Guide].
* '''Directory''':  [[WP:DIR|The full department directory]] and [[WP:Directory|quick directory]] are good tools. Or just ask someone and they'll give you a link.
 
* '''Google''':  Wikipedia is very well indexed by Google and searching for a term, even about an editing question, followed by "wiki" or "wikipedia" usually pulls up what you need.
 
 
 
 
 
==Notes==
 
Further instructions can be found in [http://www.mediawiki.org/wiki/Help:Contents MediaWiki’s help pages].  
 
  
 
<references />
 
<references />

Latest revision as of 12:00, 23 January 2015

General

CIPedia© is organized as a collection of terms with standard definitions extracted from different sources. Each term has a corresponding wiki page or article, which contains one or more definitions, references, related terms and discussions related to the term.

Creating a new article

A new article reflects the addition of a new term in CIPedia. There are three ways to create a new article:

  • By linking to a non-existing wiki article using a standard syntax. If you (or anyone else) create a link to an article that doesn't exist yet, the link will be coloured with red. Clicking a this red link will take you to the edit page of the new article. Simply type your text, click save and the new article will be created. Once the article has been created, the link will change from red to blue (or purple for pages you've visited) indicating that the article is now created in CIPedia.
  • If you search for a page that doesn't exist (using the search box and “Go” button on the left of the page) then you will be provided with a link to create the new page.
  • You can use the wiki's URL for creating a new article. The URL to a new article of the wiki is usually something like this: www.cipedia.eu/New_Term_Name.

More details about adding new pages can be found at MediaWiki http://www.mediawiki.org/wiki/Help:Starting_a_new_page.

Adding content in a new article

Applying the template

The articles (terms) in CIPedia follow a common format. They start with a short introduction, followed by available definitions for the term: European, International, National or Standard ones. A Discussion section follows summarizing the page. The last sections can also contain information such as See also (links to related terms), Notes (the sources of the article), and References (additional references), in that order.

The template that should be used for creating the content of a new article can be found here.

Adding a Category

Moreover, each article needs to be assigned to at least one Category. The categories and subcategories which are currently used in CIPedia are listed below:

Press "+" for expanding.

To add an article into a category, please enclose the category name inside of double brackets like [[Category:Resilience]]. More details see the MediaWiki http://www.mediawiki.org/wiki/Help:Categories#Adding_a_page_to_a_category

Basic editing

Editing a page is fairly simple. Every page on CIPedia has an edit link on it, either in the page itself or at the top left of the screen. The steps are:

  • Click the [edit] page tab at the top of the page (you are now on Edit mode).
  • You'll see a place where you can type and make changes.
  • Click the [Save page] button.

For advanced editing help, press here.

Formatting

  • Basic markup. Markup language is a very simple way to add formatting with symbols. These can be inserted using the editing tool bar or manually. Otherwise, just type normally.
    • Looks
      • For italics, type two apostrophes ( ' ) around the word like this ''italics''.
      • For bold use three apostrophes: '''bold''' .
      • For bold and italics use five: '''''italics and bold''''' .
    • Sections and lists
      • Section headers are made with the equals sign ( = ) on each side. More equals signs make smaller sub-sections, and so on. You won't use a level 1 header, since that is the title of the page itself.
      • Bulleted lists are made by putting * at the beginning of each line.
      • Numbered lists are made by putting # at the beginning of each line.
    • Links
      • Links from one CIPedia page to another are made with two brackets on each side of the word like [[wikilink]]. To make a link go to a different page than the word it shows, use a pipe: [[Page|word]].
      • Links to external websites are made with one bracket on each side like [external link].
    • Paragraphs and references
      • Line breaks and paragraphs require hitting [return] or [enter] twice (showing an empty line in between).
      • References go between ref tags: <ref>References here.</ref> Place these after the punctuation of the sentence they are used in.
  • Preview and save. If you want to see a draft of your changes, click [Show preview]; otherwise click [Save] and your edit will go live.

Communication

  • Talk pages. In addition to the pages you read for information, for almost every CIPedia page there is a corresponding talk page where discussion happens among editors. To use the talk page, click [edit] and add your comments. To create a new topic, click [new section] at the top of the page, give the section a title, and leave your comment. New topics go at the end of the page.
  • Indenting. To make conversations easier to follow, place your comments below the one you are responding to and indent it using a colon (:). Each colon moves the comment farther to the right, so if the person above you used 3 colons ::: you should use 4 ::::. To start a new talk page topic, click [new section] at the beginning of the page and type a title with your comment, or start a new level 2 heading for the same effect.
  • Signatures. On talk pages but not article pages, all comments should be signed with ~~~~. Once saved, this will turn into your username or IP address with a timestamp.
  • Edit summaries. Leave a brief note about what you did and why any time you make an edit. Place it in the edit summary box before you click Save.

Adding references

  • Manual references: Use reference tags after the period: ...end of sentence.<ref>Reference info here: author, publication, date, title, place, web address, etc.</ref> Place at the end of the sentence after the punctuation.
  • Notes section: References should appear at the end of the page. You don't have to type out the references there; instead, place them inside the article after the sentence they support. They'll appear automatically. You can add additional references manually to the References section.

Navigating CIPedia

  • Article: Where the various definitions and their sources are listed.
  • Talk: Where talk happens. Every article page has one, linked at the beginning of the page. Use them for collaboration and dispute resolution by clicking [Talk] at the beginning of the page.
  • History: Where prior versions of an article are stored (talk pages have them too). Click [View history] at the beginning of a page and you'll see all prior edits to the page.
  • User: Your personal page (or someone else's). Linked at the top right of every page, with a blue link and your name. Put stuff here to explain what you are about and why you are here.
  • User talk: Your personal talk page. Use this to facilitate discussions and collaboration. Also used for notices and warnings.
  • Special pages: Specific functions such as Recent changes, and Page logs. You can spot them because they don't have talk pages.

Finding terms and articles

  • Search: Type your query (key words) in the text box at the top right. The system will provide you with some suggestions. You can pick one from the suggested results by clicking on them or pressing Enter.

Notes

Further instructions can be found in MediaWiki’s help pages.

This text has been based on Wikipedia User Guide.