Did you know that Puzzle Place has a forum where you can talk about puzzles with other puzzlers?
VISIT FORUM

Tutorial

From Puzzle Place
Jump to: navigation, search

Introduction

This page explains how to add a puzzle to the Puzzle Place.

It is neither an introduction to wiki editing for beginners, nor a comprehensive documentation. This tutorial is aimed at people who already have a basic understanding of the workings of a wiki, and who want to casually contribute to the Puzzle Place.

More technical information about wiki editing can be found in the Help page.

Before starting

In order to contribute to the Puzzle Place, you must first register an account, following the link in the upper right corner.

Check if the puzzle that you want to add already exists in the Puzzle index. You can also use the search box of the wiki in the upper right hand side, or search by Designer or Manufacturer, if you are not sure about the exact name of the puzzle.

If the puzzle is not yet listed, then try to find a picture of it that would be not too small, nor too large. Sizes between 200x200 and 1000x1000 pixels should be ok. Look also for some information about the puzzle, like its designer, its manufacturer, its dimentions, price, seller... It doesn't matter if some information are missing. The page can be edited later.

Here are some sources who gave their permission to use their pictures for the Puzzle Place : Bill Cutler, Scott Peterson, John Devost, Robert Yarger, Eric Fuller, Steve Strickland, Puzzle Master, Vinco, Splinter Spierenburgh.

Adding a new puzzle

Upload the pictures

Tutorial01.jpg


Upload the picture to the wiki using the Upload file link on the left side (steps 1 and 2). You can upload several pictures if the puzzle exists in different versions, or if it is relevant to show the disassembled pieces, or even a partially disassembled configuration.

Please, give an explicit name to the pictures (step 3), as they can't be renamed after being uploaded. This can be done directly in the upload form.

Examples of relevant filenames for a puzzle that would be called "The Cube" :
The Cube - Walnut 1.jpg
The Cube - Walnut 2.jpg
The Cube - Walnut - pieces.jpg
The Cube - Cherry.jpg


Tutorial02.jpg


The picture must then be credited, and registered into the puzzle gallery. For this purpose, click the Edit link (step 5).

In the text box, add the following lines (step 6) :

[[Category:Puzzle Images]]
{{PhotoC|<name>}}

...where <name> is the source of the picture. If it is a picture taken by yourself, then put your own name here.

Save the page (step 7).

The picture is now part of the wiki, and can be included in any other page or gallery. For this purpose, copy its exact name (step 8) and keep it at hand. It will be needed for the puzzle page.

Repeat these steps for the all the pictures that you have to upload.


Create the puzzle page

Tutorial03.jpg


All pages in the wiki have the same kind of adress. It begins with the wiki adress, and ends with the name of the page. In order to create a new page, connect to the wiki, and replace the name of the page that you are reading with the name of the page that you want to create (step 1).

The name of the page should be the name of the puzzle itself. Spaces must be replaced by underscores (_) in the adress bar.

You should get to an empty page. Click "Edit this page" (step 2).


Tutorial04.jpg


In the edit window, you must paste and complete the Puzzlebox template (step 3). You can also add a description of the puzzle (step 4), and the gallery template (step 5). Here is how.

The puzzle box template

In the Puzzlebox template page, you will find the Template and its Usage. Copy the text of the template and paste it in the edit window of your new page. This creates the table that you can see on top of all puzzle pages in the wiki.

Edit the template with the informations about the puzzle, as explained in the Usage part of the template page. It will also automatically register the new page in the category that you choose, and update the list of puzzles in the wiki. You can use any existing page as an example, clicking the "edit" link to see how the template was used.

Tips

Tutorial05.jpg


  • a) To be displayed properly, the image name must be the exact name of the file that was uploaded to the wiki.
  • b) In the image caption, repeat the same {{PhotoC|<name>}} template that you entered when you uploaded the file, so that the credits of the picture are displayed. Anywhere in the wiki, you can type puzzle or people names inside [[double brakets]] to create a link to their page. You can do it even if their page doesn't exist, this way, the link will be ready when the page is created. Write the exact page name for the link to work properly.
  • c) To create a link to a webpage that is not into the wiki, type its adress, followed by a description, inside simple brakets.
  • d) Designer, Manufacturer, and Type are special fields of the puzzlebox template. Just type their name (more precisely, the name of their page in the wiki) without brakets. The template automatically registers the puzzle in the chosen categories when the page is saved.
  • e) To start a newline inside the puzzlebox, use the <br> code.

The main text

You can write a description of the puzzle below the puzzlebox. Single new lines are ignored. To start a new paragraph, type two newlines.

Remember that a wiki is a place for documentation and information. Do not write your personal opinion about the puzzle here.

The picture gallery

If you have got several pictures of the puzzle, you can create a picture gallery at the bottom of the page.

Copy and paste the Gallerybox template at the bottom of your page, and edit it with your puzzle pictures.

The <<image>> must be the exact name of the file that you uploaded. The <<caption>> is the title that you want to give to the picture in the gallery, followed by the {{PhotoC|<name>}} template with the credits of the picture.

You can use any existing page as an example, clicking the "edit" link to see how the template was used.

Final step

Re-read yourself, and click the Save page button (step 6). The new puzzle is now added to the wiki.


You can further edit the page, or correct mistakes in any other page with the "edit" link, as long as you are logged in the wiki. Fill the "Summary" field before saving to describe your change. It will be displayed in the history. Check the "Minor edit" box if you are just correcting typos.

For more comprehensive help about wiki editing, formatting text etc, start from the Help page.


Adding new people

The way the Puzzle Place deals with people is a bit special. In order to have puzzles manufactured or designed by someone automatically listed in his or her page, people are actually categories of the wiki.

But in order to handle brand names in addition to real names (Mr. Puzzle = Brian Young, for example) and to simplify the edition of the wiki, people also have their own pages. It's just that the pages associated to someone redirect to the category itself, where all the relevant information is stored.

To add someone to the Puzzle Place, first, look in the People category if this person exists. If you don't know the first name, use the search box of the wiki, in the upper right hand side. Mind the capital letter, or the search won't work.


Create the new category

Tutorial06.jpg

Proceed the same way as for creating a new page, but insert the keyword Category: in front of the page name in the adress bar of your Internet browser. The page name must be First name, then Last name, separated with an underscore (step 1). In the new page, click 'edit this page' (step 2).

Tutorial07.jpg

In the text box, write a short text about the person whom you want to add. If you don't have informations, just write A page for all puzzles by... (Step 3). Save the category (Step 4).


Create the new pages

Tutorial08.jpg

Create the new page. the process is the same. Just remove the Category: in front of the page name in the adress bar (step 5). Click 'edit this page' (step 6).

Tutorial09.jpg

In the text box, add the redirection code that leads to the category that you just created, state that this page belongs to the People category, and to the Manufacturer and/or Designer category, as following (step 7).

#REDIRECT [[:Category:<<First name Last name>>]]

[[Category:Designer]]
[[Category:Manufacturer]]
[[Category:People]]

And save the page (step 8).


If this person manufactures puzzles under a brand name (like Mr. Puzzle for Brian Young, for example), then create another redirection page with the name of the brand, following steps 5 to 8 again.


Now, inserting the name of this person between [[double brakets]] in a page of the wiki will automatically create a link to this person's category, while inserting his or her name in the Manufacturer or Designer field of the puzzle box template, in a puzzle page, will automatically update the list of the puzzles associated with this person.