What is a wiki?
A wiki is a website which allows its users to add, modify, or delete its content via a web browser usually using a simplified markup language or a rich-text editor.
If you are unfamiliar with the concept of a wiki, here is a short YouTube video that explains the basics.
Or you can consult the Wikipedia article.
Overview of wiki editing
The American Petanque Directory, like all wikis, consists of a group of pages that are tied together by "wiki links" which allow you to navigate from one wiki entry to another.
To edit any given entry, you navigate to the entry and click on the EDIT button.
This will put you into a screen where you can edit in either a SOURCE mode or a VISUAL mode.
- SOURCE mode allows you to edit the wiki markup, which is very much like the markup used by wikipedia and other wikis.
- VISUAL mode allows you to edit in a WYSWIG mode, very much like using a word processor such as Microsoft word.
The most common editing task that you will do is to add a wiki link.
- In SOURCE mode, you can create a wiki link simply by entering the name of the wiki page and enclosing it in two pairs of square brackets.
- In VISUAL mode, you can create a link by highlighting the appropriate text and clicking on either the "internal link" or "external link" editing button at the top of the screen.
Here are links for other helpful information.
- Introduction to Wikia editing
- Wikitext markup cheat sheet/overview
- Advanced features of wikitext markup
Entries for clubs, groups, terrains, and players
The Directory is designed to contain listings for four kinds of things --
- A petanque club is an organized group that has its own web site/ blog page/ Facebook page. Information about the club is provided on its web page, so the directory usually provides little information other than the address (URL) of the club's web page.
- A petanque group is an informal group that does not have its own web page. The typical group has a terrain where it plays regularly, and a regular day and time when it plays. The directory listing for the group may give a contact telephone number or email address, but in many cases the best way to contact the is simply to show up at a place and time when the group is playing, and introduce yourself.
- A petanque terrain is a location that is suitable for playing petanque. It might be an area in a park, or a petanque court in a hotel or apartment complex, or just about any place that would be a good place to play. It has a location, and it may have a web site... for example a park might have a listing on the web site of the local parks and recreation department.
- A petanque player is a person who is seeking other petanque players, in a city where there is no petanque club or group listed. Contact information may include an email address, telephone number, or personal web page such as a blog or Facebook page.
How to add information about a club
Go to the page for the state in which the club or terrain is located.
Edit the state page, and add an entry for your club. As much as possible, try to insert the entry in alphabetical order. The names of most clubs begin with the name of the city in which they are located, like this
Los Angeles Petanque Club
If your club's name does not begin with the name of your city, then start your entry with
- the name of the city in which the club is located
- a single space, a single dash, a single space
- the name of the club.
Santa Fe - La Mesa Petanque Club
After the name of the club, put a short bullet list giving information about your club.
- The first bullet should contain a link to the club's web site or Facebook page -- some web location where people can find out more about your club.
- After that you can if you wish add a few bullets with whatever high-level directory-type information you think appropriate, such as when and where the club regularly plays.
- Keep your entry short -- you don't need to go overboard on the details. This is, after all, a directory listing. A reader who is interested in more details about the club should be able to find them on the club's web site.
Further down this page, there is a section with some typical examples.
When you have finished adding the link to your club, click the Publish button to publish the updated State page.
How to add information about a group
A petanque group is an informal group that has no web site. Such groups often meet regularly at the same terrain, and prefer to refer to themselves as simply a group of "players" rather than a "club". So that is the convention that we use in the Directory. We will name the group after the terrain upon which they play, e.g. "The Udall Park Players".
For such groups, we recommend that you list
- when and where you regularly play.
If possible, we recommend that you also provide contact information, such as:
- the name and telephone number of a contact person.
- an email address of a contact person.
BUT — if you provide an email address, use a CAPTCHA link (discussed earlier in this guide) to avoid giving your email address to spammers. (One reason for creating a web page for your group, no matter how informal it is, is to remove the need for hiding your email address with a CAPTCHA.)
Here is an example of a typical listing for a petanque group:
Tucson - Udall Park players * We meet every Thursday morning at 8 am at the bocce courts in Udall Park * After entering the park, bear left. Go past the pool. * Turn right (toward the baseball diamonds). * Proceed to the parking area in front of the pavilion. You will see the courts.
How to add information about a place to play (a terrain)
If you'd like to share information about a suitable playing location (terrain) in your city, use the word "terrain".
Tucson - terrain in Reid Park
- Reid Park has a nice natural terrain next to the kid's play area.
- Use the 22nd Street entrance, and turn left into the parking lot immediately after you enter the park.
How to provide a safe email address
We here at the American Petanque Directory advise you not to provide your your email address in a listing in the Directory. The reason for this advice is the existence of software programs called spambots.
Spambots are programs that constantly rove the Internet looking for email addresses. When they find one, they give it to spammers. The spammers then flood your email INBOX with spam email. So posting your unprotected email address on a web page is like climbing on to your house-top and shouting "Please send me spam email! LOTS OF IT!"
There are two ways to make it difficult for spambots to harvest an email address. The first is called address munging. The other is CAPTCHA.
Address munging is the process of disguising an email address by inserting or changing certain characters in the address. For example, changing:
firstname.lastname@example.org —> myname (at) something (dot) net
This technique helps, especially if (as in our example) you insert space characters as well as parentheses, brackets, and so on. Spambots can be programmed to recognize such tricks, however, so address munging is not guaranteed to be 100% effective. For more information see the Wikipedia article on address munging.
CAPTCHA is a program that hides an email address from spambots, but allows humans to see and use it.
There are a number of different providers of free CAPTCHA services. We recommend Google's CAPTCHA service, which is free, easy to use, and nicely explained on their web page - http://www.google.com/recaptcha/mailhide/
Here's how to use it.
- Start with the email address that you want to use.
- In your web browser, go to Google's CAPTCHA page - http://www.google.com/recaptcha/mailhide/.
- On the CAPTCHA page, enter or paste in the email address, and click on OK.
- The CAPTCHA service will generate two things. The first will be a URL (a web address, or link). Copy that URL into your computer's clipboard. (Select/highlight it, then press CONTROL+C.)
- In your web browser, navigate to the American Petanque Directory page that you want to update and go into EDIT mode.
- Create the email link using "Send email" as the display text.
Here is how to create the email link.
- In SOURCE mode, enter the code for an external link. It will be enclosed in single square brackets, and will will look something like this:
[http://www.google.com/recaptcha/mailhide/d?k=01OlTJmzQuidimvPICKgQYQw=&c=j2vVsIQ851Jsggidx7xHKg= Send email]
- In Visual mode,
- Click on the spot on the page where you want to add the email link.
- Click on the "Add link" button (at the top of the page, it looks like a little chain link).
- When the data entry screen pops up, paste in the URL (You can use CONTROL+V to do the paste).
- Enter "Send email" as the display text.
- Make sure the "external link" is selected.
- Click OK.
How to add a picture to the entry for your club
This is easy. Open the entry for editing in visual mode. The buttons for adding a picture will be in the upper right-hand corner.
Adding a picture is actually a two-step process. First, you upload the picture from your computer to the wiki. Second, you insert the uploaded picture into your wiki entry. When you insert the picture, you will be able to align it left, right, or center, choose its display size, and to add a caption.
How to keep images from floating down into the next entry
Images — pictures and photos — tend to float up and down the page and not to stay put in the vertical place where you put them. To stop them from floating downward, edit your entry in SOURCE mode, and — at the end of the entry — code
Edit the entry in SOURCE mode, and at the end of the code that inserts the phote — just inside the two right square brackets — put the caption. In this example, the caption is "Open terrain at Udall Park".
[[File:Open_terrain_at_Udall_Park.jpg|thumb|400px|Open terrain at Udall Park]]
and this is what it will look like when it is displayed.
To remove an entry, strike it out, don't delete it
If you find a dead entry -- an entry that should be removed from the Directory, like an entry for a club that no longer exists — don't delete it, strike it out,
Here's why. Suppose you edit the page where the club is listed and simply delete the listing for the club. Late, someone else may come along with obsolete information about the club, which he believes still exists. If he finds no listing for the club, he will naturally assume that the club simply hasn't yet been listed to the Directory, and he adds it (again).
To avoid that kind of situation, don't delete the entry for the defunct club. Instead, strike out the listing and add information about the time when the club went missing, like this.
Podunk - Podunk Petanque Club* As of Dec 12, 2012, this club no longer exists.
To do this, you need to know how to produce a strike-out effect
like this when editing the wiki.
- If you are editing in Source mode, enclose the text in <strike> ... </strike> HTML tags.
- If you are editing in Visual mode, highlight the text that you want to strike, and then click on the
abc(Strike Through) button. If you don't see the abcbutton, click on the more + button, which will open a second button-bar — the Strike Through button will be the second from the left.
When to completely delete an entry to remove it
Sometimes it happens that a club actually wishes not to be found. Perhaps they have established a stable community of friends and players, or perhaps they have very limited resources, and don't want new players. For whatever reason, they prefer to remain "off the grid and below the radar".
Their wishes should be respected. If you discover such a situation, it is appropriate to completely delete the club's listing from the directory.
Remember, however, that deleting an entry is more likely to be a mistake than a deliberate decision. So when Jules Lenoir (the site administrator) sees that the listing for a club has disappeared, he will assume that the deletion was a mistake, and he will UNDO the deletion. Therefore, if you deliberately delete an entry, you should also leave a message for Jules telling him that this was a deliberate action and explaining why you did it. To communicate with Jules, add a message to the Message_Wall:Jules_Lenoir page.
How to add a Google map
See our entry on How to add a link to Google Maps