doc: lint markdown files

This commit is contained in:
Ben Grande 2024-07-04 17:08:52 +02:00
parent 46d0753329
commit 56191dab6d
No known key found for this signature in database
GPG Key ID: 00C64E14F51F9E56
2 changed files with 40 additions and 31 deletions

View File

@ -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
``` ```

View File

@ -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