Fullscreen
[Show/Hide Right Column]

How to make lists in wiki format
Print

Wiki-Syntax Lists

In Wiki pages and other contexts that support Wiki formatting (including articles, forums, and blogs), you can easily create bulleted, numbered, and definition lists. In numbered lists, Tiki numbers the items automatically. You can also create nested lists. The following sections explain the details; see the Quick Reference for an overview. Scroll down to Help! if something goes wrong.

In this page:


Quick Reference


To Create... Use Example
Bulleted list * (asterisk) *Item
*Item
*Item
Numbered list # (hash) #Item
#Item
#Item
Definition list ; (semicolon) ;term:definition

Image If you forget which character to use while you're editing, click the Wiki Quick Help tab.


Creating a Bulleted List

If you type an asterisk (*) at the beginning of a line, Tiki places a bullet (a black dot) at the beginning of the line. The line is indented and formatted with a hanging indent, so that second and subsequent lines are indented and aligned with the first line.

To create a bulleted list, do the following:
  1. Place the insertion point at the beginning of the line.
  2. Type an asterisk.
  3. Type the item's text.
  4. Press Enter.

Example :

  • I put an asterisk at the beginning of this line
  • And on the second too
  • and on the third
  • And you can see all the lines aligned.

Creating a Numbered List

