Browse Source
* configure.in.in -> configure.ac.in (hey Brian ;-) * Make config files translatable, but don't update po files yet: it will probably still change. (Old svn revision: 21987)upstream/xfce4-panel-4.10.1
Jasper Huijsmans
17 years ago
17 changed files with 1242 additions and 19 deletions
@ -1,8 +1,8 @@ |
|||
[Entry 0] |
|||
Name=Web Browser |
|||
_Name=Web Browser |
|||
Exec=exo-open --launch WebBrowser |
|||
Terminal=false |
|||
StartupNotify=false |
|||
Comment=Surf the internet |
|||
_Comment=Surf the internet |
|||
X-XFCE-IconCategory=7 |
|||
|
|||
@ -1,8 +1,8 @@ |
|||
[Entry 0] |
|||
Name=Command Prompt |
|||
_Name=Command Prompt |
|||
Exec=Terminal |
|||
Terminal=false |
|||
StartupNotify=true |
|||
Comment=X terminal emulator |
|||
_Comment=X terminal emulator |
|||
X-XFCE-IconCategory=12 |
|||
|
|||
@ -1,8 +1,8 @@ |
|||
[Entry 0] |
|||
Name=Editor |
|||
_Name=Editor |
|||
Exec=mousepad |
|||
Terminal=false |
|||
StartupNotify=true |
|||
Comment=Edit text files |
|||
_Comment=Edit text files |
|||
X-XFCE-IconCategory=1 |
|||
|
|||
@ -1,8 +1,8 @@ |
|||
[Entry 0] |
|||
Name=File Manager |
|||
_Name=File Manager |
|||
Exec=thunar |
|||
Terminal=false |
|||
StartupNotify=true |
|||
Comment=Manage files and folders |
|||
_Comment=Manage files and folders |
|||
X-XFCE-IconCategory=2 |
|||
|
|||
@ -1 +1,5 @@ |
|||
SUBDIRS = API |
|||
SUBDIRS = API manual |
|||
|
|||
html: |
|||
make -C manual html |
|||
|
|||
|
|||
@ -0,0 +1,16 @@ |
|||
SUBDIRS = \
|
|||
images |
|||
|
|||
noinst_DATA = \
|
|||
xfce4-panel.xml |
|||
|
|||
docdir=$(datadir)/xfce4/doc/C |
|||
|
|||
doc_DATA= \
|
|||
xfce4-panel.html |
|||
|
|||
EXTRA_DIST = $(noinst_DATA) $(doc_DATA) |
|||
|
|||
html: $(srcdir)/xfce4-panel.xml |
|||
xsltproc $(srcdir)/../xfce-nochunk.xsl $(srcdir)/xfce4-panel.xml |
|||
|
|||
@ -0,0 +1,5 @@ |
|||
imagesdir = $(datadir)/xfce4/doc/C/images |
|||
images_DATA = |
|||
|
|||
EXTRA_DIST = $(images_DATA) |
|||
|
|||
@ -0,0 +1,181 @@ |
|||
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Xfce 4 Panel</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"><link rel="start" href="#xfce4-panel" title="Xfce 4 Panel"><link rel="next" href="#panel-intro" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="xfce4-panel"></a>Xfce 4 Panel</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Jasper</span> <span class="surname">Huijsmans</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a href="mailto:jasper@xfce.org">jasper@xfce.org</a>></code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" class="releaseinfo"> |
|||
This manual describes <strong xmlns="" class="application"><code>xfce4-panel</code></strong> version 4.4.0. |
|||
Last updated: June 2006 |
|||
<br></br></span></div><div><p class="copyright">Copyright © 2006 Jasper Huijsmans</p></div><div><div class="legalnotice"><a name="legalnotice"></a><p> |
|||
This document is provided under the terms of the GNU GPL, version |
|||
2 or (at your option) any later version. |
|||
</p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#panel-intro">Introduction</a></span></dt><dt><span class="sect1"><a href="#panel-getting-started">Getting Started</a></span></dt><dt><span class="sect1"><a href="#panel-manager">Panel Manager</a></span></dt><dd><dl><dt><span class="sect2"><a href="#panel-selector">Select Panel</a></span></dt><dt><span class="sect2"><a href="#panel-appearance">Appearance</a></span></dt><dt><span class="sect2"><a href="#panel-position">Position</a></span></dt><dt><span class="sect2"><a href="#panel-monitor">Select Monitor</a></span></dt></dl></dd><dt><span class="sect1"><a href="#panel-items">Panel Items</a></span></dt><dd><dl><dt><span class="sect2"><a href="#launcher-item">Launcher</a></span></dt><dt><span class="sect2"><a href="#clock-item">Xfce Clock</a></span></dt><dt><span class="sect2"><a href="#switcher-item">Graphical Pager</a></span></dt><dt><span class="sect2"><a href="#actionbuttons-item">Action Buttons</a></span></dt><dt><span class="sect2"><a href="#separator-item">Separator</a></span></dt></dl></dd><dt><span class="sect1"><a href="#panel-advanced">Advanced</a></span></dt><dd><dl><dt><span class="sect2"><a href="#panel-config-files">Configuration Files</a></span></dt><dt><span class="sect2"><a href="#panel-data-files">Data Files</a></span></dt><dt><span class="sect2"><a href="#panel-kiosk">Kiosk Mode</a></span></dt></dl></dd><dt><span class="sect1"><a href="#panel-copyright">About <strong class="application"><code>xfce4-panel</code></strong></a></span></dt></dl></div><p>Â </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="panel-intro"></a>Introduction</h2></div></div></div><p> |
|||
The Xfce 4 panel is part of the <a href="http://www.xfce.org" target="_top">Xfce 4 Desktop Environment</a> and features program |
|||
launchers, panel menus, a clock, a graphical pager and more. Many |
|||
aspects of the panel can be configured through graphical dialogs. This |
|||
manual should provide you with all necessary information on how to adjust |
|||
the panel to your liking. |
|||
</p></div><p>Â </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="panel-getting-started"></a>Getting Started</h2></div></div></div><p> |
|||
You will usually start the panel as part of your Xfce session. For |
|||
convenience Xfce provides the <strong class="application"><code>startxfce4</code></strong> |
|||
script. The command for the panel is <strong class="application"><code>xfce4-panel</code></strong>. |
|||
</p><p> |
|||
When you start the panel you will see a bar appearing at the top of the |
|||
screen and a smaller one at the bottom, looking like this: |
|||
</p><div class="figure"><a name="default-panel-fig"></a><p class="title"><b>Figure 1. Default Xfce Panel Configuration</b></p><div class="screenshot"><div class="mediaobject"><img src="images/default_panel.png" alt="The default Xfce Panel configuration."></div></div></div><p> |
|||
The figure above shows the default panel configuration. Hovering the mouse |
|||
over an item will show a tooltip. The Xfce Panel makes extensive use of |
|||
left and right mouse buttons. Left clicking performs the default action of |
|||
an item, while right-clicking usually brings up a context menu. Ctrl + |
|||
left click may commonly be used instead of a right-click. Note that this |
|||
manual assumes the use of a right-handed mouse. |
|||
</p><p> |
|||
The panel comes with several items that may be added to the panel. |
|||
The available items are are described in the |
|||
"<a href="#panel-items" target="_top">Panel Items</a>" section. |
|||
</p><p> |
|||
Right-clicking on an item will popup a menu from which you can configure |
|||
the item, move it to a new location, or remove it from the panel. The menu |
|||
also allows you to configure the panel or add new items. |
|||
</p><div class="figure"><a name="item-popup-fig"></a><p class="title"><b>Figure 2. Item Popup Menu</b></p><div class="screenshot"><div class="mediaobject"><img src="images/item-popup.png" alt="Popup Menu of a launcher item."></div></div></div><p> |
|||
When you want to add an item, a dialog is opened showing all |
|||
available panel items. Some items can appear only once in the panel, |
|||
e.g. the system tray, and they will appear greyed out when one is |
|||
already present. |
|||
</p><div class="figure"><a name="add-item-dialog-fig"></a><p class="title"><b>Figure 3. Add Item Dialog</b></p><div class="screenshot"><div class="mediaobject"><img src="images/add-item-dialog.png" alt="Dialog with available panel items."></div></div></div><p> |
|||
Configuration of the panels, as well as adding and removing panels can be |
|||
done from the <a href="#panel-manager" target="_top">Panel Manager</a>. |
|||
</p></div><p>Â </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="panel-manager"></a>Panel Manager</h2></div></div></div><p>The Panel Manager can be opened from the Xfce 4 Settings Manager or |
|||
from the right-click menu on one of the panel items. |
|||
</p><div class="figure"><a name="panel-manager-fig"></a><p class="title"><b>Figure 4. Panel Manager</b></p><div class="screenshot"><div class="mediaobject"><img src="images/panel-manager.png" alt="Panel Manager dialog."></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="panel-selector"></a>Select Panel</h3></div></div></div><p> |
|||
The current active panel is selected by default or the one that was last |
|||
active if there is no active panel. You can choose another panel from |
|||
the option menu. Next to this menu are two buttons to add a new panel or |
|||
remove the current panel. |
|||
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="panel-appearance"></a>Appearance</h3></div></div></div><div class="variablelist"><dl><dt><span class="term">Size</span></dt><dd><p> |
|||
Choose the size in pixels for the panel. This is the height |
|||
for horizontal panels and the width for vertical panels. |
|||
</p></dd><dt><span class="term">Transparency</span></dt><dd><p> |
|||
If your system and the window manager support it, you can set the |
|||
transparency level of the panel. You can also choose if you would |
|||
like the panel to become fully visible when the mouse moves over |
|||
it. |
|||
</p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="panel-position"></a>Position</h3></div></div></div><p> |
|||
There are two ways to choose the position of a panel: use a fixed |
|||
position or make a panel freely moveable. |
|||
</p><div class="variablelist"><dl><dt><span class="term">Fixed Position</span></dt><dd><p> |
|||
A panel can be placed in one of twelve positions on the edge of |
|||
the screen. You can choose whether the panel should be stretched |
|||
to fit the entire width or height of the screen. When the autohide |
|||
option is selected the panel will collapse to a small line and |
|||
reappear when the mouse is moved over it. |
|||
</p></dd><dt><span class="term">Freely Moveable</span></dt><dd><p> |
|||
A freely moveable panel has one or two move handles by which you |
|||
can drag the panel anywhere on the screen. You can select the |
|||
orientation and where to put a move handle (on one or both sides |
|||
of the panel). |
|||
</p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="panel-monitor"></a>Select Monitor</h3></div></div></div><p> |
|||
If you use a Xinerama or multihead setup, you can choose on which |
|||
monitor you would like the panel to appear. |
|||
</p></div></div><p>Â </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="panel-items"></a>Panel Items</h2></div></div></div><p> |
|||
The Xfce 4 panel has the possibility to load external plugins as well |
|||
as builtin ones. In this section we will only describe panel items that |
|||
are installed with the panel. |
|||
</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="launcher-item"></a>Launcher</h3></div></div></div><p>The most common panel item is the launcher item. It allows you to |
|||
start programs from the panel. The properties dialog allows you to edit |
|||
or add one or more programs. |
|||
</p><p> |
|||
When more than one program is added to the list a small arrow button |
|||
will appear next to the panel button that will open a menu with the |
|||
other programs. |
|||
</p><p> |
|||
Every item has several option you can edit: |
|||
</p><div class="variablelist"><dl><dt><span class="term">Name</span></dt><dd><p>The label to show in a menu item.</p></dd><dt><span class="term">Comment</span></dt><dd><p> |
|||
Additional information that will be shown in a tooltip. |
|||
</p></dd><dt><span class="term">Icon</span></dt><dd><p> |
|||
The icons you choose from the icon button will follow the icon |
|||
theme you choose from the |
|||
<a href="xfce-mcs-plugins.html#ui-settings" target="_top">User |
|||
Interface</a> settings dialog. |
|||
</p><p> |
|||
Of course you can also choose a custom icon, either by browsing |
|||
the file system from the button next to the entry or by dragging |
|||
an image on the icon button from a file manager. |
|||
</p></dd><dt><span class="term">Command</span></dt><dd><p> |
|||
You can type the command to run or browse the file system. There |
|||
is an option to start in a terminal and one to use startup |
|||
notification. This last option means that the window manager can |
|||
show an hourglass while the program is loading. But, the |
|||
application has to support it as well. Programs build with Gtk 2.2 |
|||
should support it. |
|||
</p></dd></dl></div><div class="figure"><a name="launcher-fig"></a><p class="title"><b>Figure 5. Launcher Item</b></p><div class="screenshot"><div class="mediaobject"><img src="images/launcher-properties.png" alt="Shows properties dialog for a launcher item."></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="clock-item"></a>Xfce Clock</h3></div></div></div><p>The Xfce Clock has a number of options to change the way it looks. |
|||
There are three clock types available: analog, digital and LED. |
|||
There is an option to show seconds and for the digital and LED clock |
|||
types you can choose whether the clock will be in 24 hour mode, 12 |
|||
hour mode, or 12 hour mode with AM/PM indication. The clock shows the |
|||
current date as a tooltip. |
|||
</p><div class="figure"><a name="clock-fig"></a><p class="title"><b>Figure 6. Clock Item</b></p><div class="screenshot"><div class="mediaobject"><img src="images/clock-properties.png" alt="Shows properties dialog for a clock item."></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="switcher-item"></a>Graphical Pager</h3></div></div></div><p> |
|||
The graphical pager shows a miniature view of the desktops and |
|||
even allows you to move windows to another workspace by dragging the |
|||
mini-window in the pager. The pager also allows you to change workspaces |
|||
by using the mouse scrollwheel. You can set the number of rows to use, |
|||
or columns when the panel is in vertical orientation. |
|||
</p><div class="figure"><a name="pager-fig"></a><p class="title"><b>Figure 7. Graphical Pager</b></p><div class="screenshot"><div class="mediaobject"><img src="images/pager-properties.png" alt="Shows properties dialog for the graphical pager. |
|||
"></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="actionbuttons-item"></a>Action Buttons</h3></div></div></div><p>This item shows one or two buttons which can perform |
|||
special system actions. The buttons follow your panel icon theme. |
|||
There are two buttons available:</p><div class="variablelist"><dl><dt><span class="term">Lock</span></dt><dd><p>Runs the <strong class="application"><code>xflock4</code></strong> script that |
|||
will attempt to lock the screen using either xscreensaver or if |
|||
that fails xlock.</p></dd><dt><span class="term">Exit</span></dt><dd><p>This will popup a logout dialog to end your Xfce |
|||
session.</p></dd></dl></div><div class="figure"><a name="actionbuttons-fig"></a><p class="title"><b>Figure 8. Action Button Item</b></p><div class="screenshot"><div class="mediaobject"><img src="images/actionbuttons-properties.png" alt="Shows properties dialog for an action buttons item. |
|||
"></div></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="separator-item"></a>Separator</h3></div></div></div><p>This item simply adds a separator line to the panel. You can choose |
|||
to draw a separator line and if the item should expand to fill the |
|||
available space (for full width panels). |
|||
</p><div class="figure"><a name="separator-fig"></a><p class="title"><b>Figure 9. Separator Item</b></p><div class="screenshot"><div class="mediaobject"><img src="images/separator-properties.png" alt="Shows properties dialog for separator item. |
|||
"></div></div></div></div><p>Â </p></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="panel-advanced"></a>Advanced</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="panel-config-files"></a>Configuration Files</h3></div></div></div><p>Xfce now uses the Basedir Specification as defined on <a href="http://freedesktop.org" target="_top">Freedesktop.org</a> to locate its |
|||
data and configuration files. This means that file locations will |
|||
be specified as a path relative to the directories described in |
|||
the specification. |
|||
</p><div class="variablelist"><dl><dt><span class="term">${XDG_CONFIG_HOME}</span></dt><dd><p>The first base directory to look for configuration |
|||
files. By default this is set to <code class="filename">~/.config/</code>.</p></dd><dt><span class="term">${XDG_CONFIG_DIRS}</span></dt><dd><p>A list of system directories that contain configuration |
|||
data. By default the panel will look in <code class="filename">${sysconfdir}/xdg/</code> and |
|||
<code class="filename">/etc/xdg/</code>. The value of |
|||
${sysconfdir} depends on how the program was build and will often be |
|||
<code class="filename">/etc/</code> for binary |
|||
packages.</p></dd><dt><span class="term"><basedir>/xfce4/panel/panels.xml</span></dt><dd><p>This is the location of the xml configuration file |
|||
that describes the contents of the panel, relative to the base |
|||
directories metioned above.</p></dd><dt><span class="term"><basedir>/xfce4/kiosk/kioskrc</span></dt><dd><p>Kiosk Mode configuration file. See <a href="#panel-kiosk" target="_top">below</a> for an explanation. |
|||
</p></dd></dl></div><p>None of the configuration files, except |
|||
<code class="filename">kioskrc</code> , are designed to be edited by hand; in |
|||
fact the changes will be overwritten if you edit them while the panel |
|||
is running. |
|||
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="panel-data-files"></a>Data Files</h3></div></div></div><p>The Xfce Panel will look under the data directories specified by the |
|||
Basedir Specification for data files, such as panel plugin description |
|||
files. |
|||
</p><div class="variablelist"><dl><dt><span class="term">${XDG_DATA_HOME}</span></dt><dd><p> |
|||
The first base directory to look for panel plugin files. By |
|||
default this is set to <code class="filename">~/.local/share/</code>. |
|||
</p></dd><dt><span class="term">${XDG_DATA_DIRS}</span></dt><dd><p>A list of system directories that contain data files. By |
|||
default this is <code class="filename">/usr/share</code> |
|||
and <code class="filename">/usr/local/share</code>. |
|||
</p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="panel-kiosk"></a>Kiosk Mode</h3></div></div></div><p>The panel now has support for Kiosk Mode, that will prevent users |
|||
from making changes to their panel configuration. To use it you have to |
|||
edit or create the file |
|||
<code class="filename">${sysconfdir}/xdg/xfce4/kiosk/kioskrc</code>. |
|||
</p><p>The best way to explain the format of this file is by using an |
|||
example. The xfce4-panel section of your kioskrc might look like this: |
|||
</p><pre class="programlisting"> |
|||
[xfce4-panel] |
|||
CustomizePanel=%powerusers,foo |
|||
</pre><p>This allows only users in the group powerusers and the user foo to |
|||
customize their panels. |
|||
</p></div></div><p>Â </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="panel-copyright"></a>About <strong class="application"><code>xfce4-panel</code></strong></h2></div></div></div><p><strong class="application"><code>xfce4-panel</code></strong> was written by Jasper Huijsmans |
|||
(<code class="email"><<a href="mailto:jasper@xfce.org">jasper@xfce.org</a>></code>). To find more information, please visit |
|||
the <a href="http://www.xfce.org" target="_top">Xfce web site</a>. |
|||
</p><p>To report a bug or make a suggestion regarding this application or |
|||
this manual, use the bug tracking system at <a href="http://bugzilla.xfce.org/" target="_top">http://bugzilla.xfce.org/</a>. |
|||
</p><p>If you have questions about the use or installation of this package, |
|||
please ask on the <a href="http://foo-projects.org/mailman/listinfo/xfce" target="_top">xfce</a> mailing list. Development discussion takes |
|||
place on the <a href="http://foo-projects.org/mailman/listinfo/xfce4-dev" target="_top">xfce4-dev</a> mailing list. |
|||
</p><p><strong class="application"><code>xfce4-panel</code></strong> is distributed under the terms of the |
|||
GNU General Public License as published by the Free Software Foundation; |
|||
either version 2 of the License, or (at your option) any later version. |
|||
</p><p>You should have received a copy of the GNU General Public License |
|||
along with this program; if not, write to the Free Software |
|||
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
|||
USA. |
|||
</p></div></div></body></html> |
|||
@ -0,0 +1,727 @@ |
|||
<?xml version='1.0'?> |
|||
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" |
|||
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ |
|||
<!ENTITY manrevision "1.0"> |
|||
<!ENTITY date "June 2006"> |
|||
<!ENTITY appversion "4.4.0"> |
|||
<!ENTITY app "<application>xfce4-panel</application>"> |
|||
]> |
|||
|
|||
<article id="xfce4-panel" lang="en"> |
|||
|
|||
<!-- Header --> |
|||
<articleinfo> |
|||
|
|||
<title>Xfce 4 Panel</title> |
|||
|
|||
<copyright> |
|||
<year>2006</year> <holder>Jasper Huijsmans</holder> |
|||
</copyright> |
|||
|
|||
<!-- translators: uncomment this: |
|||
|
|||
<copyright> |
|||
<year>2002</year> <holder>ME-THE-TRANSLATOR (Latin |
|||
translation)</holder> |
|||
</copyright> |
|||
|
|||
--> |
|||
|
|||
<!-- I don't know about this --> |
|||
<legalnotice id="legalnotice"> |
|||
<para> |
|||
This document is provided under the terms of the GNU GPL, version |
|||
2 or (at your option) any later version. |
|||
</para> |
|||
</legalnotice> |
|||
|
|||
<authorgroup> |
|||
|
|||
<author> |
|||
<firstname>Jasper</firstname> <surname>Huijsmans</surname> |
|||
<affiliation> |
|||
<address><email>jasper@xfce.org</email></address> |
|||
</affiliation> |
|||
</author> |
|||
|
|||
<!-- This is appropriate place for other contributors: translators, |
|||
maintainers, etc. Commented out by default. |
|||
|
|||
<othercredit role="translator"> |
|||
<firstname>Latin</firstname> <surname>Translator 1</surname> |
|||
<affiliation> |
|||
<orgname>Latin Translation Team</orgname> |
|||
<address><email>translator@gnome.org</email> </address> |
|||
</affiliation> <contrib>Latin translation</contrib> |
|||
</othercredit> |
|||
--> |
|||
|
|||
</authorgroup> |
|||
|
|||
<!-- |
|||
<revhistory> |
|||
<revision> |
|||
<revnumber>1.0</revnumber> |
|||
<date>June 2006</date> |
|||
<authorinitials>jbh</authorinitials> |
|||
</revision> |
|||
</revhistory> |
|||
--> |
|||
|
|||
<releaseinfo> |
|||
This manual describes &app; version &appversion;. |
|||
Last updated: &date; |
|||
</releaseinfo> |
|||
|
|||
</articleinfo> |
|||
|
|||
<!-- extra space --> |
|||
<para> </para> |
|||
|
|||
<sect1 id="panel-intro"> |
|||
<title>Introduction</title> |
|||
|
|||
<para> |
|||
The Xfce 4 panel is part of the <ulink url="http://www.xfce.org" |
|||
type="html">Xfce 4 Desktop Environment</ulink> and features program |
|||
launchers, panel menus, a clock, a graphical pager and more. Many |
|||
aspects of the panel can be configured through graphical dialogs. This |
|||
manual should provide you with all necessary information on how to adjust |
|||
the panel to your liking. |
|||
</para> |
|||
|
|||
</sect1> |
|||
|
|||
<!-- extra space --> |
|||
<para> </para> |
|||
|
|||
<sect1 id="panel-getting-started"> |
|||
<title>Getting Started</title> |
|||
|
|||
<para> |
|||
You will usually start the panel as part of your Xfce session. For |
|||
convenience Xfce provides the <application>startxfce4</application> |
|||
script. The command for the panel is &app;. |
|||
</para> |
|||
|
|||
<para> |
|||
When you start the panel you will see a bar appearing at the top of the |
|||
screen and a smaller one at the bottom, looking like this: |
|||
</para> |
|||
|
|||
<figure id="default-panel-fig"> |
|||
<title>Default Xfce Panel Configuration</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/default_panel.png" format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/default_panel.eps" format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>The default Xfce Panel configuration.</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
<para> |
|||
The figure above shows the default panel configuration. Hovering the mouse |
|||
over an item will show a tooltip. The Xfce Panel makes extensive use of |
|||
left and right mouse buttons. Left clicking performs the default action of |
|||
an item, while right-clicking usually brings up a context menu. Ctrl + |
|||
left click may commonly be used instead of a right-click. Note that this |
|||
manual assumes the use of a right-handed mouse. |
|||
</para> |
|||
|
|||
<para> |
|||
The panel comes with several items that may be added to the panel. |
|||
The available items are are described in the |
|||
"<ulink url="#panel-items">Panel Items</ulink>" section. |
|||
</para> |
|||
|
|||
<para> |
|||
Right-clicking on an item will popup a menu from which you can configure |
|||
the item, move it to a new location, or remove it from the panel. The menu |
|||
also allows you to configure the panel or add new items. |
|||
</para> |
|||
|
|||
<figure id="item-popup-fig"> |
|||
<title>Item Popup Menu</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/item-popup.png" format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/item-popup.eps" format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>Popup Menu of a launcher item.</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
<para> |
|||
When you want to add an item, a dialog is opened showing all |
|||
available panel items. Some items can appear only once in the panel, |
|||
e.g. the system tray, and they will appear greyed out when one is |
|||
already present. |
|||
</para> |
|||
|
|||
<figure id="add-item-dialog-fig"> |
|||
<title>Add Item Dialog</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/add-item-dialog.png" format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/add-item-dialog.eps" format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>Dialog with available panel items.</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
<para> |
|||
Configuration of the panels, as well as adding and removing panels can be |
|||
done from the <ulink url="#panel-manager">Panel Manager</ulink>. |
|||
</para> |
|||
|
|||
</sect1> |
|||
|
|||
<!-- extra space --> |
|||
<para> </para> |
|||
|
|||
<sect1 id="panel-manager"> |
|||
<title>Panel Manager</title> |
|||
|
|||
<para>The Panel Manager can be opened from the Xfce 4 Settings Manager or |
|||
from the right-click menu on one of the panel items. |
|||
</para> |
|||
|
|||
<figure id="panel-manager-fig"> |
|||
<title>Panel Manager</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/panel-manager.png" |
|||
format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/panel-manager.eps" |
|||
format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>Panel Manager dialog.</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
<sect2 id="panel-selector"> |
|||
<title>Select Panel</title> |
|||
|
|||
<para> |
|||
The current active panel is selected by default or the one that was last |
|||
active if there is no active panel. You can choose another panel from |
|||
the option menu. Next to this menu are two buttons to add a new panel or |
|||
remove the current panel. |
|||
</para> |
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="panel-appearance"> |
|||
<title>Appearance</title> |
|||
|
|||
<variablelist> |
|||
<varlistentry> |
|||
<term>Size</term> |
|||
<listitem> |
|||
<para> |
|||
Choose the size in pixels for the panel. This is the height |
|||
for horizontal panels and the width for vertical panels. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
<varlistentry> |
|||
<term>Transparency</term> |
|||
<listitem> |
|||
<para> |
|||
If your system and the window manager support it, you can set the |
|||
transparency level of the panel. You can also choose if you would |
|||
like the panel to become fully visible when the mouse moves over |
|||
it. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
</variablelist> |
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="panel-position"> |
|||
<title>Position</title> |
|||
|
|||
<para> |
|||
There are two ways to choose the position of a panel: use a fixed |
|||
position or make a panel freely moveable. |
|||
</para> |
|||
|
|||
<variablelist> |
|||
<varlistentry> |
|||
<term>Fixed Position</term> |
|||
<listitem> |
|||
<para> |
|||
A panel can be placed in one of twelve positions on the edge of |
|||
the screen. You can choose whether the panel should be stretched |
|||
to fit the entire width or height of the screen. When the autohide |
|||
option is selected the panel will collapse to a small line and |
|||
reappear when the mouse is moved over it. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
<varlistentry> |
|||
<term>Freely Moveable</term> |
|||
<listitem> |
|||
<para> |
|||
A freely moveable panel has one or two move handles by which you |
|||
can drag the panel anywhere on the screen. You can select the |
|||
orientation and where to put a move handle (on one or both sides |
|||
of the panel). |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
</variablelist> |
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="panel-monitor"> |
|||
<title>Select Monitor</title> |
|||
|
|||
<para> |
|||
If you use a Xinerama or multihead setup, you can choose on which |
|||
monitor you would like the panel to appear. |
|||
</para> |
|||
|
|||
</sect2> |
|||
|
|||
</sect1> |
|||
|
|||
<!-- extra space --> |
|||
<para> </para> |
|||
|
|||
<sect1 id="panel-items"> |
|||
<title>Panel Items</title> |
|||
|
|||
<para> |
|||
The Xfce 4 panel has the possibility to load external plugins as well |
|||
as builtin ones. In this section we will only describe panel items that |
|||
are installed with the panel. |
|||
</para> |
|||
|
|||
<sect2 id="launcher-item"> |
|||
<title>Launcher</title> |
|||
|
|||
<para>The most common panel item is the launcher item. It allows you to |
|||
start programs from the panel. The properties dialog allows you to edit |
|||
or add one or more programs. |
|||
</para> |
|||
|
|||
<para> |
|||
When more than one program is added to the list a small arrow button |
|||
will appear next to the panel button that will open a menu with the |
|||
other programs. |
|||
</para> |
|||
|
|||
<para> |
|||
Every item has several option you can edit: |
|||
</para> |
|||
|
|||
<variablelist> |
|||
<varlistentry> |
|||
<term>Name</term> |
|||
<listitem> |
|||
<para>The label to show in a menu item.</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
|
|||
<varlistentry> |
|||
<term>Comment</term> |
|||
<listitem> |
|||
<para> |
|||
Additional information that will be shown in a tooltip. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
|
|||
<varlistentry> |
|||
<term>Icon</term> |
|||
<listitem> |
|||
<para> |
|||
The icons you choose from the icon button will follow the icon |
|||
theme you choose from the |
|||
<ulink url="xfce-mcs-plugins.html#ui-settings">User |
|||
Interface</ulink> settings dialog. |
|||
</para> |
|||
<para> |
|||
Of course you can also choose a custom icon, either by browsing |
|||
the file system from the button next to the entry or by dragging |
|||
an image on the icon button from a file manager. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
|
|||
<varlistentry> |
|||
<term>Command</term> |
|||
<listitem> |
|||
<para> |
|||
You can type the command to run or browse the file system. There |
|||
is an option to start in a terminal and one to use startup |
|||
notification. This last option means that the window manager can |
|||
show an hourglass while the program is loading. But, the |
|||
application has to support it as well. Programs build with Gtk 2.2 |
|||
should support it. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
|
|||
</variablelist> |
|||
|
|||
<figure id="launcher-fig"> |
|||
<title>Launcher Item</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/launcher-properties.png" |
|||
format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/launcher-properties.eps" |
|||
format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>Shows properties dialog for a launcher item.</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="clock-item"> |
|||
<title>Xfce Clock</title> |
|||
|
|||
<para>The Xfce Clock has a number of options to change the way it looks. |
|||
There are three clock types available: analog, digital and LED. |
|||
There is an option to show seconds and for the digital and LED clock |
|||
types you can choose whether the clock will be in 24 hour mode, 12 |
|||
hour mode, or 12 hour mode with AM/PM indication. The clock shows the |
|||
current date as a tooltip. |
|||
</para> |
|||
|
|||
<figure id="clock-fig"> |
|||
<title>Clock Item</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/clock-properties.png" |
|||
format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/clock-properties.eps" |
|||
format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>Shows properties dialog for a clock item.</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="switcher-item"> |
|||
<title>Graphical Pager</title> |
|||
|
|||
<para> |
|||
The graphical pager shows a miniature view of the desktops and |
|||
even allows you to move windows to another workspace by dragging the |
|||
mini-window in the pager. The pager also allows you to change workspaces |
|||
by using the mouse scrollwheel. You can set the number of rows to use, |
|||
or columns when the panel is in vertical orientation. |
|||
</para> |
|||
|
|||
<figure id="pager-fig"> |
|||
<title>Graphical Pager</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/pager-properties.png" |
|||
format="PNG"/> |
|||
</imageobject> |
|||
<textobject> |
|||
<phrase>Shows properties dialog for the graphical pager. |
|||
</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="actionbuttons-item"> |
|||
<title>Action Buttons</title> |
|||
|
|||
<para>This item shows one or two buttons which can perform |
|||
special system actions. The buttons follow your panel icon theme. |
|||
There are two buttons available:</para> |
|||
|
|||
<variablelist> |
|||
<varlistentry> |
|||
<term>Lock</term> |
|||
<listitem><para>Runs the <application>xflock4</application> script that |
|||
will attempt to lock the screen using either xscreensaver or if |
|||
that fails xlock.</para></listitem> |
|||
</varlistentry> |
|||
<varlistentry> |
|||
<term>Exit</term> |
|||
<listitem><para>This will popup a logout dialog to end your Xfce |
|||
session.</para></listitem> |
|||
</varlistentry> |
|||
</variablelist> |
|||
|
|||
<figure id="actionbuttons-fig"> |
|||
<title>Action Button Item</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/actionbuttons-properties.png" |
|||
format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/systembuttons-properties.eps" |
|||
format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>Shows properties dialog for an action buttons item. |
|||
</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="separator-item"> |
|||
<title>Separator</title> |
|||
|
|||
<para>This item simply adds a separator line to the panel. You can choose |
|||
to draw a separator line and if the item should expand to fill the |
|||
available space (for full width panels). |
|||
</para> |
|||
|
|||
<figure id="separator-fig"> |
|||
<title>Separator Item</title> |
|||
<screenshot> |
|||
<mediaobject> |
|||
<imageobject> |
|||
<imagedata fileref="images/separator-properties.png" |
|||
format="PNG"/> |
|||
</imageobject> |
|||
<!-- |
|||
<imageobject> |
|||
<imagedata fileref="images/nooptions-properties.eps" |
|||
format="EPS"/> |
|||
</imageobject> |
|||
--> |
|||
<textobject> |
|||
<phrase>Shows properties dialog for separator item. |
|||
</phrase> |
|||
</textobject> |
|||
</mediaobject> |
|||
</screenshot> |
|||
</figure> |
|||
|
|||
</sect2> |
|||
|
|||
<!-- extra space --> |
|||
<para> </para> |
|||
|
|||
</sect1> |
|||
|
|||
<sect1 id="panel-advanced"> |
|||
<title>Advanced</title> |
|||
|
|||
<sect2 id="panel-config-files"> |
|||
<title>Configuration Files</title> |
|||
|
|||
<para>Xfce now uses the Basedir Specification as defined on <ulink |
|||
url="http://freedesktop.org">Freedesktop.org</ulink> to locate its |
|||
data and configuration files. This means that file locations will |
|||
be specified as a path relative to the directories described in |
|||
the specification. |
|||
</para> |
|||
|
|||
<variablelist> |
|||
<varlistentry> |
|||
<term>${XDG_CONFIG_HOME}</term> |
|||
<listitem><para>The first base directory to look for configuration |
|||
files. By default this is set to <filename |
|||
role="directory">~/.config/</filename>.</para></listitem> |
|||
</varlistentry> |
|||
|
|||
<varlistentry> |
|||
<term>${XDG_CONFIG_DIRS}</term> |
|||
<listitem><para>A list of system directories that contain configuration |
|||
data. By default the panel will look in <filename |
|||
role="directory">${sysconfdir}/xdg/</filename> and |
|||
<filename role="directory">/etc/xdg/</filename>. The value of |
|||
${sysconfdir} depends on how the program was build and will often be |
|||
<filename role="directory">/etc/</filename> for binary |
|||
packages.</para></listitem> |
|||
</varlistentry> |
|||
|
|||
<varlistentry> |
|||
<term><basedir>/xfce4/panel/panels.xml</term> |
|||
<listitem><para>This is the location of the xml configuration file |
|||
that describes the contents of the panel, relative to the base |
|||
directories metioned above.</para></listitem> |
|||
</varlistentry> |
|||
|
|||
<varlistentry> |
|||
<term><basedir>/xfce4/kiosk/kioskrc</term> |
|||
<listitem><para>Kiosk Mode configuration file. See <ulink |
|||
url="#panel-kiosk">below</ulink> for an explanation. |
|||
</para></listitem> |
|||
</varlistentry> |
|||
|
|||
</variablelist> |
|||
|
|||
<para>None of the configuration files, except |
|||
<filename>kioskrc</filename> , are designed to be edited by hand; in |
|||
fact the changes will be overwritten if you edit them while the panel |
|||
is running. |
|||
</para> |
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="panel-data-files"> |
|||
<title>Data Files</title> |
|||
|
|||
<para>The Xfce Panel will look under the data directories specified by the |
|||
Basedir Specification for data files, such as panel plugin description |
|||
files. |
|||
</para> |
|||
|
|||
<variablelist> |
|||
<varlistentry> |
|||
<term>${XDG_DATA_HOME}</term> |
|||
<listitem> |
|||
<para> |
|||
The first base directory to look for panel plugin files. By |
|||
default this is set to <filename |
|||
role="directory">~/.local/share/</filename>. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
|
|||
<varlistentry> |
|||
<term>${XDG_DATA_DIRS}</term> |
|||
<listitem> |
|||
<para>A list of system directories that contain data files. By |
|||
default this is <filename role="directory">/usr/share</filename> |
|||
and <filename role="directory">/usr/local/share</filename>. |
|||
</para> |
|||
</listitem> |
|||
</varlistentry> |
|||
</variablelist> |
|||
|
|||
</sect2> |
|||
|
|||
<sect2 id="panel-kiosk"> |
|||
<title>Kiosk Mode</title> |
|||
|
|||
<para>The panel now has support for Kiosk Mode, that will prevent users |
|||
from making changes to their panel configuration. To use it you have to |
|||
edit or create the file |
|||
<filename>${sysconfdir}/xdg/xfce4/kiosk/kioskrc</filename>. |
|||
</para> |
|||
|
|||
<para>The best way to explain the format of this file is by using an |
|||
example. The xfce4-panel section of your kioskrc might look like this: |
|||
</para> |
|||
|
|||
<programlisting> |
|||
[xfce4-panel] |
|||
CustomizePanel=%powerusers,foo |
|||
</programlisting> |
|||
|
|||
<para>This allows only users in the group powerusers and the user foo to |
|||
customize their panels. |
|||
</para> |
|||
|
|||
</sect2> |
|||
|
|||
</sect1> |
|||
|
|||
<!-- extra space --> |
|||
<para> </para> |
|||
|
|||
<sect1 id="panel-copyright"> |
|||
<title>About &app;</title> |
|||
|
|||
<para>&app; was written by Jasper Huijsmans |
|||
(<email>jasper@xfce.org</email>). To find more information, please visit |
|||
the <ulink url="http://www.xfce.org" type="http">Xfce web site</ulink>. |
|||
</para> |
|||
|
|||
<para>To report a bug or make a suggestion regarding this application or |
|||
this manual, use the bug tracking system at <ulink |
|||
url="http://bugzilla.xfce.org/" |
|||
type="http">http://bugzilla.xfce.org/</ulink>. |
|||
</para> |
|||
|
|||
<para>If you have questions about the use or installation of this package, |
|||
please ask on the <ulink |
|||
url="http://foo-projects.org/mailman/listinfo/xfce" |
|||
type="http">xfce</ulink> mailing list. Development discussion takes |
|||
place on the <ulink |
|||
url="http://foo-projects.org/mailman/listinfo/xfce4-dev" |
|||
type="http">xfce4-dev</ulink> mailing list. |
|||
</para> |
|||
|
|||
<para>&app; is distributed under the terms of the |
|||
GNU General Public License as published by the Free Software Foundation; |
|||
either version 2 of the License, or (at your option) any later version. |
|||
</para> |
|||
|
|||
<para>You should have received a copy of the GNU General Public License |
|||
along with this program; if not, write to the Free Software |
|||
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
|||
USA. |
|||
</para> |
|||
|
|||
</sect1> |
|||
|
|||
</article> |
|||
@ -0,0 +1,11 @@ |
|||
SUBDIRS = \
|
|||
C |
|||
|
|||
noinst_DATA = \
|
|||
xfce-nochunk.xsl |
|||
|
|||
EXTRA_DIST = $(noinst_DATA) |
|||
|
|||
html: Makefile |
|||
for i in $(SUBDIRS); do make -C $$i html; done |
|||
|
|||
@ -0,0 +1,262 @@ |
|||
<?xml version='1.0'?> |
|||
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" |
|||
version='1.0' |
|||
xmlns="http://www.w3.org/TR/xhtml1/transitional" |
|||
exclude-result-prefixes="#default"> |
|||
|
|||
<!-- Load onechunk.xsl stylesheet |
|||
TODO: how can I put a location independent link here? |
|||
This should work. The url can be translated to a local one in the catalog |
|||
file" |
|||
--> |
|||
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/onechunk.xsl"/> |
|||
|
|||
<xsl:param name="suppress.navigation">1</xsl:param> |
|||
|
|||
<!-- Use stylesheet --> |
|||
<xsl:param name="html.stylesheet" select="'../xfce.css'"/> |
|||
|
|||
<!-- labels and numbering --> |
|||
<xsl:param name="autotoc.label.separator" select="'. '"/> |
|||
<xsl:param name="chapter.autolabel" select="1"/> |
|||
|
|||
<!-- Don't force the use of index.html as root filename --> |
|||
<xsl:param name="root.filename" select="''"/> |
|||
|
|||
<!-- Use element id (if present) as file name --> |
|||
<xsl:variable name="use.id.as.filename">1</xsl:variable> |
|||
|
|||
<xsl:template match="releaseinfo" mode="titlepage.mode"> |
|||
<span class="{name(.)}"> |
|||
<xsl:apply-templates mode="titlepage.mode"/> |
|||
<br/> |
|||
</span> |
|||
</xsl:template> |
|||
|
|||
<!-- Use graphics in admonitions (note, warning, etc) --> |
|||
<xsl:variable name="admon.graphics">0</xsl:variable> |
|||
|
|||
<xsl:param name="admon.style"> |
|||
<xsl:text>text-align: left;</xsl:text></xsl:param> |
|||
|
|||
<xsl:variable name="admon.graphics.path">stylesheet-images/</xsl:variable> |
|||
|
|||
<xsl:variable name="admon.graphics.extension">.gif</xsl:variable> |
|||
|
|||
<xsl:param name="table.border.thickness" select="'0.2pt'"/> |
|||
|
|||
<xsl:param name="graphic.default.extension" select="png"/> |
|||
|
|||
<!-- Addition by Jasper Huijsmans to be able to set background color --> |
|||
<!-- and cell attributes. --> |
|||
<!-- This requires an adapted template for tgroup (see end of stylesheet) --> |
|||
<xsl:attribute-set name="table.style"> |
|||
<xsl:attribute name="bgcolor">#F8F9FD</xsl:attribute> |
|||
<xsl:attribute name="cellspacing">0</xsl:attribute> |
|||
<xsl:attribute name="cellpadding">4</xsl:attribute> |
|||
</xsl:attribute-set> |
|||
|
|||
|
|||
<xsl:param name="generate.legalnotice.link" select="0"/> |
|||
|
|||
<!-- set font styles for various tags --> |
|||
<xsl:template match="guibutton"> |
|||
<xsl:call-template name="inline.boldseq"/> |
|||
</xsl:template> |
|||
|
|||
<xsl:template match="guiicon"> |
|||
<xsl:call-template name="inline.boldseq"/> |
|||
</xsl:template> |
|||
|
|||
<xsl:template match="guilabel"> |
|||
<xsl:call-template name="inline.boldseq"/> |
|||
</xsl:template> |
|||
|
|||
<xsl:template match="guimenu"> |
|||
<xsl:call-template name="inline.boldseq"/> |
|||
</xsl:template> |
|||
|
|||
<xsl:template match="guimenuitem"> |
|||
<xsl:call-template name="inline.boldseq"/> |
|||
</xsl:template> |
|||
|
|||
<xsl:template match="guisubmenu"> |
|||
<xsl:call-template name="inline.boldseq"/> |
|||
</xsl:template> |
|||
|
|||
<xsl:template match="application"> |
|||
<xsl:call-template name="inline.boldmonoseq"/> |
|||
</xsl:template> |
|||
|
|||
<xsl:template match="caption"> |
|||
<xsl:call-template name="inline.boldseq"/> |
|||
</xsl:template> |
|||
|
|||
<!-- Adapted template for tgroup. The only change is the addition of --> |
|||
<!-- table.style attributes --> |
|||
<xsl:template match="tgroup"> |
|||
<table xsl:use-attribute-sets="table.style"> |
|||
<xsl:choose> |
|||
<!-- If there's a <?dbhtml table-summary="foo"?> PI, use it for |
|||
the HTML table summary attribute --> |
|||
<xsl:when test="processing-instruction('dbhtml')"> |
|||
<xsl:variable name="summary"> |
|||
<xsl:call-template name="dbhtml-attribute"> |
|||
<xsl:with-param name="pis" |
|||
select="processing-instruction('dbhtml')[1]"/> |
|||
<xsl:with-param name="attribute" select="'table-summary'"/> |
|||
</xsl:call-template> |
|||
</xsl:variable> |
|||
<xsl:if test="$summary != ''"> |
|||
<xsl:attribute name="summary"> |
|||
<xsl:value-of select="$summary"/> |
|||
</xsl:attribute> |
|||
</xsl:if> |
|||
</xsl:when> |
|||
<!-- Otherwise, if there's a title, use that --> |
|||
<xsl:when test="../title"> |
|||
<xsl:attribute name="summary"> |
|||
<xsl:value-of select="string(../title)"/> |
|||
</xsl:attribute> |
|||
</xsl:when> |
|||
<!-- Otherwise, forget the whole idea --> |
|||
<xsl:otherwise><!-- nevermind --></xsl:otherwise> |
|||
</xsl:choose> |
|||
|
|||
<xsl:if test="../@pgwide=1"> |
|||
<xsl:attribute name="width">100%</xsl:attribute> |
|||
</xsl:if> |
|||
|
|||
<xsl:choose> |
|||
<xsl:when test="../@frame='none'"> |
|||
<xsl:attribute name="border">0</xsl:attribute> |
|||
</xsl:when> |
|||
<xsl:when test="$table.borders.with.css != 0"> |
|||
<xsl:attribute name="border">0</xsl:attribute> |
|||
<xsl:choose> |
|||
<xsl:when test="../@frame='topbot' or ../@frame='top'"> |
|||
<xsl:attribute name="style"> |
|||
<xsl:call-template name="border"> |
|||
<xsl:with-param name="side" select="'top'"/> |
|||
</xsl:call-template> |
|||
</xsl:attribute> |
|||
</xsl:when> |
|||
<xsl:when test="../@frame='sides'"> |
|||
<xsl:attribute name="style"> |
|||
<xsl:call-template name="border"> |
|||
<xsl:with-param name="side" select="'left'"/> |
|||
</xsl:call-template> |
|||
<xsl:call-template name="border"> |
|||
<xsl:with-param name="side" select="'right'"/> |
|||
</xsl:call-template> |
|||
</xsl:attribute> |
|||
</xsl:when> |
|||
</xsl:choose> |
|||
</xsl:when> |
|||
<xsl:otherwise> |
|||
<xsl:attribute name="border">1</xsl:attribute> |
|||
</xsl:otherwise> |
|||
</xsl:choose> |
|||
|
|||
<xsl:variable name="colgroup"> |
|||
<colgroup> |
|||
<xsl:call-template name="generate.colgroup"> |
|||
<xsl:with-param name="cols" select="@cols"/> |
|||
</xsl:call-template> |
|||
</colgroup> |
|||
</xsl:variable> |
|||
|
|||
<xsl:variable name="explicit.table.width"> |
|||
<xsl:call-template name="dbhtml-attribute"> |
|||
<xsl:with-param name="pis" |
|||
select="../processing-instruction('dbhtml')[1]"/> |
|||
<xsl:with-param name="attribute" select="'table-width'"/> |
|||
</xsl:call-template> |
|||
</xsl:variable> |
|||
|
|||
<xsl:variable name="table.width"> |
|||
<xsl:choose> |
|||
<xsl:when test="$explicit.table.width != ''"> |
|||
<xsl:value-of select="$explicit.table.width"/> |
|||
</xsl:when> |
|||
<xsl:when test="$default.table.width = ''"> |
|||
<xsl:text>100%</xsl:text> |
|||
</xsl:when> |
|||
<xsl:otherwise> |
|||
<xsl:value-of select="$default.table.width"/> |
|||
</xsl:otherwise> |
|||
</xsl:choose> |
|||
</xsl:variable> |
|||
|
|||
<xsl:if test="$default.table.width != '' |
|||
or $explicit.table.width != ''"> |
|||
<xsl:attribute name="width"> |
|||
<xsl:choose> |
|||
<xsl:when test="contains($table.width, '%')"> |
|||
<xsl:value-of select="$table.width"/> |
|||
</xsl:when> |
|||
<xsl:when test="$use.extensions != 0 |
|||
and $tablecolumns.extension != 0"> |
|||
<xsl:choose> |
|||
<xsl:when test="function-available('stbl:convertLength')"> |
|||
<xsl:value-of select="stbl:convertLength($table.width)"/> |
|||
</xsl:when> |
|||
<xsl:when test="function-available('xtbl:convertLength')"> |
|||
<xsl:value-of select="xtbl:convertLength($table.width)"/> |
|||
</xsl:when> |
|||
<xsl:otherwise> |
|||
<xsl:message terminate="yes"> |
|||
<xsl:text>No convertLength function available.</xsl:text> |
|||
</xsl:message> |
|||
</xsl:otherwise> |
|||
</xsl:choose> |
|||
</xsl:when> |
|||
<xsl:otherwise> |
|||
<xsl:value-of select="$table.width"/> |
|||
</xsl:otherwise> |
|||
</xsl:choose> |
|||
</xsl:attribute> |
|||
</xsl:if> |
|||
|
|||
<xsl:choose> |
|||
<xsl:when test="$use.extensions != 0 |
|||
and $tablecolumns.extension != 0"> |
|||
<xsl:choose> |
|||
<xsl:when test="function-available('stbl:adjustColumnWidths')"> |
|||
<xsl:copy-of select="stbl:adjustColumnWidths($colgroup)"/> |
|||
</xsl:when> |
|||
<xsl:when test="function-available('xtbl:adjustColumnWidths')"> |
|||
<xsl:copy-of select="xtbl:adjustColumnWidths($colgroup)"/> |
|||
</xsl:when> |
|||
<xsl:otherwise> |
|||
<xsl:message terminate="yes"> |
|||
<xsl:text>No adjustColumnWidths function available.</xsl:text> |
|||
</xsl:message> |
|||
</xsl:otherwise> |
|||
</xsl:choose> |
|||
</xsl:when> |
|||
<xsl:otherwise> |
|||
<xsl:copy-of select="$colgroup"/> |
|||
</xsl:otherwise> |
|||
</xsl:choose> |
|||
|
|||
<xsl:apply-templates select="thead"/> |
|||
<xsl:apply-templates select="tbody"/> |
|||
<xsl:apply-templates select="tfoot"/> |
|||
|
|||
<xsl:if test=".//footnote"> |
|||
<tbody class="footnotes"> |
|||
<tr> |
|||
<td colspan="{@cols}"> |
|||
<xsl:apply-templates select=".//footnote" |
|||
mode="table.footnote.mode"/> |
|||
</td> |
|||
</tr> |
|||
</tbody> |
|||
</xsl:if> |
|||
</table> |
|||
</xsl:template> |
|||
|
|||
|
|||
</xsl:stylesheet> |
|||
|
|||
Loading…
Reference in new issue