Help:Editing: Difference between revisions

From coreboot
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Editing Basics ==
On a wiki, it is customary to allow readers to edit content and structure. Changes are tracked, and are revertible. This wiki is protected from spammers and other illiterates, so you need to log on to edit pages.


{{:Help:Wikitext quick reference}} <!-- Edit this at [[Help:Wikitext quick reference]] -->
This is a brief overview of the editing and contributing process. The [http://meta.wikimedia.org/wiki/Help:Editor Editor table of contents] lists a few longer versions and a list of detailed descriptions of specific topics.


[[Help:Wikitext examples|wikitext markup examples]] are available for your pleasure.
== Editing basics ==
<!--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!-->
===Review policy and conventions===
:Make sure that what you want to write belongs where you want to put it. The operator of the site likely has specific plans for the site, and your content might be deleted or unappreciated.  You can always use the [[Wikipedia: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.
===Start editing===
:To start editing a [[Wikipedia: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 ''[[Wikipedia:Wikitext|wikitext]]'': the editable source code from which the server produces the webpage. ''If you just want to experiment, use the preview function on a non-existing page, not here, and not permanently''.
===Type your changes===
: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.
===Summarize your changes===
:Write a short [[Wikipedia: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 [[Wikipedia:Wikipedia:Edit_summary_legend | Edit_summary_legend ]].
===Preview before saving===
:When you have finished, click '''[[Wikipedia: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.
==Most frequent wiki markup explained==
<!--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 6 most frequently used wiki markups. If you need more help see:
*[[Wikipedia:Help:Wikitext examples]]
*[[Wikipedia:Help:Reference card]]
*[[Wikipedia:Help:HTML in wikitext]]
*[[Wikipedia:HTML element|HTML elements]]
{| border="1" cellpadding="2"
!width="1000" style="background:#FFFF99"|What it looks like
!width="500" style="background:#FFFF99"|What you type
|-
|
You can ''italicize text'' by putting 2
apostrophes on each side.
3 apostrophes will bold '''the text'''.
5 apostrophes will bold and italicize
'''''the text'''''.
(4 apostrophes don't do anything special -- there's just ''''one left over''''.)
|<pre>
You can ''italicize text'' by putting 2
apostrophes on each side.
3 apostrophes will bold '''the text'''.
5 apostrophes will bold and italicize
'''''the text'''''.
(4 apostrophes don't do anything
special -- there's just ''''one left
over''''.)
</pre>
|-
|
You should "sign" your comments on talk pages: <br>
- Three tildes give your user name: [[User:Stepan|Stepan]] <br>
- Four tildes give your user name plus date/time: [[User:Stepan|Stepan]] 13:41, 8 November 2006 (CET) <br>
- Five tildes give the date/time alone: 13:41, 8 November 2006 (CET) <br>
|<pre>
You should "sign" your comments
on talk pages: <br>
- Three tildes give your user
name: ~~~ <br>
- Four tildes give your user
name plus date/time: ~~~~ <br>
- Five tildes give the
date/time alone: ~~~~~ <br>
</pre>
|-
|
<div style="font-size:150%;border-bottom:1px solid #000000;">Section headings</div>
''Headings'' organize your writing into sections.
The Wiki software can automatically generate
a [[Wikipedia:Help:table of contents|table of contents]] from them.
<div style="font-size:132%;font-weight:bold;">Subsection</div>
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.
Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title.
|<pre>
== Section headings ==
''Headings'' organize your writing into sections.
The Wiki software can automatically generate
a table of contents from them.
=== Subsection ===
Using more equals signs creates a subsection.
==== A smaller subsection ====
Don't skip levels,
like from two to four equals signs.
Start with 2 equals signs not 1
because 1 creates H1 tags
which should be reserved for page title.
</pre>
|- id="lists"
|
* ''Unordered [[Wikipedia:Help:List|list]]s'' are easy to do:
** Start every line with a star.
*** More stars indicate a deeper level.
*: Previous item continues.
** A newline
* 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
A new line marks the end of the list.
# New numbering starts with 1.
|<pre>
# ''Numbered lists'' are:
## Very organized
## Easy to follow
A new line marks the end of the list.
# New numbering starts with 1.
</pre>
|-
|
Here's a link to a page named [[Official position]].
You can even say [[official position]]s
and the link will show up correctly.
|<pre>
Here's a link to a page named
[[Official position]].
You can even say
[[official position]]s
and the link will show up
correctly.
</pre>
|-
|
[[The weather in Moscow]] is a page that doesn't exist
yet. You could create it by clicking on the link.
|<pre>
[[The weather in Moscow]] 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 its title:
*[[List of cities by country#Morocco]].
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:
*[[List of cities by country#Morocco]].
If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".
</pre>
|}
===Page management===
*[[Wikipedia:Help:Starting a new page]]
*[[Wikipedia:Wikipedia:Merging_and_moving_pages|Merging and moving pages]]
*[[Wikipedia:Help:Administration#Page_protection| Protecting pages]]
*[[Wikipedia:Meta:Deletion_policy|Deletion policy]]
**[[Wikipedia:Wikipedia:Pure_wiki_deletion_system|Pure wiki deletion system]]


== Hyperlinks ==
== Hyperlinks ==


External:
External:
<pre><nowiki>[http://www.linuxbios.org/ LinuxBIOS Home Page]</nowiki></pre>
<pre><nowiki>[http://www.coreboot.org/ coreboot home page]</nowiki></pre>
[http://www.linuxbios.org/ LinuxBIOS Home Page]
[http://www.coreboot.org/ coreboot home page]


Internal:
Internal:
Line 38: Line 232:
|}
|}


== Ignore markup ==
== Categories ==
 
* In a box
<pre><nowiki><pre><nowiki>replace \/ with / for end tags<\/nowiki><\/pre></nowiki></pre>
replace \/ with / for end tags
 
* No box
<nowiki><nowiki>replace \/ with / for end tags<\/nowiki></nowiki>
 
<nowiki>replace \/ with / for end tags</nowiki>
 
== Footnotes - If we install that package it will work ==
<pre><nowiki>
<pre><nowiki>
I need a reference to a source.<ref name=source1> Reference Text for source1</ref>  
[[Category:Tutorials]]
 
</nowiki></pre>
I need to reference the same source again. <ref name=source1/>
[[Category:Tutorials]]
[[Category:Help]]


I need another one. <ref name=source2> Reference Text for source2</ref>
===Others===
</nowiki></pre>
I need a reference to a source.<ref name=source1> Reference Text for source1</ref>
I need to reference the same source again. <ref name=source1/>


I need another one. <ref name=source2> Reference Text for source2</ref>


{{Wikipedia:h:f|enname=Editing}}


At some point, usually the bottom of the page, I include
<pre><nowiki>
<references/>
</nowiki></pre>
<references/>


== Files/Images ==
== Files/Images ==
Line 100: Line 275:


If you'd rather link to the page describing the image, use <pre><nowiki> [[:Image:LinuxBIOS.pdf|This is the description of a sample file]] </nowiki></pre> [[:Image:LinuxBIOS.pdf|This is the description of a sample file]]
If you'd rather link to the page describing the image, use <pre><nowiki> [[:Image:LinuxBIOS.pdf|This is the description of a sample file]] </nowiki></pre> [[:Image:LinuxBIOS.pdf|This is the description of a sample file]]
== Categories ==
<pre><nowiki>
[[Category:Tutorials]]
</nowiki></pre>
[[Category:Tutorials]]
[[Category:Help]]

Latest revision as of 20:08, 24 September 2010

On a wiki, it is customary to allow readers to edit content and structure. Changes are tracked, and are revertible. This wiki is protected from spammers and other illiterates, so you need to log on to edit pages.

This is a brief overview of the editing and contributing process. The Editor table of contents lists a few longer versions and a list of detailed descriptions of specific topics.

wikitext markup examples are available for your pleasure.

Editing basics

Review policy and conventions

Make sure that what you want to write belongs where you want to put it. The operator of the site likely has specific plans for the site, and your content might be deleted or unappreciated. You can always use the 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.

Start editing

To start editing a 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 wikitext: the editable source code from which the server produces the webpage. If you just want to experiment, use the preview function on a non-existing page, not here, and not permanently.

Type your changes

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.

Summarize your changes

Write a short edit summary in the small field below the edit-box. You may use shorthand to describe your changes, as described in the Edit_summary_legend .

Preview before saving

When you have finished, click 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.

Most frequent wiki markup explained

Here are the 6 most frequently used wiki markups. If you need more help see:

What it looks like What you type

You can italicize text by putting 2 apostrophes on each side.

3 apostrophes will bold the text.

5 apostrophes will bold and italicize the text.

(4 apostrophes don't do anything special -- there's just 'one left over'.)

You can ''italicize text'' by putting 2 
apostrophes on each side. 

3 apostrophes will bold '''the text'''. 

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

(4 apostrophes don't do anything
special -- there's just ''''one left
over''''.)

You should "sign" your comments on talk pages:
- Three tildes give your user name: Stepan
- Four tildes give your user name plus date/time: Stepan 13:41, 8 November 2006 (CET)
- Five tildes give the date/time alone: 13:41, 8 November 2006 (CET)

You should "sign" your comments 
on talk pages: <br>
- Three tildes give your user
name: ~~~ <br>
- Four tildes give your user 
name plus date/time: ~~~~ <br>
- Five tildes give the 
date/time alone: ~~~~~ <br>
Section headings

Headings organize your writing into sections. The Wiki software can automatically generate a table of contents from them.

Subsection

Using more equals signs creates a subsection.

A smaller subsection

Don't skip levels, like from two to four equals signs.

Start with 2 equals signs not 1 because 1 creates H1 tags which should be reserved for page title.



== Section headings ==

''Headings'' organize your writing into sections.
The Wiki software can automatically generate
a table of contents from them.

=== Subsection ===

Using more equals signs creates a subsection.

==== A smaller subsection ====

Don't skip levels, 
like from two to four equals signs.

Start with 2 equals signs not 1 
because 1 creates H1 tags
which should be reserved for page title.
  • Unordered lists are easy to do:
    • Start every line with a star.
      • More stars indicate a deeper level.
    Previous item continues.
    • A newline
  • in a list

marks the end of the list.

  • Of course you can start again.
* ''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.
  1. Numbered lists are:
    1. Very organized
    2. Easy to follow

A new line marks the end of the list.

  1. New numbering starts with 1.
# ''Numbered lists'' are:
## Very organized
## Easy to follow
A new line marks the end of the list.
# New numbering starts with 1.

Here's a link to a page named Official position. You can even say official positions and the link will show up correctly.

Here's a link to a page named
 [[Official position]].
You can even say 
[[official position]]s
and the link will show up 
correctly.

The weather in Moscow is a page that doesn't exist yet. You could create it by clicking on the link.

[[The weather in Moscow]] is 
a page that doesn't exist
yet. You could create it by 
clicking on the link.

You can link to a page section by its title:

If multiple sections have the same title, add a number. #Example section 3 goes to the third section named "Example section".


You can link to a page section by its title:

*[[List of cities by country#Morocco]].

If multiple sections have the same title, add
a number. [[#Example section 3]] goes to the
third section named "Example section".

Page management

Hyperlinks

External:

[http://www.coreboot.org/ coreboot home page]

coreboot home page

Internal:

 [[Main_Page]] 

Main_Page

Tables

{|
|+ The table's caption
! Column heading 1 !! Column heading 2 !! Column heading 3
|-
|Cell 1 || Cell 2 || Cell 3
|-
|Cell A
|Cell B
|Cell C
|}
The table's caption
Column heading 1 Column heading 2 Column heading 3
Cell 1 Cell 2 Cell 3
Cell A Cell B Cell C

Categories

[[Category:Tutorials]]

Others

{{Wikipedia:h:f|enname=Editing}}


Files/Images

To include a file, first upload the file by clicking on Upload file in the toolbox on the left.

Then include to include a link to the file use

  [[Image:Chip_lb.png|tool tip]]  

tool tip

or scaled

 [[image:Chip_lb.png|80px|scaled larger logo]] 

scaled larger logo


For some reason the thumbnails end up right justified, so these are in tables.

For a thumbnail, use

[[Image:Chip_lb.png|thumb|PEL logo]]  
Chip with LB logo

or

 [[Image:Chip_lb.png|thumb|80px|Chip with LB logo]]  
Chip with LB logo

Not setting the thumbnail width respects users' preferences.

If you want to link to a file available for download, use

 [[Media:LinuxBIOS.pdf|This is a sample file]] 

This is a sample file If you'd rather link to the page describing the image, use

 [[:Image:LinuxBIOS.pdf|This is the description of a sample file]] 

This is the description of a sample file