mirror of
https://github.com/Matir/skel.git
synced 2026-05-25 21:19:09 -07:00
62 lines
2.6 KiB
Markdown
62 lines
2.6 KiB
Markdown
## Installation and Environment
|
|
|
|
This is a set of dotfiles and utilities for setting up my personal environment
|
|
on POSIX-style environments. It is cloned from github and installed from the
|
|
`install.sh` script.
|
|
|
|
It mostly relies on symlinking dotfiles and other resources into the appropriate
|
|
locations, but also installs dependencies in various ways.
|
|
|
|
I primarily target Debian Linux-based (Debian, Ubuntu, and Kali Linux) systems
|
|
as well as MacOS. Other platforms are lower priorities. Shell scripts ending
|
|
in `.sh` should use only POSIX features unless there is a shebang line at the
|
|
beginning suggesting a different shell will be used.
|
|
|
|
`zsh` and `fish` are the key interactive shells to be configured, but `bash`
|
|
may also be used at times.
|
|
|
|
## Project Structure
|
|
|
|
* `bin/`: Contains executable scripts that should be available in the shell's `PATH`.
|
|
* `dotfiles/`: Contains configuration files (dotfiles) to be symlinked into the home directory.
|
|
* `packages/`: Contains lists of packages to be installed by the `install.sh` script. Each file in this directory corresponds to a package set.
|
|
* `install.sh`: The main installation script that sets up the environment, symlinks dotfiles, and installs packages.
|
|
|
|
## Notes on Security Issues
|
|
|
|
It is safe to have scripts and tools re-invoke themselves with sudo when they
|
|
require elevated privileges, as these are my own. Do not attempt to remove
|
|
these use cases.
|
|
|
|
## Making Changes
|
|
|
|
**IMPORTANT**: Only make those changes which are explicitly requested. If you
|
|
identify other issues, notify me about them, but do not suggest changes until I
|
|
ask for them.
|
|
|
|
When making large changes, explain your chain of thought transparently and
|
|
explain solution design.
|
|
|
|
If making changes that affects how the user installs the tools, update
|
|
`README.md` accordingly.
|
|
|
|
### Adding a new dotfile
|
|
|
|
1. Place the new dotfile in the `dotfiles/` directory.
|
|
2. The `install.sh` script will automatically symlink it to the home directory.
|
|
|
|
### Adding a new script to `bin/`
|
|
|
|
1. Add the new script to the `bin/` directory.
|
|
2. Ensure the script is executable (`chmod +x`).
|
|
|
|
### Adding a new package
|
|
|
|
1. Identify the appropriate package list in the `packages/` directory (e.g., `packages/cli`, `packages/kali`).
|
|
2. Add the new package name to the list.
|
|
3. If a new package set is required, create a new file in the `packages/` directory.
|
|
|
|
### Platform-specific changes
|
|
|
|
When making changes that are specific to a platform (e.g., Debian vs. macOS), please check for existing conventions in the `install.sh` script or other files. Use conditional logic (e.g., checking `uname`) to apply platform-specific settings.
|