==========================
README: For K-Meleon's "KMBeOS" for v0.8 and above.
==========================


TABLE OF CONTENTS:

How to change skins.
How to change enclosed background.
#1: My K-Meleon Button.
#2: Email Button.
#3: Toolbar "Helper" icons.
#3a: Search from URL address field using Google.
#3b: Google News.
#3c: Open Layer/Layer Closed.
#3d: Disabling Java Button. (Thanks to jsnj!)
#3e: Comclear Button.

Please read for file information, pertinent details, and thank yous.
                                                                                    ________________________________________


How to change skins:

* Extract the files into "C:\Program Files\K-Meleon\skins\KMBeOS" (You'll have to more than likely make the folder when unzipping).
* Open K-Meleon, go to Edit>Preferences>Display>Skin and select a skin from the list.
* Select "Show Toolbar Background". Click OK.
* Exit K-Meleon and loader if used. You will restart K-Meleon with the new skin.

How to change enclosed background:

This theme comes with two backgrounds, "back" (the traditional BeOS browser background) and "backup1" (a brushed-siler) and "backup2" (a rich wood-grain panel). The default is "back", the traditional background. To switch backgrounds simply use your file manager to go into C:\Program Files\K-Meleon\Skins\KMBeOS and change the name of "back.bmp" to "backup.bmp" and the desired background to "back", start K-Meleon and it will have that background (I prefer the brushed-silver myself). I do recommend, however, that if you make changes to your background skins that you make appropriate changes to your Window's colour scheme or this won't look "right".

You'll notice a lot of buttons in with this theme. I'm enclosing the macros here along with simple directions to make them operational. :o)
                                                                                     ________________________________________

#1: MY K-MELEON BUTTON:

Looking along the iconbar you'll notice several additions. A few of these will require macros. Netscape has the "My Netscape" button which I like and wanted in my browser to quickly reach the K-Meleon Homepage. In fact, when I load a theme I usually add this button. ;) IF YOU DON'T WANT THE BUTTON: Open "Edit/Preferences/Configs/Toolbars" and scroll down until you find "My K-Kmeleon". Starting in front of that until the "}" place these "#" in a descending column on the left. It'll look like this to better show you:

#   My K-Meleon{
#      macros(MyKMeleon)
#      My K-Meleon
#      toolhot.bmp[10]
#      toolcold.bmp[10]
#      tooldead.bmp[10]
#   }

Press "Ok" and a box will come up asking you if you'd like to save your changes. Press "Yes" and restart K-Meleon and the button will be gone. ;o) IF, however, you'd like that button to remain and to work, go to "Edit/Preferences/Configs/Macros" and scroll all the way to the bottom. Click in the box and press "enter" on the keyboard to make an extra space and copy/paste the following:

MyKMeleon {
   menu=My K-Meleom
   open("http://kmeleon.sourceforge.net/");
}

Again, press "Ok", a box will come up asking you to save, press "Yes", restart K-Meleon, and when you press that button it will take you to the homepage! :o)

Congratulations! You've just done your first macro if you've never done one before! Now, see how EASY it is to configure K-Meleon? And all this time you thought it was HARD! tsk, tsk!
                                                                                       ________________________________________

#2: EMAIL BUTTON:

Frequent question on the forum: "How do I hook up my email programme to work with K-Meleon?" Tada! I'm going to show you! Now this one LOOKS hard but it really isn't. And yes---this is the next button beside the "My K-Meleon" button. If you don't want it, go to "Edit/Preferences/Configs/Toolbars" and search for "Mail" in the lineup and carry out the instructions found in the "My K-Meleon Button" example. (I'm bound and determined that you'll read this file >wink<.) IF, however, you'd like to make this button operational there are several things you must do: First, open your file manager (like Explorer, 2xExplorer, etc.) and look for the proper pathway and name of your email exe file. Write it down! Then go to "Edit/Preferences/Configs/Macros" and copy/paste the following---remembering to leave a space between this and your last macro:

exec_Mail {
menu=&Mail Client
exec("\"C:\\Program Files\\Folder\\name of programme.exe\"");
}

So let's say it's GoofyMail and made by Mickey company, okie? The pathway would look thus: ("\"C:\\Program Files\\Mickey\\GoofyMail.exe\""); provided it was actually in a subfolder by the name of "Mickey", etc. Pay VERY STRICT ATTENTION to this detail or this macro will not work! If you do though you'll see it's actually easier than you thought. :o)

Now, let's be able to call our email programme up with a keyboard shortcut as well, shall we? Let's go back into "Edit/Preferences/Configs/Accelerators" and at the bottom---remembering to leave a space once again---copy/paste in the following:

%ifplugin macros
CTRL M = macros(exec_Mail)
%endif

Remember to save, but we're still not done so don't restart K-Meleon just yet. What this shortcut allows you to do is press Ctrl+M and it'll open your email programme. Neat!

