aboutsummaryrefslogtreecommitdiff
path: root/README.mdwn
blob: fb625e0deafde6f700f4df1750991b43245510af (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
Metadot: a dotfile management system
====================================

Inspired by https://github.com/holman/dotfiles

Instalation
-----------

    git clone --recursive git://URL/dotfiles.git .dotfiles

Some configuration files depends on the "scripts" repository to
be cloned at ~/apps/scripts.

Backups of your old files can be put into .dotfiles/backups.

Layout
------

- ~/.dotfiles: where all dotfiles plugins are stored
- ~/.backups: backups of old config files
- ~/.custom: your custom configuration where you can override parameters

Module format
-------------

Modules rest at ~/.dotfiles/modules and can be git submodules. File format is:

    [path/]<name>[.dot][.link]

That means:

- files ending with a .link extension are linked at $HOME.
- files with a .dot.link extension are converted to a dotfile: vimrc.dot.link is symlinked as ~/.vimrc
- file structure is preserved: file apps/scripts.link is linked at $HOME/apps/scripts.
- all other files are ignored.

Todo
----

- Put modules as git submodules.
- Better integration with scripts project.