[[PageOutline(2-5,Contents,pullout)]] = Themes for Trac based on MacOS appearance = == Description == This is a theme that emulates the look of (some versions of) ''Mac OS'' (and '''YES''' it has an apple ''';o)''' . It requires the ThemeEnginePlugin and provides the following features. - Dock navigation ... like in the Mac !!! It's behavior may be customized using config options - Fixed (collapsible) toolbar at the bottom containing mainnav items - Fixed ctxtnav items at the top - Fixed metanav items at the top - Fixed drop down menu containing mainnav items - Controls the size of nav bars by placing extra nav items inside drop-down menus. - Pretty-fication (IOW lovely icons ''':P''') - Mac-like styles (progress bars, ...) - Active request handler highlighted - more ... === Screenshot === Once the theme is installed and selected, it looks like this [[Image(http://bitbucket.org/olemis/trac-macos/raw/tip/tracmacos/htdocs/screenshot.png, title=Mac OS theme screenshot, alt=Mac OS theme screenshot, link=http://simelo.hg.sourceforge.net/hgweb/simelo/trac-macos/)]] === Supported environments === The theme has been tested and works using the following combinations of operating system (distribution) and browser. In each case browser-specific issues are displayed. If you have successfully installed the plugin please , add more browsers and configurations to the list so that other users will be aware of your success history. ==== Opera ==== || '''Version Info''' || '''Operating system''' || || 10.00, Build 4585, System i686, 2.6.24-16-generic, Qt library 3.3.8b, JRE installed || ''Ubuntu 8.04'' || || ''Add version info'' || ''Add OS'' || ===== Known issues ===== [[TicketQuery(component=MacTheme&keywords~=opera, table)]] ==== Firefox ==== || '''Version Info''' || '''Operating system''' || || 3.6.6 || ''Ubuntu 8.04'' || || ''Add version info'' || ''Add OS'' || ===== Known issues ===== [[TicketQuery(component=MacTheme&keywords~=firefox, table)]] ==== Google Chromium Browser ==== || '''Version Info''' || '''Operating system''' || || 4.0.253.0 (Ubuntu build 32511) || ''Ubuntu 8.04'' || || ''Add version info'' || ''Add OS'' || ===== Known issues ===== [[TicketQuery(component=MacTheme&keywords~=chromium, table)]] ==== Safari ==== ''Safari'' should be added to the list soon . || '''Version Info''' || '''Operating system''' || || ''Add version info'' || ''Add OS'' || ===== Known issues ===== [[TicketQuery(component=MacTheme&keywords~=safari, table)]] ==== Galeon ==== || '''Version Info''' || '''Operating system''' || || 2.0.4 || ''Ubuntu 8.04'' || || ''Add version info'' || ''Add OS'' || ===== Known issues ===== [[TicketQuery(component=MacTheme&keywords~=galeon, table)]] ==== Internet Explorer ==== There are no plans to add support for ''Internet Explorer'' but contributions in this direction will always be welcome . Please read the [wiki:olemis#Guidelinestocollaborate patch submission guidelines]. === Configuration options in trac.ini === ==== [docknav] ==== || coefficient || Attenuation coefficient. This controls the relationship between the distance from the cursor and the amount of expansion of any affected image within that distance. A coefficient of 1 makes the expansion linear with respect to distance from cursor; a larger coefficient gives a greater degree of expansion the closer to the cursor the affected image is (within distance). || || default || Catch-all image in dock menu. || || distance || Attenuation distance from cursor, ie the distance (in pixels) from the cursor that an image has to be within in order to have any expansion applied. Note that attenuation is always calculated as if the Dock was 'at rest' (no images expanded), even though there may be expanded images at the time. || || duration || The duration (in milliseconds) of the initial 'on-Dock' expansion, and the 'off-Dock' shrinkage. || || fadeIn || The amount of time (in milliseconds) for the initial fade-in of the Dock after initialisation. By default this is set to 1000, which means that the Dock is displayed in full 1 second after it's initialized. Set this value to 0 (zero) to remove the effect. || || fadeLayer || By default the fade-in effect is applied to the original target menu element. By specifying either 'wrap' or 'dock' here, the fade-in element can be switched to the child or grand-child of the original target menu element. This option only has any effect if fadeIn is set, and is really only useful for cases where, for example, background colours have been styled on the original menu element and you don't want them to be faded in. || || images || Images rendered in dock menu. || || inactivity || The period of time (in milliseconds) after which the Dock will shrink if there has been no movement of the mouse while it is over an expanded Dock. Set to 0 (zero) to disable the inactivity timeout . || || labels || This enables/disables display of a label on the current image. Allowed string values are 2 characters in length: the first character indicates horizontal position (t=top, m=middle, b=bottom) and the second indicates vertical position (l=left, c=center, r=right). Default is 'tl' (i.e. labels shown in top-left corner). Please be aware that enabling this option with one of the middle/center label positions (eg. 'ml', 'bc', etc) may have a slight effect on the performance of the Dock, simply due to the additional processing required to position the label correctly. Hide labels by leaving this option empty. || || step || The timer interval (in milliseconds) between each animation step of the 'on-Dock' expansion, and the 'off-Dock' shrinkage. || ==== [macos] ==== || tbcount || Number of fixed items in toolbar || == Bugs/Feature Requests == Existing bugs and feature requests for MacTheme are [report:9?COMPONENT=MacTheme here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=MacTheme&owner=olemis new ticket]. If you want to submit patches, please read the [wiki:olemis#Guidelinestocollaborate patch submission guidelines]. == Download == Download the zipped source from [http://pypi.python.org/pypi/TracMacOSTheme here]. == Source == You can check out MacTheme from [https://simelo.hg.sourceforge.net/hgroot/simelo/trac-macos Simelo's project repository] or from [http://bitbucket.org/olemis/trac-macos/ its Bitbucket repository] using '''Mercurial'''. Besides you can [http://bitbucket.org/olemis/trac-macos/src browse the source] (not with with Trac, sorry ''':-/''' ) . == Example == To enable: {{{ [components] tracmacos.* = enabled }}} To use: {{{ [theme] theme = MacOS }}} == Recent Changes == [[ChangeLog(mactheme, 3)]] == Author/Contributors == '''Author:''' [wiki:olemis Olemis Lang] [[BR]] '''Maintainer:''' [wiki:olemis Olemis Lang] [[BR]] '''Contributors:''' Yelian === Acknowledgements === The plugin uses images found in [http://sourceforge.net/projects/mac4lin/ Mac4Lin] and [http://stopdreaming.deviantart.com/art/Albook-extended-585-icons-95130402 Albook extended] icon sets, as well as other Creative Commons sources (mostly from [http://stopdreaming.deviantart.com deviantart] ... e.g. the red & gray Finder ''';o)''' , so I thank them all for their dedication while creating all those amazing pictures ... ... and thnx to all those that actively enhance(d) jqDock jQuery plugin . Thnxxxxx very much !!!