mirror of
https://github.com/gaschz/dotfiles.git
synced 2025-03-01 14:22:33 +01:00
doc: lint markdown files
This commit is contained in:
parent
46d0753329
commit
56191dab6d
70
README.md
70
README.md
@ -1,41 +1,41 @@
|
|||||||
|
# dotfiles
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
SPDX-FileCopyrightText: 2023 - 2024 Benjamin Grande M. S. <ben.grande.b@gmail.com>
|
SPDX-FileCopyrightText: 2023 - 2024 Benjamin Grande M. S. <ben.grande.b@gmail.com>
|
||||||
|
|
||||||
SPDX-License-Identifier: CC-BY-SA-4.0
|
SPDX-License-Identifier: CC-BY-SA-4.0
|
||||||
-->
|
-->
|
||||||
|
|
||||||
# dotfiles
|
|
||||||
|
|
||||||
Dotfiles.
|
Dotfiles.
|
||||||
|
|
||||||
## Table of Contents
|
## Table of Contents
|
||||||
|
|
||||||
* [Description](#description)
|
* [Description](#description)
|
||||||
* [Installation](#installation)
|
* [Installation](#installation)
|
||||||
* [Salt](#salt)
|
* [Salt](#salt)
|
||||||
* [Script](#script)
|
* [Script](#script)
|
||||||
* [Usage](#usage)
|
* [Usage](#usage)
|
||||||
* [License](#license)
|
* [License](#license)
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
Configuration and scripts targeting:
|
Configuration and scripts targeting:
|
||||||
|
|
||||||
- Usability:
|
* Usability:
|
||||||
- Vi keybindings for application movement
|
* Vi keybindings for application movement
|
||||||
- Emacs keybindings for command-line editing
|
* Emacs keybindings for command-line editing
|
||||||
- XDG Specification to not clutter $HOME
|
* XDG Specification to not clutter $HOME
|
||||||
- Portability:
|
* Portability:
|
||||||
- POSIX compliant code
|
* POSIX compliant code
|
||||||
- Drop-in configuration files
|
* Drop-in configuration files
|
||||||
- Tested in Qubes OS Dom0, Debian, Fedora, OpenBSD
|
* Tested in Qubes OS Dom0, Debian, Fedora, OpenBSD
|
||||||
- Tasks:
|
* Tasks:
|
||||||
- GUI: x11, gtk
|
* GUI: x11, gtk
|
||||||
- SCM: git, tig, git-shell
|
* SCM: git, tig, git-shell
|
||||||
- Keys: gpg, ssh
|
* Keys: gpg, ssh
|
||||||
- Networking: curl, urlview, wget, w3m
|
* Networking: curl, urlview, wget, w3m
|
||||||
- Productivity: tmux, vim
|
* Productivity: tmux, vim
|
||||||
- Shell: sh, bash, zsh, less, dircolors
|
* Shell: sh, bash, zsh, less, dircolors
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
@ -48,11 +48,13 @@ If you want a machine independent installation, choose the [Script](#script)
|
|||||||
installation method.
|
installation method.
|
||||||
|
|
||||||
Install everything in a qube:
|
Install everything in a qube:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo qubesctl --skip-dom0 --targets=QUBE state.apply dotfiles.copy-all
|
sudo qubesctl --skip-dom0 --targets=QUBE state.apply dotfiles.copy-all
|
||||||
```
|
```
|
||||||
|
|
||||||
Install specific files in Dom0:
|
Install specific files in Dom0:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
sudo qubesctl state.apply dotfiles.copy-dom0,dotfiles.copy-sh,dotfiles.copy-vim,dotfiles.copy-x11
|
sudo qubesctl state.apply dotfiles.copy-dom0,dotfiles.copy-sh,dotfiles.copy-vim,dotfiles.copy-x11
|
||||||
```
|
```
|
||||||
@ -60,14 +62,17 @@ sudo qubesctl state.apply dotfiles.copy-dom0,dotfiles.copy-sh,dotfiles.copy-vim,
|
|||||||
### Script
|
### Script
|
||||||
|
|
||||||
You can simply deploy all configurations with:
|
You can simply deploy all configurations with:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
./files/setup.sh
|
./files/setup.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
Or target specific ones by specifying the directory name:
|
Or target specific ones by specifying the directory name:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
./files/setup.sh sh bash
|
./files/setup.sh sh bash
|
||||||
```
|
```
|
||||||
|
|
||||||
Note that some files might depend on other directories, specially `sh` which
|
Note that some files might depend on other directories, specially `sh` which
|
||||||
is a base for `bash` and `zsh` but might also have environment variables for
|
is a base for `bash` and `zsh` but might also have environment variables for
|
||||||
`net` and `vim`. It also adds `$HOME/.local/bin` and
|
`net` and `vim`. It also adds `$HOME/.local/bin` and
|
||||||
@ -75,11 +80,13 @@ is a base for `bash` and `zsh` but might also have environment variables for
|
|||||||
scripts, install the `sh` directory.
|
scripts, install the `sh` directory.
|
||||||
|
|
||||||
Reload your shell:
|
Reload your shell:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
exec $SHELL
|
exec $SHELL
|
||||||
```
|
```
|
||||||
|
|
||||||
Reload you X server:
|
Reload you X server:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
. ~/.config/x11/xprofile
|
. ~/.config/x11/xprofile
|
||||||
```
|
```
|
||||||
@ -94,14 +101,14 @@ configuration is implemented by including a local file per application.
|
|||||||
|
|
||||||
Supported programs and the expected file names in `$HOME`:
|
Supported programs and the expected file names in `$HOME`:
|
||||||
|
|
||||||
- **bash**: .bashrc.local
|
* **bash**: .bashrc.local
|
||||||
- **git**: .gitconfig.local
|
* **git**: .gitconfig.local
|
||||||
- **sh**: .profile.local, .shrc.local, .config/sh/profile.d/ (.sh suffix)
|
* **sh**: .profile.local, .shrc.local, .config/sh/profile.d/ (.sh suffix)
|
||||||
- **ssh**: .ssh/config.d/ (.conf suffix), .ssh/known_hosts.d/ (.host suffix)
|
* **ssh**: .ssh/config.d/ (.conf suffix), .ssh/known_hosts.d/ (.host suffix)
|
||||||
- **tmux**: .tmux.conf.local
|
* **tmux**: .tmux.conf.local
|
||||||
- **vim**: .vimrc.local
|
* **vim**: .vimrc.local
|
||||||
- **x11**: .xprofile.local, .config/x11/xprofile.d/ (.sh suffix)
|
* **x11**: .xprofile.local, .config/x11/xprofile.d/ (.sh suffix)
|
||||||
- **zsh**: .zshrc.local
|
* **zsh**: .zshrc.local
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
@ -110,6 +117,7 @@ list all licenses and copyrights and keep them up-to-date here.
|
|||||||
|
|
||||||
The easiest way to get the copyright and license of the project with the reuse
|
The easiest way to get the copyright and license of the project with the reuse
|
||||||
tool:
|
tool:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
reuse spdx
|
reuse spdx
|
||||||
```
|
```
|
||||||
|
@ -633,6 +633,7 @@ let g:ragtag_global_maps = 1
|
|||||||
" vim-markdown-toc deletes text if the file is folded, use manual updates
|
" vim-markdown-toc deletes text if the file is folded, use manual updates
|
||||||
let g:vmt_auto_update_on_save = 0
|
let g:vmt_auto_update_on_save = 0
|
||||||
let g:vmt_dont_insert_fence = 1
|
let g:vmt_dont_insert_fence = 1
|
||||||
|
let g:vmt_list_indent_text = " "
|
||||||
|
|
||||||
let b:commentary_startofline = 1
|
let b:commentary_startofline = 1
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user