mirror of
				https://github.com/gaschz/dotfiles.git
				synced 2025-10-31 03:28:58 +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
	 Ben Grande
						Ben Grande