Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added docs/images/termux_directory_doesnt_exist.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_error_writing.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_extra_keys_loaded.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_extra_keys_written.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_left_drawer.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_loaded.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_ls_all.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_opened_properties_file.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/images/termux_tight_keys.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
27 changes: 23 additions & 4 deletions docs/termux/customisation/extra_keys.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ To enable the extra keys view you have to long tap on the keyboard button in the
(Swipe from left → right to open the drawer)

!!! abstract
![Termux Left Drawer](/images/termux_left_drawer.png)
![Termux Left Drawer](/images/termux_left_drawer.jpg)

You can also press `VOLUME UP+Q` or `VOLUME UP+K`.

Expand All @@ -69,6 +69,15 @@ Open the `termux.properties` file:
$ nano ~/.termux/termux.properties
```

??? error "Directory .../home/.termux doesn't exist"
![Termux Nano Directory Doesn't Exist](/images/termux_directory_doesnt_exist.jpg)

If you get the above error, then that means that the `.termux` directory
doesn't exist. Try making it, before doing this, with
```bash
mkdir $HOME/.termux/
```

Now we will start by adding two rows of some really useful keys(default keys until v0.66)

!!! example ""
Expand All @@ -85,14 +94,14 @@ if desired, by "backslash-escaping" the line feed at the end of each line, thus:
```bash
extra-keys = [ \
['ESC','/','-','HOME','UP','END','PGUP'], \
['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN']
['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN'] \
]
```

!!! success
It should look something like this:

![Termux Extra Keys Written](/images/termux_extra_keys_written.png)
![Termux Extra Keys Written](/images/termux_extra_keys_written.jpg)

Each key "entry" can be either a string (such as `'|'`, `'/'` or `'='`) or one of the values listed below.
These values are defined in ExtraKeysView.java, and the list of values (not including possible synonyms) is:
Expand Down Expand Up @@ -157,4 +166,14 @@ All 3 of these work the same. If one doesn't for you, then use the other :smiley
The keyboard on the bottom should look something like this now!
Well Done!

![Termux Extra Keys Loaded](/images/termux_extra_keys_loaded.png)
![Termux Extra Keys Loaded](/images/termux_extra_keys_loaded.jpg)

??? bug "Tightly Packed Keys"
![Termux Tight Keys](/image/termux_tight_keys.jpg)

If after doing all the above steps, the keys look too tightly
packed to you then that's probably a bug.

Just close the application with `CTRL+D` or Exit from the
notification shade and restart it.
This should hopefully fix it :fingers_crossed:
11 changes: 8 additions & 3 deletions docs/termux/customisation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Creating new sessions and terminals is even easier.
![Installing Dependencies](/images/termux_installing_dependencies.jpg)

!!! example "The app should look something like this when it loads"
![Termux Loaded](/images/termux_loaded.png)
![Termux Loaded](/images/termux_loaded.jpg)



Expand All @@ -26,12 +26,17 @@ in a `key=value` style method.

For doing that, you first need to create a directory[^1] named `.termux`

!!! example
```bash
$ mkdir $HOME/.termux
```

??? question "Did you know?"
* On OS X machines, the files which start with `.` are hidden.
These aren't shown when you type in `ls`. To show these files you have to use the `-a` flag

!!! example
![Termux ls -a](/images/termux_ls_all.png)
![Termux ls -a](/images/termux_ls_all.jpg)

*The directory and files are just for an example*
* The `.` represents the current working directory.
Expand Down Expand Up @@ -73,7 +78,7 @@ and if it does; then just opens it
It should look something like this:

!!! success ""
![Termux Opened termux.properties File](/images/termux_opened_properties_file.png)
![Termux Opened termux.properties File](/images/termux_opened_properties_file.jpg)

## Adding configurations
* [Termux Shortcuts](./extra_keys.md#understanding-keys-on-termux-and-shortcuts)
Expand Down