~abelianr/pyroom/plugin-system

====== PyRoom Project ======

PyRoom is a fullscreen simple text editor, without a toolbar, a menubar or anything that would distract the user from his most important task: writing.

===== Dependencies =====

PyRoom depends on Python, PyGTK and gtksourceview. Please refer to your system documentation for information on how to install these modules if they're not currently available.

===== Installing and Running =====

PyRoom is available as a seutptools enabled package. Installation procedures for those are easy:

Either unpack the tarball 

    $ tar xvfz pyroom.tar.gz

or check out our bazaar branch for a development version (we try to keep those 

unbroken and ready for production use)

    $ bzr branch lp:pyroom

From there, you can either run pyroom from commandline

    $ cd pyroom/

    $ ./pyroom

Or install it system wide

    $ cd pyroom

    $ python setup.py install # as root

    $ pyroom

==== Usage ====

=== Running PyRoom ===

To run pyroom and instruct it to load some existing files, type:

  $ pyroom /path/to/file1 /other/path/to/file2

===Graphical Styles===

The default style is "green", which is a green text color in a black background. You can change the chosen style by typing:

  $ pyroom [--style={style name}]

For instance:

  $ pyroom --style=blue

At the time of writing, the available styles are:

  * blue

  * green

  * darkgreen

=== Example Usage ===

For example, to load PyRoom and instruct it to use the "darkgreen" style and to load the files "article.txt" and "blogpost.txt", type the following:

  $ pyroom --style=darkgreen article.txt blog.txt

==== Key Bindings ====

There are a few keys allowing you to perform a few useful commands:

  * Control-H: Show help in a new buffer

  * Control-I: Show buffer information

  * Control-L: Toggle line number

  * Control-N: Create a new buffer

  * Control-O: Open a file in a new buffer

  * Control-Q: Quit

  * Control-S: Save current buffer

  * Control-Shift-S: Save current buffer as

  * Control-W: Close buffer and exit if it was the last buffer

  * Control-Y: Redo last typing

  * Control-Z: Undo last typing

  * Control-Page Up: Switch to previous buffer

  * Control-Page Down: Switch to next buffer

  * Control-Plus: Increases font size

  * Control-Minus: Decreases font size

===== Want to know more? =====

  * Pyroom Website: http://pyroom.org

  * Pyroom project page on Launchpad: https://launchpad.net/pyroom

  * Pyroom Wiki: http://wiki.pyroom.org/doku.php