Help:Editing: Difference between revisions

From ced Wiki
Jump to navigation Jump to search
No edit summary
(transplanting from smwxbig pre 2010)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
== A note about content ==


'''Editing''' refers to the changing of a page by a Wikimedia user. Unless certain restrictions are in effect, such as [[protection]], all pages are editable, by everyone. This is a brief overview of that process. The editing table of contents to the right contains more information on editing functions.
== Editing the wiki ==


Wikis are typically designed to allow participation in development of the site to all users, through easy creation of new pages, links and categories. We're using the same software Wikipedia uses, along with the Semantic Mediawiki extensions. You must have an account to create and edit pages. [[Intwiki:About | Contact an admin]] if you need an account or some assistance.


Once you're signed in, you'll see an edit tab on the top of most pages. Use that link, or section edit links if present, to edit content. To avoid the problems of rich text editors and keep entered text focused on content and meaning, pages use wiki markup. The most important markup is as follows:


==Most frequent wiki markup explained==
* <nowiki>[[a link]]</nowiki> - create a link to another page
<!--It is intended to be brief, or as an overview. Otherwise why we separate the materials into different pages? Thus it's best NOT to add new materials or expand here. Add more examples or expand in other areas like Wikitext examples. Thanks!-->
* <nowiki>== heading ==</nowiki> create a section heading, in this case, heading level two
Here are the most frequently used types of wiki markup. If you need more help see [[Help:Wikitext examples|Wikitext examples]].
* <nowiki>'''boldtext'''</nowiki> and <nowiki>''italic text''</nowiki>
* * to start a bullet point, ** for second level, etc.


