Danny Hermes dotfiles

Prerequisites

In order to do this you'll need git installed. It should come by default on macOS and Linux. If not, get a new version of your OS.

bash-it Framework

As of February 2019, I'm using bash-it for many shell features I used to "handroll". I use the powerline theme.

Symlinks

After cloning this, create symlinks to all configuration files:

ln -s $(pwd)/bash_logout ~/.bash_logout
ln -s $(pwd)/bash_profile ~/.bash_profile
ln -s $(pwd)/bashrc ~/.bashrc
ln -s $(pwd)/emacs.d ~/.emacs.d
ln -s $(pwd)/git-completion.bash ~/.git-completion.bash
ln -s $(pwd)/gitconfig ~/.gitconfig
ln -s $(pwd)/profile ~/.profile
ln -s $(pwd)/screenrc ~/.screenrc
mkdir -p ~/.ssh  # Create if it doesn't exist
ln -s $(pwd)/ssh_config ~/.ssh/config
ln -s $(pwd)/Xmodmap ~/.Xmodmap
# See: http://unix.stackexchange.com/q/1677
ln -s $(pwd)/xsessionrc ~/.xsessionrc
# Optional extensions used in `~/.bash_profile`
ln -s $(pwd)/local_profile_extensions ~/.local_profile_extensions

On macOS

[sudo] cp tailscale.sh /usr/local/bin/tailscale

You may also want to enable git is-child and annoy via:

ln -s $(pwd)/is-git-child.sh /usr/local/bin/is-git-child
ln -s $(pwd)/annoy.py /usr/local/bin/annoy

(or some directory on your ${PATH} other than /usr/local/bin).

To use VS Code settings on macOS:

ln -s \
  $(pwd)/vscode/settings.macos.json \
  "${HOME}/Library/Application Support/Code/User/settings.json"
ln -s \
  $(pwd)/vscode/keybindings.macos.json \
  "${HOME}/Library/Application Support/Code/User/keybindings.json"

To use VS Code settings on Ubuntu:

ln -s \
  $(pwd)/vscode/settings.ubuntu.json \
  "${HOME}/.config/Code/User/settings.json"
ln -s \
  $(pwd)/vscode/keybindings.ubuntu.json \
  "${HOME}/.config/Code/User/keybindings.json"

To use VS Code settings on Windows for WSL2 (from PowerShell):

Remove-Item $env:APPDATA\Code\User\settings.json
New-Item `
  -Path  $env:APPDATA\Code\User\settings.json `
  -ItemType SymbolicLink `
  -Value $HOME\dotfiles\vscode\settings.windows.json
Remove-Item $env:APPDATA\Code\User\keybindings.json
New-Item `
  -Path  $env:APPDATA\Code\User\keybindings.json `
  -ItemType SymbolicLink `
  -Value $HOME\dotfiles\vscode\keybindings.windows.json

GNU Screen

In order to track open GNU Screen windows, the dotfiles/screen_sessions.json file is used. Populate it with the "initial" content

{ "SENTINEL": null }

System Paths / Defaults

There are some paths on the system that define default behavior.

• On Ubuntu, /etc/ssh/sshd_config can be modified to force ssh login to only accept a public key. In particular, the line PasswordAuthentication no should be added (or a variant of it should be uncommented). After modifying this, run restart ssh or just reboot.
• On macOS, /private/etc/ssh/sshd_config can be modified to force ssh login to only accept a public key. In particular, the line PasswordAuthentication no should be added (or a variant of it should be uncommented). Also ChallengeResponseAuthentication no should be set. "If you are using a stock install (i.e., you didn't build/install it yourself from source), launchd should take care of picking up the new config without having to restart the daemon."

VS Code

In order to use VS Code settings and keybindings, create symlinks into the VS Code install directory. (Before creating the symlinks you'll likely need to delete the existing JSON files.)

Also note that you may need to install Roboto on Ubuntu (see editor.fontFamily).

The bash-it Powerline theme has some font issues in VS Code and requires installing Menlo for Powerline (I followed a blog post to resolve the issue).

My current (as of January 2023) list of extensions is

$ code --list-extensions
artdiniz.quitcontrol-vscode
dotjoshjohnson.xml
eamodio.gitlens
esbenp.prettier-vscode
executablebookproject.myst-highlight
github.copilot
github.copilot-chat
golang.go
graphql.vscode-graphql
graphql.vscode-graphql-execution
graphql.vscode-graphql-syntax
hashicorp.terraform
janisdd.vscode-edit-csv
kaiwood.center-editor-window  # CTRL+L recenters editor on current line
ktnrg45.vscode-cython
marvhen.reflow-markdown
mostafa.change-case
ms-azuretools.vscode-docker
ms-ossdata.vscode-postgresql
ms-python.black-formatter
ms-python.debugpy
ms-python.isort
ms-python.python
ms-python.vscode-pylance
ms-toolsai.jupyter
ms-toolsai.jupyter-keymap
ms-toolsai.jupyter-renderers
ms-toolsai.vscode-jupyter-cell-tags
ms-toolsai.vscode-jupyter-slideshow
ms-vscode-remote.remote-containers
ms-vscode.cpptools
ms-vscode.makefile-tools
ms-vsliveshare.vsliveshare
stkb.rewrap
tamasfe.even-better-toml
tldraw-org.tldraw-vscode
yoavbls.pretty-ts-errors

These can be installed on a new machine via code --install-extension ${EXTENSION}. The actual state of these is kept in ${CONFIG_DIR}/Code/CachedExtensions/user (a JSON file) but that file is too specific to be stored in version control. (For example, it tracks the current version of VS Code.)

NOTE: ${CONFIG_DIR} is ${HOME}/Library/Application Support on macOS and ${HOME}/.config on Linux

Optional

• Install VS Code (code)
• It's not uncommon for me to install the Google Cloud SDK.
• For working with node, install nodenv and node-build (I prefer not to use Homebrew to install these)
• For working with python, install pyenv and sometimes also pyenv-virtualenv
• For working with go, install goenv
• For working with ruby, install rbenv
• I occasionally like to use LaTeX for typesetting, so sometimes will install it on a new machine. I will also sometimes install pdftk.
• I use the Rectangle window manager on macOS

macOS

• Often the default version of emacs is too old, so it may be worth trying to update
• It's always important to start by running xcode-select --install to make sure Developer Tools are installed
• install Homebrew
• Set custom command to lock screen (ref)
• Make function (FN) keys be function keys (ref)

Linux

• The libsecret library can be used in a similar fashion as the macOS keychain

  [credential]
         helper = /usr/share/doc/git/contrib/credential/libsecret/git-credential-libsecret