My .files and setup configurations

show/hide
My key concerns/needs
- WSL
- Use package managers whenever possible (
apt, brew, winget, choco, npm)
- Dotfiles are symlinked from this repo into
$HOME
- (Mini)Conda, Jupyter, Python
- LaTeX + reveal-md for typesetting
- Bash with
Oh-My-Posh
Installation: Main Scripts
Using the bootstrap script
The bootstrap file will take care of installing almost everything in my Linux subsystem. Just cd into the local folder of this repo and run ./bootstrap. This bootstrap script calls the individual installers to set up the dotfiles, bin/, and package installers using APT, Homebrew (Linuxbrew), and NPM.
cd $HOME
git clone https://github.com/LSYS/dotfiles.git
cd dotfiles
./bootstrap
Using the PowerShell scripts
The PowerShell scripts in win/ will take care of installing Windows OS applications using winget and, to a smaller extent for applications that cannot be installed from winget, Chocolatey.
To install apps using winget and Chocolatey:
cd win
./winget.ps1
./choco.ps1
Installation: Order of Installation (Win)
-
Install WSL: Open PowerShell as administrator
wsl --install -d Debian
# confirm that bash is running
which $SHELL
-
Install Native Windows apps: Open PowerShell (./choco.ps1 need Admin)
This will install WindowsTerminal and Oh-My-Posh. Type
to install the fonts and choose Meslo (recommended). Seth the font in WindowTerminal setting (settings.json)
{
"profiles":
{
"defaults":
{
"font":
{
"face": "MesloLGM NF"
}
}
}
}
-
Open WSL (Debian) in WindowsTerminal and run the bootstrap installer:
cd $HOME/dotfiles && ./bootstrap
This will call the following installers:
dotfiles.sh
win/wslconfig.sh
bin/install.sh
packages/apt.sh
packages/brew.sh
packages/npm.sh
monty/install.sh
-
Once Oh-My-Posh is installed via packages/brew.sh. Check that it works
eval "$(oh-my-posh init bash)"
and symlink the poshthemes to home (where bash/.bash_profile will look for the themes)
cd $HOME && mkdir poshthemes && cd poshthemes
ln -s /home/linuxbrew/.linuxbrew/opt/oh-my-posh/themes/*
Additional Details
Bash
Will be installed in ./dotfiles.sh.
.
โโโ bash
โ โโโ .aliases
โ โโโ .bash_profile
โ โโโ .exports
โ โโโ .functions
โ โโโ .inputrc
.aliases: Shell aliases defined here (including some for Git)
.bash_profile: General bash settings (including Oh-My-Posh and sources other bash dotfiles)
.exports: For environment variables (e.g., custom shell utilities and conda is specified here)
.functions: For functions too big for aliases but too small for bin/
.inputrc: Config for input (case-insensitive completion here)
- Run
make cleancr to sanitize shell scrips for \cr carriage returns (might lead to unexpected, and quiet, breakages)
(Note: .bash_profile is the first config that will be read by bash. So this file will source all other relevant dotfiles.)
Git
Will be installed in ./dotfiles.sh.
โโโ git
โ โโโ .gitconfig
.gitconfig: Includes Git aliases.
Python + (Mini)Conda (./monty/)
Will be installed by ./monty/install.sh.
โโโ monty
โ โโโ install.sh
โ โโโ jupyter_notebook_config.py
โ โโโ requirements
โ โโโ base.txt
โ โโโ dev.txt
โ โโโ docs.txt
โ โโโ gis.txt
jupyter_notebook_config.py: Needed to make sure notebooks open in browser (native from Windows)
install.sh: Installs Miniconda, Jupyter Notebook (and its extensions), installs base packages into base, creates venv(s) and installs the relevant packages into the venv(s).
Packages
Will be installed by packages/apt.sh, packages/brew.sh, and packages/npm.sh.
โโโ packages
โ โโโ apt.sh
โ โโโ brew.sh
โ โโโ npm.sh
apt.sh: Installs utilities from APT.
brew.sh Sets up and install Linuxbrew.
npm.sh: Sets up NVM and NPM. Installs reveal-md (reveal.js) and other utilities only available from NPM.
Windows
Will be installed by win/winget.ps1 and win/choco.ps1 (using PowerShell; win/choco.ps1 will require admin priviledges).
โโโ win
โ โโโ .wslconfig
โ โโโ .wslconfig-x1
โ โโโ chocolatey.ps1
โ โโโ terminal-settings.json
โ โโโ winget.ps1
โ โโโ wslconfig.sh
winget.ps1: Installs winget and follow up by installing other applications (e.g. Chrome, WindowsTerminal, Oh-My-Posh, GNUMake, PowerToys, 7zip, Slack, Sublime Text, Git etc.).
chocolatey.ps1: Installs Chocolatey and other Windows app that cannot be installed by winget (e.g., MikTex, TexStudio, tree, postgresql, pgadmin4, du, etc.). This will require PowerShell admin priviledges.
wslconfig.sh: Installs .wslconfig to c/Users/<username>
Miscellaneous (./misc/)
โโโ misc
โ โโโ img
โ โโโ .curlrc
โ โโโ .latexmkrc
โ โโโ .wgetrc
โ โโโ references.md
โ โโโ vimium.txt
References
See here.