<br clear="right" />
Otherwise, just enter your text, leaving a blank line between paragraphs. Remember you can view the wiki markup of any page to see how it was created.
{| class="wikitable"
! style="width: 50%" | What it looks like
! style="width: 50%" | What you type
|-
|
You can ''italicize text'' by putting 2
apostrophes on each side.  


3 apostrophes will embolden '''the text'''.  
An effective workflow is to create pages with links, then go back later and click on the undefined (red) links to fill them in. Often sections get turned into their own pages over time as part of "wiki gardening."


5 apostrophes will embolden and italicize
You can practice editing pages by creating your own link off the [[Sandbox]]. It's a good practice to preview your pages before saving, and to add summary contents to help others understand your changes.
'''''the text'''''.


(4 apostrophes don't do anything special -- there's just ''''one left over''''.)
All pages maintain a complete edit history, so we can always tell who edited a page and revert pages when required. It's a good idea to check the page's history to see who's been editing it.
|<pre>
You can ''italicize text'' by putting 2
apostrophes on each side.  


3 apostrophes will embolden '''the text'''.  
Further editing help is available at [http://meta.wikimedia.org/wiki/Help:Editing wikimedia.org].


5 apostrophes will embolden and italicize
== Feel free to carve out your own project wiki pages ==
'''''the text'''''.


(4 apostrophes don't do anything
When naming pages, keep in mind the wiki is used for multiple projects so use distinct names. Also keep in mind anyone can edit most pages, so your page may be changed by others including 'bureaucrats' trying to keep things organized. Monitor important pages to keep them relevant, using the [http://en.wikipedia.org/wiki/Wikipedia:Neutral_point_of_view Neutral point of view] principles. Comments and suggestions should be entered in the Discussion of a page, which can often contain the most interesting content, so keep an eye out for active Discussion links.
special -- there's just ''''one left
over''''.)
</pre>
|-
|
You should "sign" your comments on talk pages:
* Three tildes give your user name: [[User:Example|Example]] ([[User talk:Example|talk]])<br />
* Four tildes give your user name plus date/time: [[User:Example|Example]] ([[User talk:Example|talk]]) 07:46, 27 November 2005 (UTC)
* Five tildes give the date/time alone: 07:46, 27 November 2005 (UTC)
|<pre>
You should "sign" your comments
on talk pages:
* Three tildes give your user
name: ~~~
* Four tildes give your user
name plus date/time: ~~~~
* Five tildes give the  
date/time alone: ~~~~~
</pre>
|-
|
<div style="font-size:150%;border-bottom:1px solid rgb(170,170,170);">Section headings</div>


''Headings'' organize your writing into sections.
Each user has their own "namespace" where you can keep pages editable only by yourself. Those page names have this form:  <nowiki>[[User:Some Person/My own page]]</nowiki>.
The Wiki software can automatically generate
a [[Help:Section|table of contents]] from them.


<div style="font-size:132%;font-weight:bold;">Subsection</div>
{{#forminput:User page|||Add a new personal page|User page[User]={{CURRENTUSER}}&super_page=User:{{CURRENTUSER}}&namespace=User}}
Using more equals signs creates a subsection.


<div style="font-size:116%;font-weight:bold;">A smaller subsection</div>


Don't skip levels, like from two to four equals signs.
Use categories to group pages. Simply add <nowiki>[[Category:My category]]</nowiki> to the end of page content, and it can be viewed on the category index page, for example [[:Category:Wiki documentation]] or via queries (see below).


Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title.
[http://www.mediawiki.org/wiki/Help:Templates Templates] can also be used for consistent content presentation.  
|<pre>
== Section headings ==


''Headings'' organize your writing into sections.
Keep an eye out for extra help on pages such as your User page.
The Wiki software can automatically generate
a table of contents from them.


=== Subsection ===
== Semantic wiki facilities ==


Using more equals signs creates a subsection.
Semantic Mediawiki (SMW) add database-like features to the free form functionality of wikis. Annotations, properties, templates, forms and queries can be used to more consistently create content, suitable for re-use.


==== A smaller subsection ====
An annotation is a simple discrete markup of information, with a corresponding property, which describes the data type. Annotations can appear anywhere in text, except in values of other properties. They look like this: <nowiki>[[birthday::November 25, 2009]]</nowiki>.
Don't skip levels,  
like from two to four equals signs.


Start with 2 equals signs not 1
Once annotations are entered, they can be reused in queries and views, like this one:
because 1 creates H1 tags
which should be reserved for page title.
</pre>
|- id="lists"
|
* ''Unordered [[Help:List|list]]s'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
* Previous item continues.
** A new line
* in a list 
marks the end of the list.
*Of course you can start again.
|<pre>
* ''Unordered lists'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
* Previous item continues.
** A new line
* in a list 
marks the end of the list.
* Of course you can start again.
</pre>
|-
|
# ''Numbered lists'' are:
## Very organized
## Easy to follow
# Previous item continues
A new line marks the end of the list.
# New numbering starts with 1.


|<pre>
<nowiki>{{ #ask: [[birthday::+]] | format=timeline}}</nowiki>
# ''Numbered lists'' are:
## Very organized
## Easy to follow
# Previous item continues
A new line marks the end of the list.
# New numbering starts with 1.
</pre>
|-
|
: A colon (:) indents a line or paragraph.
A newline starts a new paragraph. <br>
Often used for discussion on [[talk pages]].
: We use 1 colon to indent once.
:: We use 2 colons to indent twice.
::: 3 colons to indent 3 times, and so on.
|<pre>
: A colon (:) indents a line or paragraph.
A newline starts a new paragraph. <br>
Often used for discussion on talk pages.
: We use 1 colon to indent once.
:: We use 2 colons to indent twice.
::: 3 colons to indent 3 times, and so on.
</pre>


Which means ask for all pages with birthdays, and display them in timeline format, including links to page names ({{PAGENAME}} in this case).


|-
{{ #set: birthday=November 25, 2009}}
|
{{ #ask: [[birthday::+]] |?birthday | format=timeline}}
Here's a link to the [[Main page]].


But be careful - capitalization counts! 
Other formats include [[Facilities|graphs]], maps, facet browsers, tables and charts. The property type is often a page, so the annotation provides a link type. This corresponds to [http://en.wikipedia.org/wiki/Resource_Description_Framework RDF] triples - object (the page), predicate (the link), subject (the destination link). SMW has RDF features to support interaction with other software.
|<pre>
Here's a link to the [[Main page]].
</pre>
|-
|
[[Intentionally permanent red link]] is a page that doesn't exist
yet. You could create it by clicking on the link.
|<pre>
[[Intentionally permanent red link]] is
a page that doesn't exist
yet. You could create it by
clicking on the link.
</pre>
|-
|
You can link to a page section by placing a "#" before its title:


* [[Help:Contents#For editors]].
Properties are commonly assigned in templates and used with forms to provide consistent data using fields and categories. [[Special:CreateClass]] provides functionality to create a template and form in one step.


If multiple sections have the same title, add
See also: [[How to annotate]].
a number. [[#Example section 3]] goes to the
third section named "Example section".
|<pre>


You can link to a page section by its title:
[[Category: Wiki documentation]]


* [[Help:Contents#For editors]].
Please go [http://meta.wikimedia.org/wiki/Help:Editing here] until full help is copied.
 
If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".
</pre>
|}
 
== Restrictions ==
Some pages cannot be edited by everyone. A special function known as [[protection]] can be applied to a page by [[administrator]]s, making the said page uneditable to certain classes of users. There are several degrees of protection:
*If a page is semiprotected, it can be edited by everyone except IPs and accounts that have not yet been [[autoconfirmation|confirmed]].
*If a page is fully protected, only other admins can make edits to the page.
*A page can also be protected so that it cannot be [[move|moved]].
*In some cases, an admin might see fit to protect a page from being created.
*For very rare pages, such as the Main Page, "cascading" protection is applied, wherein every page that is [[transcluded]] onto a page is protected too.
There are various reasons why a page might be protected. Vandalism and spam can lead to semiprotection, while content wars and other severe cases can lead to full protection. There are other times where [[Office actions]] come into play. For the most part, protection is temporary and editing privileges are then restored. In any case, everyone can [[view source|view the source]] of any page, irrespective of its level of protection.
 
==Further reading==
<!--More relevant links are welcome-->
 
===Editing help===
* [[Help:Editing FAQ]]
*[[Help:Editing toolbar]]
*[[Help:Minor edit]]
 
===Wiki markups and codes===
*[[Help:Wikitext examples]]
*[[m:Help:Reference card|Help:Reference card]]: a one-page summary of important commands, to be printed out and used next to the computer
*[[Help:HTML in wikitext]]
*[[Help:Comment tags]]
*[[w:HTML element|HTML elements]]: introduction to HTML
*[[Help:Redirect]] - Setting up a Redirect Page within Wiki
 
===Page management===
*[[Help:Starting a new page]]
*{{ml|Help:Administration|Protection|Protecting pages}}
*{{mlw|Wikipedia:Merging and moving pages|Merging and moving pages}}
*{{mlm|Anti-spam features}}
{{h:f|enname=Editing}}
 
'''This page copied from http://meta.wikimedia.org/wiki/Help:Editing'''

Latest revision as of 16:45, 6 September 2015

A note about content

Editing the wiki

Wikis are typically designed to allow participation in development of the site to all users, through easy creation of new pages, links and categories. We're using the same software Wikipedia uses, along with the Semantic Mediawiki extensions. You must have an account to create and edit pages. Contact an admin if you need an account or some assistance.

Once you're signed in, you'll see an edit tab on the top of most pages. Use that link, or section edit links if present, to edit content. To avoid the problems of rich text editors and keep entered text focused on content and meaning, pages use wiki markup. The most important markup is as follows:

  • [[a link]] - create a link to another page
  • == heading == create a section heading, in this case, heading level two
  • '''boldtext''' and ''italic text''
  • * to start a bullet point, ** for second level, etc.

Otherwise, just enter your text, leaving a blank line between paragraphs. Remember you can view the wiki markup of any page to see how it was created.

An effective workflow is to create pages with links, then go back later and click on the undefined (red) links to fill them in. Often sections get turned into their own pages over time as part of "wiki gardening."

You can practice editing pages by creating your own link off the Sandbox. It's a good practice to preview your pages before saving, and to add summary contents to help others understand your changes.

All pages maintain a complete edit history, so we can always tell who edited a page and revert pages when required. It's a good idea to check the page's history to see who's been editing it.

Further editing help is available at wikimedia.org.

Feel free to carve out your own project wiki pages

When naming pages, keep in mind the wiki is used for multiple projects so use distinct names. Also keep in mind anyone can edit most pages, so your page may be changed by others including 'bureaucrats' trying to keep things organized. Monitor important pages to keep them relevant, using the Neutral point of view principles. Comments and suggestions should be entered in the Discussion of a page, which can often contain the most interesting content, so keep an eye out for active Discussion links.

Each user has their own "namespace" where you can keep pages editable only by yourself. Those page names have this form: [[User:Some Person/My own page]].


Use categories to group pages. Simply add [[Category:My category]] to the end of page content, and it can be viewed on the category index page, for example Category:Wiki documentation or via queries (see below).

Templates can also be used for consistent content presentation.

Keep an eye out for extra help on pages such as your User page.

Semantic wiki facilities

Semantic Mediawiki (SMW) add database-like features to the free form functionality of wikis. Annotations, properties, templates, forms and queries can be used to more consistently create content, suitable for re-use.

An annotation is a simple discrete markup of information, with a corresponding property, which describes the data type. Annotations can appear anywhere in text, except in values of other properties. They look like this: [[birthday::November 25, 2009]].

Once annotations are entered, they can be reused in queries and views, like this one:

{{ #ask: [[birthday::+]] | format=timeline}}

Which means ask for all pages with birthdays, and display them in timeline format, including links to page names (Editing in this case).


Other formats include graphs, maps, facet browsers, tables and charts. The property type is often a page, so the annotation provides a link type. This corresponds to RDF triples - object (the page), predicate (the link), subject (the destination link). SMW has RDF features to support interaction with other software.

Properties are commonly assigned in templates and used with forms to provide consistent data using fields and categories. Special:CreateClass provides functionality to create a template and form in one step.

See also: How to annotate.

Please go here until full help is copied.