137 lines
4.9 KiB
Plaintext
137 lines
4.9 KiB
Plaintext
|
Quick THEME howto for SLiM
|
||
|
|
||
|
Some basic information regarding the slim theme format.
|
||
|
Read this file if you plan to make some theme for
|
||
|
the program, and of course have a look at the included themes
|
||
|
|
||
|
GENERAL CONCEPT
|
||
|
A SLiM theme essentially consists of:
|
||
|
- a background image (background.png or background.jpg)
|
||
|
- a panel image (panel.png or panel.jpg)
|
||
|
- input box(es) and messages and their placement
|
||
|
and properties (slim.theme)
|
||
|
|
||
|
The panel and background images can be a PNG or JPEG file.
|
||
|
The panel is blended into the background image,
|
||
|
taking care of alpha transparency.
|
||
|
|
||
|
SUPPORTED FORMATS
|
||
|
- fonts: use the xft font specs, ie: Verdana:size=16:bold
|
||
|
- colors: use html hex format, ie #0066CC
|
||
|
- positions: can be either absolute in pixels, ie 350
|
||
|
or relative to the container, ie 50% is in the middle
|
||
|
of the screen.
|
||
|
|
||
|
OPTIONS
|
||
|
The following is an example slim.theme file
|
||
|
----------------------------------------------------------------------
|
||
|
# Color, font, position for the messages (ie: shutting down)
|
||
|
msg_color #FFFFFF
|
||
|
msg_font Verdana:size=16:bold
|
||
|
msg_x 50%
|
||
|
msg_y 30
|
||
|
|
||
|
# Color, font, position for the session list
|
||
|
session_color #FFFFFF
|
||
|
session_font Verdana:size=16:bold
|
||
|
session_x 50%
|
||
|
session_y 90%
|
||
|
|
||
|
# style of background ('stretch', 'tile', 'center') and color
|
||
|
background_style stretch
|
||
|
background_color #FF0033
|
||
|
|
||
|
# Horizonatal and vertical position for the panel.
|
||
|
input_panel_x 50%
|
||
|
input_panel_y 40%
|
||
|
|
||
|
# Input controls horizontal and vertical positions relative to
|
||
|
# the panel.
|
||
|
# Set input_pass_x and input_pass_y to -1 to use a single input
|
||
|
# box for username/password (GDM Style).
|
||
|
# Note that these fields only accept absolute values.
|
||
|
input_name_x 40
|
||
|
input_name_y 100
|
||
|
input_pass_x 40
|
||
|
input_pass_y 120
|
||
|
|
||
|
# Input controls font and color
|
||
|
input_font Verdana:size=12
|
||
|
input_color #000000
|
||
|
|
||
|
# Welcome message position. (relative to the panel)
|
||
|
# use -1 for both values or comment the options to disable
|
||
|
# the welcome message
|
||
|
welcome_x 50%
|
||
|
welcome_y 38
|
||
|
|
||
|
# Font and color for the welcome message
|
||
|
welcome_font Verdana:size=16:bold:slant=italic
|
||
|
welcome_color #d7dde8
|
||
|
|
||
|
# 'Enter username' font and foreground/background color
|
||
|
username_font Verdana:size=12
|
||
|
username_color #d7dde8
|
||
|
|
||
|
# 'Enter username' and 'Enter password' position (relative to the panel)
|
||
|
# use -1 for both values to disable the message
|
||
|
# note that in case of single inputbox the password values are ignored.
|
||
|
username_x 50%
|
||
|
username_y 146
|
||
|
password_x 50%
|
||
|
password_y 146
|
||
|
|
||
|
# The message to be displayed. Leave blank if no message
|
||
|
# is needed (ie, when already present in the panel image)
|
||
|
username_msg Please enter your username
|
||
|
password_msg Please enter your password
|
||
|
|
||
|
# Optional message to show on a failed login. Similar set of values
|
||
|
# to the above. Use -1 for the x & y to disable (default).
|
||
|
password_feedback_x 50%
|
||
|
password_feedback_y 165
|
||
|
password_feedback_msg Authentication failed
|
||
|
# The font and color are inherited from msg_xxx
|
||
|
----------------------------------------------------------------------
|
||
|
|
||
|
SHADOWS
|
||
|
|
||
|
The 'msg', 'input', 'welcome', 'session' and 'username' sections
|
||
|
support shadows; three values can be configured:
|
||
|
- color: the shadow color
|
||
|
- x offset: the offset in x direction, relative to the normal text
|
||
|
- y offset: the offset in y direction, relative to the normal text
|
||
|
|
||
|
So to add a text shadow to the welcome message, add the following
|
||
|
to slim.conf:
|
||
|
----------------------------------------------------------------------
|
||
|
welcome_shadow_xoffset -2
|
||
|
welcome_shadow_yoffset 2
|
||
|
welcome_shadow_color #ff0000
|
||
|
----------------------------------------------------------------------
|
||
|
|
||
|
The other keys are analogous:
|
||
|
----------------------------------------------------------------------
|
||
|
# for username and password label
|
||
|
username_shadow_xoffset 2
|
||
|
username_shadow_yoffset -2
|
||
|
username_shadow_color #ff0000
|
||
|
|
||
|
# for the input fields
|
||
|
input_shadow_xoffset 1
|
||
|
input_shadow_yoffset 1
|
||
|
input_shadow_color #0000ff
|
||
|
|
||
|
# for the messages:
|
||
|
msg_shadow_xoffset 1
|
||
|
msg_shadow_yoffset 1
|
||
|
msg_shadow_color #ff00ff
|
||
|
|
||
|
# For the session:
|
||
|
session_shadow_xoffset 1
|
||
|
session_shadow_yoffset 1
|
||
|
session_shadow_color #ff00ff
|
||
|
----------------------------------------------------------------------
|
||
|
|
||
|
|