Wiki Help : How to Use this Wiki

Adding a Page to the Wiki

Adding a page to the wiki is very easy. In the case of linking, the preferred methodology is wiki linking syntax. 

Important When creating a page, be sure to use the proper template.

• To add a page

There are two methods to add a page to the wiki:

Method 1

1. Type double brackets [[ ]] around what you want the title of your page to be.
2. Save your edit.
3. When you save the page where you typed the brackets around the new page name, the page name appears as a red link. The red indicates the page does not yet have content. Click the link.
4. Add content to the new page, then save your work.

Method 2

1. On the left of the wiki, in the Search box, type a string with the desired page name.
   1. Important Follow the capitalization norms highlighted in the Bungee Documentation Style Guide.
2. Under the Search box, click Go.
3. At the top of the Search page, click the red bold string matching the name you just entered.
4. Add content to the new page, then save your work.

Editing Limitations

WikiMedia and the HTML editors we have added to this interface use different models for editing content, formatting styles, and creating links. The Bungee Documentation wiki's use of HTML editors means that most wiki syntax is not recognized by MediaWiki. For example, the expected formatting headings and bullets that would normally result from items such as:

== Heading ==

=== AnotherHeading ===

* SomeText

**SomeMoreText

do not result. For a quick overview of how to use the FCKeditor's formatting, see the FCKeditor User's Guide. The process of creating links in the Bungee Documentation Wiki is not subject to the same limitations as styles formatting.

Creating Links

You may use either MediaWiki's linking syntax or FCKedtior's linking methodology (see the FCKeditor User's Guide) to create the four basic types of wiki links.

Tip Although copying links is often a good way to begin learning the wiki syntax, you may sometimes find that a pasted link does not work properly. In such cases, at the top left corner of the editor, click Source. When you inspect the copied link in the source view, you may see something like the following: [<font size="2">[Some Other Page in the Wiki]]</font></li>. Removing the font characteristics should make the link functional.

• External to the wiki--HTML editor preferred
• Pointing to a different page in the wiki--wiki syntax preferred <nowiki>Some Other Page in the Wiki</nowiki> 

• Note for a more thorough discussion  of the use of topic areas in wiki links, please see Wiki Naming Conventions

• Pointing to a particular heading on a different page in the wiki--wiki syntax preferred <nowiki>Some Topic On That Page</nowiki>
• Word or phrase (not a section heading) on a different page in the wiki, HTML editor preferred   
• Section Heading on the same page you are editing--wiki sytax preferred <nowiki>Some Topic On This Page</nowiki>
• Word or phrase (not a section heading) on the same page you are editing, HTML editor preferred 

Whether you use wiki syntax or the HTML editor, when you create a link external to the wiki, please do not open a new window for the page to which you are linking.

Note Beyond the examples of wiki link syntax shown above, there are many examples of linking on the pages of this wiki. A quick glance at one of them (in edit mode) may provide you with an example that is pertinent to what you are trying to accomplish.

Creating an External Link

When you reference a link to a topic outside of the Bungee Connect wiki, such as an article at Wikipedia, you should create an external link.  An external link will have a small icon next to it to indicate that this link leave the wiki.  The following syntax will create an external link:  <nowiki>Click here for the external link</nowiki>  The above link will look like Click here for the external link.  The wiki uses all the text after the URL as the title of the link.

Preventing URLs from Becoming Links

In some cases, you may not want text to display as a link, even though the text is a URL, for example, when you are giving instructions to type a URL into a field. If you use the text http://someurl then the Wiki automatically creates a link. To prevent the creation of a link, surround the URL with nowiki tags, like this: <nowiki> http://someurl</nowiki>. (Click the Edit link for this section to see the example.)

Importing Images

Image imporatation and linking uses the HTML editor model only (see the FCKeditor User's Guide).

Creating an AlphaNumeric Sublist within an Ordered List

• To create an alphanumeric sublist

1.  With the wiki in edit mode, within your ordered list, place your cursor at the end of the line containing the item inside of an ordered  list that you want to make subordinate.
2. Press the ENTER key on your keyboard so that add another item below the one you want indented.
   

   Important You need to do this before you indent the line you want to indent, or else you won't be able to get back to the orignal level of your ordered list without tweaking the source code. If you are at the end of the procedure, and don't need another numbered item at the orignal level following your indented item, then this step is not necessary.

3. Select the item you want to indent, then in the Toolbar at the top of the Editor, click the Increase Indent button. This makes the list item a child of the previous list item.
4. You can then add as many indented items as you want by selecting the end of the indented line and pressing ENTER repeatedly.
5. Fill in the steps for each of the indented list items, as well as the extra non-indented list item as appropriate.
6. If you follow these steps for the example above, the list renders so:

1. Rose
2. David and Betty
   
   1. Clark
   2. Gail
   3. Alan
3. Bill

Creating Admonitions Within a List

If you want to create an admonition within a list (as appears in the procedure #To create an alphanumeric sublist above, you must follow the steps below.

• To create an admonition within a list

1. At the end of the list item to which you want to add an admonition, press Enter to create a new list item.
2. Type the text you want to appear in the admonition.
3. Press  Enter to create a new list item.
4. Select the first list item you created. Press Tab to make the first list item a child of the previous list item.
5. In the FCKeditor controls at the top of the page, in the Style drop-down box, choose admonition_list.
   1. Note Currently, this works only in Firefox and you must select the number or letter at the beginning of the admonition in order to see admonition_list in the drop-down box.
      
      You may add multiple lines to the admonition by pressing Shift + Enter at the end of a line in the admonition.

• To end the Admonition press Enter once, then  FCKeditor controls at the to of the page, choose Decrease Indent.. If you are lucky, this will change the item to the same level as the original list item and remove the style from the new list. If you are not fortunate, the admonition will be removed, but the level will remain indented to the same level. The only hope then is use the FCKeditor controls at the to of the page to select Source, and in the source view, to remove the extra ordered list tags <ol></ol> that have somehow been placed around the item. This will return the item to the proper level.

Applying Table Styles

• All tables will receive a bottom boarder by default.
• The table_Heading style must be applied to the table cell <td>, not the row <tr>.
• The table_Highlight style should be applied to every other row starting with the first row below the table heading.

Applying the Prochead style

Although it may not appear to be, this item is treated as a list. This means that before you apply the prochead paragraph style, you should apply either an unordered (bulleted) list. If you apply an ordered (numbered)list, then your numbering in the procedure will be off. Then apply the prochead style tag. The prochead bullet (triangle) should then appear.

When I Fix a Broken Link, the Link Stays Pink and the Font Size Grows

If you copy and paste existing HTML docs into the wiki, and the HTML includes links internal to that pasted page's content, the pasted links will be broken and shown as pink. The good news is that all of the anchors on the pasted page are still intact. You must however, re-do all links pointing to those anchors. If you simply click the link icon and re-make the link, the link stays pink, and the font size grows slightly larger.

When I Edit a Page, I Get a Length Warning

When you open a document over a certain length, a warning appears at the top of the page displaying text such as this: WARNING: This page is 58 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections.