This document contains notes about my personal configuration of development environment on Debian-based Linux distributions. For configuration on Linux on Android, checkout the android branch.

Content:

• Machine setups
• Explanations
  • Dotfiles
  • Plugins
• References

1. install essential packages

   sudo apt update; sudo apt upgrade; \
   sudo apt install curl git zsh vim tmux; \
   apt list --installed curl git zsh vim tmux

   zsh configuration manager: OhMyZsh

   sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

2. establish GitHub connection

   1. generate ssh keys

      ssh-keygen -t ed25519 -C "<username>@gmail.com"; \
      eval "$(ssh-agent -s)"; \
      ssh-add ~/.ssh/id_ed25519; \
      cat ~/.ssh/id_ed25519.pub

   2. add public key to GitHub account
   3. verify GitHub connection using ssh

      ssh -T git@github.com

3. setup dotfiles on local machine

   git clone git@github.com:alexhyang/dotfiles.git ~/.dotfiles/; \
   source ~/.dotfiles/bootstrap.sh

4. install Node.js

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash; \
   omz reload

   nvm install --lts; nvm ls

• some tools to be configured through dotfiles:

  • shell -- ~/.bashrc, ~/.bash_profile, ~/.zshrc
  • git -- ~/.gitconfig
  • vim -- ~/.vimrc
  • ssh -- ~/.ssh/config
  • tmux -- ~/.tmux.conf
  • aliases, functions, local environment variables -- ~/.aliases, ~/.bash_aliases, ~/.shell_utils, ~/.local_env

• use "redirect" to source files in the dotfiles repo, sensitive information such as customized directory and API keys will be configured locally

  • symlink, dotfile, etc.

• files created by OS:

  • Ubuntu 22.04 ~/.bashrc, ~/.bash_logout, ~/.profile, ~/.motd_shown
  • Debian ~/.bashrc, ~/.bash_logout, ~/.profile

Detailed list of command line tools see Command_Line_Tools-ref.

• Zsh plugins

  • git
  • zsh-users/zsh-syntax-highlighting
  • zsh-users/zsh-completions
  • zsh-users/zsh-autosuggestions
  • ohmyzsh list of plugins

• Vim plugins and their help files

  • List of plugins:
    • Check plugin list in .vimrc, or
    • In vim, open help file using type :help command in normal mode. Search "local-additions" with /local-additions command in help file. Use ctrl ] to open hyperlink (go to tag) and ctrl t to return from opened hyperlink (ctag return), or ctrl o to go back.

• tmux plugins

  • see tmux.conf

• My developer workflow using WSL, tmux and Neovim
• Oh My Zsh Plugins
• Vimawesome - Vim plugins
• Debian packages of R software
• A guide to dotfiles - blog post
• Shell startup scripts - blog post
• Install Node.js on WSL2