Changes between Version 2 and Version 3 of Development/Styles

Feb 26, 2006 10:56:56 AM (14 years ago)



  • Development/Styles

    v2 v3  
    22''This is part of the [wiki:Development Development Documentation Project], please help document Colloquy if you know anything that would be relevant here for other users to know about.'' 
    4 = Creating Colloquy Styles = 
     4= Creating new Colloquy Styles = 
    66A new major feature of Colloquy 2 are the extensible conversation styles. Styles are simple OS X bundles wraped around a [wiki:Development/Styles/CSS CSS file] file (at minimum) or a CSS file and a [wiki:Development/Styles/XSL XSL file]. Knowing this, the fact that Colloquy uses XML to store chat messages that come in over the network is no surprise to some. Pairing these three technologies gives us great flexibility when processing and displaying a message on screen. 
    88The process of formatting a message follows these steps, start to finish. Frist, wrap the message in a simple XML envelope, encoding any special characters and representing IRC styling as XHTML. This XML envelope gets transformed with the curent style's XSL file (or a built-in default XSL file). The resulting transformation from the XSL on the XML should be XHTML that can then be rendered with help from the style's CSS file. Rendering is done via Apple's Safari (!WebKit) engine—so the possibilities are endless (evidenced by the built-in iChat like Bubbles style). 
    10 The anatomy of a complex style is as follows, with optional elements italicized. 
     10The anatomy of a complex style is as follows, with optional elements italicized: 
    12 [[Image(stylebundle.png)]] 
     12[[Image(stylebundle.png, nolink)]] 
    1414The Variants folder inside the Resources is a great way to provide subtile variations upon the main CSS that gives the end user more choice. These variants show up as a sub-menu of the style, named exactly as they are in the variants folder (or keyed upon that name to a translation in the users localization Variants.strings). Any images you wish to use should also be bundles in the Resources folder and referenced relatively through the HTML or CSS. 
    1616For examples of various styles, look inside Colloquy's application bundle in the "Contents/Resources/Styles" folder. You will find the Standard and Bland styles use the built-in "default.xsl" file, while the Bubbles and Novel style use custom XSL files. Colloquy also uses the standard [ Info.plist keys] defined by Apple, namely CFBundleName and CFBundleIdentifier. 
     20Install Style Bundles in the following location: `~/Library/Application Support/Colloquy/Styles/` 
     22If you created a new style that you want to make public, please [ mail it to us] so we can add it to the [ Official Style repository].