guifications/guifications.org

d99cfd6917e1
Parents c64fe2dd3cd9
Children 2e45dacda28c
Tweak a bunch of things on the guifications page
--- a/docs/guifications2.md Mon Feb 27 21:39:44 2023 -0600
+++ b/docs/guifications2.md Mon Feb 27 21:39:55 2023 -0600
@@ -27,7 +27,7 @@
## FAQ
-**Why are so many feature requests closed as "wontfix"?**
+### Why are so many feature requests closed as "wontfix"?
We are not interested in adding new features to Guifications 2.x currently.
Instead, our development efforts are focused on the Purple Plugin Pack and
@@ -36,7 +36,7 @@
feature may do so; we will review patches and are likely to accept them if they
are well-written and won't cause an excessive maintenance burden.
-**Why don't email notifications work?**
+### Why don't email notifications work?
This is a bit of a trick question. Technically they do work, just not how
everyone expects. Currently, if Pidgin is informed that you have precisely one
@@ -47,18 +47,18 @@
We do consider this to be a bug (see #371). It may, however, be quite some time
until we release a version in which this is fixed.
-**What happened to the Appearance page?**
+### What happened to the Appearance page?
The appearance page was removed in favor of its successor feature, themes.
-**What are themes?**
+### What are themes?
Themes define how notifications appear. After a few feature requests for them
and seeing a few screenshots of notifications with backgrounds and the
Appearance page settings for those notifications, Gary decided to actually
implement them. They're designed to be distributable.
-**Why can I load multiple themes at once?**
+### Why can I load multiple themes at once?
Gary likes variety, so he designed themes with variety in mind. The idea is
that themes can handle as many or as few notifications as the author wishes.
@@ -67,46 +67,47 @@
that theme. You can also right-click on a buddy or group and set a Guifications
Theme for the buddy or group.
-**Where did <insert pref name here> go?**
+### Where did <insert pref name here> go?
+
Eventually every application or plugin will end up with what we call
"preference bloat," where too many options exist. Generally some preferences
will get removed and the behavior will match sensible default values of those
preferences. These changes will be logged in the ChangeLog.
-**How do I change the font?**
+### How do I change the font?
Edit your theme or create a new one.
-**How do I install a theme?**
+### How do I install a theme?
There are two ways:
1. From the Pidgin buddy list window, go to the Tools menu and select Plugins.
- Find and select Guifications in the list, then click "Configure Plugin." Go
- to the Themes tab. Drag and drop a theme that is in a .tar.gz format archive
- onto the list of themes.
+ Find and select Guifications in the list, then click `Configure Plugin`. Go
+ to the Themes tab. Drag and drop a theme that is in a `.tar.gz` format
+ archive onto the list of themes.
1. Unpack the theme from its archive and place the resulting theme directory in
- .purple/guifications/themes. The location of .purple will, of course, depend
- on your environment.
+ `.purple/guifications/themes`. The location of `.purple` will, of course,
+ depend on your environment.
-**How can I change the default colors with a gtkrc?**
+### How can I change the default colors with a gtkrc?
-See the example .gtkrc-2.0. To use it, edit ~/.gtkrc-2.0 on Linux and UNIX or
-%APPDATA%\.gtkrc-2.0 on Windows, put what you want from the example in that
-file, save it, and restart Pidgin.
+See the example `.gtkrc-2.0`. To use it, edit `~/.gtkrc-2.0` on Linux and UNIX
+or `%APPDATA%\.gtkrc-2.0` on Windows, put what you want from the example in
+that file, save it, and restart Pidgin.
-**Why isn't CVS/SVN/MTN/HG supported?**
+### Why isn't CVS/SVN/MTN/HG supported?
-See this page on the subject.
+See [this page](faq/vcs.md) on the subject.
-**Why does Guifications disappear on WinPidgin upgrades?**
+### Why does Guifications disappear on WinPidgin upgrades?
This is a problem with the Pidgin installer. When you upgrade Pidgin with the
installer, it removes the old installation, including everything in Pidgin's
pixmaps directory and the directory Gufications' system-wide themes are stored
in. This means that you will need to reinstall Guifications. You should be
installing all themes to your user account's .purple/guifications/themes
-directory (generally %APPDATA%\.purple\guifications\themes, where %APPDATA% is
-an environment variable which automatically expands as appropriate on all
+directory (generally `%APPDATA%\.purple\guifications\themes`, where `%APPDATA%`
+is an environment variable which automatically expands as appropriate on all
modern Windows versions when used in Explorer's address bar or the Run box's
entry area), so that they will not get removed during an upgrade