Marty Oehme
083973e7c1
Also given new mapping. Hit `<c-t>` instead of `<c-x>`. `<c-x>` (in insert mode) instead now brings up the path completion which was previously on the other mapping. On any line in a markdown-like file (i.e. markdown, quarto, djot, etc.), we can hit `<c-t>` in normal mode or insert mode to toggle the current line having a checkbox or not. It takes care to leave the current item a list item like it was if it already was filled with content. It does _not_ remove the list item even if it is empty, this may be an improvement for the future (i.e., empty line -> we hit <c-t> -> line turns into `- [ ] ` -> we hit <c-t> -> line stays `- `). But care should be taken to not remove a list item if we don't intend to, e.g. we could have toggled part of a list beforehand and don't want to remove the list on each toggle. That's why it is more conservative for now and I think it should work well enough (the case is likely to be rare in my mind). Also, while it does pick up the extended checkbox symbols ([o], [~], [-]), those are currently hardcoded into the query. In my mind it should pick those up dynamically from another plugin instead of hardcoding here, e.g. render-markdown which also defines the symbols? Lastly, we could extend it to use treesitter queries instead / on top if TS is found which would make it more robust than regex matching. But for an hour of hacking it works quite well. |
||
|---|---|---|
| .assets | ||
| .dotter | ||
| .githooks | ||
| bootstrap | ||
| desktop | ||
| disks | ||
| multimedia | ||
| nvim/.config | ||
| office | ||
| pass | ||
| qutebrowser | ||
| scripts | ||
| services | ||
| sh | ||
| social/.config | ||
| ssh | ||
| terminal | ||
| vcs | ||
| writing | ||
| .gitignore | ||
| .gitmodules | ||
| install.sh | ||
| LICENSE | ||
| README.md | ||
~/🌹
Note that the below screenshots still show the X configuration from v0.1 which is very old by now. The current dotfiles are geared toward wayland for which the setup looks similar but not identical to the previews below.
What's in these dotfiles
- wayland setup using
riverwmwith quick access to many overlays and picking tools for styles, downloads, browsing history, passwords and more - vim configuration for simple programming tasks (especially python/bash/lua) and prose (markdown/quarto/latex)
- academic workflow tools, to allow quick citation, pdf compilation, and preview
- simple, efficient waybar with package update notification and mpris integration
- system-wide color management (terminals, vim, qutebrowser, polybar, xresources) through
flavoursapplication using base16 themes - quick theme switching by activating
flavoursand fuzzy-searching themes with hot-key (default<Super>=<Shift>+S) - quick directory jumping using
z, withfzfintegration fzf-like integrations for bibtex citation, vim buffer management, most recently used switching, shell command history, and more- password management with
passand picking it with automatic typing into any window
Quick-Start
The dotfiles use dotter to link themselves in the home directory. You can clone this repository anywhere (though I have mine in ~/.dotfiles as it seemed most logical for me).
I would recommend doing an initial git clone --recursive for this repository, since it contains git submodules, which will then automatically get pulled in as well.
Of course, you can do it non-recursively and then just pull those modules selectively which you actually want.
Once in the repository directory, when you then run ./install.sh it will install many of the packages I use (though they are probably slightly out-of-date) and link the dotfiles into the home directory.
I would mostly recommend this on fresh machines or a test machine first - it will link my personal dotfiles and, if you allow it, will install quite a few packages.
By default it will ask your consent for some steps -- use ./install.sh -f to force yes to everything.
The dotfile installation procedure is based on dotter, it will generally not overwrite anything already in the home directory, but of course be observant when doing ptentially destructive operations.
NOTE The same non-destructive installation procedure does not apply to the package installation and system setting file linking, where it can potentially overwrite or remove existing files.
After all files are linked and you open a new shell session, the dotlink alias will allow you to re-link all dotfiles from anywhere on the system.1
Both automatic installation paths are presumably somewhat brittle. In any case, I would suggest to manually look through the files for things you want instead of copying and activating everything. Dotfiles are too personal to be standardized like that. They're pets, not cattle. Enjoy!
Main Modules
wayland- Containing basics for fully functional tiling wayland setup:wezterm- Terminal emulator and multiplexer (fast, understandable and lua configurable)nvim- Neovim configurationvifm- vim-like file-managerqutebrowser- vim-key enabled web browserpass- Password management suite- [
typst] - LateX/BibteX/pandoc-like plaintext writing & reference suite jujutsu- distributed version control system, together with git.office- office/productivity software for writing e-mail and setting appointments
Notes
- Generally, most configuration for applications attempts to follow the XDG specifications, keeping configuration in .config directory and supplementary files in .local/share directory. Over time, I am moving more applications to this standard: it keeps the home directory clean, and the separation of configuration, binaries, and data relatively clear.
- The
zshdirectory contains all setup for the z-shell, my daily work environment. It should not be required for working with any other module but will add additional functionality to many (such as command auto-completion and so on).shsets some base functionality for any shell you may wish to work in. It is, for now, the only module that is required for some other modules to work.2 roficontains additional scripts and a simple theming framework for rofi and should probably be reorganized to put the correct files into the correct directories (per xdg) at some point.- Whereas
shmodule scripts are requirements for other scripts,.local/binin thescriptsmodule contains most executable user scripts. Most of these have been migrated to other corresponding modules (e.g. if a script exclusively targets git functionality, it will live there), some useful --- or left-over --- stand-alone scripts remain however. .local/share/pandoccontains configuration for academic latex writing (pandoc, really) and is of interest if you want to use this functionality..xinitrcis used for x initialization and program startup. At some point, some of the consistently running applications may be moved to systemd/runit as supervised services.- Generally, top-level directories starting with a . are only meaningful for the repository not for the functionality of the machine that these dotfiles are deployed on. That means
.gitlab-ci.yml,.assets/,.gitignoreand similar files and directories will not show up in the final deployment in any home directory. Perhaps they should be called dotdot-files since they're the dotfiles for my dotfiles. 🙂 (Also, 'dotfiles'.)
-
This alias only works when the dotfiles are cloned into
~/.dotfiles, mirroring my setup. This is due to a hard-coded cd into this directory. If your dotfiles lie in another directory, and you want to use the dotlink alias, simply change the corresponding line inbootstrap/.config/sh/alias.d/dotlink.sh↩︎ -
I may remove this requirement in the future to make modules more self-contained. However, relying on some base utility scripts makes it easier to avoid duplicating such functionality for each individual script in other modules. ↩︎