Apple Computer Hardware manual Editing CSS Files, Website

Page 13

6Restart the web service by doing one of the following: ÂÂ Restart the server.

ÂÂ In Server Preferences, click Web, move the slider to Off, and then to On.

ÂÂ In Server Admin, open the disclosure triangle for your server, select Web, click Stop Web, and then click Start Web.

ÂÂ Enter the following in Terminal:

$ sudo serveradmin stop teams; sudo serveradmin start teams;

If prompted, enter your administrator account password.

Restarting the server and restarting web service can disrupt users, so send out a notification that the server will be temporarily down before doing this.

Editing CSS Files

Cascading Style Sheet (.css) files control how the wiki looks. By editing these CSS files, you can easily change display attributes for specific page elements. For example, you can change:

ÂÂ Color

ÂÂ Background color ÂÂ Margin

ÂÂ Padding ÂÂ Font size

If you’re skilled at editing CSS files, you can completely overhaul the look of the wiki by changing its layout, removing unwanted visual elements, and adding your own visual elements.

When you edit a CSS file, your changes occur immediately; you don’t have to restart the server or web service after editing. Because you might disrupt users by changing CSS files, you should create, edit, and test them with a theme that isn’t currently in use.

There are many online sources of information about Cascading Style Sheets. These websites should help you get started:

Website	URL
World Wide Web Consortium	w3.org

CSS3	css3.info

QuirksMode	quirksmode.org

Position is Everything	positioniseverything.net

The WebKit OpenSource Project	webkit.org

A List Apart	alistapart.com

CSS Zen Garden	csszengarden.com

Chapter 1    Customizing How the Wiki Looks

13

Image 13

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 Property List Keys and Values About Property List FilesAbout Strings About DictionariesHere is the sidebars array in a plain text editor About ErrorsHere is an example of an array with a single string Here is an example of an array with multiple stringsKey Default Value Possible Values Changing General Theme SettingsDescription Understanding the Types of Sidebars Creating SidebarsShared Keys All sidebars require the following keysEach dictionary entry has the following keys Static Unique KeysKey Example Value Possible Values Optional or Required Search Unique Keys Calendar Unique Keys Tag Unique Keys Overview of the Example SidebarsRecent Activity Unique Keys Sidebar Name DescriptionTerminal, enter the following command Using the Example SidebarsTo comment out specific sidebars To this To add JavaScript files or XSL files to a theme Adding JavaScript and XSL FilesPut JavaScript .js files or XSL .xsl files in this folder Here are some published JavaScript guides About JavaScriptTopic JavaScript Example About XSLViewing Dynamic XML Create a plain text file with the following contentTo view context $ sudo serveradmin stop teams sudo serveradmin start teams Attributes Creating a Custom Whitelist Allowing Specific URL Protocols About the Custom Whitelist’s StructureAllowing Specific CSS Styles To allow specific Html tags and attributes Allowing Specific Html Tags and AttributesTag Attributes Protocols Allowed in the Built-in Whitelist About the Built-in WhitelistBuilt-in whitelist allows these protocols ProtocolHtml Tags and Attributes Allowed in the Built-in Whitelist CSS Styles Allowed in the Built-in WhitelistBuilt-in whitelist allows these CSS styles Built-in whitelist allows these Html tags and attributesNode 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 ContentTo regenerate the index after editing raw wiki content Viewing a Wiki’s Administration SettingsFor more information about AtomPub, see Key Example Value Description Metadata.plist file includes the following keysTo manually edit wiki administration settings Pageuid Viewing a Page’s MetainformationManaging Attachments