From 4e34eb96c80e81441270fea4a6342ad6b608b94f Mon Sep 17 00:00:00 2001 From: Joe Previte Date: Wed, 28 Apr 2021 13:44:07 -0700 Subject: [PATCH] refactor(docs): move termux info install -> termux --- ci/dev/fmt.sh | 2 +- docs/install.md | 28 +--------------------------- docs/termux.md | 47 ++++++++++++++++++++++++++++++++++++++++++++++- 3 files changed, 48 insertions(+), 29 deletions(-) diff --git a/ci/dev/fmt.sh b/ci/dev/fmt.sh index f72c5e92e..849440fee 100755 --- a/ci/dev/fmt.sh +++ b/ci/dev/fmt.sh @@ -30,7 +30,7 @@ main() { doctoc --title '# Maintaining' docs/MAINTAINING.md >/dev/null doctoc --title '# Contributor Covenant Code of Conduct' docs/CODE_OF_CONDUCT.md >/dev/null doctoc --title '# iPad' docs/ipad.md >/dev/null - doctoc --title '# Termux' docs/ipad.md >/dev/null + doctoc --title '# Termux' docs/termux.md >/dev/null if [[ ${CI-} && $(git ls-files --other --modified --exclude-standard) ]]; then echo "Files need generation or are formatted incorrectly:" diff --git a/docs/install.md b/docs/install.md index 91e0ebcb2..f9e77616c 100644 --- a/docs/install.md +++ b/docs/install.md @@ -10,7 +10,6 @@ - [Fedora, CentOS, RHEL, SUSE](#fedora-centos-rhel-suse) - [Arch Linux](#arch-linux) - [Termux](#termux) - - [Known Search Issue](#known-search-issue) - [yarn, npm](#yarn-npm) - [macOS](#macos) - [Standalone Releases](#standalone-releases) @@ -131,32 +130,7 @@ sudo systemctl enable --now code-server@$USER ## Termux -Termux is an Android terminal application and Linux environment, which can also run code-server from your phone. - -1. Install Termux from the [Google Play Store](https://play.google.com/store/apps/details?id=com.termux&hl=en_US&gl=US) -2. Make sure it's up-to-date by running `apt update && apt upgrade` -3. Install required packages: `apt install build-essential python git nodejs yarn` -4. Install code-server: `yarn global add code-server` -5. Run code-server: `code-server` and navigate to localhost:8080 in your browser - -To upgrade run: `yarn global upgrade code-server --latest` - -### Known Search Issue - -There is a known issue with search not working on Android because it's missing `bin/rg`. To fix: - -1. Install `ripgrep` with `pkg` - ```sh - pkg install ripgrep - ``` -2. Make a soft link using `ln -s` - -```sh -# run this command inside the code-server directory -ln -s $PREFIX/bin/rg ./lib/vscode/node_modules/vscode-ripgrep/bin/rg -``` - -For more context, see [comment](https://github.com/cdr/code-server/issues/1730#issuecomment-721515979). +Please see "Installation" in the [Termux docs](./termux.md#installation) ## yarn, npm diff --git a/docs/termux.md b/docs/termux.md index fbf469914..6970b358c 100644 --- a/docs/termux.md +++ b/docs/termux.md @@ -1 +1,46 @@ -# Termux \ No newline at end of file + + +# Termux + +- [Termux](#termux) + - [Installation](#installation) + - [Upgrading](#upgrading) + - [Known Issues](#known-issues) + - [Search issue](#search-issue) + + + +# Termux + +Termux is an Android terminal application and Linux environment, which can also run code-server from your phone. + +## Installation + +1. Install Termux from the [Google Play Store](https://play.google.com/store/apps/details?id=com.termux&hl=en_US&gl=US) +2. Make sure it's up-to-date by running `apt update && apt upgrade` +3. Install required packages: `apt install build-essential python git nodejs yarn` +4. Install code-server: `yarn global add code-server` +5. Run code-server: `code-server` and navigate to localhost:8080 in your browser + +## Upgrading + +To upgrade run: `yarn global upgrade code-server --latest` + +## Known Issues + +### Search issue + +There is a known issue with search not working on Android because it's missing `bin/rg`. To fix: + +1. Install `ripgrep` with `pkg` + ```sh + pkg install ripgrep + ``` +2. Make a soft link using `ln -s` + +```sh +# run this command inside the code-server directory +ln -s $PREFIX/bin/rg ./lib/vscode/node_modules/vscode-ripgrep/bin/rg +``` + +For more context, see [comment](https://github.com/cdr/code-server/issues/1730#issuecomment-721515979).