Difference between revisions of "Help:Editing"

From 3000GT/Stealth Wiki
Jump to navigation Jump to search
m (How Do I Create a Page or Edit an Existing Page?)
m (Added shortcut links + typo fix)
 
Line 3: Line 3:
  
 
=Do I Need to Know HTML/Programming?=
 
=Do I Need to Know HTML/Programming?=
Nope! Just about everything you can imagine can be done without the use of HTML or programming knowledge. This include the ability to format text (bold/italics/etc), make headers/sections, build lists, create links, embed images, create tables, and much, much more.
+
Nope! Just about everything you can imagine can be done without the use of HTML or programming knowledge. This includes the ability to [[#Formatting Text|format text]] (bold/italics/etc), [[#Make Headers/Sections|make headers/sections]], [[#Build Lists|build lists]], [[#Create Links|create links]], [[#Embed Images|embed images]], [[#Create Tables|create tables]], and much, much more.
  
 
The ultimate goal is to provide a data source that ''anyone'' can contribute to -- easily and efficiently. Then, if you want to get fancy, the wiki provides a number of tools and plenty of flexibility to help your article grow and look exactly how you want it to. After that, if you want to (or already know how), you are more than welcome to use HTML as well. For those just starting out, here are the basics:
 
The ultimate goal is to provide a data source that ''anyone'' can contribute to -- easily and efficiently. Then, if you want to get fancy, the wiki provides a number of tools and plenty of flexibility to help your article grow and look exactly how you want it to. After that, if you want to (or already know how), you are more than welcome to use HTML as well. For those just starting out, here are the basics:

Latest revision as of 06:41, August 12, 2012

You're just a few steps away from starting and/or contributing to existing articles on 3SWiki. Before you start, here are a few tips to set you in the right direction (you can bookmark this page and refer to it later as you build your articles).

Do I Need to Know HTML/Programming?[edit]

Nope! Just about everything you can imagine can be done without the use of HTML or programming knowledge. This includes the ability to format text (bold/italics/etc), make headers/sections, build lists, create links, embed images, create tables, and much, much more.

The ultimate goal is to provide a data source that anyone can contribute to -- easily and efficiently. Then, if you want to get fancy, the wiki provides a number of tools and plenty of flexibility to help your article grow and look exactly how you want it to. After that, if you want to (or already know how), you are more than welcome to use HTML as well. For those just starting out, here are the basics:

How Do I Create a Page or Edit an Existing Page?[edit]

In order to edit or create a new article, please refer to this tutorial: Creating or Editing a 3SWiki Page

Using the Toolbar[edit]

Similar to what you may be used to, every article's edit page provides a useful toolbar that can be used to help beautify your articles. It can also be used for quick reference if you've seen something done in another wiki article, and you want to create similar results.

This is what the 3SWiki Editing Toolbar looks like:

3SWiki Editing Toolbar.png

Our toolbar is a little more advanced than you might be used to on other wiki sites to provide greater flexibility. To give a quick run-through of each of the buttons:

Top Row
Bold | Italics | Embed File/Image | Sign w/ Signature & Timestamp | Create a Link (Internal or External) | Insert a Reference
Bottom Row (Advanced)
Create Large Text Heading/Section | Create Bulleted List | Create Numbered List | Create Indented List | Create Unparsed Wiki Code | Force a New Line | Increase Text Size | Decrease Text Size | Make Superscript | Make Subscript | Embed an Image Gallery | Create a Redirect | Create a Table | Search & Replace

These buttons should cover most of the basic things you may want to do with your article. However, there are a lot of other great features built in as well. To see these additional features, click on the 'Help' link on the toolbar to get a quick reference of the guide below:

Useful Tips[edit]

3SWiki uses the same formatting techniques as every other major wiki on the web (including Wikipedia).


Formatting Text[edit]

To bolden or italicize text, simply surround the text with the appropriate number of apostrophes ( ' ). Use 2 apostrophes to italicize, or 3 apostrophes to make the text bold.

Action What You Type What 3SWiki Displays
Bold Text I am '''bold text'''! I am bold text!
Italics Text I am ''text in the style of italics''. I am text in the style of italics.
Bold+Italics Text I am '''''text that is both bold and italics'''''. I am text that is both bold and italics.


Make Headers/Sections[edit]

In order to help with the readability of an article, it is useful to divide your content up into sub-sections (kind of like this tutorial is). The sections are used to automatically construct the table of contents (see above), as well as giving other users the ability to edit just a section of your article as opposed to the entire thing. Sections are denoted by surround section-title text in equal signs ( = ), with more equal signs meaning deeper the sub-section (up to 6 levels).

Action What You Type What 3SWiki Displays
Root/Main Section =2003 3S National Gathering (St. Louis, MO)= 3SWiki Editing Header Example.png
Second-Level Sub-Section ==Gateway National Park== 3SWiki Editing Header Example 2.png
... ... ...
Sixth-Level Sub-Section ======3S Drinking Games====== 3SWiki Editing Header Example 3.png


Build Lists[edit]

Lists are great to help itemize thoughts like:

  • Modifications
  • Tools required for a tutorial
  • Steps in a process
  • etc.

There are three types of lists you can use: bulleted (unordered), numbered (ordered) or definition lists. The lists are built automatically for you by using a combination of astricks ( * ), number signs ( # ) and colons ( : ). Please note that in order for the list item to register and display properly, it needs to be on its own line. See the following for examples:

Action What You Type What 3SWiki Displays
Bulleted List
* Mitsubishi
** GTO
** 3000GT
*** Base
*** SL
*** VR4
* Dodge
** Stealth
*** Base
*** ES
*** RT
*** RT/TT
  • Mitsubishi
    • GTO
    • 3000GT
      • Base
      • SL
      • VR4
  • Dodge
    • Stealth
      • Base
      • ES
      • RT
      • RT/TT
Numbered List
# Put car on jackstands
# Empty oil
## Remove oil plug
## Let oil drain completely
## Reinstall oil plug
# Change oil filter
# Pour in fresh oil
  1. Put car on jackstands
  2. Empty oil
    1. Remove oil plug
    2. Let oil drain completely
    3. Reinstall oil plug
  3. Change oil filter
  4. Pour in fresh oil
Definition List
; ABS
: Anti-lock Breaking System
; DOHC
: Dual Over Head Cam
ABS
Anti-lock Breaking System
DOHC
Dual Over Head Cam
Mixed Lists
# Clean car
#* Spray car with hose
#* Use sponge to apply clean, soapy water
# Dry car
# Apply wax
#* Use an applicator pad
#* Apply evenly
#*: Avoid globs of wax as it takes longer for it to dry
  1. Clean car
    • Spray car with hose
    • Use sponge to apply clean, soapy water
  2. Dry car
  3. Apply wax
    • Use an applicator pad
    • Apply evenly
      Avoid globs of wax as it takes longer for it to dry


Create Links[edit]

Sometimes you may want to link to another website (e.g. a reference/source), or to another article here on 3SWiki. Doing this is very straight-forward, and even (at times) done automatically for you. However, if you want the greatest flexibility when it comes to how your links are displayed, please use the following techniques:

Action What You Type What 3SWiki Displays
Basic Link (automatic) http://www.stealth316.com http://www.stealth316.com
External Link (w/ custom text) [http://www.stealth316.com Jeff Lucius' Stealth 316 Website] Jeff Lucius' Stealth 316 Website
Internal Link [[1999 3000GT VR4]] 1999 3000GT VR4
Internal Link (w/ custom text) [[1999 3000GT VR4|1999 Mitsubishi 3000GT VR4 Owner Registry]] 1999 Mitsubishi 3000GT VR4 Owner Registry

In case it's not extremely obvious, external links are usually automatically parsed out of your article. If you want to customize the text that link displays, you will need to surround the link in single brackets ( [ and ] ). After the web address (e.g. http://www.stealth316.com), simply add a space, and then type the text you want to display (e.g. Jeff Lucius' Stealth 316 Website).

For internal links, including photos here on 3SWiki (as you'll learn in the next section), simply surround the article title in double brackets ( [[ and ]] ), and place a pipe ( | ) between the title of the article and the custom text you want to display for the link. The custom text is optional.


Embed Images[edit]

Images are great! People are very visual. With that in mind, 3SWiki provides free hosting for any 3000GT/Stealth related image. These photos can be used elsewhere (on the forums, for example), or you can embed them in your article. Additionally, if you already have your images hosted elsewhere (PhotoBucket, etc), you can still embed them here as well. To get started, you must first upload your new file. For instructions on how to do this, please visit: Help:Upload

Once your upload completes, you will be redirected to the info page for your photo. The web address will be something similar to: http://www.3swiki.org/File:My_Photo.jpg

Use the name of the file, including the File: prefix, surrounded in double-brackets ( [[ and ]] ) to embed the photo in your article. Here is the basic syntax:

[[File:filename.extension|options|caption]]

Note: When uploading an image, please try to make your filename something meaningful and unique. (e.g. Alan92RTTT_1992_Dodge_Stealth_RTTT.jpg)

Single Images[edit]

Action What You Type What 3SWiki Displays
Single Image [[File:Rotm_default.png]] Rotm default.png
Single Image (Resized) [[File:Rotm_default.png|100px]] Rotm default.png
Single Image (Centered) [[File:Rotm_default.png|center]]
Rotm default.png
Single Image (Float Right) [[File:Rotm_default.png|right]]
Rotm default.png
Single Image (Frame w/ Caption) [[File:Rotm_default.png|frame|It's a 3000GT, see it?]]
It's a 3000GT, see it?
Single Image (Thumbnail) [[File:Rotm_default.png|thumb|100px|3SWiki will automatically resize your images!]]
3SWiki will automatically resize your images!

It is worth making a special mention of the thumbnail feature shown above. You no longer need to resize your images in Photoshop, etc in order to make them the right size for the wiki. The 3SWiki software will automatically do that for you, creating alternate (smaller file size) versions of the full-size image you uploaded. This helps make your articles load faster, and saves you from having to upload multiple sizes of the same image.

Multiple Images[edit]

Galleries are becoming increasingly popular if you have leftover images to display at the end of your article. To display a gallery, simply use the <gallery> tag.

Action What You Type What 3SWiki Displays
Multi-Image Gallery
<gallery>
File:Showkiller5.jpg
File:Jbelknap13.jpg
File:IMG_0238a.jpg
File:Duttch4.jpg
</gallery>
Multi-Image Gallery (w/ Captions)
<gallery>
File:Showkiller5.jpg|Show Killer
File:Jbelknap13.jpg|VR-4ever
File:IMG_0238a.jpg|Oohnoo
File:Duttch4.jpg|DuTTch
</gallery>
Multi-Image Gallery (Resized)
<gallery widths=75px heights=50px>
File:Showkiller5.jpg
File:Jbelknap13.jpg
File:IMG_0238a.jpg
File:Duttch4.jpg
</gallery>
Multi-Image Gallery (Multi Row)
<gallery widths=75px heights=50px perrow=2>
File:Showkiller5.jpg
File:Jbelknap13.jpg
File:IMG_0238a.jpg
File:Duttch4.jpg
</gallery>

This is just the tip of the iceberg on what all you can do with images. To read more, please check out MediaWiki's Guide on Embedding Images.


Create Tables[edit]

Tables are invaluable when it comes to organizing your data into rows and columns. The syntax may seem daunting at first, but it becomes fairly intuitive after first using it. The basic symbols you want to know include the following (each symbol needs to start on a new line):

Symbol Meaning
{| Start Table
| New Column
|- New Row
|} End Table
Action What You Type What 3SWiki Displays
Basic 3x3 Table
{|
|3SI
|3SGTO
|BAWC
|-
|dpfsharkbait
|Alan92RTTT
|Gatecrasher
|-
|http://www.3si.org
|http://www.3sgto.org
|http://www.bawcforums.org
|}
3SI 3SGTO BAWC
dpfsharkbait Alan92RTTT Gatecrasher
http://www.3si.org/ http://www.3sgto.org/ http://www.bawcforums.org/
Advanced 3x3 Table
{| class="wikitable"
|
!3SI
!3SGTO
!BAWC
|-
!Admin
|dpfsharkbait
|Alan92RTTT
|Gatecrasher
|-
!Website
|http://www.3si.org
|http://www.3sgto.org
|http://www.bawcforums.org
|}
3SI 3SGTO BAWC
Admin dpfsharkbait Alan92RTTT Gatecrasher
Website http://www.3si.org/ http://www.3sgto.org/ http://www.bawcforums.org/


HTML/CSS[edit]

Of course, if you wish to show off, the ability to use HTML and CSS is also enabled on 3SWiki. If you know what you're doing, and you're confident the HTML you're included is well-formed and valid, feel free to sprinkle it within your articles!