<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN"> <HTML LANG="en"> <HEAD> <META NAME="Author" CONTENT="Emil Brink, emil@obsession.se, 27-Aug-1998"> <META NAME="Design and HTML" CONTENT="Ulf Pettersson, ulf@obsession.se, 29-Sep-1998"> <META NAME="Copyright" CONTENT="May be redistributed and changed according to the GNU General Public License. See gpl.html" LANG="en"> <META NAME="Keywords" CONTENT="gentoo, Obsession, Emil Brink, filemanager, GTK+, Linux, file management, graphical configurability, Ulf Pettersson, Johan Hanson, files, copying, Obsession Development, " LANG="en"> <META NAME="Description" CONTENT="gentoo Documentation and User Manual. gentoo is a highly configurable graphical filemanager for Linux and other Unix-operating systems." LANG="en"> <META NAME="Resource-Type" CONTENT="document"> <META HTTP-EQUIV="Content-Type" CONTENT="text/html, charset=iso-8859-1"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="Toc" HREF="index.html"> <LINK REL="Next" HREF="cfg_types.html"> <LINK REL="Previous" HREF="gentoorc.html"> <LINK REL="Stylesheet" HREF="../gentoo.css" TYPE="text/css"> <TITLE>gentoo Documentation: File Style Configuration</TITLE> </HEAD> <BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#33EE33" VLINK="#EF8210" ALINK="#FFFF00"> <TABLE BORDER="0" WIDTH="100%"> <TR> <TD HEIGHT="90" VALIGN="Middle"><A HREF="../index.html"><IMG SRC="../images/gentoo_logo_g.gif" WIDTH="50" HEIGHT="50" ALT="Back to Table of Contents" VSPACE="8" HSPACE="32" BORDER="0"></A><IMG SRC="../images/gentoo_logo_text.gif" WIDTH="200" HEIGHT="55" ALT="gentoo - A Click-Ass Filemanager" BORDER="0"></TD> <TD ALIGN="CENTER"> </TD> <TD ALIGN="RIGHT" VALIGN="Middle"> <A HREF="http://www.obsession.se/"><IMG SRC="../images/od__logo_small.gif" WIDTH="64" HEIGHT="61" HSPACE="32" ALT="Go to Obsession Developments Homepage" BORDER="0"></A> </TD> </TR> </TABLE> <TABLE WIDTH="100%" CELLSPACING=0 CELLPADDING=2 BORDER=0 STYLE="background: #000000; text-align: center;"> <TR> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../gpl.html" TITLE="License - How to distribute this software">LICENSE</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../relnotes.html" TITLE="Release Notes - Notes regarding this release">NOTES</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../quick.html" TITLE="Quick Guide - A quick guide to the basic concepts of gentoo">GUIDE</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../intro.html" TITLE="Introduction - Why another filemanager?, The features and goals of gentoo ">INTRO</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"> <A HREF="../usage.html" TITLE="Usage - How to use gentoo">USAGE</A></SMALL></TD> <TD CLASS="Section"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../config/index.html" TITLE="Configuration - How to configure gentoo">CONFIG</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../history.html" TITLE="History - History of changes between versions">HISTORY</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../contribute.html" TITLE="Contribute - Help making gentoo a better filemanager">CONTRIBUTING</A></SMALL></TD> <TD CLASS="Select"><SMALL STYLE="font-weight: bold; font-size: 10px; font-family: Arial, Helvetica, sans-serif;"><A HREF="../acks.html" TITLE="Acknowledgements - Who made gentoo?, Thanks">ACKS</A> </SMALL></TD> </TR> </TABLE> <H1>File Style Configuration</H1> <IMG SRC="../images/tone.gif" WIDTH=175 HEIGHT=18 BORDER="0"> <H2>Introduction</H2> <P> You use <EM>file styles</EM> to control the way files of different <A HREF="../types.html">types</A> are displayed and generally dealt with. For more information about styles and their various properties, the tree structure applied to styles, and all other fun details, check out the <A HREF="../styles.html"> styles</A> chapter! </P> <P> Configuring styles is important in order to get <STRONG>gentoo</STRONG> to look the way you want it to, and also to <EM>act</EM> the way you want it to. </P> <H2>Styles Configuration in Pictures</H2> <P> Here's two (cropped) pictures how what the file styles configuration page looks like. The picture to the left shows the page as it looks when no style has been selected, while the right hand picture shows it with a style ("Root") selected. </P> <DIV> <IMG BORDER="0" SRC="../images/cfg_styles.gif" WIDTH=512 HEIGHT=429 ALT="The styles config page (no selection)"> <IMG BORDER="0" SRC="../images/cfg_styles2.gif" WIDTH=511 HEIGHT=430 ALT="The same, but with a selection"> </DIV> <H3>The Tree View</H3> <P> The dominant part of the style page is taken up by a single widget; a display of the style tree. The tree widget is hopefully more or less selfexplanatory; it shows the different styles and the parent-child relationships between them. You can click on the (tiny) boxes to the left of an item to show or hide its children. The default is to expand the tree fully, showing all styles. </P> <P> The styles are listed in alphabetical order on each tree level, to make finding a certain style a little easier. </P> <H3>The Name and Parent Fields</H3> <P> Right below the tree view, there's a text entry widget labeled "Name". Not surprisingly (I hope), that's where you enter the name of the style. The name of a style must always be unique, since the name is used to link styles to types. When you edit the style name, <STRONG>gentoo</STRONG> will ignore any changes that make the name a duplicate, keeping the last unique name. This might seem confusing, but chances are you'll never even notice it. </P> <P> Under the name entry widget, there's another text entry widget, this time labeled "Parent". Unlike the name, you can't edit the parent name directly; the widget is used just to display the name. To change the parent of a style, click the tiny button labeled with the ellipsis. This will open up a dialog window where you can choose a new parent style. None of the current style's children will be in the dialog, of course. Once you change the parent, the tree display changes to reflect the new hierarchy. </P> <H2>The Properties Frame</H2> <P> The rest of the page is taken up by a big frame labeled "Preperties". It gives you a chance to edit and view the style's properties. Properties are <EM>inherited</EM> from parent to child, so when editing a style high up in the hierarchy, the changes might be visible far down. You can always click on a style to see its current property values. </P> <P> Each property has a check button; if the button is active (I would say "checked", but GTK+ doesn't render check buttons with check marks in them), that means that the property in question is being <EM>overridden</EM> by the current style; i.e. the parent's value is <EM>not</EM> being used. When a property is overridden, the style provides its own value for the property. When you deactivate an override check button, the style reverts to using its parent's value for the property in question. </P> <P> In the right picture above, you can see that all the check buttons are indeed active, but also that they are "insensitive"; you can't manipulate them. This is simply because the style selected is the root style; it <STRONG>must</STRONG> always override all properties, since it has no parent to inherit values from. </P> <H2>Visual Properties</H2> <P> There are 6 different <EM>visual</EM> properties, divided into two groups: unselected and selected. Since the meaning and use of these has been covered in the <A HREF="../styles.html">styles</A> chapter, I won't repeat that here. I'll just tell you what you can do when configuring a style's visual properties. </P> <H3>Preview List</H3> <P> The list containing the rows "Unselected" and "Selected" is the <EM>style preview</EM>. It shows how the current visual property values would look in a pane. The preview is not interactive. </P> <P> Below the preview are two sets of property editing frames; one for the unselected state and one for the selected. Each frame contains widgets to control override and value of the three state-specific properties (background and foreground colors, and icon). </P> <H3>Setting a Color</H3> <P> To set a color property, first make sure its override button is active. When active, the "Edit..." button becomes available. Clicking it opens up the GTK+ standard <A HREF="../images/colsel.jpeg"> color selection</A> window. Manipulate the widgetry in this window until you find a color you like, and accept the changes by clicking the "OK" button. While manipulating, watch the preview as it updates to show an accurate preview. </P> <H3>Setting an Icon</H3> <P> To set an icon property, click the "Pick..." button (after making sure that the style being edited actually does override the property in question, of course). This brings up (after a small delay during which you get to view a nice progress indicator) an <A HREF="../images/iconsel.gif"> icon selection</A> window. Select an icon and click OK, and the style is modified. It's as simple as that. Currently, there's no "active preview" while choosing icons, but you really shouldn't need one IMO. </P> <H3>Convenient Copiers</H3> <P> Between the unselected and selected property frames is a narrow frame labaled "Copy>>". It contains some buttons that can be used to perform often-wanted operations a bit faster. The buttons are: </P> <DL> <DT>FG Invert</DT> <DD>This copies the unselected foreground color to the selected <STRONG>background</STRONG>, thus creating the normal inverted look used to indicate selection. It also activates the selected foreground override, of course.</DD> <DT>FG+BG Invert</DT> <DD>Clicking this first does a "FG Invert" as described above, then also copies the unselected background color to the selected <STRONG>foreground</STRONG>. This creates a "full inversion" of the colors.</DD> <DT>Icon</DT> <DD>This copies the setting of the unselected icon to the selected icon. You generally want to click this, unless you're being extravagant and use different icons for the two states.</DD> </DL> <H2>Action Properties</H2> <P> Again, the concept of action properties has been explained in the <A HREF="../styles.html"> styles</A> chapter, here we'll concentrate on how you go about setting them to values you like. The first thing you need to do is access the action properties notebook page; you do this by clicking the tab labeled "Action". The display then changes to look something like <A HREF="../images/cfg_styles3.gif"> this</A>. </P> <P> The action property notebook page contains one row for each available action property. To the left is a check button which you use to control override, as usual. Next on the row comes a simple "preview" of the action command sequence; it'st just a list of commands. Not very useful, but I wanted to put something there, to fill out the window a bit. <CODE>;^)</CODE> The last thing on the row is an "Edit" button, which when pressed brings up the standard command sequence editor. </P> <P> That's basically it. </P> <H2>Adding and Deleting Styles</H2> <P> Of course, style editing wouldn't be so interesting if you only had the two styles shown in the screenshots here to work upon. Of course, you want to add your own styles, and experiment. </P> <H3>Adding a Style</H3> <P> To add a new style to the tree, click the "Add" button (surprise!). If no style was selected when you clicked, the new style will be added with "Root" as its parent. If a style was selected, it will be used as the parent. The new style appears in the tree under the temporary name "(New Style") or something similar; make sure you change this to your wanted, unique, name as soon as possible. </P> <H3>Deleting a Style</H3> <P> To delete a style, select it in the tree, then hit the "Delete" button. If the style selected is a parent, a dialog box will appear requesting you to confirm that you really want to delete it, since deleting a parent style <EM>deletes all the children too</EM>! Beware. Of course, you cannot delete the Root style. </P> </BODY> </HTML>