Getting Started with TechCamp Wiki

From TechCampGlobal
Revision as of 17:20, 7 October 2011 by Johnawysham (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This page is intended to provide a brief overview of the editing process in the TechCamp wiki. This is not a comprehensive introduction to wiki editing. It should be just enough to get you started.

Sign up for an account

  1. Click on the link on the upper right of the page that says "Create an account or log in"
  2. Fill out all the boxes.
  3. Click "Create new account" when you're done.

Once you create an account, you are logged in. When you want to edit something, click the "Create an account or log in" link and use the user name and password that you created.

Checking for Updates

Want to be notified of changes to particular pages without having to check them every day? In order to be notified by email of any changes to a particular page, you would need to add this to page to your watchlist.

Simply go to the page and click on watch at the top of the page.

Depending on your personal settings, you will then be notified via email or on your watchlist [casino en ligne] of what changes were made, when, and by whom.

You can also check for updates related to any given page or category via the web-based tool Special:RelatedChanges.

Existing Content

Before you start a new article, do a search or two to see if an article with a similar name already exists (an article which you may be able to expand rather than write a new article from scratch). If an article exists, you are then welcome to edit the existing article to add content.

Editing basics

Review the introductory materials

Please read through the Terms of Use and About page before you begin editing.

Practice

You can edit the sandbox page to your heart's content - it is just a scratch page to get used to editing a wiki. When you are ready, come back to this page for more tips. Go to the sandbox page by clicking here.

Start editing

To start editing a 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.

Summarize your changes

Write a short edit summary in the small field below the edit-box.

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 most frequently used wiki markups.

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 doesn'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 doesn't do anything
special -- there's just ''''one left
over''''.)

You should "sign" your comments on talk pages:
- Three tildes gives your user name: Tiffanysmith
- Four tildes give your user name plus date/time: Tiffanysmith 15:57, 11 May 2011 (PDT)
- Five tildes gives the date/time alone: 15:57, 11 May 2011 (PDT)

You should "sign" your comments 
on talk pages: <br>
- Three tildes gives your user
name: ~~~ <br>
- Four tildes gives your user 
name plus date/time: ~~~~ <br>
- Five tildes gives 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 - using only 1 equals sign creates H1 tags which should be reserved for page titles.

Images / Pictures

To upload images to TechCamp Wiki:

  1. Make sure the image is either a JPEG (.jpg), GIF (.gif), or Portable Network Graphics (.png) file format.
  2. Click the Upload File link on the left menubar of an article page. (If you don't see the link, you probably aren't yet logged in.)
  3. Next to the Source filename box, click Browse and select the image you want to upload.
  4. Add a Summary.
  5. Click the Upload file button.

To add the new image to a TechCamp Wiki article, you'll add code like this to your article:

[[image:picture.jpg]]

TechCamp Wiki will understand the file is a picture and display it properly. It doesn't look like this should work, but it does.

To resize an image, a new IMAGE tag would be something like this:

[[image:Jane-Doe.jpg|right|thumb|200px]]

This will put the picture on the right hand side and size it to 200 pixels no matter what the size of the original. If you want to add a caption, use

[[image:picture.jpg|right|frame|This is the caption text]]

For example:

[[image:Jane-doe.jpg|right|thumb|200px|This is Jane Doe]]

The resulting picture in each case will have 2 little boxes in the lower right corner. If you click this, you'll get a nice copy of the original size.

If you get a red link instead of a picture, you need to click the link and upload the picture you want to display. If you already uploaded the file, then there may be a misspelling in the file name.

Want to link to an image, file, template, or category without causing it to render on the page? Prepending a colon to the beginning of the link will create a standard internal wiki link to your special object.

[[:image:picture.jpg]]

Web Links

Unlike wiki links that enclose an article title in double square brackets, links to web addresses are enclosed in single square brackets. A title for the link goes after the URL. For example, the link TechCampGlobal.org is made using the code
[http://techcampglobal.org/ TechCampGlobal.org]

Links to Wikipedia are simplified by the macro {{Wikipedia}}. A link to article "Main page" would be {{Wikipedia|Main_page|Main Page}} - the second parameter is the name of the article as it appears in the wikipedia page address with underscores for spaces. The third parameter is the article name in normal text or any text you would like to show up for the link: Main PageWikipedia Logo.jpg.

The Wiki will automatically convert anything beginning with http:// into a link. To prevent this, use the <nowiki> command. Example: <nowiki>http://techcampglobal.org/</nowiki>

Reference Links

Adding references can be made a couple ways. Reference documents may be placed at the end of an article in a "Reference" section. If you wish to add scholary inline references, you can put a web link (like Web Links above) after the quote but do not put any text after the web address.

The link should show up like this: [1]

References are self-numbering in order of appearance. Feel free to add references without regard to numbering.

Documents and Adobe Acrobat Files

To add documents to your markup, upload the files by going to the Upload Page. Upload your document: for example, myfile.pdf.

Then to reference your file, make a web link to the document like this:

You can read a PDF version of My File which uses a link like this:
[[media:myfile.pdf|PDF version of My File]]

The same works for a Microsoft Word document, Powerpoint file, etc. Just remember to use the proper filename (myfile.doc might replace myfile.pdf above for example).


Wiki Markup Reference

  • Wikipedia - how to edit a page. Good for more in-depth items including standards and variables.
  • Wikimedia - Information for readers, editors, moderators, and administrators