guifications/guifications.org
Add the guifications2 theme howto
This is a straight of a recent build from the repository
--- a/docs/guifications2/index.md Mon Feb 27 22:43:21 2023 -0600
+++ b/docs/guifications2/index.md Mon Feb 27 22:44:32 2023 -0600
@@ -27,4 +27,4 @@
Themes are the only thing still located on SourceForge. They are available in
this [tracker](https://sourceforge.net/p/guifications/themes/).
-Here is the Theme Howto for those interested in developing themes.
+Here is the [Theme Howto](theme_howto/) for those interested in developing themes. Binary file docs/guifications2/theme_howto/images/item_delete.png has changed
Binary file docs/guifications2/theme_howto/images/item_icon_page.png has changed
Binary file docs/guifications2/theme_howto/images/item_image_page.png has changed
Binary file docs/guifications2/theme_howto/images/item_new.png has changed
Binary file docs/guifications2/theme_howto/images/item_text_page.png has changed
Binary file docs/guifications2/theme_howto/images/notification_new.png has changed
Binary file docs/guifications2/theme_howto/images/notification_page.png has changed
Binary file docs/guifications2/theme_howto/images/theme_editor.png has changed
Binary file docs/guifications2/theme_howto/images/theme_info.png has changed
Binary file docs/guifications2/theme_howto/images/theme_ops.png has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/index.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,241 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +>Guifications Theme Howto</TITLE +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="The Theme Editor" +>Guifications Theme Howto</A +HREF="mailto:grim@reaperworld.com" +>grim@reaperworld.com</A +>Editing Theme Information</A +>Editing Theme Options</A +>Creating Notifications</A +>Editing Notifications</A +>Deleting Items and Notifications</A +> This guide was written to help new theme authors get a good start + on understanding the capabilities of the theme editor. + Unfortunately it is not very intuitive, but I hope to make it a bit + easier to work with as time goes on. +> This guide is not meant to be comprehensive, it's focus is on the + use of the Guifications theme editor and nothing more. +SUMMARY="Footer navigation table" \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x105.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,157 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +>Figure 8. Image Page</B +SRC="images/item_image_page.png"></P +> Images have one unique attribute which is the image to display. + Guifications supports any image format that Gtk supports, which + gives you quite a range to choose from. However, if you are + planning on distrubuting your theme, then you'll probably want to + stick to the formats that Gtk supports internally. +SUMMARY="Footer navigation table" \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x111.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,325 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="Deleting Items and Notifications" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +SRC="images/item_text_page.png"></P +> Text has five atrributes that you can modify. The first is the + format string to use (See the table below for specifics). Width + allows you to set a maximum width for the text. If the width is + zero or greater than the width of the notification it will + automatically be set to the width of the notification minus the + position of the text. Clipping allows you to decide what happens + when all of the text will not fit. You have four options for when + this occurs. You can either truncate the text, or put an ellipsis + at the beginning, middle, or end. The text that is used for the + ellipsis can be modified within the theme options page. Lastly, + there is font and color, which modify the text's font and color +>Table 2. Format Tokens</B +>The conversation title</TD +>The conversation name</TD +>Date formatted using the theme option</TD +>The day of the month</TD +>Your public IP address</TD +>Buddy's name (following preferences for aliases)</TD +>Time formatted using the theme option</TD +>Seconds since the epoc</TD +>The name of who warned you (Does this even work?)</TD +>Your warning level or the theme option</TD +>Extra info (needs clarification)</TD +>Year without century</TD +SUMMARY="Footer navigation table" +>Deleting Items and Notifications</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x193.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,158 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +>Deleting Items and Notifications</TITLE +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +>11. Deleting Items and Notifications</A +>Figure 10. Delete Window</B +SRC="images/item_delete.png"></P +> When you click the delete button in the toolbar when an item or a + notification is selected you will be presented with this dialog. + This is your last chance to keep your item or notification, since + currently there is no undo functionality. If you delete an item or + a notification, there is no way to restore it, except by manually +SUMMARY="Footer navigation table" \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x199.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,144 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="Deleting Items and Notifications" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +> Once you have populated your theme with a fair ammount of + notifications and items, hit the save button in the toolbar. + Guifications will notice when this happens and update the theme + list in preferences if you have it open. From the themes list you + can load your theme, and see it in action! +SUMMARY="Footer navigation table" +>Deleting Items and Notifications</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x202.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,156 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +> Guifications has always been about user customization, and with the + introduction of themes in 2.x it has been taken to a new level. I + love seeing people submitting new themes as well. You can always + submit your themes to the +HREF="http://sf.net/tracker/?atid=676821&group_id=92888&func=browse" +> If you have any questions or comments, please don't be afraid to + ask. You can always find us in #guifications on irc.freenode.net, + or by sending an email to +HREF="mailto:guifications-devel@lists.guifications.org" +>guifications-devel@lists.guifications.org</A +> I hope this tutorial has been helpful, and as always, thank you for +SUMMARY="Footer navigation table" \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x23.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,247 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +>The Theme Editor</TITLE +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="Guifications Theme Howto" +TITLE="Editing Theme Information" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +>Figure 1. The Theme Editor</B +SRC="images/theme_editor.png"></P +> This is the theme editor, the user interface is pretty clunky, but + it is slowly getting better over time. +> Across the top, there is a menu bar where you can add and remove + items and notifications. On the left is the actual tree that makes + up the theme. It starts with the theme itself, which contains + information, options and notifications, while notification contain + items. If that didn't sit well with you, don't worry it will all + become clear throughout the rest of this howto. On the right you + will be doing the majority of your editing. This area is used to + update probably more settings than you'd expect. +>Creates a new theme.</TD +>Saves the current theme.</TD +>Creates a new notification.</TD +>Creates a new item.</TD +> Creates a duplicate of a notification or an item. +>Deletes a notification or an item.</TD +> Moves a notification or an item up in the list. + While the order of notifications has no impact on + how Guifications treats the theme, it can be handy + Items however, are drawn in the order that they are + in the theme. So, if you wanted to create a layer + effect, or add drop shadows, you can do that by + making sure your shadow is above the actual item + that it is a shadow for. +> Moves a notification or an item down in the list. +>Brings you to this tutorial.</TD +SUMMARY="Footer navigation table" +>Guifications Theme Howto</TD +>Editing Theme Information</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x61.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,160 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +>Editing Theme Information</TITLE +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="The Theme Editor" +TITLE="Editing Theme Options" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +>3. Editing Theme Information</A +>Figure 2. Theme Information Page</B +SRC="images/theme_info.png"></P +> This is the theme information page. Here you can set some basic + information about your theme. These fields should be + self-explanatory, so they will not be discused further. +> NOTE: Theme names MUST be unique to not only avoid confusion in the + theme list, but they are used to create the directory for new +SUMMARY="Footer navigation table" +>Editing Theme Options</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x68.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,164 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +>Editing Theme Options</TITLE +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="Editing Theme Information" +TITLE="Creating Notifications" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +NAME="page-theme-options" +>4. Editing Theme Options</A +>Figure 3. Theme Options Page</B +SRC="images/theme_ops.png"></P +> The time and date formats follow the strftime format. A simple + google search for 'strftime' or a 'man 3 strftime' on Unix should + be able to help you there. +> Warning is the text to display if a text item contains a %w and the + protocol for the notification does not support warning levels. + This would be any protocols besides AIM or ICQ. +> Ellipsis is the text to use when clipping text. If your clipping + format for text items is set to truncate this option has no effect. +SUMMARY="Footer navigation table" +>Editing Theme Information</TD +>Creating Notifications</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x76.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,173 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +>Creating Notifications</TITLE +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="Editing Theme Options" +TITLE="Editing Notifications" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +NAME="window-notification-new" +>5. Creating Notifications</A +>Figure 4. New Notification Window</B +SRC="images/notification_new.png"></P +> When you click on the new notification button in the toolbar, you + will be presented with this window. It contains a dropdown of all + of the currently available notifications, as well as a master +> A master notification is used as a template for any notifications + created after it. When you create a new theme, a master + notification will automatically be created for you. If you know + your theme is going to look basically the same for all + notifications, you can create a master notification that already + has a background image set, contains some text, and any other +> You can add as many notifications of as many types as you want. + When an event happens, Guifications looks at all the loaded themes, + checks how notifications of that type that they have, and chooses + one at random to display. This gives another level to + customization, since you do not have to create another theme if you + want to make the same notifications have subtle differences. +SUMMARY="Footer navigation table" +>Editing Theme Options</TD +>Editing Notifications</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x84.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,171 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +>Editing Notifications</TITLE +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="Creating Notifications" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +NAME="page-notification" +>6. Editing Notifications</A +>Figure 5. The Notification Page</B +SRC="images/notification_page.png"></P +> In the notification page, you will create the basic look of your + notification. You can have it fit in with your gtk theme by + checking the 'Use Gtk theme background' or you can choose to use + an image. Guifications supports 1-bit alpha which you can use to + create non-rectangular notifications. +> If you choose to use the Gtk theme's background, you can decide how + big you want the notification. If you decide that you want to use + an image as the background, the notification size will be set to + the size of the image. If the image is non-rectangular, it will + still use the resolution of the image. +> The alias entry has been added for those of you that would like to + support multiple notifications of the same type in a theme. By + using aliases, you can tell at a glance which notification is + which. Hopefully this will prove to be useful for someone besides +SUMMARY="Footer navigation table" +>Creating Notifications</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x92.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,158 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +TITLE="Editing Notifications" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +>Figure 6. New Item Window</B +SRC="images/item_new.png"></P +> Similar to the new notification window, the new item window + presents you with a list of all the currently available items. + Notifications can contain as many items as many times as they want. + You can use this, with the order they are in to have text overlay + icons and images, or to add drop shadows, or anything else you can +SUMMARY="Footer navigation table" +>Editing Notifications</TD \ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/guifications2/theme_howto/x98.html Mon Feb 27 22:44:32 2023 -0600
@@ -0,0 +1,168 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd"> +CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK +TITLE="Guifications Theme Howto" +SUMMARY="Header navigation table" +>Guifications Theme Howto</TH +SRC="images/item_icon_page.png"></P +> All items have three common attributes. These are position, + horizontal offset, and vertical offset. Guifications does not + place items like most people are used to. You select a general + position of where the item will be placed (Top Left, Center, + Bottom Right, etc) and then place it exactly where you want it by + using the horizontal and vertical offsets. As you can see in the + screen shot, the offsets can also be used as percentages. All + items use the notification's height and width to calculate the + values of the percentages. +> Icons have two unique attributes. These are type and size. The + type is what type of icon to show, which includes protocol, status, + and buddy icon. Size is the size to scale the icon too. You can + choose from some previously defined values between 16x16 all the +SUMMARY="Footer navigation table" \ No newline at end of file