summary refs log tree commit diff stats
path: root/README
Commit message (Expand)AuthorAgeFilesLines
* README: updatedhut2010-03-291-1/+1
* removed the cd-after-exit hackhut2010-03-291-0/+13
* README: Removed the reference to code/keys.rb >_<hut2010-03-291-2/+2
* incremented verison number v1.0.4hut2010-03-121-2/+2
* README: typohut2010-03-121-2/+2
* more documentationhut2010-03-121-3/+10
* README: slightly changed introductionhut2010-03-121-3/+3
* README: changed introductionhut2010-03-121-8/+10
* README: updatedhut2010-03-121-16/+19
* incremented version number and updated pydoc html files v1.0.3hut2010-02-161-2/+2
* readme: normalized letter casing in headingshut2010-02-151-2/+2
* updated READMEhut2010-02-151-29/+40
* made configuration more simplehut2010-01-251-6/+2
* README: corrected bad instructionshut2010-01-241-2/+2
* readme: improvedhut2010-01-201-6/+13
* 1.0.2! v1.0.2hut2010-01-141-2/+2
* readme: added part "customizing ranger"hut2010-01-141-0/+16
* readme: removed ugly sentencehut2010-01-141-3/+1
* new minor version v1.0.1hut2010-01-021-2/+2
* readme: updatedhut2010-01-011-4/+77
* decided to use python from now onhut2009-11-221-1/+1
* Initial commithut2009-11-161-0/+11
this guide suggests otherwise, tabs are used for indentation of code and docstrings. In other documents (readme, etc), use spaces. Patches ------- Send patches, created with "git format-patch", to the email adress romanz@lavabit.com If you plan to do major changes, or many changes over time, I encourage you to create a fork on GitHub, Gitorious or any other site. Common Changes -------------- * Change which files are previewed in the auto preview: In ranger/gui/widget/browsercolumn.py the constant PREVIEW_BLACKLIST * Adding options: In ranger/defaults/options.py add the default value, like: my_option = True In ranger/shared/settings.py add the name of your option to the constant ALLOWED_SETTINGS The setting is now accessible at self.settings.my_option, assuming <self> is a "SettingsAware" object. * Change commands: ranger/defaults/commands.py * Create aliases for commands: In ranger/defaults/commands.py at the bottom, write something like: alias(exit=quit) * Adding colorschemes: Copy ranger/colorschemes/default.py to ranger/colorschemes/myscheme.py and modify it according to your needs. Alternatively, mimic the jungle colorscheme. It subclasses the default scheme and just modifies a few things. In ranger/defaults/options.py (or ~/.ranger/options.py), change colorscheme = colorschemes.default to: colorscheme = colorschemes.myscheme * Change which files are considered to be "hidden": In ranger/defaults/options.py change the hidden_filter regular expression. * Change the key map: Modify ranger/defaults/keys.py. This should be self-explanatory. Check out ranger/core/actions.py for the most common actions, of course you can also use your own functions. * Change the file type => application associations: In ranger/defaults/apps.py modify the method app_default. The variable "f" is a filesystem-object with attributes like mimetype, extension, etc. For a full list, check ranger/fsobject/fsobject.py * Change the file extension => mime type associations: Modify ranger/data/mime.types and run ranger/data/generate.py to compile it. Version Numbering ----------------- X.Y.Z, where: * X: Milestones * Y: Stable versions * Z: Experimental versions