Theme Specification

From Docky
Jump to: navigation, search

Docky looks for themes by listing the sub-directories in /usr/share/docky/themes (or /usr/local/share/docky/themes), with each sub-directory representing a theme.

The structure of a theme directory is as follows:

  • docky/themes/<name-of-theme>/background.svg
  • docky/themes/<name-of-theme>/background3d.svg
  • docky/themes/<name-of-theme>/menu.svg
  • docky/themes/<name-of-theme>/tooltip.svg

If any of these files exist, they are used in place of the default theme. If the file does not exist, the theme inherits the default theme.


PLEASE NOTE THAT THE BELOW IMAGES ARE NOT IN THE CORRECT SIZE. THEY ARE HERE SIMPLY TO CLARIFY HOW DOCKY DIVIDES THEM INTERNALLY.

Dock Background (background.svg)

The image must be 1000px wide by 150px tall. The left 50px and right 50px are used for the ends of the dock. The remaining middle portion is repeated or cut off (if necessary) to fit the dock.


Background-grid.png

3D Dock Background (background3d.svg)

This is similar to the 2D background. The image must be 1000px wide by 150px tall. The left 50px and right 50px are used for the ends of the dock. The remaining middle portion is repeated or cut off (if necessary) to fit the dock.

If this file does not exist, the theme will fall back to the theme's 2D background (if that doesn't exist, the default 2D background is used).

Dock Menus (menu.svg)

The image must be 100px wide by 120px tall. There are 3 rows: 24px/52px/44px. Rows 1 and 2 are split into 3 columns: 24px/52px/24px. Row 3 is split into 5 columns: 24px/11px/30px/11px/24px.

Row 2 is expanded vertically (if necessary). Column 2 (in rows 1 and 2) is expanded horizontally (if necessary). Columns 2 and 4 in row 3 are expanded horizontally (if necessary).


Menu-grid.png

Dock Tooltips (tooltip.svg)

The image must be 39px wide by 26px tall. The image is split into 3 sections, each 13px wide. The middle section is repeated (if necessary).


Tooltip-grid.png