Skip to main content link. Accesskey S

XPages Wiki

Submit Search

XPages Wiki Documentation

Home > Documentation > Getting Started

Getting Started
ShowTable of Contents

Creating a new wiki

A new wiki is created using your Lotus Notes client using “File > Application > New” and selecting the XPage Wiki template.

Signing

Because this template is released on Openntf.org it is not signed with the standard Lotus Notes development signer, so you will need to sign the template with an id that is allowed to run agents/code on your servers.

ACL

You will need to add your users/groups to the ACL. You will need to give users at least Editor access, there is currently a restriction on editing using Author access.

There is a role “[admin]”. You will need to assign this to anyone who should administer the wiki. This will grant access to the preferences (More > Preferences from any Notes view).

You can also add the role "[basic]" which will hide the advanced section in the Notes Client navigator if assigned to a person/group in the ACL.

Database Titles

The default title for your wiki is “XPages Wiki”. This can be changed in the preferences within the field “Site Title”.


The secondary title comes from the actual database title:

Server Settings for RSS feeds

The RSS feeds need some settings from the server. Because there is not a performance friendly way of getting some information they are stored within “Preferences > Server”. They are created by default and can be refreshed using the refresh button. So if you have any issues with RSS – this is the place to look.

Full Text Indexing

You will need to switch on full text indexing for searching when you first use the wiki.

Welcome Page

Your wiki has no documents when first created. When you first open the wiki in a browser it will display a new page titled “Welcome” for you to create the default “welcome page”. The title can also be changed to one of your choice.


Once saved this will automatically be set as the welcome page. You can change this page at anytime by going to “More > Preferences” from any Notes view (you will need the admin role as in the ACL section) and selecting a new welcome page:


Locking documents

You may wish to prevent web users editing certain pages, such as the welcome page. You need to do this in the Notes Client by editing the document and setting “Secure”. This is not a security setting for the document (to be developed further in future iterations) it is just a web lock.

The secure setting can be found under “Show Advanced” within the add page form:

Categories

By default pages only have tags for organizing. You can also switch on categories within the preferences. The setting is “Use Categories”.

Switching categories “on” will show the category selection field when you add new pages, and add the “Site Map” to the side bar:

You can also add custom html and images for these categories by creating category documents (advanced > Content Categories).


Images can be added via Advanced > Images and then selected within the “Formatting” tab of the category document.


Revisions

By default when you edit documents within the web browser or with Lotus Notes a copy of the previous document is taken and you can view these previous edits in the revisions section within the browser and within the rollback function in Notes.

Revisions can be switched on/off within preferences:


They can be view within the browser at the bottom of the page, and you can view previous versions by clicking the version number:


You can also view these documents in Lotus Notes using the “Rollback” option under “More > Rollback”.

As the name suggests you can also select a previous version, within the Notes Rollback option, and make that the current version. In future iterations this will also be a web feature.

Wiki Markup

The wiki template supports html, rich text editing from Notes and Web as well as "wiki markup". Look for documents on how to use this markup.

Side Bar Links

You can add links to the most useful documents for your wiki within the preferences (Advanced > Sidebar Page Links).

Simply add pages to the displayed list and reorder using the arrows (you can also remove links):


Setting logout redirect

When a user logs out of the wiki, you can set where they get redirected to (default is the server root). The setting is in preferences under “Advanced > Site Settings > Logout Redirect”.