/
readme.txt
54 lines (45 loc) · 2.35 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
Plugin for CudaText.
Shows the toolbar widget (modern name is breadcrumb bar) below or on top of the editor for quick
file-system navigation. For example, when you have active editor with filename
"~/mydir/myfile.ext" ("~" is Unix shortcut for "/home/user"), the widget shows buttons:
[ home > user > mydir > myfile.ext ]
It can also show the "~" button (by option):
[ ~ > mydir > myfile.ext ]
Clicking on each button shows the popup with file-system listing, showing the
folder containing the clicked item. This popup supports basic tree-view navigation,
you can click files there to open them in CudaText.
Plugin can also show buttons for Code-Tree nodes. This must be enabled first
in the config file - turn on the option "code_navigation".
Clicking the buttons from the code-tree shows the same tree-popup but with
a different content - with symbols of the documents. Clicking the nodes
in the tree-popup scrolls the document to different symbols.
Configuration
-------------
Plugin can be configured via menu:
"Options > Settings-plugins > Breadcrumbs".
Section [breadcrumbs].
Options description:
* "position_bottom" - whether to show breadcrumbs below the document, or on top
* "show_root_parents" - show full path, otherwise - only project-directory files are shown
* "root_dir_source" - project-directory source (accepts comma-separated list of values for fallback):
* 0 - parent directory of '.cuda-proj'
* 1 - first directory in project
* 2 - project main-file's directory
* "file_sort_type" - how files in the tree-dialog are sorted:
* "name" - sort by filename (default)
* "ext" - sort by extension
* "tilde_home" - replace home directory path by a single item: `~`
* "show_hidden_files" - whether to show hidden files in tree-dialog (hidden by default)
* "max_name_len" - max file/directory name length on breadcrumbs bar
* "max_dirs_count" - limit number of directories displayed on breadcrumbs bar
* "path_separator" - breadcrumbs path separator (by default - OS path separator)
* "code_navigation" - show breadcrumbs for position in Code-Tree, possible values:
* 0 - disabled
* 1 - fast, but might be inaccurate on some lexers
* 2 - less fast, but more accurate
* "code_tree_height" - height of code-tree dialog, possible values:
* -1 - full screen height
* 0 - same as usual
* <pixel height>
Author: halfbrained (https://github.com/halfbrained)
License: MIT