Need Help? Wiki User Guides

Added by Karen Huffman, last edited by Karen Huffman on Dec 08, 2009  (view change)

Select the topic to help get you started:

Creating Pages and Organizating Content

Table of contents

Related user guides

Below are a selection of tutorials to get you started. For a complete list of tutorials, please see Confluence User Guide.

Organizing your site

When starting ANY website as with any document or presentation, it is extremely important to take some time to figure out how you want to organize the content. If you have a wiki-master (aka wiki administrator), then they may have already done this for your wiki site. Confluence has useful guides on this topic: 

  • Organizing pages hierarchically (parents and children): This is particularly useful if you want to group related content, for example, chapters in a user guide/manual, committee material, topical expertise, etc.
  • Page restrictions (security for viewing/editing pages) may be placed on a single page or a group of pages. If security is placed on the parent page, all children inherit the security placed on its parent page.

Consistency and standards

  • Add a table of contents at the top of to help users navigate content to major headings/subheadings. For example: 
    {toc:style=disc|indent=20px|maxLevel=3}
  • Use wiki headings and subheadings to group major ideas (e.g., h1, h2, h3, etc.)
  • Write for the Web. Keep ideas on target and in digestable chunks.
  • White space is okay.
  • Integrate images and rich media to enhance message and content.
  • Add labels to categorize content. For example, as our DC/SLA Communications Committee builds a 2009 conference wiki, we are adding information about local area attractions such as theatre performances at the Kennedy Center. Useful labels might include the following: theatre, performances, distance_1-3_miles. These labels can be used a variety of ways including an ability to create a dynamic search for our wiki visitors.
  • See also adding a page using a template.

Adding File Attachments Images

Table of contents

Related user guides

Below are a selection of tutorials to get you started. For a complete list of tutorials, please see Confluence User Guide.

Tips

Images can be formatted similar to HTML images. Parameters are added after the pipe "|". For example, the below parameters will display the image on the right with 10 pixels of space between the image and other objects (vspace = vertical spacing, hspace=horizontal spacing), and 1 pixel black border.

!KennedyCenter.jpg|align=right,vspace=10,hspace=10,border=1!

File formats and size recommendations

Confluence supports the following image file formats: GIF, JPG/JPEG, and PNG. 

Images often need to be resized to fit within the layout/design of Web pages. When resizing, make sure to maintain the picture's proper proportions.  If not, the picture will look vertically or horizontally stretched (or skewed). Below are suggested image sizes (in pixels):

Image sizes (pixels) Landscape Portrait Square
Thumbnails      
Width 90 90 90
Height 70 120 90
Medium      
Width 180 140 140
Height 120 210 140
Large      
Width 400 300 400
Height 300 400 400
Extra Large      
Width 600 450 600
Height 450 600 600

Acceptable image formats: GIF, JPG, and PNG.

Free photo editors

Creating Internal and External Links

Table of contents

Related user guides

Below are a selection of tutorials to get you started. For a complete list of tutorials, please see Confluence User Guide.

Formatting and style recommendations

Additional User Guides

Confluence's documentation

Labels