Apple Computer Hardware manual Manually Editing Raw Content, File or Folder Name Purpose

Page 40

The Groups folder in the wiki data store includes the following critical wiki files and folders:

File or Folder Name

Purpose

group_name/

Enabling web services for a group creates a folder with

 

the group’s short name.

 

 

group_name/index.db

Automatically changed when you edit wiki content. If

 

you manually edit raw content, erase this file so that it

 

will regenerate based on raw content.

 

 

group_name/metadata.plist

Contains wiki administration settings.

 

 

group_name/wiki/

Stores all pages in the wiki.

 

The blog uses a similar file structure. The blog stores all

 

of its pages in group_name/weblog/.

 

 

group_name/wiki/page_uid.page/

Automatically created when you create a new wiki page.

 

The name of the folder is a unique identifier that also

 

appears in the page’s URL:

 

http://domain_name/groups/group_name/wiki/

 

page_uid/page_name

 

 

group_name/wiki/page_uid.page/page.html

Contains the page’s HTML content.

 

 

group_name/wiki/page_uid.page/page.plist

Contains meta-information for a page.

 

 

group_name/wiki/page_uid.page/attachments/

Stores subfolders for every attachment.

 

 

group_name/wiki/page_uid.page/attachments/

Automatically created when a file is attached to a page.

attachment_uid/

Every folder stores one attachment. The name of the

 

folder is a unique identifier that also appears in the

 

attachment’s URL:

 

http://domain_name/groups/groupname/wiki/pageuid/

 

attachments/attachment_uid/attachment_filename

 

 

group_name/wiki/page_uid.page/attachments/

This is an attachment.

attachment_uid/attachment_filename

 

 

 

group_name/wiki/page_uid.page/images/

Stores all images for a page.

 

 

group_name/wiki/page_uid.page/images/image_

This is an image.

filename

 

 

 

Manually Editing Raw Content

When you use the wiki to edit wiki pages, the wiki server automatically indexes your content. If you manually edit raw content, the wiki server doesn’t automatically index. You must delete the index.db file so that the file is regenerated based on the changed raw content; otherwise, an error occurs.

You can avoid this problem by using the Atom Publishing Protocol, also known as AtomPub. You can use an AtomPub-enabled client to log in, publish, update, or delete wiki and blog entries. Configure AtomPub clients to use this service address: http://domain_name/groups/group_name/atompub

40

Chapter 3    Managing Wiki Content

Image 40
Contents Mac OS X Server 019-1252/2008-04-24 Contents Managing Wiki Content Getting Additional Information PrefacePreface About This Guide This chapter describes how to customize a wiki’s appearance Theme File Structure OverviewCustomizing How the Wiki Looks Variant Theme File Structure Overview Wireframe Theme File Structure Overview File or Folder Name PurposeBorders, and positioning for comment entry Terminal, enter the following commands Creating a ThemeEditing CSS Files WebsiteEditing Property List Files About Property List EditorAbout Property List Files About Property List Keys and ValuesAbout Strings About DictionariesAbout Errors Here is the sidebars array in a plain text editorHere 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 Creating Sidebars Understanding the Types of 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 Overview of the Example Sidebars Tag Unique KeysRecent 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 About XSL JavaScript ExampleViewing 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 About the Built-in Whitelist Protocols Allowed in the Built-in WhitelistBuilt-in whitelist allows these protocols ProtocolCSS Styles Allowed in the Built-in Whitelist Html Tags and Attributes 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 Migrating Wiki Content From Other Websites Backing Up the Wiki ServerManaging Wiki Content Wiki File Structure Overview Manually Editing Raw Content File or Folder Name PurposeTo regenerate the index after editing raw wiki content Viewing a Wiki’s Administration SettingsFor more information about AtomPub, see Metadata.plist file includes the following keys Key Example Value DescriptionTo manually edit wiki administration settings Viewing a Page’s Metainformation PageuidManaging Attachments