in the wiki context menu and go to the
'Appearance' tab of the action form. If you want to change the start page, layout page, print template, search results page or style definition of a wiki, you have several options.
•Selection of a system-supplied start page or other system-supplied resource document.
•Creation and activation of own start pages or other resource documents.
•Editing active home pages or other resource documents.
•Disabling the home page or other resource documents.
You select other system default start pages or resource documents as active for your wiki as follows.
•Select in the wiki context menu and go to the
'Appearance' tab of the action form.
•Select the aspect of the appearance you want to change, e.g. layout page, and select a new system standard under 'New layout page'. Continue in this way for other resource documents and add the selected resource documents to your wiki with [OK]. These new pages are thereby set as active start page, layout page, etc. and determine the appearance of the wiki.
•The previously active start page, layout page, etc. are deactivated by this action, but not replaced, so that they can be reactivated later if necessary.
A new system default home page, layout page, or style definition can also be
•To do this, use the context menu to open the wiki as a folder
•with 
, 
or in the context menu of the wiki and thus
activate it.
You can create the appearance-defining documents yourself: upload them to your wiki, copy and edit existing pages and style definitions, or move such resource documents from other wikis to your current one. The resource documents such as layout pages, print templates, search results pages and style definitions should be placed in the Resources folder. You activate such self-generated pages and style sheets as follows.
•Select 
in the wiki context menu and go to the
'Appearance' tab of the action form.
•Select an aspect of the appearance, e.g. layout page, and select a page you have created as a new layout page in the drop-down menu under 'Select layout page'. The respective active page or style definition is preselected in the menu. Continue in this way for other aspects and activate the selected pages and style sheets with [OK].
Before creating start pages and other resource documents,
you should have a look at the predefined pages and familiarize yourself with the
BSCW elements used there (see 8.7.4 Use BSCW elements).For example, layout pages and
print templates must contain the special element [element content]
exactly once. This element determines where the other pages of the Wiki,
the content pages, are embedded in the layout page, or where the content of the
page to be printed is embedded in the print template. Furthermore, all BSCW
elements may also be used in layout pages and print templates. However, these
elements are not evaluated with respect to the layout page or print template,
but with respect to the embedded page. For example, if you have used a BSCW
element in the layout page that displays the page size, the size of the embedded
page is displayed, not the size of the layout page itself. Search results pages
must contain the special element [element searchresults ...]
exactly once.
Designing your own style definitions requires knowledge of how stylesheets work. In any case, take a look at the predefined style definitions that come with a newly created wiki.
You may also edit active start pages and other active resource documents in the Resources folder directly on the spot. Here, too, you should have a look at the system predefined pages and familiarize yourself with the BSCW elements used there.
•Select
in the context menu of the relevant document, edit the document and confirm with
[OK].
•Home pages, layout pages, and style definitions can also be edited using
the , , or actions in the wiki context menu.
If you have automatic versioning turned on for the wiki, these actions will create new versions of the corresponding documents and you can revert to an old look by deleting the newer versions of home page and other resource documents.
For details on editing HTML pages in wikis, see the previous section.
You can use the action to disable the Home page and other
resource documents.
•In the 'Appearance' tab, select 'No start page' in the drop-down menu under 'Select start page', select 'No layout page' under 'Select layout page', etc. and confirm with [OK].
Disabling the start page (for whatever reason) makes the wiki appear as a normal folder.
After upgrading your BSCW server to a new version, it may happen that your style definitions no longer fit to the new version of wikis. In this case you will receive an error message that cannot be overlooked and you have to adjust your style definitions. Style definitions of wikis are not automatically converted during a server upgrade because they exist as documents that may have been modified by you or other users.
If you are working with default style definitions, you only need to recreate and thus activate one of the system default style definitions, as described above. If you are working with style definitions that you have revised, you have two options.
o You can incorporate your changes (such as a different color scheme) back into a new system-side style definition.
o You can revise your own style
definition and adapt it to the new wiki version. To do this, you must enter the
current version number at least in the first line of the style definition
document, e.g. /*bscw-style-v2*/. Compare your style definition
with the current standard version of the style definition from which your style
definition originated and make the necessary changes.
The procedure for editing active style definitions is also described above.
If you work with style definitions that do not correspond to the current version of the wiki, a variety of errors may occur: Context menus are displayed incorrectly, navigation in tree-like wikis does not work properly anymore or newer BSCW elements do not work at all. So you should not ignore the related error message.