dotfiles

This branch of the excellent dotfiles by nickjj extends the original environment, which is made for web development in vim, with a local python environment for data science. For convenience it includes a shell script that executes all installations / updates automatically. Once installed it sets the default shell to zsh. Note that the installation script should only be used in WSL 2, since it also changes files in the windows directories.

Installation

Before you start the installation, make sure that

• You have virtualization enabled in your bios (manufacturer specific)
• WSL is installed with WSL 2 enabled as default (guide)and
• And Ubuntu 20.04 LTS is installed (windows store link)

1. Install MS Windows Apps

These apps are needed on the windows side for the environment to work without any special configurations

• Windows Terminal
• VcXsrv
• Docker Desktop
• Firefox
• SumatraPDF

2. Make Firewall Exceptions

Make firewall exceptions for VcXsrv. This can be done either by allowing all com for the app or by making exceptions for specific ports. (risks)

3. Install Dotfiles

1. Open Ubuntu in Windows Terminal
2. Make sure that git is installed and clone this repo to your home directory

sudo apt install git
git clone https://github.com/romanrue/dotfiles ~/dotfiles

3. Make machine and user configurations (do this before you run the install script!)

Change memory allocation for wsl in c/Users/roman/.wslconfig based on your systems memory

Change windows username in folder structure, that is

mv ~/dotfiles/c/Users/roman/ ~/dotfiles/c/Users/<windows username>/

Change github credentials in .gitconfig.user

Source install script from dotfiles directory (always source from within the dotfiles folder!)

cd ~/dotfiles/
./installscript.sh

Remarks

PATHS

To integrate the windows apps into the dotfiles workflow, linux must be able to detect their respective executables. Luckily WSL appends the windows paths to the linux ones. Therefore we only need to include the desired apps to the windows path. In the current setup the paths for

• firefox, standar location C:\Program Files\Mozilla Firefox
• SumatraPDF, standard location C:\Users\<username>\AppData\Local\SumatraPDF were manually added. If you do not want to extend your windows path variable include the absolute paths to the respective windows executable inside of .local/bin/wslinks/

Aliases do not work with GNU Make

Because GNU Make is only looking for executables one can find some simple executables inside of .local/bin/wslinks/. These scripts execute the respective windows executable and can also be called from any Makefile

You don't want to use firefox

If you prefer another browser, change the the firefox link in the .vimrc to your browser and add an alias or an executable to .local/bin/wslinks/

Introduction

If you want to learn more, I can really recommend the content provided by the original author.

TODO

• Add/Iterate on Themes for QtConsole
• Add Themes for jupyter notebook