about summary refs log tree commit diff stats
path: root/html
Commit message (Collapse)AuthorAgeFilesLines
* 3792Kartik K. Agaram2017-03-121-267/+292
| | | | | | | Bugfix: make sure 'print 0, 0' always does the right thing, no matter how it's overloaded. Thanks Ella Couch for reporting this.
* 3791Kartik K. Agaram2017-03-122-1419/+1381
| | | | Simpler way to do commit 2929.
* 3790Kartik K. Agaram2017-03-127-1040/+1043
| | | | Don't try to snapshot in scenarios.
* 3789Kartik K. Agaram2017-03-127-1045/+1047
| | | | | | | | | | | | | I accidentally got rid of git snapshotting of lessons back when I switched to testable file primitives last De
ranger v.1.7.2
==============
ranger is a console file manager with VI key bindings.  It provides a
minimalistic and nice curses interface with a view on the directory hierarchy.
It ships with "rifle", a file launcher that is good at automatically finding
out which program to use for what file type.

![screenshot](doc/screenshot.png)

This file describes ranger and how to get it to run.  For instructions on the
usage, please read the man page.  See HACKING.md for development specific
information.  For configuration, check the files in ranger/config/ or copy the
default config to ~/.config/ranger with ranger's --copy-config option.  The
examples/ directory contains several scripts and plugins that demonstrate how
ranger can be extended or combined with other programs.  These files can be
found in the git repository or in /usr/share/doc/ranger.

A note to packagers:  Versions meant for packaging are listed in the changelog
on the website.


About
-----
* Authors:     see "AUTHORS" file
* License:     GNU General Public License Version 3
* Website:     http://ranger.nongnu.org/
* Download:    http://ranger.nongnu.org/ranger-stable.tar.gz
* Bug reports: https://github.com/hut/ranger/issues
* git clone    http://git.sv.gnu.org/r/ranger.git


Design Goals
------------
* An easily maintainable file manager in a high level language
* A quick way to switch directories and browse the file system
* Keep it small but useful, do one thing and do it well
* Console based, with smooth integration into the unix shell


Features
--------
* UTF-8 Support  (if your python copy supports it)
* Multi-column display
* Preview of the selected file/directory
* Common file operations (create/chmod/copy/delete/...)
* Renaming multiple files at once
* VIM-like console and hotkeys
* Automatically determine file types and run them with correct programs
* Change the directory of your shell after exiting ranger
* Tabs, Bookmarks, Mouse support


Dependencies
------------
* Python (tested with version 2.6, 2.7, 3.1-3.5) with the "curses" module
  and (optionally) wide-unicode support.
* A pager ("less" by default)

Optional:

* The "file" program for determining file types
* The python module "chardet", in case of encoding detection problems
* "sudo" to use the "run as root"-feature
* w3m for the "w3mimgdisplay" program to preview images

Optional, for enhanced file previews (with "scope.sh"):

* img2txt (from caca-utils) for ASCII-art image previews
* highlight for syntax highlighting of code
* atool for previews of archives
* lynx, w3m or elinks for previews of html pages
* pdftotext for pdf previews
* transmission-show for viewing bit-torrent information
* mediainfo or exiftool for viewing information about media files


Insht'>
|
* 3752 - fix a couple of segfaultsKartik K. Agaram2017-03-023-357/+376
| | | | Thanks Ella Couch for running into these.
* 3751Kartik K. Agaram2017-03-024-6/+6
| | | | Some hacky manual fixes to auto-generated html.
* 3750Kartik K. Agaram2017-03-0264-1317/+1309
|
* 3749Kartik K. Agaram2017-03-0264-1352/+1350
|
* 3748Kartik K. Agaram2017-02-281-1/+1
|
* 3747Kartik K. Agaram2017-02-072-6/+6
|
* 3746Kartik K. Agaram2017-02-0738-2536/+2570
|
* 3737Kartik K. Agaram2017-01-224-43/+42
|
* 3734Kartik K. Agaram2017-01-119-15/+15
|
* 3732Kartik K. Agaram2017-01-1114-1024/+1033
|
* 3727Kartik K. Agaram2016-12-311-0/+1
|
* 3725Kartik K. Agaram2016-12-2732-1611/+1650
| | | | | | More improvements to cross-linking example programs. Include their own functions as well in the tags for each program, even as you share the core .mu files everywhere.
* 3719 - cross-link Mu waypoints to their locationKartik K. Agaram2016-12-2713-103/+103
|
* 3716Kartik K. Agaram2016-12-26118-0/+236
| | | | Make hyperlinks less salient in the rendered html since there's so many of them.
* 3715Kartik K. Agaram2016-12-2612-1262/+1262
| | | | | | | | Fix cross-links in html for the edit/ app. I originally thought I'd need to provide a commandline flag like --rel-path or something. But we need to support different relative paths in a single html file. So the solution instead is appropriately engineering the tags file.
* 3713 - cross-link calls with definitions in htmlKartik K. Agaram2016-12-26105-5909/+5909
|
* 3710Kartik K. Agaram2016-12-26118-41040/+41040
| | | | | Turns out we don't need to explicitly add anchors for each line. Vim's TOhtml has magic for that out of the box.
* 3709 - line numbers in htmlKartik K. Agaram2016-12-26118-41482/+44315
| | | | | | Each line number also gets an anchor name, but I'm not hyperlinking them for now because I don't want to encourage bookmarking these links just yet. They aren't permalinks because every revision may change what's at any given line number.
* 3707Kartik K. Agaram2016-12-1213-27/+39
| | | | | | | | | | | | | | | | | | Be more disciplined about tagging 2 different concepts in the codebase: a) Use the phrase "later layers" to highlight places where a layer doesn't have the simplest possible self-contained implementation. b) Use the word "hook" to point out functions that exist purely to provide waypoints for extension by future layers. Since both these only make sense in the pre-tangled representation of the codebase, using '//:' and '#:' comments to get them stripped out of tangled output. (Though '#:' comments still make it to tangled output at the moment. Let's see if we use it enough to be worth supporting. Scenarios are pretty unreadable in tangled output anyway.)
* 3706Kartik K. Agaram2016-12-111-2/+2
|
* 3705 - switch to tested file-system primitivesKartik K. Agaram2016-12-1113-643/+602
|
* 3704Kartik K. Agaram2016-12-112-5/+28
| | | | | | | Bugfix: writing to a new file in a non-empty fake file system. The one time I try to get a little clever, it bites me in the ass. That'll teach me..
* 3703Kartik K. Agaram2016-12-066-50/+59
|
* 3700Kartik K. Agaram2016-11-284-113/+71
| | | | | | Reorder products of some functions in the edit/ and sandbox/ apps. My recent realization: always return 'real' products before ones that just indicate an ingredient is mutable.
* 3699Kartik K. Agaram2016-11-285-14/+11
| | | | | Delete some obsolete /same-as-ingredient attributes. We should always let Mu deduce those at this point.
* 3697Kartik K. Agaram2016-11-271-13/+2
| | | | | | Decouple programming environment initialization from rendering. This helps make clear that we only need the width from screen during initialization.
* 3696Kartik K. Agaram2016-11-276-168/+193
| | | | | | Decouple editor initialization from rendering to screen. This hugely simplifies the header of 'new-editor' and makes clear that it was only using the screen for rendering.