Laurie: /* Image formatting */

2007-11-08T02:11:51Z

Image formatting

New page

==Summary==

It's very easy to edit a wiki page. Simply click on the "'''Edit'''" link at the top of a Wiki page to change the page itself, or click on "'''Discussion'''" and then on "Edit" to write on the corresponding [[Help:Talk pages|talk page]]. This will bring you to a page with a text box containing the editable text of that Wiki page.

Then type away, write what you desire in the edit-box and when finished press "Save"! You can also preview your changes before saving if you like. Depending on your system, pressing Enter while the edit box is not active (there is no typing cursor in it) may have the same effect as pressing Save.

It is often more convenient to copy and paste the text first INTO your favorite text editor, edit and spell CHECK there, and then paste back INTO your web browser to preview. This way, you can also keep a local backup copy of the pages you authored so that you can make changes offline.

== Minor edits ==
When editing a page, a logged-in user has the option of flagging the edit as a "minor edit". When to use this is somewhat a matter of personal preference. The rule of thumb is that an edit of a page that is spelling corrections, formatting, and minor rearranging of text should be flagged as a "minor edit". A major edit is basically something that makes the entry worth relooking at for somebody who wants to watch the article rather closely, so any "real" change, even if it is a single word. This feature is important, because users can choose to ''hide'' minor edits in their view of the '''Recent Changes''' page, to keep the volume of edits down to a manageable level.

The reason for not allowing a user who is not logged in to mark an edit as minor is that vandalism could then be marked as a minor edit, in which case it would stay unnoticed longer. This limitation is another reason to log in.

==Templates==
Some text on a page may correspond in the edit box to just a reference to another page, in the form <nowiki>{{</nowiki>''name''<nowiki>}}</nowiki>, referring to the page "Template:''name''". This is called a [[template]]. For changing that text, edit that other page. Sometimes a separate edit link is provided for this purpose.

==Page protection==
In a few cases the link labeled "{{MediaWiki:Editthispage}}" is replaced by the text "{{MediaWiki:Protectedpage}}" (or equivalents in the language of the project). In that case the page can not be edited.

==Separating edits==
When moving or copying a piece of text within a page or FROM another page, and also making other edits, it is useful to separate these edits. This way the [[MediaWiki User's Guide: Diff|diff function]] can be usefully applied for checking these other edits.

==Help Editing Wiki Pages==

# Click on '''Edit this page''' on top of web page or '''edit''' on the right (if available) for a section
# ''Type in text''
# Click on '''Show Preview'''. Modify if required.
# Add summary if required. Click on '''Save page'''.
 

Practice editing in the [[PGVWiki:Sandbox]]

==Wiki Code==

Most basic HTML commands will work, but wiki also has "easier" ways to specify some commands. 
Triple single quotes, like <nowiki>'''Bold'''</nowiki> around text will make it bold, like '''Bold'''. and two single quotes will show ''Italics''.)

Also ... there are newer CSS commands to replace outdated HTML. Stay tuned.

Some other Wiki things:

placing a 'space' at the beginning of a line
results in the text being displayed exactly as written
inside this blue box ... wysiwyg.
so this works good for displaying robot code snippets
and other DB code

Here's another way: 
Use <nowiki><pre> and </pre></nowiki> to bracket your code. 
This precludes one having to enter a space at the beginning of every line. 
An example: 

'''''A handy method for eventually unfixing the stuck bot is:'''''

<pre>
'will normally unfix bot by restoring .fixpos to zero
'typically I place this in most bots to prevent possible attack and accidental fixing
cond
start
.fixpos *.fixed mult dec
stop
</pre>

This will also disable any HTML code/tags within the 'box' 
allowing one to list them as instructions without activating the tag. 
example:
<pre> have no effect within the <nowiki><pre></pre> tags.</nowiki> </pre>

===Placing Comments in the Edit Window===

<pre>
using  one can place comments in the edit window which will not be visible on the page.
like so: 
</pre>

===Table of contents (TOC)===

For each article with more than three headings, a '''table of contents (TOC)''' is automatically generated from the section headings, unless:
*(for a user) preferences are set to turn it off
*(for an article) in the edit box the code <tt><nowiki>__NOTOC__</nowiki></tt> is added

The TOC is put before the first section header unless it is placed manually with the code <tt><nowiki>__TOC__</nowiki></tt>.
Thus there may be some introductory text before it, known as the "lead".

<pre>
__NOTOC__ disables Table of Contents on those short pages which may not require it.
__TOC__ will manually place the TOC
</pre>

===Bullet list===

adding * at the beginning of a line will form a bullet list.
*1st bullet
*2nd bullet
* etc ...

===Number list===

adding # at the beginning of a line will form a number list.
#1st
#2nd
# etc ...

===Line Break===

<nowiki>If you put a break command </nowiki> 
at the end of a line you can get a 
single spacing and format your code 
like you wish.

===Indent===

adding : at the beginning of a line will indent.

no indent
: one indent
:: two
::: three

this also precludes having to place <nowiki> </nowiki> at the end of a line to break it.

===Font Size=== (using HTML)

<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text

Or, instead of using absolute sizes, you can adjust font sizes relative to the ones that the user has chosen. So for instance, if a user with visual difficulties has already set his or her font sizes to be large, you make them larger and will not accidentally set them smaller than the user can read.
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text

You can also make a font smaller:
<nowiki> Text </nowiki> = Text

===Font Color=== (using HTML)

<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text
<nowiki> Text </nowiki> = Text

<nowiki> Text </nowiki> = Text

even

R
A
I
N
B
O
W
C
O
L
O
R
S

are possible

(Font colors may look different on different screens, but the basic colors such as red, green, blue, black and white are fairly consistent.)

===Font color, face, size===

<nowiki></nowiki>
abcdefghijklmnopqrstuvwxyz

<nowiki></nowiki>
abcdefghijklmnopqrstuvwxyz

(If the viewer does not have the font you select on his or her computer, it may not look the way you expect.)

===Other HTML Commands===

<nowiki> Text </nowiki> = Bold Text
<nowiki> Text </nowiki> = Italic Text
<nowiki> Text </nowiki> = Underlined Text
<nowiki><S> Text </S></nowiki> = <S>Strikeout Text</S>
or any combination:
<nowiki> Text </nowiki> = Underline/Bold Text

===Math Markup===
Not sure this is a feature here yet ... will have to experiment.

<math> A = b ^ x</math>

===Templates===

Here is where all the major templates for this wikki will go.

*delete - <nowiki>{{delete}}</nowiki> This is the rapid delete template, designed so users can request page deletes by admins

===External Help===
[http://www.wikicities.com/wiki/Category:Help Help:WikiCities] - Wikicities help area, very useful and informative
[http://meta.wikimedia.org/wiki/Wiki_Spam Wiki Spam] - A page on wikispam from wikimedia.

== The wiki markup ==
In the left column of the TABLE below, you can see what effects are possible. In the right column, you can see how those effects were achieved. In other words, to make text look like it looks in the left column, type it in the format you see in the right column.

You may want to keep this page open in a separate browser window for reference. If you want to try out things without danger of doing any harm, you can do so in the [[PGVWiki:Sandbox|Sandbox]].

=== Sections, paragraphs, lists and lines ===
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>What it looks like</th>
<th>What you type</th>
</tr>
<tr>
<td>
Start your sections with header lines:






 New section 

 Subsection

 Sub-subsection

</td>
<td><pre><nowiki>

== New section ==

=== Subsection ===

==== Sub-subsection ====
</nowiki></pre>
</td>
</tr>
<tr>
<td>
A single [[en:newline|newline]]
has no effect on the layout.
These can be used to separate
sentences within a paragraph.
Some editors find that this aids editing
and improves the ''diff'' function.

But an empty line
starts a new paragraph.
</td>
<td>
<pre><nowiki>A single [[en:newline|newline]]
has no effect on the layout.
These can be used to separate
sentences within a paragraph.
Some editors find that this aids editing
and improves the ''diff'' function.

But an empty line
starts a new paragraph.</nowiki></pre>
</td>
</tr>
<tr valign="top"><td>You can break lines 
without starting a new paragraph.</td>
<td><pre><nowiki>You can break lines 
without starting a new paragraph.</nowiki></pre>
</td>
</tr>
<tr>
<td>
* Lists are easy to do:
** start every line with a star
** more stars means deeper levels
</td>
<td><pre><nowiki>* Lists are easy to do:
** start every line with a star
** more stars means deeper levels
</nowiki></pre>
</td>
</tr>
<tr>
<td>
# Numbered lists are also good
## very organized
## easy to follow
</td>
<td><pre><nowiki># Numbered lists are also good
## very organized
## easy to follow</nowiki></pre>
</td>
</tr>
<tr>
<td>
* You can even do mixed lists
*# and nest them
*#* like this
</td>
<td><pre><nowiki>* You can even do mixed lists
*# and nest them
*#* like this</nowiki></pre>
</td>
</tr>
<tr>
<td>
; Definition list : list of definitions
; item : the item's definition
</td>
<td><pre><nowiki>; Definition list : list
of definitions
; item : the item's definition</nowiki></pre>
</td>
</tr>
<tr>
<td>
: A colon indents a line or paragraph.
A manual newline starts a new paragraph.
* This is primarily for displayed material, but is also used for discussion on [[Help:Talk pages|Talk page]]s.
</td>
<td><pre><nowiki>: A colon indents a line or paragraph.
A manual newline starts a new paragraph.
</nowiki></pre>
</td>
</tr>
<tr valign=top>
<td>
<pre><nowiki>IF a line starts with a space THEN
it will be formatted exactly
as typed;
in a fixed-width font;
lines won't wrap;
ENDIF
this is useful for:
* pasting preformatted text;
* algorithm descriptions;
* program source code
* ascii art;</nowiki></pre>

WARNING If you make it wide,
you [[en:page widening|force the whole page to be wide]] and
hence less readable. Never start ordinary lines with spaces.
</td>
<td><pre><nowiki> IF a line starts with a space THEN
it will be formatted exactly
as typed;
in a fixed-width font;
lines won't wrap;
ENDIF
this is useful for:
* pasting preformatted text;
* algorithm descriptions;
* program source code
* ascii art;</nowiki></pre></td>
</tr>
<tr valign="top"><td><center>Centered text.</center>
</td>
<td><pre><nowiki><center>Centered text.</center></nowiki></pre>
</td>
</tr>
<tr>
<td>A [[en:horizontal dividing line|horizontal dividing line]]: above
----

and below.

Mainly useful for separating threads on Talk pages.
</td>
<td><pre><nowiki>A horizontal dividing line: above
----
and below. </nowiki></pre>
</td>
</tr>
</table>
 
 
=== Character formatting ===

<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>What it looks like</th>
<th>What you type</th>
</tr>
<tr valign="top"><td>
''Emphasize'', '''strongly''', '''''very strongly'''''.
*These are double and triple apostrophes, not double quotes.
</td>
<td>
<pre><nowiki>''Emphasize'', '''strongly''',
'''''very strongly'''''.</nowiki></pre>
</td>
</tr>
<tr valign="top"><td>
You can also write italic and bold
if the desired effect is a specific font style
rather than emphasis, as in mathematical formulae:
:F = ma
*However, the difference between these two methods is not very important for graphical browsers, and many people choose to ignore it.
</td>
<td>
<pre><nowiki>You can also write italic and bold
if the desired effect is a specific font style
rather than emphasis, as in mathematical formulas:
:F = ma</nowiki></pre>
</td>
</tr>
<tr valign=top>
<td>A typewriter font for <tt>technical terms</tt>.
</td>
<td><pre><nowiki>A typewriter font for <tt>technical terms</tt>.</nowiki></pre>
</td>
</tr>
<tr valign=top>
<td>You can use small text for captions.
</td>
<td><pre><nowiki>You can use small text for captions.</nowiki></pre>
</td>
</tr>
<tr valign="top"><td>You can <strike>strike out deleted material</strike>
and underline new material.
</td>
<td><pre><nowiki>You can <strike>strike out deleted material</strike>
and underline new material.</nowiki></pre>
</td>
</tr>
<tr valign="top">
<td>
'''Umlauts and accents:''' (See [[MediaWiki User's Guide: Creating special characters]]) 
è é ê ë ì í 
 </td></tr></table>

=== Image formatting ===
See [http://meta.wikimedia.org/wiki/Help:Contents | MediaWiki Handbook] : [http://meta.wikimedia.org/wiki/Help:Image_page Image Page] and [http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files Images and other uploaded files ]] for more extensive options.
<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>What it looks like</th>
<th>What you type</th>
</tr>
<tr valign="top"><td>Image Heading 
[[Image:PGVlogo.jpg]]</td>
<td><pre><nowiki>Image Heading 
[[Image:PGVlogo.jpg]]</nowiki></pre></td></tr>
<tr>
<td>[[Image:PGVlogo.jpg|centre|100px|thumb]]</td><td><pre><nowiki>[[Image:PGVlogo.jpg|centre|100px|thumb]]</nowiki></pre></td></tr>
<tr>
<td>[[image:PGVlogo.jpg|right|thumb|350px|Caption with a [[PhpGedView|PhpGedView]] link.]]</td><td><pre><nowiki>[[image:PGVlogo.jpg|right|thumb|350px|Caption with a [[PhpGedView|PhpGedView]] link.]]</nowiki></pre></td></tr><tr><td align="center" colspan=2>sample image: PGVlogo.jpg (281 × 50 pixel, file size: 4 KB, MIME type: image/jpeg)</td></tr>
</table>

[[Category:Help|Editing]]

Help:Editing - Revision history

Laurie: /* Image formatting */