Now some people like to also call up their email client from the drop-down menubar. I have mine in "File" between "Save As" and "Print". This is what you copy/paste there:

 - 
%ifplugin macros
   macros(exec_Mail);
 %endif

Remember that little "-" if you want a seperate line to set it off between the "Save As" and the "Print". In other words, make sure there's one before and after this shortcut. And NOW save all of your work, exit K-Meleon, restart, and try out your shortcuts and button to see if they work. If not, re-check everything again CAREFULLY. Usually it's just something as simple as the pathway to your email programme being off by a letter. If it DID work, congratulations! You've made a mini-browser suite and your life a whole lot easier! :o)
                                                                                          ________________________________________

#3: TOOLBAR "HELPER" ICONS:

#3a: SEARCH FROM URL ADDRESS FIELD USING GOOGLE:

I've removed the "Search" icon from the iconbar as I like doing my searches from the URL bar, like in Mozilla/Firefox. So I've added the search there. Type in a word in the URL bar, press the "Flashlight" icon and this will search Google. Again, if you do NOT wish to have this icon the procedure for removal is covered in "MY K-MELEON BUTTON" above. If you choose to use it go to "Macros" (by now you should know where it's located? "Edit/Preferences/Configs/Macros") and copy/paste the following macro---remembering to leave a space from your last macro:

search_button {
    $google = "http://www.google.com/search?q=";
    $oldclip = getclipboard();
    id(ID_SELECT_URL);
    id(ID_EDIT_COPY);
    $query = getclipboard();
    setclipboard($oldclip);
    open($google . $query);
}

Save this, restart K-Meleon, and the search button will work. Give it a try! :o)

(The standard iconbar "Search" is still located on the menubar under "Go" and will bring up a search box FYI.)
                                                                                                ________________________________________

#3b: GOOGLE NEWS:

Yes, that's what the "Globe" is in this theme. Now while I myself don't keep up much on the news, occasionally when I do my news page of choice is Google News and I thought this would make a great addition. :o) If you've been reading through this Readme/Help File then you'll know how to disable it as discussed in #1: "MY K-MELEON BUTTON". If you wish to use it, however, go into macros and paste the following:

open_News {
   menu=Google News
   open("http://news.google.com/");
}

Of course, by now I suspect that you're getting pretty good at these macros so you'd know how to change that URL to open any other News Service, or website that you'd like. Maybe ebay? If you DO change it, make sure that you go into "Toolbars" and change the "Display Name" line to read appropriately. The "Display Name" would be "Google News" before "toolbars.bmp3".
                                                                                             ________________________________________

#3c: LAYER OPEN/LAYER CLOSED:

This HAS to be one of THE MOST asked questions on the forum when it comes to adding buttons I think! :o) "How can I add a simple button to open and close my 'tabs'?" We'll handle them both together since I doubt anyone will want to add one without the other. Disabling these is done the same way as any toolbar button as the example discussed in #1: "MY K-MELEON BUTTON". If you wish to keep and use these---and trust me, they are HANDY!---copy/paste the following into macros, remembering to leave a space before your last macro added:

close_layer {
      %ifplugin layers
      plugin(layers,Close)
      %endif
}

open_layer {
      %ifplugin layers
      plugin(layers,Open)
      %endif
}

Save your changes/additions, restart K-Meleon, and your new "Tab" buttons should work. Hey! Okie, so they're layers. Sue me! I come from a long line of tabbed browsers. ;o) I even changed them in User.js by adding this setting to read "Tabs": user_pref("kmeleon.plugins.layers.title", "Tabs:"); MAKE SURE you copy the entire line from "user" to ";" and go to: "Edit/Preferences/Settings/User.js" and place it there. ;o) And now once you restart K-Meleon you'll have a "tabbed" browser and no one will know the difference but YOU and other K-Meleon users. --ahem!--

Sidenote: The "Open Layer/Close Layer" in this theme come from one joined file and as such cannot be separated so as to have "Open" at one end and "Close" at the other end as seen in some themes. (Eyes-Only)

________________________________________

#3d: DISABLING JAVA BUTTON:

jsnj of the K-Meleon Homepage forums provided up with a button that enables up to disable java upon request. Sometimes I've noted that this comes in handy, especially if you're speed-browsing just for quick information---when you need to find it fast and not wait for java to open up. This button is the little coffee cup (Neat, yes?). One note: Press in and java works. Unpressed and java does NOT work. This confused me a little at first so I thought I'd pass this along. Just think this: "Steaming coffee: Java works. Empty cup: No java."

This button is a little harder to hook up as it HAS to go in a special place in macros in order for it to work, for K-Meleon to read it. You are going to look for a macro that starts with "PGToggle{" after the "}" you are to skip a space and paste in the following macro:

JSToggle{
$tmp = (getpref(BOOL, $jscript) ? false : true);setpref(BOOL, $jscript, $tmp);
statusbar("JavaScript " . ($tmp ? "ENABLED" : "DISABLED"));&buttonSync;
}

