{"id":18948884,"url":"https://github.com/gkapfham/dotfiles","last_synced_at":"2025-04-15T23:31:08.458Z","repository":{"id":38845133,"uuid":"59601884","full_name":"gkapfham/dotfiles","owner":"gkapfham","description":":battery: Configuration \"Dotfiles\" for Programs used by Gregory M. Kapfhammer","archived":false,"fork":false,"pushed_at":"2024-11-03T01:31:08.000Z","size":2238,"stargazers_count":14,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-03T02:21:11.362Z","etag":null,"topics":["dotfiles","muttrc","vimrc","zshrc"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gkapfham.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-05-24T19:22:31.000Z","updated_at":"2024-04-08T16:31:17.000Z","dependencies_parsed_at":"2024-02-05T01:25:00.218Z","dependency_job_id":"150397d2-775a-44b4-874b-4eb8cbbd457e","html_url":"https://github.com/gkapfham/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkapfham%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkapfham%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkapfham%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gkapfham%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gkapfham","download_url":"https://codeload.github.com/gkapfham/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223688650,"owners_count":17186299,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dotfiles","muttrc","vimrc","zshrc"],"created_at":"2024-11-08T13:14:57.560Z","updated_at":"2024-11-08T13:14:58.927Z","avatar_url":"https://github.com/gkapfham.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dotfiles\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/gkapfham/dotfiles/master/.github/dotfiles-logo.jpeg\" alt=\"Dotfiles Logo\"\u003c/img\u003e\n\u003cbr\u003e\n\u003cb\u003e\nCarefully Curated Dotfiles for Popular Linux Programs\n\u003c/b\u003e\n\u003c/p\u003e\n\n[![Build Status](https://travis-ci.org/gkapfham/dotfiles.svg?branch=master)](https://travis-ci.org/gkapfham/dotfiles)\n\nThis repository contains the configuration files (i.e., \"dotfiles\") used to\nconfigure the programs regularly used by me, [Gregory M.\nKapfhammer](https://www.gregorykapfhammer.com/). Please note that the dotfiles\nin this repository are, at least to some extent, \"hard-coded\" to work for my\ndevelopment environment and projects. For instance, I created these\nconfiguration files under the assumption that a developer will use Arch Linux.\nEven though they are heavily customized, my hope is that they are largely\nreusable and, additionally, will give examples of how to configure various\nprograms such as `i3`, `mutt`, `nvim`, `polybar`, `tmux`, `vim`, and `zsh`.\n\nThis is a summary of some of the dotfiles and program configurations that I\ncreated and actively maintain:\n\n- `.Rprofile`: initialization for the R programming language\n- `.Xresources`: configuration for the Rofi for displaying menus\n- `.bibtoolrsc`: configuration for the `bibtool` program's BibTeX management\n- `.ctags`: extensions for `exuberant-ctags` to handle new languages\n- `.compton.conf`: configuration for the `compton` compositor used with `i3`\n- `.gitconfig`: configuration file for Git, including customized aliases\n- `.gitignore_global`: configuration of the files to exclude from Git repositories\n- `.gvimrc`: legacy configuration of `gvim` text editor\n- `.indentconfig.yaml`: pointer to configurations for the `latexindent` program\n- `.chopsentences.yaml`: configuration for the `latexindent` program to do semantic linefeeds\n- `.inputrc`: configuration of all input-enabled tools with `vi`-like mappings\n- `.latexmkrc`: configuration for the `latexmk` wrapper for LaTeX compilers\n- `.mailcap`: configuration for how MIME-enabled programs load files\n- `.minivimrc`: minimal configuration of `vim` and `nvim` for testing purposes\n- `.msmtprc`: legacy configuration for the `msmtp` SMTP client\n- `.muttprintrc`: configuration of the `muttprint` program for printing emails\n- `.muttrc`: configuration of the `mutt` mail user agent\n- `.oh-my-zsh.sh`: customized script to load the oh-my-zsh framework\n- `.zprofile`: script to run when first starting the shell environment\n- `.signature`: footer displayed by `mutt` in all email messages\n- `.tmux.conf`: configuration of the `tmux` terminal multiplexing tool\n- `.urlview`: configuration for the `urlview` program used with `mutt` and `tmux`\n- `.vimrc`: configuration for the `nvim` and `vim` text editors\n- `.xinitrc`: configuration for to set environment variables and to start i3\n- `.zshrc`: configuration for the `zsh` shell to use oh-my-zsh\n- `.config/bat/themes`: theme configuration to ensure that `bat` looks like `nvim`\n- `.config/alacritty`: configuration and color scheme for the `alacritty` terminal window\n- `.config/dunst`: configuration and scripts for the `dunst` notification manager\n- `.config/gtkrc-2.0`: configuration of GTK 2.0 to support legacy GTK programs on Arch Linux\n- `.config/gtkrc-3.0`: configuration of GTK 3.0 to support GTK programs on Arch Linux\n- `.config/i3`: configuration and scripts for the `i3` window manager\n- `.config/polybar`: configuration and scripts for the `polybar` used with `i3`\n- `.config/termite`: configuration and color scheme for the `termite` terminal window\n- `.config/zathura`: configuration for the `zathura ` PDF viewer\n- `.local/bin`: scripts for regular use through the terminal window and `rofi`\n\nAre you looking for some neat configurations to improved your own dotfiles? If\nso, then I encourage you to review the `.vimrc`, `.zshrc`, and `.tmux.conf`\nfiles that I regularly improve. Interesting in learning how to configuration the\ni3 window manager? Then, you are invited to review the `.config/i3` and\n`.config/polybar` directories. Please note that many of these files have\ngroupings with beginning and ending marks that respectively look like `{{{` and\n`}}}`, thereby helping to group the regions.\n\nTo ensure that my development environment is largely self-contained, this\nrepository also includes Git submodules of the packages that I actively use in,\nfor instance, the `zsh` shell. When I needed to heavily customize a specific\nplugin or tool I forked a specific GitHub repository and then made my\nimprovements in that fork. Otherwise, I added the needed repository as a\nsub-module to this one. These are the current submodules that I maintain:\n\n- `fastsyntaxhighlighting`\n- `fzftab`\n- `gitstatus`\n- `tpm`\n- `zshautosuggestions`\n- `zshdefer`\n- `zshgitprompt`\n- `zshsyntaxhighlighting`\n\n## Installation Instructions\n\nYou can type the following command if you want to clone this repository:\n\n```shell\ngit clone https://github.com/gkapfham/dotfiles.git\n```\n\nNow, you can type `cd dotfiles` and start to browse the configuration files that\nare available. I suggest that you make symbolic links from your home directory\nto this repository if you want to maintain and use these configuration files.\nFor instance, if you use the `bibtool` program to manage your BibTeX files and\nif you were in your home directory and the `dotfiles/` directory was in\n`configure/`, then you would type the following command to create the\n`.bibtoolrsc` as a symbolic link to the file in the `~/configure/dotfiles/`\ndirectory containing this repository.\n\n```shell\nln -s ~/configure/dotfiles/.bibtoolrsc .bibtoolrsc\n```\n\nAs an alternative to manually creating all of the symbolic links in the\naforementioned fashion, this repository has a `Makefile` with rules that use\n`stow` to create these symbolic links automatically. If a system already\ncontains dotfiles that you no longer needed and you want to remove them from the\nsystem, then please type the command `make purge`. Next, typing the command\n`make dotfiles` will create all the needed directories and subdirectories and\nmake symbolic links to the dotfiles in this repository from the correct\ndestination directories. In summary, the main command to type is:\n\n```shell\nmake dotfiles\n```\n\n## Problems or Praise\n\nIf you have any problems with downloading or understanding these configuration\nfiles, then please create an issue associated with this Git repository using\nthe [Issues](https://github.com/gkapfham/dotfiles/issues) link at the top of\nthis repository. As the sole contributor to the `dotfiles` repository, I will\ndo everything possible to resolve your issue and ensure that all the\nconfigurations are clear and, potentially, best suited to working in your\ndevelopment environment. Remember, this repository is being made publicly\navailable to provide examples of how to write configurations for programs\nlike `vim`, `nvim`, and `i3`. If you find that these files help you in\npreparing your own configurations, then I also encourage you to \"star\" and\n\"watch\" this project!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgkapfham%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgkapfham%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgkapfham%2Fdotfiles/lists"}