Writing Epiphany Extensions

Adam Hooper

Revision History
Revision 0.07 29-Jan-2005 ah
Inaugurate Pyphany.
Revision 0.06 30-Oct-2004 ah
Put titles on examples, and ensure all examples work with unloading.
Revision 0.05 30-Oct-2004 ah
Replaced ephyplugins with epiphany-extensions. Got rid of now-incorrect statements. Mention copy-template script, which saves the user from copy/pasting everything.
Revision 0.04 14-Jan-2004 ah
Replaced Savannah links to point to the page on Epiphany's website.
Revision 0.03 13-Jan-2004 ah
s/Firdbird/Firebird/
Revision 0.02 03-Jan-2004 ah
I've implemented all changes suggested by lwillis and chpe and done some clarifications of my own.
Revision 0.01 01-Jan-2004 ah
My first shot at a great HOWTO. Surelly loaded with typos and minor errors.

Table of Contents

1. Introduction
What Epiphany Extensions Are
Document Scope
Getting Help
About the Author
2. Preparation
Required Experience
Required Programs
Required Source Code
Required Documentation
Before Coding
Required License
3. Build Framework
4. Coding
register_module
Header File
Minimum C Code
Connecting Signals
Translation
User Interface Integration
Statusbar
GConf Settings
Your Own Ideas
Hacking at Epiphany

List of Examples

4.1. Connecting the switch_page signal
4.2. Listening to location changes
4.3. Basic gettext usage
4.4. Adding menu entries
4.5. Adding menu entries (Python)
4.6. Manipulating the statusbar
4.7. Retrieving a GConf value
4.8. Listening to GConf