Apple Computer Hardware manual Using the Example Sidebars, To comment out specific sidebars

Page 23

Using the Example Sidebars

The wireframe theme’s theme.plist file includes several sidebar examples. All of these examples are commented out by default. You’ll need to remove the comments marks if you want to use the example sidebars as custom sidebars. If you don’t add any custom sidebars, the default sidebars are used. If you use at least one custom sidebar, the default sidebars don’t appear.

Consider commenting out all sidebars you don’t want to use, and leaving uncommented all sidebars you want to use. Doing this allows you to choose which sidebars you want and allows you to easily change sidebar settings later on. To do this, you must start a comment before the <dict> tag for a sidebar, and end the comment after the </dict> tag for that sidebar.

To comment out specific sidebars:

1In Terminal, enter the following command:

$ cd /Library/Application\ Support/Apple/WikiServer/Themes/

2If you want to use a non–command-line tool, copy the theme.plist file to your

Documents folder.

To copy this file, enter:

$ cp theme_name.wikitheme/theme.plist /Users/user_name/Documents/

Replace theme_name with the name of the theme. Replace user_name with the short name of the user you’re logged in as.

3Open theme.plist in a text editor.

To open this file in a command-line text editor, enter:

$ sudo nano theme_name.wikitheme/theme.plist

If prompted, enter your administrator account password.

You can use any command-line text editor, as long as you precede the command to run the text editor with sudo.

If you’re using a non–command-line tool, open the theme.plist located in your Documents folder.

4If there is a  comment marker before <key>version</key>.

Chapter 1    Customizing How the Wiki Looks

23

Image 23

Contents Mac OS X Server 019-1252/2008-04-24 Contents Managing Wiki Content Preface Getting Additional InformationPreface About This Guide Theme File Structure Overview This chapter describes how to customize a wiki’s appearanceCustomizing How the Wiki Looks Variant Theme File Structure Overview File or Folder Name Purpose Wireframe Theme File Structure OverviewBorders, and positioning for comment entry Creating a Theme Terminal, enter the following commandsWebsite Editing CSS FilesAbout Property List Editor Editing Property List FilesAbout Dictionaries About Property List FilesAbout Property List Keys and Values About StringsHere is an example of an array with multiple strings About ErrorsHere is the sidebars array in a plain text editor Here is an example of an array with a single stringDescription Changing General Theme SettingsKey Default Value Possible Values All sidebars require the following keys Creating SidebarsUnderstanding the Types of Sidebars Shared KeysKey Example Value Possible Values Optional or Required Static Unique KeysEach dictionary entry has the following keys Search Unique Keys Calendar Unique Keys Sidebar Name Description Overview of the Example SidebarsTag Unique Keys Recent Activity Unique KeysTo comment out specific sidebars Using the Example SidebarsTerminal, enter the following command To this Put JavaScript .js files or XSL .xsl files in this folder Adding JavaScript and XSL FilesTo add JavaScript files or XSL files to a theme Topic About JavaScriptHere are some published JavaScript guides JavaScript Example About XSLTo view context Create a plain text file with the following contentViewing Dynamic XML $ sudo serveradmin stop teams sudo serveradmin start teams Attributes Creating a Custom Whitelist Allowing Specific CSS Styles About the Custom Whitelist’s StructureAllowing Specific URL Protocols Tag Attributes Allowing Specific Html Tags and AttributesTo allow specific Html tags and attributes Protocol About the Built-in WhitelistProtocols Allowed in the Built-in Whitelist Built-in whitelist allows these protocolsBuilt-in whitelist allows these Html tags and attributes CSS Styles Allowed in the Built-in WhitelistHtml Tags and Attributes Allowed in the Built-in Whitelist Built-in whitelist allows these CSS stylesNode Pre Cite Span Strong Tbody Tfoot Colspan, rowspan Thead Backing Up the Wiki Server Migrating Wiki Content From Other WebsitesManaging Wiki Content Wiki File Structure Overview File or Folder Name Purpose Manually Editing Raw ContentFor more information about AtomPub, see Viewing a Wiki’s Administration SettingsTo regenerate the index after editing raw wiki content Key Example Value Description Metadata.plist file includes the following keysTo manually edit wiki administration settings Pageuid Viewing a Page’s MetainformationManaging Attachments