1
0
Fork 0
mirror of synced 2024-11-16 06:15:34 -05:00
yadm/_pages/splash.md
2020-12-27 21:02:07 -06:00

150 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.