Commit 9cbcca04 by o9000

Updated doc

parent a5528a4b
......@@ -244,7 +244,8 @@ install( FILES tint2.desktop DESTINATION ${DATADIR}/applications )
install( CODE "execute_process(COMMAND gtk-update-icon-cache -f -t ${DATADIR}/icons/hicolor WORKING_DIRECTORY ${CMAKE_INSTALL_PREFIX})" )
install( FILES themes/tint2rc DESTINATION ${SYSCONFDIR}/xdg/tint2 )
install( FILES default_icon.png DESTINATION ${DATADIR}/tint2 )
install( FILES AUTHORS ChangeLog README.md doc/tint2.md DESTINATION ${DOCDIR} )
install( FILES AUTHORS ChangeLog README.md doc/tint2.md doc/manual.html doc/readme.html DESTINATION ${DOCDIR} )
install( DIRECTORY doc/images DESTINATION ${DOCDIR} )
install( FILES doc/tint2.1 DESTINATION ${MANDIR}/man1 )
if( ENABLE_EXTRA_THEMES )
add_subdirectory(themes)
......
To build and install tint2 you need CMake.
These steps should be enough for building tint2:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr ../
make
sudo make install
To see additional options you can set at the 'cmake' step, run 'cmake -L ../'
......@@ -4,6 +4,7 @@ Changes: https://gitlab.com/o9000/tint2/blob/0.12.11/ChangeLog
Documentation: [doc/tint2.md](doc/tint2.md)
Compile it with (see also [dependencies](https://gitlab.com/o9000/tint2/wikis/Install#dependencies)):
```
git clone https://gitlab.com/o9000/tint2.git
cd tint2
......@@ -15,6 +16,7 @@ make -j4
```
To install, run (as root):
```
make install
```
......
</body>
</html>
#!/bin/bash
# You can install md2man with gem install md2man. You need gem and ruby-dev.
md2man-roff tint2.md > tint2.1
cat header.html > manual.html
cat tint2.md | sed 's/^# TINT2 .*$/# TINT2/g' | md2man-html >> manual.html
cat footer.html >> manual.html
cat header.html > readme.html
cat ../README.md | sed 's|doc/tint2.md|manual.html|g' | md2man-html >> readme.html
cat footer.html >> readme.html
<!DOCTYPE html>
<html>
<head>
<head>
<style type="text/css">
html,
body {
color: #333;
font-family: Helvetica, Arial, sans-serif;
font-size: 14px;
line-height: 1.6;
word-wrap: break-word;
max-width: 1000px;
margin: 0 auto;
}
h1,
h2,
h3,
h4,
h5,
h6 {
margin-top: 1em;
margin-bottom: 1rem;
}
h1 {
font-size: 1.8rem;
font-weight: normal;
font-style: normal;
border-bottom: 1px solid #eee;
}
h2 {
font-size: 1.5rem;
font-weight: normal;
font-style: normal;
border-bottom: 1px solid #eee;
}
h3 {
font-size: 1.2rem;
font-weight: bold;
font-style: normal;
}
h4 {
font-size: 1rem;
font-weight: bold;
font-style: normal;
}
h5 {
font-size: 1rem;
font-weight: bold;
font-style: italic;
}
h6 {
font-size: 1rem;
font-weight: normal;
font-style: italic;
}
code,
kbd,
pre {
font-family: monospace;
font-size: 1em;
}
table {
border-spacing: 0;
border-collapse: collapse;
}
td,
th {
padding: 0;
}
asdff {
box-sizing: border-box;
}
a {
color: #46c;
text-decoration: none;
}
a:hover,
a:active {
text-decoration: underline;
}
a:not([href]) {
color: inherit;
text-decoration: none;
}
hr {
box-sizing: content-box;
height: 0;
margin: 15px 0;
overflow: hidden;
background: transparent;
border: 0;
border-bottom: 1px solid #ddd;
}
hr::before {
display: table;
content: "";
}
hr::after {
display: table;
clear: both;
content: "";
}
p {
margin-top: 0;
margin-bottom: 0.7em;
}
blockquote {
margin: 0;
}
code {
font-family: "Liberation Mono", monospace;
font-size: 1em;
}
pre {
margin-top: 0;
margin-bottom: 0;
font: 1em "Liberation Mono", monospace;
overflow-x: auto;
}
blockquote {
padding: 0 15px;
color: #777;
border-left: 4px solid #ddd;
}
blockquote>:first-child {
margin-top: 0;
}
blockquote>:last-child {
margin-bottom: 0;
}
table {
display: block;
width: 100%;
overflow: auto;
word-break: normal;
}
table th {
font-weight: bold;
}
table th,
table td {
padding: 6px 13px;
border: 1px solid #ddd;
}
table tr {
background-color: #fff;
border-top: 1px solid #ccc;
}
table tr:nth-child(2n) {
background-color: #f8f8f8;
}
code {
padding: 0.2em;
margin: 0;
font-size: 0.95em;
background-color: #eee;
}
pre {
word-wrap: normal;
background-color: #eee;
margin: 1em 0;
padding: 0.2em;
}
</style>
</head>
<body>
This diff is collapsed. Click to expand it.
<!DOCTYPE html>
<html>
<head>
<head>
<style type="text/css">
html,
body {
color: #333;
font-family: Helvetica, Arial, sans-serif;
font-size: 14px;
line-height: 1.6;
word-wrap: break-word;
max-width: 1000px;
margin: 0 auto;
}
h1,
h2,
h3,
h4,
h5,
h6 {
margin-top: 1em;
margin-bottom: 1rem;
}
h1 {
font-size: 1.8rem;
font-weight: normal;
font-style: normal;
border-bottom: 1px solid #eee;
}
h2 {
font-size: 1.5rem;
font-weight: normal;
font-style: normal;
border-bottom: 1px solid #eee;
}
h3 {
font-size: 1.2rem;
font-weight: bold;
font-style: normal;
}
h4 {
font-size: 1rem;
font-weight: bold;
font-style: normal;
}
h5 {
font-size: 1rem;
font-weight: bold;
font-style: italic;
}
h6 {
font-size: 1rem;
font-weight: normal;
font-style: italic;
}
code,
kbd,
pre {
font-family: monospace;
font-size: 1em;
}
table {
border-spacing: 0;
border-collapse: collapse;
}
td,
th {
padding: 0;
}
asdff {
box-sizing: border-box;
}
a {
color: #46c;
text-decoration: none;
}
a:hover,
a:active {
text-decoration: underline;
}
a:not([href]) {
color: inherit;
text-decoration: none;
}
hr {
box-sizing: content-box;
height: 0;
margin: 15px 0;
overflow: hidden;
background: transparent;
border: 0;
border-bottom: 1px solid #ddd;
}
hr::before {
display: table;
content: "";
}
hr::after {
display: table;
clear: both;
content: "";
}
p {
margin-top: 0;
margin-bottom: 0.7em;
}
blockquote {
margin: 0;
}
code {
font-family: "Liberation Mono", monospace;
font-size: 1em;
}
pre {
margin-top: 0;
margin-bottom: 0;
font: 1em "Liberation Mono", monospace;
overflow-x: auto;
}
blockquote {
padding: 0 15px;
color: #777;
border-left: 4px solid #ddd;
}
blockquote>:first-child {
margin-top: 0;
}
blockquote>:last-child {
margin-bottom: 0;
}
table {
display: block;
width: 100%;
overflow: auto;
word-break: normal;
}
table th {
font-weight: bold;
}
table th,
table td {
padding: 6px 13px;
border: 1px solid #ddd;
}
table tr {
background-color: #fff;
border-top: 1px solid #ccc;
}
table tr:nth-child(2n) {
background-color: #f8f8f8;
}
code {
padding: 0.2em;
margin: 0;
font-size: 0.95em;
background-color: #eee;
}
pre {
word-wrap: normal;
background-color: #eee;
margin: 1em 0;
padding: 0.2em;
}
</style>
</head>
<body>
<h1 id="latest-stable-release-0-12-11"><span class="md2man-title">Latest</span> <span class="md2man-section">stable</span> <span class="md2man-date">release:</span> <span class="md2man-source">0.12.11</span><a name="latest-stable-release-0-12-11" href="#latest-stable-release-0-12-11" class="md2man-permalink" title="permalink"></a></h1><p>Changes: <a href="https://gitlab.com/o9000/tint2/blob/0.12.11/ChangeLog">https://gitlab.com/o9000/tint2/blob/0.12.11/ChangeLog</a></p><p>Documentation: <a href="manual.html">manual.html</a></p><p>Compile it with (see also <a href="https://gitlab.com/o9000/tint2/wikis/Install#dependencies">dependencies</a>):</p><pre class="highlight plaintext"><code>git clone https://gitlab.com/o9000/tint2.git
cd tint2
git checkout 0.12.11
mkdir build
cd build
cmake ..
make -j4
</code></pre>
<p>To install, run (as root):</p><pre class="highlight plaintext"><code>make install
</code></pre>
<p>And then you can run the panel <code>tint2</code> and the configuration program <code>tint2conf</code>.</p><p>Please report any problems to <a href="https://gitlab.com/o9000/tint2/issues">https://gitlab.com/o9000/tint2/issues</a>. Your feedback is much appreciated.</p><p>P.S. GitLab is now the official location of the tint2 project, migrated from Google Code, which is shutting down. In case you are wondering why not GitHub, BitBucket etc., we chose GitLab because it is open source, it is mature and works well, looks cool and has a very nice team.</p><h1 id="what-is-tint2">What is tint2?<a name="what-is-tint2" href="#what-is-tint2" class="md2man-permalink" title="permalink"></a></h1><p>tint2 is a simple panel/taskbar made for modern X window managers. It was specifically made for Openbox but it should also work with other window managers (GNOME, KDE, XFCE etc.). It is based on ttm <a href="https://code.google.com/p/ttm/">https://code.google.com/p/ttm/</a>.</p><h1 id="features">Features<a name="features" href="#features" class="md2man-permalink" title="permalink"></a></h1>
<ul>
<li>Panel with taskbar, system tray, clock and launcher icons;</li>
<li>Easy to customize: color/transparency on fonts, icons, borders and backgrounds;</li>
<li>Pager like capability: move tasks between workspaces (virtual desktops), switch between workspaces;</li>
<li>Multi-monitor capability: create one panel per monitor, showing only the tasks from the current monitor;</li>
<li>Customizable mouse events.</li>
</ul>
<h1 id="goals">Goals<a name="goals" href="#goals" class="md2man-permalink" title="permalink"></a></h1>
<ul>
<li>Be unintrusive and light (in terms of memory, CPU and aesthetic);</li>
<li>Follow the freedesktop.org specifications;</li>
<li>Make certain workflows, such as multi-desktop and multi-monitor, easy to use.</li>
</ul>
<h1 id="i-want-it">I want it!<a name="i-want-it" href="#i-want-it" class="md2man-permalink" title="permalink"></a></h1>
<ul>
<li><a href="https://gitlab.com/o9000/tint2/wikis/Install">Install tint2</a></li>
</ul>
<h1 id="how-do-i">How do I ...<a name="how-do-i" href="#how-do-i" class="md2man-permalink" title="permalink"></a></h1>
<ul>
<li><a href="https://gitlab.com/o9000/tint2/wikis/Install">Install</a></li>
<li><a href="https://gitlab.com/o9000/tint2/blob/master/manual.html">Configure</a></li>
<li><a href="https://gitlab.com/o9000/tint2/wikis/ThirdPartyApplets">Add applet not supported by tint2</a></li>
<li><a href="https://gitlab.com/o9000/tint2/wikis/FAQ">Other frequently asked questions</a></li>
<li><a href="https://gitlab.com/o9000/tint2/wikis/Debug">Obtain a stack trace when tint2 crashes</a></li>
</ul>
<h1 id="how-can-i-help-out">How can I help out?<a name="how-can-i-help-out" href="#how-can-i-help-out" class="md2man-permalink" title="permalink"></a></h1>
<ul>
<li>Report bugs and ask questions on the <a href="https://gitlab.com/o9000/tint2/issues">issue tracker</a>;</li>
<li>Contribute to the development by helping us fix bugs and suggesting new features.</li>
</ul>
<h1 id="links">Links<a name="links" href="#links" class="md2man-permalink" title="permalink"></a></h1>
<ul>
<li>Home page: <a href="https://gitlab.com/o9000/tint2">https://gitlab.com/o9000/tint2</a></li>
<li>Git repository: <a href="https://gitlab.com/o9000/tint2.git">https://gitlab.com/o9000/tint2.git</a></li>
<li>Documentation: <a href="https://gitlab.com/o9000/tint2/wikis/home">https://gitlab.com/o9000/tint2/wikis/home</a></li>
<li>Downloads: <a href="https://gitlab.com/o9000/tint2-archive/tree/master">https://gitlab.com/o9000/tint2-archive/tree/master</a> or <a href="https://code.google.com/p/tint2/downloads/list">https://code.google.com/p/tint2/downloads/list</a></li>
<li>Old project location (inactive): <a href="https://code.google.com/p/tint2">https://code.google.com/p/tint2</a></li>
</ul>
<h1 id="screenshots">Screenshots<a name="screenshots" href="#screenshots" class="md2man-permalink" title="permalink"></a></h1><h2 id="default-config">Default config:<a name="default-config" href="#default-config" class="md2man-permalink" title="permalink"></a></h2><p><img src="https://gitlab.com/o9000/tint2/uploads/948fa74eca60864352a033580350b4c3/Screenshot_2016-01-23_14-42-57.png" alt="Screenshot_2016-01-23_14-42-57"></p><h2 id="various-configs">Various configs:<a name="various-configs" href="#various-configs" class="md2man-permalink" title="permalink"></a></h2><p><img src="https://gitlab.com/o9000/tint2/wikis/screenshot.png" alt="screenshot"></p>
</body>
</html>
......@@ -65,7 +65,7 @@ Battery \[la]#battery\[ra]
.IP \(bu 2
Executor \[la]#executor\[ra]
.IP \(bu 2
Example \[la]#an-example-tint2rc\[ra]
Example configuration \[la]#example-configuration\[ra]
.RE
.SS Introduction
.PP
......@@ -89,7 +89,7 @@ The tint2 config file starts with the options defining background elements with
.IP \(bu 2
\fB\fCborder_width = integer\fR : the border width in pixels
.IP \(bu 2
\fB\fCborder_sides = LRTB\fR : the sides to draw the border on (left, right, top, bottom). If not specified, all sides are used.
\fB\fCborder_sides = LRTB\fR : the sides to draw the border on (left, right, top, bottom). If not specified, all sides are used. \fI(since 0.12.12)\fP
.IP \(bu 2
\fB\fCbackground_color = color opacity\fR
.RS
......@@ -107,7 +107,7 @@ The tint2 config file starts with the options defining background elements with
\fB\fCopacity\fR varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque
.RE
.IP \(bu 2
\fB\fCbackground_color_hover = color opacity\fR (default: same as background_color) \fI(since 0.12.3)\fP
\fB\fCbackground_color_hover = color opacity\fR (default: same as \fB\fCbackground_color\fR) \fI(since 0.12.3)\fP
.RS
.IP \(bu 2
\fB\fCcolor\fR is specified in hex RGB, e.g. #ff0000 is red
......@@ -115,7 +115,7 @@ The tint2 config file starts with the options defining background elements with
\fB\fCopacity\fR varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque. Note that for a transparent panel you need to enable a desktop compositor (such as compton or compiz)
.RE
.IP \(bu 2
\fB\fCborder_color_hover = color opacity\fR (default: same as border_color) \fI(since 0.12.3)\fP
\fB\fCborder_color_hover = color opacity\fR (default: same as \fB\fCborder_color\fR) \fI(since 0.12.3)\fP
.RS
.IP \(bu 2
\fB\fCcolor\fR is specified in hex RGB, e.g. #ff0000 is red
......@@ -123,7 +123,7 @@ The tint2 config file starts with the options defining background elements with
\fB\fCopacity\fR varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque
.RE
.IP \(bu 2
\fB\fCbackground_color_pressed = color opacity\fR (default: same as background\fIcolor\fPhover) \fI(since 0.12.3)\fP
\fB\fCbackground_color_pressed = color opacity\fR (default: same as \fB\fCbackground_color_hover\fR) \fI(since 0.12.3)\fP
.RS
.IP \(bu 2
\fB\fCcolor\fR is specified in hex RGB, e.g. #ff0000 is red
......@@ -131,7 +131,7 @@ The tint2 config file starts with the options defining background elements with
\fB\fCopacity\fR varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque. Note that for a transparent panel you need to enable a desktop compositor (such as compton or compiz)
.RE
.IP \(bu 2
\fB\fCborder_color_pressed = color opacity\fR (default: same as border\fIcolor\fPhover) \fI(since 0.12.3)\fP
\fB\fCborder_color_pressed = color opacity\fR (default: same as \fB\fCborder_color_hover\fR) \fI(since 0.12.3)\fP
.RS
.IP \(bu 2
\fB\fCcolor\fR is specified in hex RGB, e.g. #ff0000 is red
......@@ -205,7 +205,7 @@ Use \fB\fCpanel_monitor = all\fR to get a separate panel per monitor
\fB\fCprimary_monitor_first = boolean (0 or 1)\fR : Place the primary monitor before all the other monitors in the list. \fI(since 0.12.4)\fP
.RE
.PP
[\[la]http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg](http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg)\[ra]
[](images/panel_padding.jpg)
.RS
.IP \(bu 2
\fB\fCpanel_position = vertical_position horizontal_position orientation\fR
......@@ -237,13 +237,13 @@ panel_size = 94% 30
\fB\fCpanel_margin = horizontal_margin vertical_margin\fR : The margins define the distance between the panel and the horizontal/vertical monitor edge. Use \fB\fC0\fR to obtain a panel with the same size as the edge of the monitor (no margin).
.RE
.PP
[\[la]http://farm4.static.flickr.com/3438/3266303192_476a188196.jpg](http://farm4.static.flickr.com/3438/3266303192_476a188196.jpg)\[ra]
[](images/panel\fIsize\fPmargin.jpg)
.RS
.IP \(bu 2
\fB\fCpanel_padding = horizontal_padding vertical_padding spacing\fR : Please refer to the image below.
.RE
.PP
[\[la]http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg](http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg)\[ra]
[](images/panel_padding.jpg)
.RS
.IP \(bu 2
\fB\fCfont_shadow = boolean (0 or 1)\fR
......@@ -331,7 +331,7 @@ You can switch between virtual desktops.
\fB\fCtaskbar_padding = horizontal_padding vertical_padding spacing\fR
.RE
.PP
[\[la]http://farm4.static.flickr.com/3521/3266303292_14d9b6b623.jpg](http://farm4.static.flickr.com/3521/3266303292_14d9b6b623.jpg)\[ra]
[](images/taskbar_padding.jpg)
.RS
.IP \(bu 2
\fB\fCtaskbar_background_id = integer\fR : Which background to use
......@@ -400,7 +400,7 @@ The following options configure the task buttons in the taskbar:
\fB\fCurgent_nb_of_blink = integer\fR : Number of blinks on 'get attention' events.
.RE
.PP
[\[la]http://farm4.static.flickr.com/3086/3265475337_262799ded3.jpg](http://farm4.static.flickr.com/3086/3265475337_262799ded3.jpg)\[ra]
[](images/task_padding.jpg)
.RS
.IP \(bu 2
\fB\fCtask_font = [FAMILY\-LIST] [STYLE\-OPTIONS] [SIZE]\fR
......@@ -511,9 +511,9 @@ To hide the clock, comment \fB\fCtime1_format\fR and \fB\fCtime2_format\fR\&.
.IP \(bu 2
\fB\fCtooltip_padding = horizontal_padding vertical_padding\fR
.IP \(bu 2
\fB\fCtooltip_show_timeout = float\fR : Delay to show the tooltip in seconds. Use '.' as decimal separator.
\fB\fCtooltip_show_timeout = float\fR : Delay to show the tooltip in seconds. Use \fB\fC\&.\fR as decimal separator.
.IP \(bu 2
\fB\fCtooltip_hide_timeout = float\fR : Delay to hide the tooltip in seconds. Use '.' as decimal separator.
\fB\fCtooltip_hide_timeout = float\fR : Delay to hide the tooltip in seconds. Use \fB\fC\&.\fR as decimal separator.
.IP \(bu 2
\fB\fCtooltip_background_id = integer\fR : Which background to use for tooltips. Note that with fake transparency the alpha channel and corner radius options are not respected.
.IP \(bu 2
......@@ -569,9 +569,9 @@ To hide the clock, comment \fB\fCtime1_format\fR and \fB\fCtime2_format\fR\&.
.IP \(bu 2
\fB\fCexecp_has_icon = boolean (0 or 1)\fR : If \fB\fCexecp_has_icon = 1\fR, the first line printed by the command is interpreted as a path to an image file. \fI(since 0.12.4)\fP
.IP \(bu 2
\fB\fCexecp_cache_icon = boolean (0 or 1)\fR : If execp\fIcache\fPicon = 0, the image is reloaded each time the command is executed (useful if the image file is changed on disk by the program executed by \fB\fCexecp_command\fR). \fI(since 0.12.4)\fP
\fB\fCexecp_cache_icon = boolean (0 or 1)\fR : If \fB\fCexecp_cache_icon = 0\fR, the image is reloaded each time the command is executed (useful if the image file is changed on disk by the program executed by \fB\fCexecp_command\fR). \fI(since 0.12.4)\fP
.IP \(bu 2
\fB\fCexecp_icon_w = integer\fR : You can use execp\fIicon\fPw and execp\fIicon\fPh to resize the image. If one of them is zero/missing, the image is rescaled proportionally. If both of them are zero/missing, the image is not rescaled. \fI(since 0.12.4)\fP
\fB\fCexecp_icon_w = integer\fR : You can use \fB\fCexecp_icon_w\fR and \fB\fCexecp_icon_h\fR to resize the image. If one of them is zero/missing, the image is rescaled proportionally. If both of them are zero/missing, the image is not rescaled. \fI(since 0.12.4)\fP
.IP \(bu 2
\fB\fCexecp_icon_h = integer\fR : See \fB\fCexecp_icon_w\fR\&. \fI(since 0.12.4)\fP
.IP \(bu 2
......@@ -689,7 +689,7 @@ execp_continuous = 1
execp_interval = 1
.fi
.RE
.SH EXAMPLE CONFIG
.SS Example configuration
.PP
.RS
.nf
......@@ -834,7 +834,7 @@ strut_policy = minimum
tint2 was written by Thierry Lorthiois \[la]lorthiois@bbsoft.fr\[ra]\&.
It is based on ttm, originally written by Pål Staurland \[la]staura@gmail.com\[ra]\&.
.PP
This manual page was written by Daniel Moerner \[la]dmoerner@gmail.com\[ra], for the Debian project (but may be used by others).
This manual page was originally written by Daniel Moerner \[la]dmoerner@gmail.com\[ra], for the Debian project (but may be used by others).
It was adopted from the tint2 docs.
.SH SEE ALSO
.PP
......
This diff is collapsed. Click to expand it.
......@@ -56,7 +56,7 @@ Goals:
* [Executor](#executor)
* [Example](#an-example-tint2rc)
* [Example configuration](#example-configuration)
### Introduction
......@@ -80,7 +80,7 @@ The tint2 config file starts with the options defining background elements with
* `border_width = integer` : the border width in pixels
* `border_sides = LRTB` : the sides to draw the border on (left, right, top, bottom). If not specified, all sides are used.
* `border_sides = LRTB` : the sides to draw the border on (left, right, top, bottom). If not specified, all sides are used. *(since 0.12.12)*
* `background_color = color opacity`
* `color` is specified in hex RGB, e.g. #ff0000 is red
......@@ -90,19 +90,19 @@ The tint2 config file starts with the options defining background elements with
* `color` is specified in hex RGB, e.g. #ff0000 is red
* `opacity` varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque
* `background_color_hover = color opacity` (default: same as background_color) *(since 0.12.3)*
* `background_color_hover = color opacity` (default: same as `background_color`) *(since 0.12.3)*
* `color` is specified in hex RGB, e.g. #ff0000 is red
* `opacity` varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque. Note that for a transparent panel you need to enable a desktop compositor (such as compton or compiz)
* `border_color_hover = color opacity` (default: same as border_color) *(since 0.12.3)*
* `border_color_hover = color opacity` (default: same as `border_color`) *(since 0.12.3)*
* `color` is specified in hex RGB, e.g. #ff0000 is red
* `opacity` varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque
* `background_color_pressed = color opacity` (default: same as background_color_hover) *(since 0.12.3)*
* `background_color_pressed = color opacity` (default: same as `background_color_hover`) *(since 0.12.3)*
* `color` is specified in hex RGB, e.g. #ff0000 is red
* `opacity` varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque. Note that for a transparent panel you need to enable a desktop compositor (such as compton or compiz)
* `border_color_pressed = color opacity` (default: same as border_color_hover) *(since 0.12.3)*
* `border_color_pressed = color opacity` (default: same as `border_color_hover`) *(since 0.12.3)*
* `color` is specified in hex RGB, e.g. #ff0000 is red
* `opacity` varies from (0 to 100), where 0 is fully transparent, 100 is fully opaque
......@@ -153,7 +153,7 @@ Identifier 0 refers to a special background which is fully transparent, identifi
* `primary_monitor_first = boolean (0 or 1)` : Place the primary monitor before all the other monitors in the list. *(since 0.12.4)*
![http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg](http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg)
![](images/panel_padding.jpg)
* `panel_position = vertical_position horizontal_position orientation`
* `vertical_position` is one of: `bottom`, `top`, `center`
......@@ -171,11 +171,11 @@ panel_size = 94% 30
* `panel_margin = horizontal_margin vertical_margin` : The margins define the distance between the panel and the horizontal/vertical monitor edge. Use `0` to obtain a panel with the same size as the edge of the monitor (no margin).
![http://farm4.static.flickr.com/3438/3266303192_476a188196.jpg](http://farm4.static.flickr.com/3438/3266303192_476a188196.jpg)
![](images/panel_size_margin.jpg)
* `panel_padding = horizontal_padding vertical_padding spacing` : Please refer to the image below.
![http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg](http://farm4.static.flickr.com/3425/3265475271_81e8ed56e0.jpg)
![](images/panel_padding.jpg)
* `font_shadow = boolean (0 or 1)`
......@@ -245,7 +245,7 @@ panel_size = 94% 30
* `taskbar_padding = horizontal_padding vertical_padding spacing`
![http://farm4.static.flickr.com/3521/3266303292_14d9b6b623.jpg](http://farm4.static.flickr.com/3521/3266303292_14d9b6b623.jpg)
![](images/taskbar_padding.jpg)
* `taskbar_background_id = integer` : Which background to use
......@@ -300,7 +300,7 @@ The following options configure the task buttons in the taskbar:
* `urgent_nb_of_blink = integer` : Number of blinks on 'get attention' events.
![http://farm4.static.flickr.com/3086/3265475337_262799ded3.jpg](http://farm4.static.flickr.com/3086/3265475337_262799ded3.jpg)
![](images/task_padding.jpg)
* `task_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]`
......@@ -399,9 +399,9 @@ The action semantics:
* `tooltip_padding = horizontal_padding vertical_padding`
* `tooltip_show_timeout = float` : Delay to show the tooltip in seconds. Use '.' as decimal separator.
* `tooltip_show_timeout = float` : Delay to show the tooltip in seconds. Use `.` as decimal separator.
* `tooltip_hide_timeout = float` : Delay to hide the tooltip in seconds. Use '.' as decimal separator.
* `tooltip_hide_timeout = float` : Delay to hide the tooltip in seconds. Use `.` as decimal separator.
* `tooltip_background_id = integer` : Which background to use for tooltips. Note that with fake transparency the alpha channel and corner radius options are not respected.
......@@ -455,9 +455,9 @@ The action semantics:
* `execp_has_icon = boolean (0 or 1)` : If `execp_has_icon = 1`, the first line printed by the command is interpreted as a path to an image file. *(since 0.12.4)*
* `execp_cache_icon = boolean (0 or 1)` : If execp_cache_icon = 0, the image is reloaded each time the command is executed (useful if the image file is changed on disk by the program executed by `execp_command`). *(since 0.12.4)*
* `execp_cache_icon = boolean (0 or 1)` : If `execp_cache_icon = 0`, the image is reloaded each time the command is executed (useful if the image file is changed on disk by the program executed by `execp_command`). *(since 0.12.4)*
* `execp_icon_w = integer` : You can use execp_icon_w and execp_icon_h to resize the image. If one of them is zero/missing, the image is rescaled proportionally. If both of them are zero/missing, the image is not rescaled. *(since 0.12.4)*
* `execp_icon_w = integer` : You can use `execp_icon_w` and `execp_icon_h` to resize the image. If one of them is zero/missing, the image is rescaled proportionally. If both of them are zero/missing, the image is not rescaled. *(since 0.12.4)*
* `execp_icon_h = integer` : See `execp_icon_w`. *(since 0.12.4)*
......@@ -564,7 +564,8 @@ execp_continuous = 1
execp_interval = 1
```
# EXAMPLE CONFIG