-
-
Notifications
You must be signed in to change notification settings - Fork 4.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
yadm: add pages #13920
base: main
Are you sure you want to change the base?
yadm: add pages #13920
Conversation
Well I hope this one works now. Creating a new PR was the only way to get rid of the wrong author. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you for your first contribution. Please make sure to read the style guide and contributing guide.
I have added some comments that need to be addressed before the PR is GTG.
@@ -0,0 +1,9 @@ | |||
# yadm-bootstrap | |||
|
|||
> This command allows you to execute Yadm's bootstrap file. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> This command allows you to execute Yadm's bootstrap file. | |
> Execute Yadm's bootstrap file. |
|
||
- Create the necessary files and folders for encryption: | ||
|
||
`touch {{encrypt-file-path}} && mkdir {{archive-folder-path}}` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
`touch {{encrypt-file-path}} && mkdir {{archive-folder-path}}` | |
`touch {{path/to/encrypt_file}} && mkdir {{path/to/archive_folder}}` |
|
||
- Share the repository using GPG: | ||
|
||
`yadm git-crypt add-gpg-user {{USER_ID}}` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Does the USER_ID need to be capitalised?
# yadm-perms | ||
|
||
> Update permissions. | ||
> It is usually unnecessary to run this command, as `yadm` automatically processes permissions by default. This automatic behavior can be disabled by setting the configuration `yadm.auto-perms` to "false". |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> It is usually unnecessary to run this command, as `yadm` automatically processes permissions by default. This automatic behavior can be disabled by setting the configuration `yadm.auto-perms` to "false". | |
> It is usually unnecessary to run this command, as `yadm` automatically processes permissions by default. This automatic behavior can be disabled by setting the configuration `yadm.auto-perms` to `"false"`. |
- Set the symmetric cipher to utilize for encryption: | ||
|
||
`yadm transcrypt --cipher={{cipher}}` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
`yadm transcrypt --cipher={{cipher}}` | |
`yadm transcrypt --cipher={{cipher}}` |
|
||
- Override the location of the yadm encrypted files archive: | ||
|
||
`yadm --yadm-archive` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
`yadm --yadm-archive` | |
`yadm --yadm-archive` |
|
||
> A dotfiles manager that works by using `git`. | ||
> The subcommands are just like `git` but use `yadm`. | ||
> You can use `yadm` (init | clone | push | pull). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> You can use `yadm` (init | clone | push | pull). | |
> Some subcommands such as `init`, `clone`, `push`, and `pull` have their own usage documentation. |
https://github.com/tldr-pages/tldr/blob/main/CONTRIBUTING.md#referencing-subcommands
@@ -0,0 +1,13 @@ | |||
# yadm-upgrade | |||
|
|||
> Use this command upgrade `yadm` to the latest version. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> Use this command upgrade `yadm` to the latest version. | |
> Upgrade `yadm` to the latest version. |
> Upgrading will attempt to de-initialize and re-initialize your submodules. | ||
> More information: <https://github.com/TheLocehiliosan/yadm/blob/master/yadm.md#commands>. | ||
- Upgrade: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Upgrade: | |
- Upgrade `yadm` to the latest version: |
@@ -0,0 +1,13 @@ | |||
# yadm-enter | |||
|
|||
> Run a sub-shell with all Git variables set. This sub-shell can be used to easily interact with your `yadm` repository using Git commands. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> Run a sub-shell with all Git variables set. This sub-shell can be used to easily interact with your `yadm` repository using Git commands. | |
> Run a sub-shell with all Git variables set. This sub-shell can be used to easily interact with the local `yadm` repository using Git commands. |
common
,linux
,osx
,windows
,sunos
,android
, etc.