summary refs log tree commit diff stats
diff options
context:
space:
mode:
-rw-r--r--ranger/defaults/options.py53
1 files changed, 35 insertions, 18 deletions
diff --git a/ranger/defaults/options.py b/ranger/defaults/options.py
index 34e0c37e..e73ba1d7 100644
--- a/ranger/defaults/options.py
+++ b/ranger/defaults/options.py
@@ -15,22 +15,33 @@
 
 """
 This is the default configuration file of ranger.
-If you do any changes, make sure the import-line stays
-intact and the type of the value stays the same.
+
+There are two ways of customizing ranger.  The first and recommended
+method is creating a file at ~/.ranger/options.py and adding
+those lines you want to change.  It might look like this:
+
+from ranger.api.options import *
+preview_files = False  # I hate previews!
+max_history_size = 2000  # I can afford it.
+
+The other way is directly editing this file.  This will make upgrades
+of ranger more complicated though.
+
+Whatever you do, make sure the import-line stays intact and the type
+of the values stay the same.
 """
 
 from ranger.api.options import *
 
+# Which files are hidden if show_hidden is False?
+hidden_filter = regexp(
+	r'lost\+found|^\.|~$|\.(:?pyc|pyo|bak|swp)$')
+show_hidden = False
+
 # Which colorscheme to use?  These colorschemes are available by default:
 # default, default88, texas, jungle, snow
 # Snow is monochrome, texas and default88 use 88 colors.
-colorscheme = colorschemes.default
-
-max_history_size = 20
-scroll_offset = 2
-
-# Flush the input after each key hit?  (Noticable when ranger lags)
-flushinput = True
+colorscheme = colorschemes.ice
 
 # Preview files on the rightmost column?
 # And collapse the last column if there is nothing to preview?
@@ -38,15 +49,25 @@ preview_files = True
 max_filesize_for_preview = 300 * 1024  # 300kb
 collapse_preview = True
 
+# Specify a title for the window? Some terminals don't support this,
+# so it's turned off by default.
+update_title = False
+
+# How many directory-changes or console-commands should be kept in history?
+max_history_size = 20
+
+# Try to keep so much space between the top/bottom border when scrolling:
+scroll_offset = 2
+
+# Flush the input after each key hit?  (Noticable when ranger lags)
+flushinput = True
+
 # Save bookmarks (used with mX and `X) instantly?
-# this helps to synchronize bookmarks between multiple ranger
-# instances but leads to slight performance loss.
+# This helps to synchronize bookmarks between multiple ranger
+# instances but leads to *slight* performance loss.
 # When false, bookmarks are saved when ranger is exited.
 autosave_bookmarks = True
 
-# Specify a title for the window? Some terminals don't support this:
-update_title = False
-
 # Makes sense for screen readers:
 show_cursor = False
 
@@ -55,7 +76,3 @@ sort = 'basename'
 reverse = False
 directories_first = True
 
-# Which files are hidden if show_hidden is False?
-hidden_filter = regexp(
-	r'lost\+found|^\.|~$|\.(:?pyc|pyo|bak|swp)$')
-show_hidden = False
>200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282