Xander’s Dot Files and Sundry Store

Abstract

Xander’s Dot files and Sundry Store documentation master file, created by sphinx-quickstart on Sat Jan 20 10:30:38 2024. You can adapt this file completely to your liking, but it should at least contain the root toctree directive.

Xander’s Dot Files and Sundry Store#

Documentation#

contents

NeoVIM plugins#

This role assumes the presence of NeoVIM and it’s related configuration directories. It installs the following plugins.

Minutiae#

meta

Indices and tables#

Readme#

GitHub Pages Deployment   GitHub Actions Workflow Status wakatime Coverage Status Code style: black

<3 bash#

Best Amazing SHell is the best.

Supported Distributions#

Though mainly work is done on ArchLinux because apt is a bummer.

GitHub Actions#

You can delete unwanted workflow runs with this script.

for run in $(gh run list --json databaseId --jq '.[].databaseId'); do
    gh run delete $run;
done

Usage#

This repository has three main plays, explained below.

  1. Local user, as in your Linux username. The values in site.yml represent my personal settings, all variables are required.

    ansible-playbook -t user site.yml

    The default configuration will run this on localhost.

  2. A service account, as in the account you would use to run bind.

    ansible-playbook -t sa site.yml

    The default configuration assumes a group named ns in your Ansible inventory.

  3. The root account, you shouldn’t be using this account but if you’re always tinkering with stuff like the author does, then you’ll want to have reasonable settings for the shell at least.

    ansible-playbook -t root site.yml

tools#

Apparently, neovim has completely eliminated the need for anything as silly as VSCode or some other abominable thing like emacs.

Sphinx extensions used by the documentation include the following.

  1. myst-parser

  2. sphinxcontrib-autoyaml

  3. sphinx-copybutton

  4. sphinx-last-updated-by-git

pre-commit hooks#

  1. markdownlint-cli2

  2. black

Glossary#

AD#

AD is short for Active Directory, which is a collection of network services that are intended to provide an enhanced LDAP service.

Ansible#

Ansible offers open-source automation that is simple, flexible, and powerful.

ArchLinux#

ArchLinux a lightweight and flexible Linux® distribution that tries to Keep It Simple.

crowdsec#

A free, OSS firewall that takes advantage of the wisdom of crowds.

DC#

DC is short for Domain Controller, this is a system that manages domain services for a computer network.

dotfiles#

A colloquial reference to the files one uses to configure one’s shell program, named for their tendenancy to begin with a dot.

etcd#

etcd is a key value store that is used by Kubernetes Control Planes

netctl#

netctl is a program that allows the configuration of multiple network interfaces on a single system.

For more information on setting up profiles, see netctl.profile(5)

router#

Router is piece of network infrastructure that sends network packets to the appropriate destination.

Sphinx#

[Sphinx](https://sphinx-doc.org is a static site generator that is used to generate the documentation for this repository.

sysctl#

sysctl is a utility that can be used to configure Linux system options.

See this documentation for more information about how to configure sysctl.

You can also read the related man page, sysctl.d.5.

systemd#

systemd is a set of programs that manage the boot process and system services for Linux after the kernel has been loaded. It is usually run as PID 1.

ufw#

ufw is Un-Complicated Firewall, which is an Ubuntu project designed to make managing Linux firewalls less of a disaster area.

Extensions#

Some of the extensions used to generate this repository’s documentation were sourced from sphinx-extensions.

The most important are listed here.

Contents