mirror of
https://github.com/TheLocehiliosan/yadm
synced 2024-10-27 20:34:27 +00:00
151 lines
4.3 KiB
Markdown
151 lines
4.3 KiB
Markdown
---
|
|
layout: splash
|
|
permalink: /
|
|
stars_button: '
|
|
{::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}
|
|
'
|
|
title: Yet Another Dotfiles Manager
|
|
header:
|
|
overlay_color: "#000"
|
|
overlay_filter: 0.7
|
|
overlay_image: /images/unsplash.jpg
|
|
cta_label: Install Now
|
|
cta_url: /docs/install
|
|
caption: "_Photo: [Michael Jasmund](https://unsplash.com/photos/o51enAB_89A)_"
|
|
excerpt: '
|
|
|
|
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**.
|
|
|
|
'
|
|
feature_row:
|
|
- title: Overview
|
|
alt: Overview
|
|
btn_class: btn--inverse
|
|
btn_label: Discover yadm
|
|
image_path: /images/picture-padding.png
|
|
url: /docs/overview
|
|
excerpt: '
|
|
|
|
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: Alternate Files
|
|
alt: Alternates
|
|
btn_class: btn--inverse
|
|
btn_label: Details
|
|
image_path: /images/copy-padding.png
|
|
url: /docs/alternates
|
|
excerpt: '
|
|
|
|
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: Encryption
|
|
alt: Encryption
|
|
btn_class: btn--inverse
|
|
btn_label: Learn more
|
|
image_path: /images/secret-padding.png
|
|
url: /docs/encryption
|
|
excerpt: '
|
|
|
|
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: Bootstrap
|
|
alt: Bootstrap
|
|
btn_class: btn--inverse
|
|
btn_label: Explore how
|
|
image_path: /images/tasks-padding.png
|
|
url: /docs/bootstrap
|
|
excerpt: '
|
|
|
|
Define your own instructions to complete your dotfiles installation.
|
|
If provided, yadm can execute your custom program immediately
|
|
following a successful clone.
|
|
|
|
'
|
|
- title: Hooks
|
|
alt: Hooks
|
|
btn_class: btn--inverse
|
|
btn_label: Get started
|
|
image_path: /images/cogs-padding.png
|
|
url: /docs/hooks
|
|
excerpt: '
|
|
|
|
Perform custom operations before or after any yadm command.
|
|
|
|
'
|
|
- title: FAQ
|
|
alt: FAQ
|
|
btn_class: btn--inverse
|
|
btn_label: Get answers
|
|
image_path: /images/question-circle-padding.png
|
|
url: /docs/faq
|
|
excerpt: '
|
|
|
|
Have a question? You might find an answer in the FAQ.
|
|
|
|
'
|
|
- title: Manual
|
|
alt: Manual
|
|
btn_class: btn--inverse
|
|
btn_label: See man page
|
|
image_path: /images/book-padding.png
|
|
url: https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md
|
|
excerpt: '
|
|
|
|
View the manual online.
|
|
|
|
'
|
|
- title: Example Dotfiles
|
|
alt: Examples
|
|
btn_class: btn--inverse
|
|
btn_label: View examples
|
|
image_path: /images/keyboard-padding.png
|
|
url: /docs/examples
|
|
excerpt: '
|
|
|
|
Need some inspiration? Here are some example dotfiles repository.
|
|
|
|
'
|
|
- title: Contribute
|
|
alt: Contribute
|
|
btn_class: btn--inverse
|
|
btn_label: Read guidlines
|
|
image_path: /images/hands-padding.png
|
|
url: https://github.com/TheLocehiliosan/yadm/blob/master/.github/CONTRIBUTING.md
|
|
excerpt: '
|
|
|
|
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](https://github.com/TheLocehiliosan/yadm)
|
|
on GitHub. The star count helps others discover yadm.
|