yadm/_pages/splash.md

4.3 KiB

layout permalink stars_button title header excerpt feature_row
splash / {::nomarkdown}<iframe src="https://ghbtns.com/github-btn.html?user=TheLocehiliosan&repo=yadm&type=star&count=true" frameborder="0" scrolling="0" width="100" height="20px" style="float: right;"></iframe>{:/nomarkdown} Yet Another Dotfiles Manager
overlay_color overlay_filter overlay_image cta_label cta_url caption
#000 0.7 /images/unsplash.jpg Install Now /docs/install _Photo: [Michael Jasmund](https://unsplash.com/photos/o51enAB_89A)_
When you live in a command line, configurations are a deeply personal thing. They are often crafted over years of experience, battles lost, lessons learned, advice followed, and ingenuity rewarded. When you are away from your own configurations, you are an orphaned refugee in unfamiliar and hostile surroundings. You feel clumsy and out of sorts. You are filled with a sense of longing to be back in a place you know. A place you built. A place where all the short-cuts have been worn bare by your own travels. A place you proudly call... **$HOME**.
title alt btn_class btn_label image_path url excerpt
Overview Overview btn--inverse Discover yadm /images/picture-padding.png /docs/overview If you know how to use Git, you already know how to use yadm. yadm helps you maintain a single repository of dotfiles, while keeping them where they belong---in `$HOME`. Anything you can do with Git, you can do using yadm.
title alt btn_class btn_label image_path url excerpt
Alternate Files Alternates btn--inverse Details /images/copy-padding.png /docs/alternates Sometimes you need different configurations on different systems. yadm makes it possible to use alternate versions of files based on the OS or hostname of the system. Templates allow you to use alternate sections within files.
title alt btn_class btn_label image_path url excerpt
Encryption Encryption btn--inverse Learn more /images/secret-padding.png /docs/encryption Configurations occasionally include secrets such as passwords, encryption keys, or other sensitive information. yadm allows you to add such files to an encrypted archive, which can be maintained alongside your other configurations.
title alt btn_class btn_label image_path url excerpt
Bootstrap Bootstrap btn--inverse Explore how /images/tasks-padding.png /docs/bootstrap Define your own instructions to complete your dotfiles installation. If provided, yadm can execute your custom program immediately following a successful clone.
title alt btn_class btn_label image_path url excerpt
Hooks Hooks btn--inverse Get started /images/cogs-padding.png /docs/hooks Perform custom operations before or after any yadm command.
title alt btn_class btn_label image_path url excerpt
FAQ FAQ btn--inverse Get answers /images/question-circle-padding.png /docs/faq Have a question? You might find an answer in the FAQ.
title alt btn_class btn_label image_path url excerpt
Manual Manual btn--inverse See man page /images/book-padding.png https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md View the manual online.
title alt btn_class btn_label image_path url excerpt
Example Dotfiles Examples btn--inverse View examples /images/keyboard-padding.png /docs/examples Need some inspiration? Here are some example dotfiles repository.
title alt btn_class btn_label image_path url excerpt
Contribute Contribute btn--inverse Read guidlines /images/hands-padding.png https://github.com/TheLocehiliosan/yadm/blob/master/.github/CONTRIBUTING.md Improve yadm by reporting bugs, coding changes, documentation and packaging yadm installations.

{% include feature_row id="intro" type="center" %}

{% include feature_row %}

If you enjoy using yadm, consider adding a star to the repository on GitHub. The star count helps others discover yadm.