syspunktdateien/README.md

56 lines
2.1 KiB
Markdown
Raw Normal View History

2024-03-15 01:39:21 +01:00
# jstm's sysdotfiles
## Read this first!
Running `install.sh` or `uninstall.sh` will delete and change some things in your /etc and /usr/local/bin directories!
### Affected directories
- /etc/jstmbash
- /etc/pacman.d
### Affected files
- /etc/bash.bashrc
- /etc/jstmbash.env
2024-03-15 02:04:30 +01:00
- /etc/locale.gen
- /etc/locale.conf
- /etc/vconsole.conf
2024-03-15 02:04:35 +01:00
- /etc/localtime
2024-03-15 01:39:21 +01:00
- /etc/pacman.conf
2024-03-15 02:04:30 +01:00
- /etc/paru.conf
2024-03-15 01:39:21 +01:00
- /etc/makepkg.conf
2024-03-15 02:04:30 +01:00
- /etc/mkinitcpio.conf
- /etc/sudo.conf
2024-03-15 01:39:21 +01:00
## Recommendation
Please, do not modify any files. It will only cause issues during the update process. \
If you wish to make your own system dotfiles repo, you can of course modify files and then make your own repository.
## Managing
### Installing
This will remove all related files and install some software. \
2024-03-15 02:04:30 +01:00
***WARNING: Please back up all files listed above, most important are /etc/pacman.conf, /etc/pacman.d and /etc/makepkg.conf since you'll likely need these to reinstall all other packages to restore their configuration files. Backing up all files and directories though is HIGHLY RECOMMENDED***
2024-03-15 01:39:21 +01:00
```bash
git clone https://git.staropensource.de/JeremyStarTM/syspunktdateien.git "/etc/sysdotfiles"
cd "/etc/sysdotfiles"
./install.sh
```
### Updating
This will remove all related files, pull and then link everything again automatically.
```bash
sysdotfiles-updater
```
### Uninstalling
This will reset all programs to their original state and remove `/etc/sysdotfiles` completely. \
***WARNING: This will erase all installed configuration files and directories. Please reinstall all packages with your package manager, if it's even functional. Please use your backed up files. If you didn't back them up, shoot yourself in the foot.***
```bash
cd "/etc/sysdotfiles"
env REMOVE_INSTALLBIT=true REMOVE_REPOSITORIES=true ./uninstall.sh
cd "/"
rm -rf "/etc/sysdotfiles"
```
### Repairing
This will *should* repair any issues you could have with this repository.
```bash
cd "/etc/sysdotfiles"
env REMOVE_INSTALLBIT=true REMOVE_REPOSITORIES=true ./uninstall.sh
./install.sh
"/usr/local/bin/sysdotfiles-updater" --force
```
If you are still facing issues, contact me.