History: Using Wiki Pages

            {DIV(id="onthispage", float=right,width="180px")}
{DIV}
!Using Wiki Pages
To fully understand the power and flexibility of Tiki's wiki pages, be sure to review the ((The Wiki)) section. Depending on the features and options enabled, you may be able to:
* Create new pages
* Edit existing pages
* Read pages
* Add Comments to pages
* Find Similar pages
* See what is hot and what is not
* Much, much more 
{DIV(id="break" clear="both")}{DIV}
!!About Wiki Syntax
For detailed information on using Tiki's wiki syntax, see the following pages:
{toc structId="3841"}


!Displaying the Wiki menu
Most wiki features can be accessed from the main menu:

{TABS(name="wikimenu" tabs="7.x|2.x")}
{img fileId=589 thumb=n rel=box[g] width="100%" desc="Sample Wiki menu." align="center"}
Depending on your site configuration, different options may be available. The primary Wiki menu options are:
{FANCYTABLE(head="Option | Description" colwidths="25%|75%" colaligns="left" colvaligns="top")}
Wiki Home | Displays which wiki page is viewed as the Wiki ''Home'' page. You can ((Wiki General Preferences|configure any wiki page)) to be the wiki (or site) ''home'' page
Last Changes | Displays the last (recently) changed/edited pages. See [#Displaying_Last_Changes|Displaying Last Changes].
Dump | Create (and download) an archive of the content of the wiki pages.
Rankings | Displays the top (popular) pages, based on activity. See __Wiki Rankings__ below
List Pages | Displays ''all'' wiki pages. See [#Listing_Pages|Listing Pages].
Orphan Pages | Displays wiki pages that are ''orphans'' (that is, have no incoming wiki links). See [#Displaying_Orphan_Pages|Displaying Orphan Pages].
Sandbox | Displays the wiki ((Sandbox)) for practicing your wiki skills. See [#Using_the_Sandbox|Using the Sandbox].
Print | Displays a printer-pretty version of a page (or selected pages) for printing. See [#Printing_Wiki_Pages|Printing Wiki Pages].
Structures | Displays the ((Structures)) on the site.
Create a wiki page | Allows you to create a brand new wiki page.
{FANCYTABLE}
/////
The following image is the menu that most users will see if all options are activated.
::{img src="img/wiki_up//WikiUser-menu.png" class="reflect center"}:: 
The options are as follows:
* __Wiki__ the Wiki Home page is viewed. See __A Wiki Page__ below
* __Wiki Home__ the Wiki Home page is viewed. See __A Wiki Page__ below
* __Last Changes__ this allows the user to see which pages have changed. See __Last Changes__ below
* __Dump__ this allows the user to create a compressed file from the page
* __Rankings__ this will show which pages are hot or how much activity they have had. See __Wiki Rankings__ below
* __List Pages__ this provides a complete listing of all pages in the site. See __List Pages__ below
* __Orphan Pages__ pages do get orphaned with time - that is - the links to them are removed. This option provides a way to find them. See __Backlinks & Orphan Pages__ below
* __Sandbox__ this is a safe place to experiment with Wiki Syntax or HTML. See __The Sandbox__ below
* __Print__ this allows multiple pages to be printed. See __Wiki Printing__ below
* __Structures__ (not shown in the image) are visible to anyone with Admin privileges. Structures are a way of applying an order to Wiki pages, like building a directory tree.
{TABS}


!! Creating a Wiki Page
If configured, Wiki pages can be created using Smashed Word syntax. This can be defined as a number of capitalized words joined together without spaces like __MaryHadALittleLamb__. Alternately, a user can specifically tell the system to create a page like this __~040~(This is a New Page)~041~__. In either case, when the page is saved the Wiki will add a question mark to indicate a new page. The question mark is a link to the Wiki page editor for that page. After the new page is saved, the question mark is replaced from the original page and the link will be indicated.

TIP: A Fast Way to Create a New Wiki Page
* Edit __ANY__ Wiki Page
* Somewhere at the top of the page, add the name of the page you want to create in double parentheses. Example: ~040~(My New Page)~041~
* Hit Save
* In the altered page, select the underlined Question Mark. Example: My New Page===?===
You will then be editing the page you wanted to create. This method allows you to see if the page already exists. A link will be displayed if a page with that name exists (instead of the question mark) so you can change the page's name and hit Preview again.

!! Displaying Last Changes
This page displays the last changed (most recently updated) wiki pages. You can select a specific timeframe (Today, Last 2 days, Last 3 days, Last 5 days, Last week, Last 2 weeks, Last month, or  All) to display. You can also use the __Find__ box to search for a specific page.

Use the ((Wiki Page Listings)) tab of the ((Administer Wiki)) page to enable this feature and specify what information appears on the page.
{TABS(name="lastchanges" tabs="7.x|2.x")}
{img fileId=590 thumb=y rel=box[g] width="450" align="center" alt="Last changes" desc="Displaying last (recent) wiki changes"}
/////
{img src="img/wiki_up/WikiUser-LastChanges.png" align="center" class="reflect"}
{TABS}

For each page's change, Tiki displays:
* Time and date of the change
* Page name
* User (and IP address) who made the change
* Description (comment) of the edit
* An __Action__ column with the following links:
+{FANCYTABLE(head="Link | Description" colwidths="15%|85%" colaligns="left" colvaligns="top")}
{img src=img/icons/page_white_stack.png alt="History"} | Display a detailed Page History for the page. See ((History)).
 __v__ | Display the indicated page version.
 __b__ | Rollback (that is, revert) a page to the specified version. Tiki will prompt you for confirmation before rolling the page back. An alternative to rolling back pages is to remove all the versions of the page that you do not want, until the desired version becomes current.
__c__ | Display a side-by-side comparsion (diff) of selected version with the current version.
 __d__ | Display a side-by-side comparsion (diff) of selected version with any other version of the page. Some people prefer the Difference tool while others prefer the Comparison tool, you can use whatever you want or both.
__s__ | Display the wiki source of the selected version. This is nearly identical to what is shown in the Wiki Page Editor when you edit a page.
{FANCYTABLE}
!! Wiki Rankings


!! Listing Pages
This page lists all wiki pages. You can filter the list by Language and Category. You can also use the __Find__ box to search for a specific page and even specify if the page name must exactly match the query. Use the __Number of displayed rows__ field to specify the number of wiki pages to display on each page.

Use the ((Wiki Page Listings)) tab of the ((Administer Wiki)) page to enable this feature and specify what information appears on the page.

{TABS(name="listingpages" tabs="7.x|2.x|1.9.x")}
{img fileId=591 thumb=y rel=box[g] alt="List Pages" desc="Listing wiki pages" align="center" width="450"} 
/////
::{img src="img/wiki_up/wiki_listpages_01.png" class="reflect"}::
Pages can be listed through the option "__Wiki > List pages__" in the main menu, which will lead to the relative url "__tiki-listpages.php__". From there, you will be able to search for page names containing certain words and indicating whether you want to find exact matches or not (Tiki 1.9)
/////
::{img src="img/wiki_up/wiki_listpages_00.png" class="reflect"}::
In Tiki 2.0, this feature has been enhanced and it allows to search pages also by category, set the number of rows that you want in the resulting list.
{TABS}

For each wiki page, Tiki displays:
* Name of the page
* Number or hits (reads)
* Date and time the page was last modified
* Name (and IP address) of the user who last modified the page
* Number of versions of the page ((history)) 
* Number of wiki links and backlinks to the page
* Language of the page
* Category of the page
* An __Action__ column with the following links: 
+{FANCYTABLE(head="Link | Description" colwidths="15%|85%" colaligns="left" colvaligns="top")}
{img src=img/icons/page_edit.png alt="Edit"} | Edit the page
{img src=img/icons/page_copy.png alt="Copy"} | Copy (duplicate) the page
{img src=img/icons/page_white_stack.png alt="History"} | Display a detailed Page History for the page. See ((History)).
{img src=img/icons/key.png alt="Permissions" | Configure object-specific permissions for the page. See ((Permissions)). This option was introduced in Tiki 2.
{img src=img/icons/cross.png alt="Delete"} | Delete the page.
{FANCYTABLE}

Starting in Tiki 2.0, you can modify multiple wiki pages at once by choosing specific pages and selecting an option from the __Perform action with checked__.
::{img src="img/wiki_up/wiki_listpages_02.png" class="reflect"}::


!! Displaying Orphan Pages
This page lists all wiki pages that are ''orphans'' (that is, they have no incoming or ((backlinks))). You can filter the list by Language and Category. You can also use the __Find__ box to search for a specific page and even specify if the page name must exactly match the query. Use the __Number of displayed rows__ field to specify the number of wiki pages to display on each page.

Use the ((Wiki Page Listings)) tab of the ((Administer Wiki)) page to enable this feature and specify what information appears on the page.

{img fileId=592 thumb=y rel=box[g] alt="Orphan Pages" width="450" desc="Sample Orphan Pages." align=center}

For each wiki page, Tiki displays:
* Name of the page
* Number or hits (reads)
* Date and time the page was last modified
* Name (and IP address) of the user who last modified the page
* Number of versions of the page ((history)) 
* Number of wiki links and backlinks to the page
* Language of the page
* Category of the page
* An __Action__ column with the following links: 
+{FANCYTABLE(head="Link | Description" colwidths="15%|85%" colaligns="left" colvaligns="top")}
{img src=img/icons/page_edit.png alt="Edit"} | Edit the page
{img src=img/icons/page_copy.png alt="Copy"} | Copy (duplicate) the page
{img src=img/icons/page_white_stack.png alt="History"} | Display a detailed Page History for the page. See ((History)).
{img src=img/icons/key.png alt="Permissions" | Configure object-specific permissions for the page. See ((Permissions)). This option was introduced in Tiki 2.
{img src=img/icons/cross.png alt="Delete"} | Delete the page.
{FANCYTABLE}

Starting in Tiki 2.0, you can modify multiple wiki pages at once by choosing specific pages and selecting an option from the __Perform action with checked__.
::{img src="img/wiki_up/wiki_listpages_02.png" class="reflect"}::


!Working with Wiki pages
You can perform many tasks from a wiki page. Tiki displays the following buttons a typical wiki page:

{TABS(name="wikimenu" tabs="7.x|2.x")}
{img fileId="588" thumb="y" rel="box[g]" width="450" imalign="center" desc="Sample wiki page with icons, droplists, and buttons (Tiki 7)." alt="Sample wiki page" align="center"}
Depending on your site configuration, different buttons may be available. The primary Wiki menu options are:
__Icons__
The icons at the top of the page can be used to:
* {img src=img/icons/edit.png alt="Edit"} Edit the page in the __((Wiki Page Editor))__.
* {img src=img/icons/print.png  alt="Print"} Display a printer-friendly version of the page (with no menus, sidebars, or banners -- only the central content area).
* {img src=img/icons/mime/pdf.png alt="PDF" } Create an Adobe PDF file from the current page.
* {img src=img/icons/disk.png alt="Save"} Creates a copy of the page and saves it to your __Notepad__ in the ~np~MyTiki~/np~ section. See __((Notepad))__
* {img src=img/icons//icon_watch.png } Allows the page to be monitored. When a change is made to the page, an email is automatically sent to every user who is monitoring the page. See __Page Notification__ below
*{img src=img/icons/wiki_plugin_edit_view.png alt="Edit icons"} Toggles the edit icons

__Droplists__
*structure
* {img src=images//ico_link.gif } Provides a listing of every page that references this page. See __Backlinks & Orphan Pages__ below
*language

__Buttons__
The buttons across the top have the following meaning:
* __Edit this page__ this opens the Wiki Page editor for this page. See the __((Wiki Page Editor))__ page
* __Source__
* __Remove__ this allows a Wiki page to be deleted. __NOTE:__ A deleted page can be recovered by admin.
* __Rename__ this allows the page to be renamed. See __Page Renaming__ below
* __Lock/Unlock__ a page can be locked to prevent it from being edited. If this is done, only the Author (if enabled) or Admin will be able to unlock it.
* __Permissions__ Group Permissions can be assigned to a page. See __Page Permissions__ below
* __History__ this provides a detailed History of the page. See __Page History__ below
* __Similar__ this is a search facility for finding similar pages. See __Similar Pages__ below
* __Slideshow__
* __Undo Button__ this will undo the last edit. See __Undo Edit__ below
* __Export__ this allows the page to be exported to a text file on your system. See __Page Export__ below
* __Comment__ users can add comments to a page. See __Page Comment__ below
*__Attach File__

/////
The following image is for the Wiki Home Page before any content was added to it.
::{img src="img/wiki_up/WikiUser-HomePage.png" class="reflect"}::
Depending on your site configuration, different buttons may be available. The buttons across the top have the following meaning:
* __Edit Button__ this opens the Wiki Page editor for this page. See the __((Wiki Page Editor))__ page
* __Remove Button__ this allows a Wiki page to be deleted. __NOTE:__ A deleted page can be recovered by admin.
* __Rename Button__ this allows the page to be renamed. See __Page Renaming__ below
* __Lock/Unlock Button__ a page can be locked to prevent it from being edited. If this is done, only the Author (if enabled) or Admin will be able to unlock it.
* __Perms Button__ Group Permissions can be assigned to a page. See __Page Permissions__ below
* __History Button__ this provides a detailed History of the page. See __Page History__ below
* __Similar Button__ this is a search facility for finding similar pages. See __Similar Pages__ below
* __Undo Button__ this will undo the last edit. See __Undo Edit__ below
* __Export Button__ this allows the page to be exported to a text file on your system. See __Page Export__ below
* __Comment Button__ users can add comments to a page. See __Page Comment__ below
The Icons at the top have the following meaning:
* {img src="img/icons//edit.gif"} Opens the editor for this page. See the __((Wiki Page Editor))__ page
* {img src=images//ico_link.gif } Provides a listing of every page that references this page. See __Backlinks & Orphan Pages__ below
* {img src=images//ico_print.gif } This will display a printer-friendly version of the page by removing menus, sidebars, banners and anything else except the central column.
* {img src=img/icons//ico_pdf.gif } Will create an Adobe PDF file from the current page.
* {img src=images//ico_save.gif } Creates a copy of the page and saves it to your __Notepad__ in the ~np~MyTiki~/np~ section. See __((Notepad))__
* {img src=img/icons//icon_watch.png } Allows the page to be monitored. When a change is made to the page, an email is automatically sent to every user who is monitoring the page. See __Page Notification__ below
{TABS}



!! Page History
{img src=img/wiki_up//WikiUser-LC-History.png align="center" class="reflect"}
Please see: ((History))
!! Similar Pages
Similar Pages show a listing of pages with names similar to the current page. Pages are created and named using words combined together, so Similar Pages will show pages where one or more of these words are the same as the words in the current pages. As an example MyPage, NFLResultsPage OpinionsPage are similar because they share the word Page

!! Undo Edit
The Undo button can be used to Undo the last edition of a page. If the Undo feature is enabled then a user that can edit pages will be able to Undo what they did even if they can not Rollback pages or Remove page versions.
Pressing the undo button removes the current version of the page making the last version in the history the current page; if no version is in the history then the page is reverted to an empty page.
__Note:__ A users will only be able to Undo their editing and not the editing that any other user has done unless the user has permission to remove page versions.

!!Page Export
The Export button can be used to export the current version of the page. When clicked your browser will prompt you to save the file. The exported page can then be edited and later be imported back into the Wiki. You can also export all the versions of a page. This link is inside the Page Editor.

!!Page Comments
Wiki pages can allow comments to be posted to them. The comments can be threaded, in a similar way as they can be in ((forums)). If the feature is enabled, and the user belongs to a group with the needed permission, a button "__add comment__" will be shown below the page.

::{img src="img/wiki_up/wiki_comments_01.png" class="reflect"}::

!! Page Renaming
The Rename button can be used to ((rename)) a Wiki page; all wiki links referencing the page will be updated as well. An error message will be generated if the new page name is already in use.
__Note:__ A user must have a permission to rename pages.


!! Backlinks & Orphan Pages
Every page has a list of Backlinks. Backlinks are links from any page to the current page (the page you are reading), you can use the Backlinks option to see which pages are linking to a particular page and find Orphan pages (pages with no Backlinks). Orphan pages are unlikely to get visited very often. On many occasions, Orphan pages are old pages that were removed from the Wiki and should have been deleted.

*In order to display orphan pages the feature must be enabled through Admin > Wiki > Page Listings  
*See ((Backlinks)) 
!! The Sandbox
Like a real Sandbox, in Tiki, the Sandbox is a place to play. You can test out ideas here, experiment with Wiki Syntax or HTML safely. The contents of the Sandbox are never saved, so when you have something perfected - copy the contents and paste them into a Wiki page.

!! Page Monitoring
Page monitoring allows a registered user to receive an email when ever there is an edit or new comment applied to a a wiki page. Logged in users can click the monitor button at the top of a wiki page to turn monitoring on or off per a page.

For instance, for this page, a registered user will have the option to monitor it (add a "User Watch" to it), as indicated in the following image: 

{img src="display779" link="display779" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

Later on, the user can click on the equivalent icon (eye with the red cross) again to stop monitoring the page:

{img src="display780" link="display780" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

Since wiki pages can belong Wiki ((Structures)), and Wiki structures can be monitored, you can get an email each time a page has been added below the hierarchical level of the page you are interested in (regarding a common ((structure)) of wiki pages). 

Keep in ind also that if you are interested in pages of the same type of content, you can use add a Watch on a content ((Category)), so that any other pages (or other tiki objects) assigned to or unassigned from that category, will send you an email reporting you that change in the objects of that category.

For an overview on the possibilities of Monitoring wiki pages (user watches, group watches, structures, categories, etc), see ((Watches)).

!! Page Permissions
NOTE: in Tiki 1.9 permissions can be applied to an entire wiki structure.

Users in a group with permissions tiki_p_admin_wiki can set permissions per a page. Click __perms__ and then select the permissions you wish to apply for what user groups to that page. If no individual permissions are applied to a page, global permissions apply.
If tiki_p_creator_admin is set too and if the user is the creator, he can also redifine the perms.

As soon as one permission is applied, all global permissions are overridden and thus you will probably have to apply a few individual permissions so one or more user groups can view and edit the page.
::{img src="img/wiki_up/assignPerm.jpg" class="reflect"}::


-= Useful Links=-
*((tw:Why Wiki Syntax is Important))
* The Color Picker II is located at [http://www.pagetutor.com/pagetutor/makapage/picker/]
* [https://addons.mozilla.org/extensions/moreinfo.php?id=60|Web Developer extension] for [http://www.mozilla-europe.org/fr/products/firefox/|Mozilla Firefox]
---
* The wiki syntax is not standardized across applications. There is an initiative to publish the Wiki-Syntax as an RFC from the [http://www.ietf.org/|IETF]. See [http://tikiwiki.org/RFCWiki|RFCWiki]