protesilaos.dotfiles/README.md
Protesilaos Stavrou 4e593e602f
IMPORTANT UPDATE to the repo's README
Remove the old notice.  In its stead add a proper description of what my
custom desktop session is about.  More importantly, provide crucial
information about my free/libre book: "Prot's Dots For Debian (PDFD)".

Users who wish to reproduce my custom desktop session are expected to
read PDFD and work with its bespoke code repo ("Code for PDFD"):
https://gitlab.com/protesilaos/cpdfd.  CPDFD is a clone of my dotfiles
that only tracks its latest fixed release.

For the releases, use `git`:

    ~/dotfiles $ git tag --list
    v1.0.0.pdfd_rc1
2019-04-17 10:00:01 +03:00

2.1 KiB

Custom desktop session (BSPWM) and configurations for GNU/Linux

My custom desktop session can be outlined thus:

  • Debian stable because rolling release distros tend to be overrated.
  • bspwm for fine-grained window management.
  • tmux to make the terminal power user even more powerful (no plugins).
  • vim because I can't exit it (no plugins).
  • Carefully-defined font configurations to complement my hardware and satisfy my aesthetic preferences.
  • Full integration of my Tempus themes for considerate colour contrast and easy live theme switching for the entire session.
  • The superb Maté desktop environment as a fallback option and provider of some important programs and system-wide base configurations.

Demos

Get my configs

To reproduce my custom desktop session on Debian 10 'buster', follow the detailed instructions in my book "Prot's Dots for Debian (PDFD)": https://protesilaos.com/pdfd. It is freely available under the terms of Creative Commons Attribution-ShareAlike License Version 4.0 International.

PDFD will only offer guidance about the latest "fixed release" of my dotfiles. These are tagged with the appropriate annotation (formatted as .pdfd<?_label>) and are then synced with a separate code repo, titled "Code for PDFD": https://gitlab.com/protesilaos/cpdfd.

Do not track my dotfiles directly

My dotfiles' repo functions as a laboratory for my custom desktop session. I offer no support whatsoever about tracking it and may introduce breaking changes without prior notice.

Just use PDFD. It is why I spent an inordinate amount of time cleaning up the code, documenting it extensively, and ultimately writing instructions about how to reproduce it.

That granted, you can always open an issue here or contribute any fixes.

Copying

Unless otherwise noted, all code herein is distributed under the terms of the GNU General Public License Version 3 or later.