diff --git a/.prettierrc b/.prettierrc new file mode 100644 index 000000000..965bcdb5e --- /dev/null +++ b/.prettierrc @@ -0,0 +1,4 @@ +{ + "printWidth": 120, + "proseWrap": "always", +} diff --git a/README.md b/README.md index 4761826ca..e480700b2 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,17 @@ # Awesome dotfiles A curated list of dotfiles resources. Inspired by the [awesome](https://github.com/sindresorhus/awesome) list thing. - -Note that some articles or tools may look old or look old-fashioned, but this usually means they're battle-tested and mature (like dotfiles themselves). +Note that some articles or tools may look old or old-fashioned, but this usually means they're battle-tested and mature +(like dotfiles themselves). Feel free to propose new articles, projects or tools! ## Articles ### Introductions -- [Getting started with dotfiles](https://medium.com/@webprolific/getting-started-with-dotfiles-43c3602fd789) ([L. Kappert](https://github.com/webpro)) -- [Getting started with dotfiles](https://driesvints.com/blog/getting-started-with-dotfiles/) ([D. Vints](https://github.com/driesvints)) +- [Getting started with dotfiles](https://medium.com/@webprolific/getting-started-with-dotfiles-43c3602fd789) + ([L. Kappert](https://github.com/webpro)) +- [Getting started with dotfiles](https://driesvints.com/blog/getting-started-with-dotfiles/) + ([D. Vints](https://github.com/driesvints)) - [Managing your dotfiles](https://medium.com/@webprolific/managing-your-dotfiles-7d2725297304) - [Dotfiles Are Meant to Be Forked](https://zachholman.com/2010/08/dotfiles-are-meant-to-be-forked/) - [Dotfile discovery](https://wynnnetherland.com/journal/dotfiles-discovery/) @@ -17,7 +19,8 @@ Note that some articles or tools may look old or look old-fashioned, but this us ### Tutorials - [Setting up a new (OS X) development machine: Part 3 - Dotfiles and custom SSH config](https://mattstauffer.com/blog/setting-up-a-new-os-x-development-machine-part-3-dotfiles-rc-files-and-ssh-config/) -- [Setting Up a Mac Dev Machine From Zero to Hero With Dotfiles](https://code.tutsplus.com/tutorials/setting-up-a-mac-dev-machine-from-zero-to-hero-with-dotfiles--net-35449); [Part 2](https://code.tutsplus.com/tutorials/setting-up-a-mac-dev-machine-from-zero-to-hero-with-dotfiles-part-2--cms-23145) +- [Setting Up a Mac Dev Machine From Zero to Hero With Dotfiles](https://code.tutsplus.com/tutorials/setting-up-a-mac-dev-machine-from-zero-to-hero-with-dotfiles--net-35449); + [Part 2](https://code.tutsplus.com/tutorials/setting-up-a-mac-dev-machine-from-zero-to-hero-with-dotfiles-part-2--cms-23145) - [Using Git and GitHub to manage your dotfiles](http://blog.smalleycreative.com/tutorials/using-git-and-github-to-manage-your-dotfiles/) - [conf.d like directories for zsh/bash dotfiles](https://chr4.org/blog/2014/09/10/conf-dot-d-like-directories-for-zsh-slash-bash-dotfiles/) - [Managing your dotfiles](https://www.anishathalye.com/2014/08/03/managing-your-dotfiles/) @@ -37,17 +40,21 @@ Note that some articles or tools may look old or look old-fashioned, but this us ## Find dotfiles repos -There are many great dotfiles repos out there, each containing their own inspiration and gems. I think one of the best ways to go through them is by [searching GitHub for "dotfiles"](https://github.com/search?q=dotfiles&type=Repositories). +There are many great dotfiles repos out there, each containing their own inspiration and gems. I think one of the best +ways to go through them is by [searching GitHub for "dotfiles"](https://github.com/search?q=dotfiles&type=Repositories). Also see: - [Google for "dotfiles"](https://www.google.nl/search?q=dotfiles) - [Archlinux collection](https://wiki.archlinux.org/index.php/Dotfiles) -- Tip: search for a filename on GitHub, e.g. [in:path .gitconfig](https://github.com/search?utf8=%E2%9C%93&type=Code&q=in%3Apath+.gitconfig). +- Tip: search for a filename on GitHub, e.g. + [in:path .gitconfig](https://github.com/search?utf8=%E2%9C%93&type=Code&q=in%3Apath+.gitconfig). ## Example dotfiles repos -A collection of the most popular, well-maintained, and collaborative dotfiles repositories & frameworks. Some projects contain just the dotfiles. Others go further by allowing you to easily add your own custom dotfiles, and/or including scripts to manage dotfiles/plugins. +A collection of the most popular, well-maintained, and collaborative dotfiles repositories & frameworks. Some projects +contain just the dotfiles. Others go further by allowing you to easily add your own custom dotfiles, and/or including +scripts to manage dotfiles/plugins. ### Bash @@ -82,22 +89,31 @@ A collection of the most popular, well-maintained, and collaborative dotfiles re ## Tools -- [Ansible](https://www.ansible.com) - Radically simple configuration-management, application deployment, task-execution, and multinode orchestration engine. +- [Ansible](https://www.ansible.com) - Radically simple configuration-management, application deployment, + task-execution, and multinode orchestration engine. - [bashdot](https://github.com/bashdot/bashdot) - Minimalist dotfile management framework written entirely in bash. - [chezmoi](https://github.com/twpayne/chezmoi) - Manage your dotfiles securely across multiple machines. - [dotbot](https://github.com/anishathalye/dotbot) - Tool that bootstraps your dotfiles. - [dotdrop](https://github.com/deadc0de6/dotdrop) - Save your dotfiles once, deploy them everywhere. -- [emplace](https://github.com/tversteeg/emplace) - Synchronize installed packages on multiple machines using a dotfiles repository. +- [emplace](https://github.com/tversteeg/emplace) - Synchronize installed packages on multiple machines using a dotfiles + repository. - [Fisher](https://github.com/jorgebucaran/fisher) - A package manager for Fish -- [fresh](https://freshshell.com) - Keep your dotfiles fresh. Fresh is a tool to source shell configuration (aliases, functions, etc) from others into your own configuration files. -- [GNU Stow](http://www.gnu.org/software/stow/) - Symlink farm manager which takes distinct packages of software and/or data located in separate directories on the filesystem, and makes them appear to be installed in the same place. +- [fresh](https://freshshell.com) - Keep your dotfiles fresh. Fresh is a tool to source shell configuration (aliases, + functions, etc) from others into your own configuration files. +- [GNU Stow](http://www.gnu.org/software/stow/) - Symlink farm manager which takes distinct packages of software and/or + data located in separate directories on the filesystem, and makes them appear to be installed in the same place. - [homeshick](https://github.com/andsens/homeshick) - Git dotfile synchronizer written in Bash. -- [homesick](https://github.com/technicalpickles/homesick) - Your home directory is your castle. Don't leave your dotfiles behind ([article](https://technicalpickles.com/posts/never-leave-your-dotfiles-behind-again-with-homesick)). +- [homesick](https://github.com/technicalpickles/homesick) - Your home directory is your castle. Don't leave your + dotfiles behind ([article](https://technicalpickles.com/posts/never-leave-your-dotfiles-behind-again-with-homesick)). - [mackup](https://github.com/lra/mackup) - Keep your application settings in sync (OS X/Linux). -- [Pearl](https://github.com/pearl-core/pearl) - Package manager that allows to control, sync, share dotfiles as packages automatically activated during shells or editors startup. There is a wide range of packages already available in the [Official Pearl Hub](https://github.com/pearl-hub) (for Linux and OSX). +- [Pearl](https://github.com/pearl-core/pearl) - Package manager that allows to control, sync, share dotfiles as + packages automatically activated during shells or editors startup. There is a wide range of packages already available + in the [Official Pearl Hub](https://github.com/pearl-hub) (for Linux and OSX). - [rcm](https://github.com/thoughtbot/rcm) - rc file (dotfile) management. -- [themer](https://github.com/mjswensen/themer) - Manage and generate themes across your development tools from within your dotfiles. -- [yadm](https://github.com/TheLocehiliosan/yadm) - Tool for managing a collection of files across multiple computers, using a shared Git repository and some additional features. +- [themer](https://github.com/mjswensen/themer) - Manage and generate themes across your development tools from within + your dotfiles. +- [yadm](https://github.com/TheLocehiliosan/yadm) - Tool for managing a collection of files across multiple computers, + using a shared Git repository and some additional features. ### macOS @@ -108,19 +124,29 @@ A collection of the most popular, well-maintained, and collaborative dotfiles re ## Miscellaneous - [dotfiles.github.io](http://dotfiles.github.io) - Your unofficial guide to dotfiles on GitHub. -- [OS X Defaults](https://github.com/kevinSuttle/macOS-Defaults) - Centralized place for the awesome work started by [@mathiasbynens on .macos](https://github.com/mathiasbynens/dotfiles#sensible-macos-defaults). -- [Filesystem Hierarchy Standard](https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard) - Directory structure and directory contents in Linux distributions. -- [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) - [Summary](https://wiki.archlinux.org/index.php/XDG_Base_Directory) -- [A lesson in shortcuts](https://www.reddit.com/r/linux/comments/at05xh/why_do_hidden_files_in_unix_begin_with_a_dot/egyj6lr/) - How the idea of "hidden" or "dot" files was born, by Rob Pike (originally posted on Google+) +- [OS X Defaults](https://github.com/kevinSuttle/macOS-Defaults) - Centralized place for the awesome work started by + [@mathiasbynens on .macos](https://github.com/mathiasbynens/dotfiles#sensible-macos-defaults). +- [Filesystem Hierarchy Standard](https://en.wikipedia.org/wiki/Filesystem_Hierarchy_Standard) - Directory structure and + directory contents in Linux distributions. +- [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) - + [Summary](https://wiki.archlinux.org/index.php/XDG_Base_Directory) +- [A lesson in shortcuts](https://www.reddit.com/r/linux/comments/at05xh/why_do_hidden_files_in_unix_begin_with_a_dot/egyj6lr/) - + How the idea of "hidden" or "dot" files was born, by Rob Pike (originally posted on Google+) ## Related Lists -- [Awesome Dev Env](https://github.com/jondot/awesome-devenv) - Curated list of awesome tools, resources and workflow tips making an awesome development environment. -- [Awesome Fish](https://github.com/jorgebucaran/awesome-fish) - Curated list of packages, prompts, and resources for the fish shell. -- [Awesome Shell](https://github.com/alebcay/awesome-shell) - Curated list of awesome command-line frameworks, toolkits, guides and gizmos. -- [Awesome Sysadmin](https://github.com/n1trux/awesome-sysadmin) - A curated list of amazingly awesome open source sysadmin resources. -- [Awesome Zsh Plugins](https://github.com/unixorn/awesome-zsh-plugins) - List of Zsh plugins suitable for use with oh-my-zsh, antigen & Prezto. -- [Terminals Are Sexy](https://github.com/k4m4/terminals-are-sexy) - A curated list of Terminal frameworks, plugins & resources for CLI lovers. +- [Awesome Dev Env](https://github.com/jondot/awesome-devenv) - Curated list of awesome tools, resources and workflow + tips making an awesome development environment. +- [Awesome Fish](https://github.com/jorgebucaran/awesome-fish) - Curated list of packages, prompts, and resources for + the fish shell. +- [Awesome Shell](https://github.com/alebcay/awesome-shell) - Curated list of awesome command-line frameworks, toolkits, + guides and gizmos. +- [Awesome Sysadmin](https://github.com/n1trux/awesome-sysadmin) - A curated list of amazingly awesome open source + sysadmin resources. +- [Awesome Zsh Plugins](https://github.com/unixorn/awesome-zsh-plugins) - List of Zsh plugins suitable for use with + oh-my-zsh, antigen & Prezto. +- [Terminals Are Sexy](https://github.com/k4m4/terminals-are-sexy) - A curated list of Terminal frameworks, plugins & + resources for CLI lovers. ## Archive/abandoned projects @@ -136,10 +162,13 @@ A collection of the most popular, well-maintained, and collaborative dotfiles re - [Kevin's dotfiles](https://github.com/kdeldycke/dotfiles) - [kody](https://github.com/jh3y/kody) - [osxc](http://osxc.github.io) -- [vcsh](https://github.com/RichiH/vcsh) ([article](https://blog.tfnico.com/2014/03/managing-dot-files-with-vcsh-and-myrepos.html), [article](https://www.kunxi.org/2014/02/manage-dotfiles-using-vcsh-and-mr/)) +- [vcsh](https://github.com/RichiH/vcsh) + ([article](https://blog.tfnico.com/2014/03/managing-dot-files-with-vcsh-and-myrepos.html), + [article](https://www.kunxi.org/2014/02/manage-dotfiles-using-vcsh-and-mr/)) ## License [![CC0](https://licensebuttons.net/p/zero/1.0/88x31.png)](https://creativecommons.org/publicdomain/zero/1.0/) -To the extent possible under law, [Lars Kappert](https://www.webpro.nl) has waived all copyright and related or neighboring rights to this work. +To the extent possible under law, [Lars Kappert](https://www.webpro.nl) has waived all copyright and related or +neighboring rights to this work.