wiki:MacTheme

Version 7 (modified by Olemis Lang, 14 years ago) (diff)

TracMac: Say my name, say my name ...

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

Mac OS theme screenshot

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

Ticket Summary Keywords Owner Type Status Priority
No tickets found

Firefox

Version Info Operating system
3.6.6 Ubuntu 8.04
Add version info Add OS
Known issues

Ticket Summary Keywords Owner Type Status Priority
No tickets found

Google Chromium Browser

Version Info Operating system
4.0.253.0 (Ubuntu build 32511) Ubuntu 8.04
Add version info Add OS
Known issues

Ticket Summary Keywords Owner Type Status Priority
#7476 Annoying display of docknav captions at load time using Chromium and Safari chromium version_4.x jqDock safari version_5.x Olemis Lang defect new low

Safari

Safari should be added to the list soon .

Version Info Operating system
Add version info Add OS
Known issues

Ticket Summary Keywords Owner Type Status Priority
#7476 Annoying display of docknav captions at load time using Chromium and Safari chromium version_4.x jqDock safari version_5.x Olemis Lang defect new low

Galeon

Version Info Operating system
2.0.4 Ubuntu 8.04
Add version info Add OS
Known issues

Ticket Summary Keywords Owner Type Status Priority
#7475 Wrong display of mainbar menus using Galeon, SeaMonkey and Kazekahase galeon version_2.x ctxtnav kazekahase version_0.5.x seamonkey version_1.x Olemis Lang defect new high

Internet Explorer

There are no plans to add support for Internet Explorer but contributions in this direction will always be welcome . Please read the 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 here.

If you have any issues, create a new ticket. If you want to submit patches, please read the patch submission guidelines.

Download

Download the zipped source from here.

Source

You can check out MacTheme from Simelo's project repository or from its Bitbucket repository using Mercurial. Besides you can browse the source (not with with Trac, sorry :-/ ) .

Example

To enable:

[components]
tracmacos.* = enabled

To use:

[theme]
theme = MacOS

Recent Changes

17940 by rjollos on 2020-12-23 22:58:53
Code drop from PyPI
(more)

Author/Contributors

Author: Olemis Lang
Maintainer: Olemis Lang
Contributors: Yelian

Acknowledgements

The plugin uses images found in Mac4Lin and Albook extended icon sets, as well as other Creative Commons sources (mostly from 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 !!!

Attachments (1)

Download all attachments as: .zip