Setup Windows¶

Here is a little reminder to setup windows for power users (aka. with Linux on it )

[Optional] Rename your laptop¶

If you want to have a clean/cool prompt, you should change your laptop default name (most of the time something like: DESKTOP-458DF) to a new one (a short name of your choice).

Go to Start > Settings > System > About
Click on Rename this PC
Restart your computer

[Optional] Rename your user folder¶

As the last step, if you want to have a clean/cool prompt, you should change your windows user folder if it is truncated (that was the case for me. eg. arthu instead of wanted username arthy).

To do so, follow this article

Install Windows Subsystem for Linux (WSL 2)¶

Follow this article to install Ubuntu within your windows

Install Docker on your desktop natively (without emulation). Follow this article

Install Windows terminal¶

If you want to use a great terminal, install new Windows Terminal

You may want to change some settings:

Update Default profile to Ubuntu to start it when you open Windows terminal
In Ubuntu profile, go to Appearance to change cursor shape to filled box - this helps on vim prompt
If listenings windows bells sound is not your hobby, I suggest you to change it to flash. To do so, in Ubuntu profile, go to Advanced to change Bell notification style to Flash window
In Ubuntu profile, go to General to Starting directory to \\wsl$\Ubuntu\home\arthy - change arthy by your home folder name
Do not forget to save your changes in Settings page

Install Visual Studio Code and setup it¶

Install VS Code
Install vim extension in VSCode (vscodevim)
Install wsl code extension and learn to use it
Setup VS Code to use Docker remote container

Setup Ubuntu¶

Vim¶

apt install vim

To change cursor as standard in vim, paste the following code in ~/.vimrc:

" cursor shape
if &term =~? 'rxvt' || &term =~? 'xterm' || &term =~? 'st-'
    " 1 or 0 -> blinking block
    " 2 -> solid block
    " 3 -> blinking underscore
    " 4 -> solid underscore
    " Recent versions of xterm (282 or above) also support
    " 5 -> blinking vertical bar
    " 6 -> solid vertical bar
    " Insert Mode
    let &t_SI .= "\<Esc>[6 q"
    " Normal Mode
    let &t_EI .= "\<Esc>[2 q"
endif

Git¶

Setup Git with this link

To create ssh key¶

ssh-keygen -t rsa -C arthur.mauvezin@gmail.com

Add the content of the public key (~/.ssh/id_rsa.pub) to your Github account keys

Setup .gitconfig¶

The following setup allow you to use multiple git account depending on your current folder

~/.gitconfigs/company.gitconfig

[user]
        email = arthur.mauvezin@company.com
        name = Arthur MAUVEZIN

~/.gitconfig

[user]
        email = arthur.mauvezin@gmail.com
        name = Arthur MAUVEZIN

# Use includeIf to commit with different accounts depending on the parent folder
[includeIf "gitdir:~/company/"]
  path = .gitconfigs/company.gitconfig

[push]
    default = simple
    recurseSubmodules = on-demand
[core]
    editor = vim
[alias]
    clo = clone
    co = checkout
    st = status
    pur = pull
    ci = commit
    rc = rebase
    lg = log -M --decorate --graph
    tree = log --oneline --decorate --graph
    lola = log --graph --decorate --pretty=oneline --abbrev-commit --all
    br = branch
    sth = stash
[credential]
    helper = cache --timeout=604800
[diff]
    submodule = log
[status]
    submodulesummary = 1

[Optional] Download Jira precommit hook to automatically add issue number to commit message¶

Follow instructions written in the Github's Readme

Python¶

sudo apt install python3 python3-pip python-is-python3

Test the installation with the following command:

python -V

Information

If the last command prompts something like Python 3.8.10, then it's good !

oh-my-zsh¶

Install ZSH¶

sudo apt install zsh
chsh -s $(which zsh)

Warning

Upon opening a terminal for the first time after this change, you will be prompted for a setup wizard with many options. Just select the option 2 and you should be good.

Install Oh-My-Zsh¶

Follow official instructions

In ~/.zshrc, modify:

theme to bira
add plugins: git docker gitignore

Setup useful scripts¶

Create folder

mkdir -p .oh-my-zsh/functions

Download this sample functions which allow you to create dumb commits for lab examples

curl https://gist.githubusercontent.com/arthurmauvezin/694d1b9ee1cbb3d82b40d0f05f0238a4/raw/e351f77657f442d86ae8d691ea6f8811df0962b1/gencommit -o .oh-my-zsh/functions/gencommit

Add following line to ~/.zshrc

autoload -Uz $ZSH/functions/*(.:t)

Source ~/.zshrc file

source ~/.zshrc

Now, all files put in ~/.oh-my-zsh/functions folder will be available as commands

See this kind of file for example