README update for v5

This commit is contained in:
Wryn Wagner 2021-09-25 01:43:36 -06:00
parent f4ebf2ec69
commit e29ee080fa

View File

@ -1,46 +1,19 @@
# The `.wryn` Library # The `.wryn` Library
My collection of configurations and plugins.
A compilation of utilities which I use across my machines **this repo is principally for personal utility**. ## Setup / Configuration
Although I try to build utilities to be dependency aware, the library is considered to be in a good state when it works on my machine. The setup script is the pride and joy of this project.
Running an [interactive installer](./setup/linux) removes the hassle of setting up a new computer by configuring symlinks, installing applications, and synchronizing media with the cloud.
Feel free to use or adapt anything you find useful :) After running the setup, [default configurations](./env) can be overridden by editing the appropriate local configuration (`~/.config/wryn/env`).
## File Structure Breakdown ## System Breakdown
### [setup](./setup) `.wryn/MODULE` | Description
The pride and joy of this project. ---------------------------- | --------------------------------------
Running the script will set up the appropriate links and RC entries to enable the entire library. [setup/](./setup) | os-specific setup / update utilities
[config/](./config) | general configuration; appropriate `~/.config` files are symlinked on setup
Relatively robust, but always works best the OS I'm currently using (arch). [vim/](./vim) | `vim` keybindings, plugins, and dictionary binary; activated by an [entry rc](./vim/rc.vim)
[zsh/](./zsh) | `zsh` aliases, functions, and plugins; activated by an [entry rc](./zsh/rc)
### [config](./config) [zsh/plugins](./zsh/plugins) | external `zsh` plugins (included as submodules)
Configuration files / utilities. [resume/](./resume) | my working resume in `.tex` format
The setup script handles all the headache of symlinking each one to the right place. [freeze/](./freeze) | list of hardware specific packages...this will move to cloud storage soon
### [env](./env)
Default configuration used by the rest of the library.
You can override the environment by editing `~/.config/wryn/env` files after running setup.
### [resume](./resume)
My working resume in `.tex` format.
### [latex](./latex)
A compilation of LaTeX templates, used by the [`.wryn/zsh/latex`](./zsh/latex) utility.
Each template is composed of four files: `template.tex`, `body.tex`, `imports.sty`, and `formatting.sty`.
The `template.tex` file is the parent of the document, and thus the target of the latex compiler.
This can be renamed to match the document title, but typically does not contain the document body.
Every template will use the same parent `template.tex` file, so this is found at the `~/.wryn/latex` directory root.
### [vim](./vim)
Contains keybindings, dictionary binary, and custom plugins for `vim`.
### [zsh](./zsh)
Contains (a mess of) `zsh` aliases and functions used directly by a terminal user.
The [`.wryn/zsh/rc`](./zsh/rc), which loads the custom `zsh` modules is sourced directly from the user RC.
Any OS specific utilities are nested in appropriately named directories.
...this will be hacked to pieces very soon
### [freeze](./freeze)
A historical list of packages used on personal machines.
Also contains machine-specific `systemd` daemons for managing hardware-specific issues.
...this will likely move to a cloud storage soon.