Install documentation

OS intended: Ubuntu (Debian based, with access to standard ppa), Guix

The main script currently works out of the batch, in a fresh Ubuntu installation.

1. You should install `git`: `sudo apt-get install git`;
2. Clone the repository, git clone https://github.com/BuddhiLW/dotfiles.git;
3. cd dotfiles;
4. export DOTFILES=$(pwd)
5. Execute main script: bash ./main.sh;

That’s it.

As a one-liner:

sudo apt-get install -y git && git clone https://github.com/BuddhiLW/dotfiles.git && cd dotfiles && DOTFILES=$(pwd) bash ./main.sh

See the IMPORTANT: Extra functionalities to understand more about extra functionalities and the main editors for this build! Note: Plans to migrate it to a Bonzai-based script, called arara. [fn:3]

Issues

Feel free to issue any requests or issues, if you encounter trouble installing, from a Vanilla Ubuntu (fresh install). You (of course) can try it out in a non-vanilla install. That’s ok, but state that clearly, in the issue, so we can hold the possibility of the issue having to do with conflicting configs.

Documentation

Documentation for Xmonad Bindings

• Markdown: .config/documentation/xmonad-bindings-tables.md
• PDF: .config/documentation/xmonad-bindings-tables.pdf

M-d will open the PDF for consulting.

Note: Modifying it and building your own version should be as easy as:`vim $DOTFILES/.config/documentation/xmonad-bindings-tables.md && dotdoc-compile`

What the script does

It’s a cascade of bash scripts to install programs from source, or from Debian repositories (PPAs).

The first setup/script-names that are run - before the install/script-names ones - they create symlinks and refresh, when needed, the script-process environmental variables (through source command etc).

This is all done to ensure you only have to run this script, and nothing more.

It would be recommended that you run export DOTFILES=$(pwd), inside the dotfiles directory, before running the script. Just to make 100% sure this path-variable is correctly set.

#!/usr/bin/bash
export DOTFILES=$(pwd)
DOTFILES=$(pwd)

ln -sf $DOTFILES/.bashrc $HOME/.bashrc
rm -rf $DOTFILES/gitthings
SC="$DOTFILES/scripts/"
cd $SC
bash ./setup/bk-dots
bash ./setup/init
bash ./scripts/setup/link-config

source $HOME/.bashrc

bash ./install/main
# make newly installed fonts available
fc-cache -vf

# Install the window manager
bash ./setup/xmonad
bash ./install/xmonad

echo "Congrats. If everything went well, you have the newest Buddhi WM installed."
echo "New step, you can logout from your current Ubuntu session, and chose XMonad,"
echo "instead of GNOME Window Manager. This choice is generally done at the login"
echo "interface."

To understand more about the efforts behind this ricing-system, read the KEG node devoteed to the subject[fn:1].

IMPORTANT: Extra functionalities

A lot of “non-essential” installs are available at dotfiles/scripts/install

My two main editors are Emacs and Vim. So, I will comment their scripts.

Native compiled Emacs

You already have Emacs installed, but you can compile it from source, with optimizations.

bash ./scripts/install/emacs

Afterwards, doom install and doom sync; you are ready to go.

Vim build

To setup a sweet and basic vim build:

bash ./scripts/install/vim

NOTE: after running this script, run vim, and then give the command: :PlugInstall, inside it. This will download all the dependencies to make the build sweet.

About the full repository

Take a look at all the scripts available at dotfiles/scripts/install, and run them as you see fit. Just the bare-minimum are run at BLWM’s main setup, to give a functional and light build. Not even me, when in a fresh computer, will install all of them. This collection was built over time.

ls ~/dotfiles/scripts/install/

Footnotes

[fn:1] 67 Creation of a bootstraping/ricing system [fn:2] https://github.com/rwxrob [fn:3] https://github.com/BuddhiLW/blw-zet/blob/main/139/README.md