| Version: | 1.15.161 |
|---|---|
| Date: | 2019-09-30 23:43 UTC |
| Organization: | National Braille Press |
| Contact: | Brian Mac Donald |
| Address: | 88 St. Stephen Street Boston, MA 02115 United States of America |
Contents
Several key bindings are described within this document. They aren't actually part of the editor itself, but, rather, are part of the B2G's user interface. They're more fully documented within the User Interface Manual.
A quick way to invoke the editor is to press Space+ed (dots 1246).
The main screen contains the following screen elements:
This region shows the absolute path to the file that's currently being edited. If it's a new file (see the New action) then it says:
[new file]
This region is where the content of the file is loaded and can be modified. If the file is empty then it says:
[empty file]
Dots 78 [⣀] represents the cursor. This is the location where new characters are inserted and where existing characters are deleted.
Dot 8 [⢀] represents either selected text (see Selecting Text) or highlighted text (see Highlighting Text).
Insert that character immediately to the left of the cursor, and then move the cursor one character to the right.
The Enter key.
Press Backward together with a cursor routing key to mark the start of a text selection. If text has already been selected then its start is adjusted.
Press Forward together with a cursor routing key to mark the end of a text selection. If text has already been selected then its end is adjusted.
Press Space+Dot8+a (dot 1) to select all of the text.
Press any cursor routing key (by itself) to clear the text selection and set the cursor's location.
The editor doesn't have its own clipboard - it uses Android's global clipboard. This means that text can be easily copied between the editor and other apps.
Press Space + one of the following letters together with Dot8 to turn on the corresponding type of highlighting, and together with Dot7 to turn it off:
| Letter | Dots | Type |
| b | 12 | Bold |
| i | 24 | Italics |
| s | 234 | Strike Through |
| u | 136 | Underline |
More than one type of highlighting may be turned on at the same time. A quick way to turn all of them off at once is to press Space+h (dots 125) together with Dot7.
If a character is marked as being highlighted (see Braille Indicators) then you can press Dot3 together with the corresponding cursor routing key to find out how it has been highlighted.
To find text:
The text is interpreted as a sequence of space-separated words.
A case-insensitive, forward search is performed. If the text is found then the braille display is panned such that its leftmost cell is where the text starts.
To continue searching forward for the same text without reentering it, press Space+Dot8+f (dots 124).
To search backward for the same text without reentering it, press Space+Dot7+f (dots 124).
The file finder is used to locate a file for editing (see the Open action), for saving (see the Save As action), etc.
The initial screen presents a list of the available locations where files can be stored. For each of them, a descriptive label and the absolute path are shown. This listing may contain:
Selecting the desired location goes to its top-level Folder Listing. Alternatively, one of the following actions may be selected:
A folder listing presents a list of the files and/r folders that the current folder contains. A forward slash [/] is appended to the name of each folder within the listing.
Folders that aren't readable won't be listed. The listing may be further constrained by editor features (e.g. the "Select Format" dialog).
Selecting a file causes the editor to act on that file.
Selecting a folder goes to its listing.
Additionally, one of the following actions may be selected:
Go to the listing for the folder that contains the one currently being listed. If currently listing the system root folder then go to the Location Listing.
Return to the file currently being edited.
For actions that only require read access to the selected file (e.g. the Open action):
For actions that require write access to the selected file (e.g. the Save As action):
These additional actions may also be selected:
Go to the Path Editor so that the name of a new file can be entered.
The absolute path of the folder currently being listed is shown within a read-only field, and the name of the file currently being edited is shown within an editable field. If the file name extension is being imposed (e.g. by the Select Format dialog) then it's shown in bold and can't be edited.
Forward slashes [/] may be appended to and/or inserted into the file name. This is how a subfolder (to any depth) can be specified.
Any number of parent folder references [../] may be prepended to the file name in order to escape the folder currently being listed.
One of the following actions may be selected:
This dialog is presented in order to confirm that the file will be saved in the desired format. If the file's path isn't known (a new file is being edited) then the Select Format dialog is used instead.
One of the following must be confirmed:
One of the following actions may be selected:
This dialog is presented so that one of the editor's Supported Formats can be selected when saving a file. The File Finder is then used either to locate an existing file or to enter a new file name.
Each listed format shows its corresponding file extension and its description. Folder listings will be filtered based on the selected extension. If the special format all files is selected then folder listings won't be filtered, and the file will be saved in the format associated with the extension of the selected or entered file's name.
One of the following actions may also be selected:
This dialog is presented before a new file is edited if the Edit Area contains changes.
One of the following actions may be selected:
This dialog is presented in order to confirm that a file has been successfully saved. It contains the file's absolute path. Select OK to clear it.
This dialog is presented before a file is actually deleted in order to ensure that the correct file has been chosen.
One of the following confirmations may be selected:
| Extension | Description |
|---|---|
| .brf | Formatted ASCII Braille |
| .brl | Unformatted ASCII Braille |
| .doc | Microsoft Word 1997-2007 |
| .docm | Microsoft Word 2007+ XML (macro-enabled) |
| .docx | Microsoft Word 2007+ XML (macro-free) |
| .html | HyperText Markup Language |
| .mhtml | MIME HTML |
| .odt | Open Document Text |
| .rtf | Rich Text |
| .txt | Plain Text |
| Extension | Description |
|---|---|
| .kwb | BrailleNote Keyword Braille |
| .kwt | BrailleNote Keyword Text |
| Extension | Description |
|---|---|
| .epub | Electronic Publication |
| .oxps | Open XML Paper Specification |
| Portable Document Format | |
| .ps | PostScript |
| .xps | Microsoft XML Paper Specification |