ranger - mirror of ranger - a simple, vim-like file manager

	Commit message (Expand)	Author	Age	Files	Lines
*	ranger in danger because of some stranger v1.8.1	hut	2017-01-08	1	-1/+1
*	git commit -m 'git commit -m git\ commit\ -m\ '\''Happy\ Holidays\!'\' v1.8.0	hut	2016-12-24	1	-1/+1
*	manpage: rebuild	hut	2016-09-03	1	-14/+10
*	rebuild man pages	hut	2016-02-24	1	-1/+1
*	Fixed that rare bug with the fireballs and explosions v1.7.2	hut	2015-10-04	1	-2/+2
*	Initial commit v1.7.1	hut	2015-05-04	1	-1/+1
*	Should I dual ranger/cleric or wait for the THAC0 bonus? v1.7.0	hut	2015-04-14	1	-1/+1
*	ranger.1: added documentation for %rangerdir and %space macros	hut	2015-04-10	1	-1/+1
*	container.directory: implemented random sorting	hut	2014-08-26	1	-1/+1
*	fix references to README.md	hut	2014-08-22	1	-2/+2
*	Add setting "automatically_count_files"	hut	2014-04-11	1	-1/+1
*	rebuilt man pages with new pod2man version	hut	2013-06-21	1	-11/+20
*	RANGER! RANGER! HIGH VOLTAGE! v1.6.1	hut	2013-05-24	1	-1/+1
*	rifle: added --version option	hut	2013-03-01	1	-1/+1
*	doc/rifle.1: added whitespace at examples	hut	2013-02-18	1	-9/+21
*	doc/rifle.1: Added man page for rifle	hut	2013-02-18	1	-0/+211

Guidelines on Code Modification =============================== Coding Style ------------ * Use syntax compatible to both python 2.6 and 3.1. * Use docstrings with pydoc in mind * Follow the style guide for python code: http://www.python.org/dev/peps/pep-0008/ * Although this guide suggests otherwise, tabs are used for indentation of code and docstrings. In other documents (readme, etc), use spaces. * Test the code with "doctest" where it makes sense 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. Starting Points --------------- Good places to read about ranger internals are: ranger/core/actions.py ranger/fsobject/fsobject.py About the UI: ranger/gui/widgets/browsercolumn.py ranger/gui/widgets/browserview.py ranger/gui/ui.py Common Changes -------------- * Change which files are previewed in the auto preview: In ranger/fsobject/file.py the constant PREVIEW_BLACKLIST * Adding options: In ranger/config/options.py add the default value, like: my_option = True In ranger/container/settingobject.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. * 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/config/options.py (or ~/.config/ranger/options.py), change colorscheme = 'default' to: colorscheme = 'myscheme' * Change the file type => application associations: In ranger/config/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 Version Numbering ----------------- Three numbers; The first changes on a rewrite, the second changes when major configuration incompatibilities occur and the third changes with each release.