Contents
About Conkeror
Conkeror is a keyboard-oriented, highly-customizable, highly-extensible web browser based on Mozilla XULRunner, written mainly in JavaScript, and inspired by exceptional software such as Emacs and vi. Conkeror features a sophisticated keyboard system, allowing users to run commands and interact with content in powerful and novel ways. It is self-documenting, featuring a powerful interactive help system.
Community
Most development talk takes place on the IRC channel, however the mailing list is active and developers notify it when important things happen or break. The issue tracker's bug and feature request sections are generally up-to-date and tend to be very informative.
IRC Channel (#conkeror on Freenode)
Mailing List - Our mailing list.
Reporting Problems - How to report problems, like bugs.
Requesting Features - How to request features.
Wiki Access - How to edit this wiki.
Breaking Changes - Changes that may affect your RC.
Example Configs - Links to users' RC scripts.
Artwork - Icons and other Conkeror-inspired graphics.
Support - Supporting Conkeror.
Documentation
1. Installation and Startup
XULRunner - How to install XULRunner.
- Installation - How to install Conkeror.
Spawn Helper - Installing the spawn helper, for switching to an external editor.
Starting Conkeror - Command-line arguments and the steps taken at startup.
Profiles - Multiple instances and multiple configurations.
Multiple XULRunners - How to install multiple XULRunner versions.
Default Browser - Setting Conkeror as your default browser.
Troubleshooting - What to try when things don't work.
2. Using Conkeror
2.1. Essentials
Quick Start - A brief tour of the keys.
FAQ - Frequently asked questions.
Rc File - Configuration file or files loaded at start-up.
2.2. UI
Hinting - Mastering the numbers.
History - Browsing URLs from your history.
Downloads - Working with downloads.
Targets - The Target System: controlling where urls are opened.
External Editing - Editing text form elements in an external program.
Mode Line - Customizing the mode-line.
Tab Bar - Tab bar module.
Appearance - Changing appearance using styles and themes.
Favicons - Displaying Favicons in Conkeror.
Key Bindings - Defining custom key sequences.
Hide Scrollbars - How to hide scrollbars.
Zoom - About zooming.
Buffer Order - Controlling the spatial order of buffers.
2.3. Content
Webjumps - Working with webjumps - shortcuts to often-used pages.
Read-Url Handlers - Defining syntax handlers for the url prompt.
Page Modes - Special functionality for particular web sites.
Content Handlers - Configuring actions and external programs for specific MIME types.
Protocol Handlers - Configuring external handlers for protocols.
Content Policy - Filtering and monitoring content requests.
Focus - Dealing with web pages that steal focus.
KeyKill - Dealing with web pages that steal keys.
Client Redirect - Program your own redirects.
Formfill - About the completions popup in content input fields.
UserAgent - What websites know about your browser, and how to change it.
2.4. Environment
Keyboard - Keyboard configuration.
Proxy Management - Working with with proxy settings.
2.5. Reference
User Variables - Configuration settings controlled by variables.
Modules - Optional functionality.
Mozilla Preferences - Working with Mozilla preferences.
Mozilla Extensions - Using Mozilla extensions.
Mozilla Plugins - Using Mozilla plugins.
Password Management - Working with Mozilla's password manager.
2.6. Misc
Bookmarks - Bookmark management.
Common Problems - Common problems with solutions.
Tips from Users - User-contributed tips and tricks.
Using Conkeror for Web Development - Specific web-development related tricks.
3. Programming Conkeror
Startup - What happens when, during startup.
Hooks - Working with hooks.
Keymaps - Working with key bindings.
Modes - Overview of mode types.
Minibuffer Read - How to take minibuffer input.
Coroutines - How Conkeror's coroutine.js works.
Keywords - $keyword arguments
Minibuffer Read Walkthrough - A practical walkthrough of coroutine usage.
Writing Webjumps - How to write webjumps.
Writing Commands - Writing interactive commands.
Writing Browser Object Commands - The what and how of browser objects.
Writing Buffer Modes - How to write modes that provide per-buffer features.
Writing Page Modes - Writing feature-suites for specific sites.
Load Spec - The load_spec datatype.
Object Orientation - Classical OO JavaScript tutorial.
External Programs - Interacting with other programs.
4. Development Resources
Roadmap - Future of Conkeror
Development Guidelines - Development guidelines.
Browse Code - Browse the git repository.
Unit Tests - Writing unit tests.
Debugging - Running Conkeror in a debugger.
Bugs in Conkeror - Best practices for reporting bugs.
Upstream Bugs - Known bugs in Mozilla that impact Conkeror.
Git Help - Advice on developing with git.
License - License agreement(s).