If you type a hash mark (#) at the beginning of a line, Tiki numbers the line and indents it from the left margin. The item's text is formatted with a hanging indent, so that second and subsequent lines are indented and aligned with the first line.

To create a numbered list, do the following:
  1. Place the insertion point at the beginning of the line.
  2. Type a hash mark. Tiki supplies the period automatically.
  3. Type the item's text.
  4. Do one of the following:
    1. To continue typing items, press Enter once, and go to Step 2, above.
    2. To stop typing the list, press Enter twice.

Image If you place more than one numbered list in a page, the items are separately numbered.

Creating a Nested List

A nested list is a bulleted or numbered list that has more than one level — that is, some items have "sub-items". To create a nested list, type two or more asterisks (bulleted lists) or hash marks (numbered lists) at the beginning of the line, as shown in the following examples:

*Level 1 (bulleted list)
**Level 2 (bulleted list)
***Level 3 (bulleted list)

#Level 1 (numbered list)
##Level 2 (numbered list)
###Level 3 (numbered list)

Creating an Outline Numbered List

You can add some custom CSS to a page by using the (PluginHTML|HTML Plugin).


{HTML()}<style type="text/css">
ol {
list-style-type: decimal;
}
ol ol {
list-style-type: lower-alpha;
}
ol ol ol {
list-style-type: lower-roman;
}
</style>
{HTML}

The following
!!!Outline numbered list
# Level 1
## Level 1 a
# Level 2
## Level 2 a
## Level 2 b
### Level 2 b i
### Level 2 b ii
# Level 3
## Level 3 a

> 1. Level 1
>> a. Level 1 a
> 2. Level 2
>> a. Level 2 a
>> a. Level 2 b
>>> i. Level 2 b i
>>> ii. Level 2 b ii
> 3. Level 3
>> a. Level 3 a


Bullet list example:

  • This is a Level 1 item.
  • This is another Level 1 item
    • This is a Level 2 item.
  • Yet another Level 1 item.
    • This is a Level 2 item.
      • Sub-items can have their own sub-items! This is Level 3.
  • Back to Level 1.

Image In a bulleted list, you can create additional sub-levels beyond the third level, but Tiki doesn't use distinctive bullets beyond Level 3.

Numbered list example:

Here's a numbered list with nested levels:
  1. This is a Level 1 item.
  2. This is another Level 1 item
    1. This is a Level 2 item.
  3. Yet another Level 1 item.
    1. This is a Level 2 item.
    2. Another Level 2 item. Note the numbering.
      1. Sub-items can have their own sub-items! This is Level 3.
  4. Back to Level 1.

Image You can create deeper levels of nesting, but doing so might prove confusing to your readers.

Combined Bullet and Numbered list example:


Syntax:
*Level 1 (bulleted list)
**Level 2 (bulleted list) 
###Level 3 (numbered list) 
###Level 3 (numbered list) 
**Level 2 (bulleted list)
***Level 3 (bulleted list)
#Level 1 (numbered list) 
**Level 2 (bulleted list) 
##Level 2 (numbered list) 
##Level 2 (numbered list)


Result:
  • Level 1 (bulleted list)
    • Level 2 (bulleted list)
      1. Level 3 (numbered list)
      2. Level 3 (numbered list)
    • Level 2 (bulleted list)
      • Level 3 (bulleted list)
  1. Level 1 (numbered list)
    • Level 2 (bulleted list)
    1. Level 2 (numbered list)
    2. Level 2 (numbered list)




Adding Hidden Details

An expandable area allows you to display the major items in your list by default. Every item is still there, but it needs to be expanded to become visible. An expandable area is created by adding a minus - character after the star * characters.
  • This is a Level 1 item.
  • This Level 1 item has Hidden Details. Click the Plus [+] to open it.
    [+]
  • Back to Level 1.

Image Expandable areas work with Bulleted and Numbered lists.

Text Continuation

Text can be forced to continue at the same indentation level in a list without having a bullet or a Number assigned to it. This is accomplished by having a Plus + character start each line. The number of Plus characters controls the indentation level.
  • This is a Level 1 item.
    This line begins with a single Plus character
    • This is a Level 2 item.
      This line begins with a 2 Plus characters
  • Back to Level 1.

Image Expandable areas work with Bulleted and Numbered lists.

Creating a Definition List

A definition list displays a term that is aligned flush left; the term's definition is positioned on the subsequent line and indented. Here's an example:
unordered list
A list in which the order of the items is unimportant; also called a bulleted list.

To create a definition list, do the following:
  1. At the beginning of a line, type a semicolon (;).
  2. Type the term to be defined.
  3. Type a colon (:).
  4. Type the definition.
    • Your line should look like this: ;term:definition
  5. Press Enter.
  6. Do one of the following:
    1. To type another item, go to Step 2, above.
    2. To end the list, press Enter again.

Image Better definition lists can be created using the DL plugin.

Creating a Table of Contents List

Use the {maketoc} plugin to automatically create a table of contents, based on the headings on the current wiki page.

For example, using {maketoc} on this page will produce:



You can use the following options to customize the table of contents list:
Option Description Valid Values
type For backwards compatibility from older syntax: {maketoc:box}. Optional. box
maxdepth Defines how many heading levels to include in the list. If 0, then all headings will be included. Default = 0 Numeric
title Title (heading) of the table of contents. Use title="" to have no title. Default = Table of Contents
Note: The title will be translated, if available.
Introduced in 1.9.10 		Alphanumeric
showhide Create a link that will collapse (that is, hide) the table of contents link. Default = N Y or N
nolinks Create the table of contents without links. Default = n (links will be created). Y or N
nums Specify if the items in the table of contents listing should be numbered. Default = n (use bullets instead of numbers). Y, N, Force (same as Y)


Remarks

{maketoc:box} produces a table of contents without respect to the hierarchical order.
Example:

'index



Contributors to this page: nick390 points  , Rick21675 points  , campbe13658 points  , frankh07134 points  , Jürgen Heckes473 points  , xavidp1209 points  , fivos88 points  , sylvie7160 points  , DavidBright112 points  , Gérald Pineau18 points  , StarRider1 points  , Mose96 points  and system .
Page last modified on Tuesday 19 October, 2010 13:36:10 UTC by nick390 points .
The content on this page is licensed under the terms of the Creative Commons Attribution-ShareAlike License.

SourceHistorySlideshow

Site Language

Reference Guide

Keywords

These keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):



Tiki Newsletter

Delivered fresh to your email inbox!
Newsletter subscribe icon
Don't miss major announcements and other news!
Contribute to Tiki