Help:Editing: Difference between revisions

From ced Wiki
Jump to navigation Jump to search
(adding help from wp)
 
(transplanting from smwxbig pre 2010)
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
''This article is licensed under the GNU Free Documentation License. It uses material from the MediaWiki Meta article "Help:Editing"''
== A note about content ==


{{H:h|editor toc}}
== Editing the wiki ==


'''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.
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.


==Editing basics==
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:
<!--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!-->


===Start editing===
* <nowiki>[[a link]]</nowiki> - create a link to another page
:[[w:MediaWiki|MediaWiki]] page, click the '''Edit this page''' (or just '''edit''') link at one of its edges. This brings you to the edit page: a page with a text box containing the ''[[w:wikitext|wikitext]]'' – the editable code from which the server produces the finished page, and often called the '''edit box'''.
* <nowiki>== heading ==</nowiki> create a section heading, in this case, heading level two
:''If you just want to experiment, please do so only in the [[{{ns:4}}:Sandbox|sandbox]]''.
* <nowiki>'''boldtext'''</nowiki> and <nowiki>''italic text''</nowiki>
* * to start a bullet point, ** for second level, etc.


===Type your changes===
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.
:You can just type your text. However, also using basic wiki markup (described in the next section) to make links and do simple formatting adds to the value of your contribution. [[w:Wikimedia|Wikimedia]] wikis have style guidelines available. If you follow these, your contributions will be more valuable as they won't need to be cleaned up later.


===Summarize your changes===
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."
:Write a short [[Help:Edit summary|edit summary]] in the small field below the edit-box. You may use shorthand to describe your changes, as described in the [[w:Wikipedia:Edit summary legend|edit summary legend]].


===Preview before saving!===
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.
:When you have finished, click '''[[Help:Show preview|Show preview]]''' to see how your changes will look '''before''' you make them permanent.  Repeat the edit/preview process until you are satisfied, then click '''Save page''' and your changes will be immediately applied to the article. Sometimes it is helpful to save in between.


==Most frequent wiki markup explained==
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.
<!--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!-->
Here are the most frequently used types of wiki markup. If you need more help see [[Help:Wikitext examples|Wikitext examples]].


<br clear="right" />
Further editing help is available at [http://meta.wikimedia.org/wiki/Help:Editing wikimedia.org].
{| 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'''.
== Feel free to carve out your own project wiki pages ==


5 apostrophes will embolden and italicize
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.
'''''the text'''''.


(4 apostrophes don't do anything special -- there's just ''''one left over''''.)
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>.
|<pre>
You can ''italicize text'' by putting 2
apostrophes on each side.


3 apostrophes will embolden '''the text'''.
{{#forminput:User page|||Add a new personal page|User page[User]={{CURRENTUSER}}&super_page=User:{{CURRENTUSER}}&namespace=User}}


5 apostrophes will embolden and italicize
'''''the text'''''.


(4 apostrophes don't do anything
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).
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.
[http://www.mediawiki.org/wiki/Help:Templates Templates] can also be used for consistent content presentation.  
The Wiki software can automatically generate
a [[Help:Section|table of contents]] from them.


<div style="font-size:132%;font-weight:bold;">Subsection</div>
Keep an eye out for extra help on pages such as your User page.
Using more equals signs creates a subsection.


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


Don't skip levels, like from two to four equals signs.
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.


Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title.
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>.
|<pre>
==Section headings==


''Headings'' organize your writing into sections.
Once annotations are entered, they can be reused in queries and views, like this one:
The Wiki software can automatically generate
a table of contents from them.


===Subsection===
<nowiki>{{ #ask: [[birthday::+]] | format=timeline}}</nowiki>


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


====A smaller subsection====
{{ #set: birthday=November 25, 2009}}
Don't skip levels,
{{ #ask: [[birthday::+]] |?birthday | format=timeline}}
like from two to four equals signs.


Start with 2 equals signs not 1
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.
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>
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.
# ''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>


See also: [[How to annotate]].


|-
[[Category: Wiki documentation]]
|
Here's a link to the [[Main page]].


But be careful - capitalization counts!
Please go [http://meta.wikimedia.org/wiki/Help:Editing here] until full help is copied.
|<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]].
 
If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".
|<pre>
 
You can link to a page section by its title:
 
* [[Help:Contents#For editors]].
 
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]]d.
*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.
 
 
===Review policy and conventions===
 
:Make sure that you submit information which is relevant to the specific purpose of the wiki, or your content might be changed. You can always use the [[Help:Talk page|talk pages]] to ask questions or check to see if your idea will be accepted. Please make note of the license your contributions will be covered with.
 
==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}}

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.

Retrieved from "https://ced.zooid.org/index.php?title=Help:Editing&oldid=7581"