readme: better setup explanations

This commit is contained in:
xeruf 2023-08-21 22:04:21 +02:00
parent a2a2943a1d
commit a67742c9d2
1 changed files with 31 additions and 22 deletions

View File

@ -1,29 +1,28 @@
* Dotfiles * Dotfiles
Welcome to Janek's dotfiles, Welcome to Janek's dotfiles,
thousands of lines of handcraft shell code thousands of lines of handcrafted shell code
to make the live of a linux sysadmin to make the live of a linux sysadmin and developer easier!
and developer easier!
I mainly use Arch Linux, I mainly use Arch Linux,
currently with the KDE desktop environment with tiling extension formerly with the KDE desktop environment with tiling extension,
with the intention of moving a proper tiling WM (Awesome or Sway) soon. on the move to Manjaro Sway.
This config is opinionated, This config is opinionated,
but currently deployed on multiple machines but currently deployed on multiple machines
including some other eager users including some other eager users.
who run Manjaro Sway.
Thus I am progressively generalising it. Thus I am progressively generalising it.
If you are not one of those, If you are not one of those,
you can safely skip the following section. you can safely skip the following section.
** Usage ** Usage
Here are some basic commands you should remember: Here are some basic commands to remember:
- ~u~ to upgrade everything (works on arch-based systems with topgrade installed and any debian-based system, with safeguards to ensure upgrade stability even on longtime dormant machines) - ~u~ to upgrade everything (works on arch-based systems with topgrade installed and any debian-based system, with safeguards to ensure upgrade stability even on longtime dormant machines)
- yas :: interactively install software packages - yas :: interactively install software packages
- yar :: interactively uninstall software packages - yar :: interactively uninstall software packages
- loc :: quickly find a file on your system, case-insensitive - loc :: quickly find a file on your system, case-insensitive
- loca :: do a deep search for a file on the whole system, case-insensitive - loca :: do a deep search for a file on the whole system, case-insensitive
- loce :: find a file/directory with exact name match - loce :: find a file/directory on your system with exact name match
- moul :: mount a device interatively (unmount with ~umoul~) - moul :: mount a device interatively (unmount with ~umoul~)
*** Mounting Manually *** Mounting Manually
To mount a device, To mount a device,
@ -31,11 +30,12 @@ first check ~ds~ ([d]isk [s]tats, a prettification of ~lsblk --fs~)
and find your device, and find your device,
then call ~moul~ with the respective name or label, then call ~moul~ with the respective name or label,
e.g. ~moul my-usb~ or ~moul sdc2~. e.g. ~moul my-usb~ or ~moul sdc2~.
This will mount the device and jump to the mounted directory. This will mount the device and enter the mounted directory.
As long as you are in the device directory As long as you are in the device directory
you can unmount it simply by calling ~umoul~, you can unmount it simply by calling ~umoul~,
otherwise provide the argument used above again. otherwise provide the argument from above again.
* Overview * Overview
If you are looking to snag some of my handy tools, If you are looking to snag some of my handy tools,
focus on [[./.local/bin/scripts][.local/bin/scripts]] and [[./.config/shell][.config/shell]]. focus on [[./.local/bin/scripts][.local/bin/scripts]] and [[./.config/shell][.config/shell]].
@ -45,11 +45,11 @@ which in turn use ~zfz~, ~zf~ and ~locz~.
~ex~, ~m~, ~moul~, ~grpr~ / ~rpl~, ~s~, ~sd~, ~tl~ are also commonly used conveniences. ~ex~, ~m~, ~moul~, ~grpr~ / ~rpl~, ~s~, ~sd~, ~tl~ are also commonly used conveniences.
Below is an overview of the structure Below is an overview of the structure.
** Home ** Home
I am trying to keep my home clean, I try to keep my home clean,
but some files unfortunately cannot be moved. but some files unfortunately cannot be moved.
Out of these, only [[.zprofile][.zprofile]] is of interest, Out of these, only [[.zshenv][.zshenv]] is of interest,
it contains lots of mappings to store files according to XDG it contains lots of mappings to store files according to XDG
and configuration for ~less~ and ~fzf~. and configuration for ~less~ and ~fzf~.
** .config ** .config
@ -59,20 +59,29 @@ and configuration for ~less~ and ~fzf~.
- ideavim, vifm, nvim :: vi-related tools - ideavim, vifm, nvim :: vi-related tools
- git, yadm :: version control - git, yadm :: version control
** .local ** .local
- [[.local/bin/scripts][scripts]] :: lots of useful scripts, - [[.local/bin/scripts][bin/scripts]] :: lots of useful scripts,
most have a short documentation header - most have a short documentation header -
including many essential git scripts including many essential git scripts
* Package Setup (moving to [[https://git.jfischer.org/xeruf/instalee][Instalee]]) - [[.local/bin/server][bin/server]]-scripts :: a few scripts for use on servers
* Package Setup (moving to [[https://github.com/xeruf/instalee][Instalee]])
By Size: By Size:
: LC_ALL=C pacman -Qi | awk '/^Name/{name=$3} /^Installed Size/{print $4$5, name}' | sort -h : LC_ALL=C pacman -Qi | awk '/^Name/{name=$3} /^Installed Size/{print $4$5, name}' | sort -h
Copy list of in stalled packages: Copy list of in stalled packages:
: pacman -Qe | cut -d\ -f1 | xclip -selection clipboard : pacman -Qe | cut -d\ -f1 | xclip -selection clipboard
- dotfiles :: yadm
: yadm clone --bootstrap git@git.jfischer.org:xeruf/dotfiles.git
: yadm clone --bootstrap https://git.jfischer.org/xeruf/dotfiles.git
Run ~bootstrap~ after starting ZSH
Basics: diffr fzf - dotfiles :: yadm
: yadm clone --bootstrap https://code.ftt.gmbh/janek/dotfiles.git
Run ~yadm bootstrap~ again after starting ZSH to finish initialization.
Basic required packages for scripts: diffr fzf
** Full Personal Setup
Manjaro:
#+begin_src sh
yay -Syu yadm instalee-full-git
yadm clone --bootstrap git@code.ftt.gmbh:janek/dotfiles.git
instalee arch/base
#+end_src
** Applications ** Applications
- utilities :: youtube-dl dos2unix rlwrap - utilities :: youtube-dl dos2unix rlwrap
- powertools :: hexedit hexyl [[https://lftp.yar.ru/][lftp]] glances zsh-doc pacman-contrib - powertools :: hexedit hexyl [[https://lftp.yar.ru/][lftp]] glances zsh-doc pacman-contrib
@ -115,7 +124,7 @@ texlive-core texlive-latexextra texlive-most-doc
context-bin context-bin
: git clone --depth 1 https://github.com/hlissner/doom-emacs ${XDG_CONFIG_HOME:-$HOME/.config}/emacs && ${XDG_CONFIG_HOME:-$HOME/.config}/emacs/bin/doom -y install : git clone --depth 1 https://github.com/hlissner/doom-emacs ${XDG_CONFIG_HOME:-$HOME/.config}/emacs && ${XDG_CONFIG_HOME:-$HOME/.config}/emacs/bin/doom -y install
- mail :: offlineimap mu - mail :: offlineimap mu
*** [[id:firefox][Firefox]] Addons *** Essential [[id:firefox][Firefox]] Addons
**** Password management **** Password management
***** Pass - the unix password manager ***** Pass - the unix password manager
Store all kinds of secrets in plain text Store all kinds of secrets in plain text