Make SURE that you leave a space between this and the next macro which will start with "ImgToggle{".

Remember! Save your changes! ;)

________________________________________

#3e: COMCLEAR BUTTON:

You'll notice in this theme that there is a little BeOS "trashcan" on the toolbar. A lot of people like to clear their cookies and cache after closing their browser. In the forum there are several ways mentioned to do this. Some are .bat files but I've never had success getting these to work 100% of the time. Alain, one of our members, does put out a "CookieMonster" programme. But this programme takes care of BOTH. (It's also supposed to clear the history but has a bug and doesn't for some reason.) Though developed for Netscape it works for any Gecko-based browser. It's called "ComClear" and may be obtained from this URL: http://www.neuro-tech.net/

Install ComClear to "C:\Program Files\Comclear" for the following macro to work properly.

In the Macro section of "Config" add this at the bottom of your list making sure that you leave a space between your last macro and this one:

exec_ClearCache {
exec("\"C:\\Program Files\\Comclear\\Comclear.exe\"");
}

If you've added ComClear to the directory in Program Files which I've directed then before closing your browser click on the trashcan. ComClear will come up. Before you can use it the first time you'll need it to scan for your "Profile Directory". Check the first four boxes to the right, and then press the button marked "Rescan". This will find ANY profile directories on your computer for a Gecko-based programme (So this is great to use with Netscape, Mozilla, K-Meleon and Firefox!). Once it has finished scanning they will show up in the window. Select the COMPLETE pathway, as sometimes it doesn't do so, and---making SURE that your browser is CLOSED, press the button that says "Clear". A GUI will come up afterwards telling you "Ok", or something like that, meaning that the directories have been cleared.

From now on all you will need do is before closing the browser click on the trashcan, THEN close K-Meleon, press the "Clear" button, and your cookies, drop-down field, and cache will be completely cleared! :) Very simple, yes? I knew you'd agree! In fact, I've even made a shortcut to ComClear on my "Quick Launch" menu so that I can use this for my Netscape, Mozilla, and Firefox browsers---I like it that much!

This programme is no longer being supported nor updated. If you are unable to download it then let me know and I'll make arrangements so you can download it from my server.

________________________________________

PLEASE READ FOR FILE INFOMATION, PERTINENT DETAILS, AND THANK YOUS:

Base iconbar icons and some menu icons from the skin "BeOS for MyIE" by Toxi with alterations by me (Eyes-Only/L'Peau-Rouge) and found at: http://www.skinnable.com/myie2/skins.asp
Other icons obtained from a BeOS skin for Firebird by Lynchknot and available from his website at: http://home.comcast.net/~lynchknot/phoenix.html
"Brushed-Silver" originally from Lynchknot's many assorted themes for Mozilla Firebird and found at: http://home.comcast.net/~lynchknot/phoenix.html
Throbber by Al for Mozilla! theme by Rapido for K-Meleon and likewise available in the throbber section for free and both may be found at: http://kmeleon.sourceforge.net/
Any other icons not attributed to a source may have been made by me (Eyes-Only/L'Peau-Rouge). Heck if I know---I have a bad memory. But I did make several for this theme.

K-Meleon Homepage: http://kmeleon.sourceforge.net/
Eyes-Only Homepage (where I'm known as "jimmymac"): http://eyesonly.no-ip.info/jimmymac/ Here you can learn more about me, my interests and hobbies, artwork, physical illnesses, and a whole lot more. :o)
My email: LeSauvage@eyesonly.no-ip.info (Down on Sundays between 21:00hrs to 21:30hrs EST for system maintenance). I will TRY to answer all questions but it's best to ask on the K-Meleon Homepage being VERY specific as to what the problem is and the macro, etc, with which you are working. I have a serious memory problem and this is NOT a joke.

FOR THANKS:

I would like to thank the Great Spirit for giving me each day of Life and for the gift of my grandson, Isaac James, who has inspired me to continue living despite great pain and sickness.

I would like to thank Lynchknot, Aaron and Mr. Kayser, who have been a great inspiration to me in my theming---even if it wasn't browsers for which I themed. They are not only the Greatest Masters in their fields, but true artists in every sense of the word. Thank you gentlemen!

I would like to thank the hard-working Devs and beta-testers who continue to put out K-Meleon, which in my humble opinion, is the very best browser in the field today. It is through your diligence, continued work and patience that you have kept this project not only alive---BUT THRIVING! And all of you know who you are, from the greatest to the smallest, as you ALL play a priceless part.

To ALL of you who encouraged me to finish this: THANKS! It's been fun! I just wished I could've been quicker for YOU!

(This theme is not copyrighted or anything. Have a go at it people and change it in ways unimaginable! That's the whole fun of learning how to theme! Have fun---Life is too short to quibble over who made what. In 100 years who's going to give a rat's behind anyway?)