Introduction

Included in the realmacros.py file is a function called smiley. This macro puts funky smilies into your blog.

It uses a modified version of smiley.py by Mark Andrews. It also requires the path module. These are both included in the modules directory. You should keep this directory in the same place as realmacros.py. If you move them elsewhere you should make sure they are on the Python search path [1]. If you don't know what I'm on about then leave them where they are.

To use this macro, you'll need to put in the path from realmacros.py to the smilies directory. You'll also need to put in the URL of the smilies. This means editing the line that looks like :

The Smilies

To use the smilies you use the smiley macro. This can be either {smiley;SMILEY} or the shorter form {sm;SMILEY}. Replace SMILEY with the symbols for the the smiley you want to display. For example {smiley;8)} becomes .

Here is the full smiley set :

• -- :doubt:
• -- :-?
• -- :!:
• -- :lol:
• -- 8)
• -- :(
• -- :)
• -- :eek:
• -- :-D
• -- :cry:
• -- :-X
• -- :?
• -- :evil:
• -- :-o
• -- :mad:
• -- :oops:
• -- :grin:
• -- :-|
• -- :-p
• -- :biggrin:
• -- :idea:
• -- :shock:
• -- :o
• -- :?:
• -- :badgrin:
• -- :roll:
• -- :arrow:
• -- :|
• -- :smile:
• -- :p
• -- :razz:
• -- :wink:
• -- :-)
• -- 8-)
• -- :cool:
• -- :D
• -- :neutral:
• -- :sad:
• -- :???:

The Missing Smilies

We can't use the following smilies. ;-) and ;).

Because they contain a ";" [2], we can't yet use these smilies. They both represent the same smiley. You have to use it in its other form; :wink: -- .

Alternative Smiley Sets

The nice thing about smiley.py is that it supports any smile sets with a .pak file. This is the standard for smiley sets that is used by phpbb. You can find alternative sets of smilies at the stylesdb website.

Simply replace the smilies directory with an alternative set to use them. smiley.py will automatically create the right links by reading the .pak file.

You will need to edit the smiley function in realmacros.py to have the right path to the smilies directory (to read it) and the right final path to the smilies for your site.

Credits

• The smilies come from a gentleman called Spider.
• smiley.py is written by Mark Andrews. It is licensed under the BSD license, which is the same one as the Voidspace License .
• path.py (needed by smiley.py) is written by Jason Orendorff. He has placed it in the public domain.

Footnotes