「ドットファイル」の版間の差分

2022年5月30日 (月) 23:17時点における版

ユーザー固有のアプリケーション設定は、伝統的にドットファイル(ファイル名がドットで始まるファイル) に保存されています。変更を追跡し、さまざまなホスト間でドットファイルを同期するために、Git などのバージョン管理システムでドットファイルを管理することは一般的な方法です。ドットファイルを管理するには、さまざまな方法があります(例えば、ホームディレクトリでドットファイルを直接追跡する、サブディレクトリに保存する、シェルスクリプトや専用ツールでファイルをシンボリックリンク/コピー/生成するなど)。ドットファイルの管理方法とは別に、この記事には、ドットファイルのリボジトリのリストも含まれています。

ドットファイルを Git で直接追跡する

ドットファイルを直接 Git で追跡することの利点は、Git だけで済み、シンボリックリンクを必要としないことです。デメリットは、ホスト固有の設定では一般的に複数の branches に変更をマージする必要があるということです。

このアプローチを実現する最もシンプルな方法は、ホームディレクトリに直接 Git リポジトリを初期化して、gitignore(5) パターンの * でデフォルトで全てのファイルを無視することです。しかし、この方法には二つの欠点があります。ホームディレクトリに他の Git リポジトリがある場合、混乱することがあります(例えば、リポジトリの初期化を忘れると、突然 dotfile リポジトリを操作することになります。)また、(無視されるので)現在のディレクトリのどのファイルが追跡されていないかを簡単に確認することができなくなりました。

これらの欠点がない別の方法として、Ask Hacker News で人気のある "bare repository and alias method" があります。これは、3つのコマンドでセットアップすることができます。

$ git init --bare ~/.dotfiles
$ alias config='/usr/bin/git --git-dir=$HOME/.dotfiles/ --work-tree=$HOME'
$ config config status.showUntrackedFiles no

そうすると、作成したエイリアスでドットファイルを管理することができます。もし Bash を使っていてこのエイリアスを bash 補完したい場合は、bash-complete-alias^AUR をインストールして、エイリアスと次の行を ~/.bashrc に追加してください。

$ complete -F _complete_alias config

bash で補完させるもう一つの方法は、~/.bashrc に以下を追加することです。(https://askubuntu.com/a/642778] から引用)

source /usr/share/bash-completion/completions/git
__git_complete config __git_main

ヒント: 機密情報を誤ってコミットしないようにするには、Git#Filtering confidential informationを参照してください。

ホスト固有の設定

様々なマシンで dotfiles を同期させる際によくある問題が、ホスト固有の設定です。

Git では、すべての共有設定を master ブランチで管理し、個々のマシンにはマシン固有のブランチをチェックアウトすることでこれを解決できます。ホスト固有の設定はマシン固有のブランチにコミットすることができます。共有設定が master ブランチで変更された場合、マシンごとのブランチは更新された master の上にリベースされる必要があります。

シェル設定ファイルのような設定スクリプトでは、条件付きロジックを使用することができます。例えば、Bash スクリプト (すなわち .bashrc) は、マシン名 (またはタイプ、カスタム変数など) に応じて異なる設定を適用することができます。

if [[ "$(hostname)" == "archlaptop" ]]; then
    # laptop specific commands here
else
    # desktop or server machine commands
fi

同様のことは、.Xresources でも実現できます。[1]

Git ブランチのリベースが面倒だと感じる場合は、ファイルのグループ化 をサポートするツールや、さらに柔軟性を求めるなら 加工処理 を行うツールを使用するとよいでしょう。

ツール

ファイルのグループ化: 設定ファイルを設定グループ (プロファイルまたはパッケージとも呼ばれる) にグループ化する方法です。

処理

ホストによってカスタマイズできるように、設定ファイルを処理するツールもあります。

名前	パッケージ	言語	ファイルのグループ化	処理
chezmoi	chezmoi	Go	ディレクトリベース	Go テンプレート
dot-templater	dot-templater-git^AUR	Rust	ディレクトリベース	カスタムシンタックス
dotdrop	dotdrop^AUR	Python	構成ファイル	Jinja2
dotfiles	dotfiles^AUR	Python	No	No
Dots	dots-manager^AUR	Python	ディレクトリベース	カスタム追加ポイント
dotter	dotter-rs^AUR	Rust	構成ファイル	Handlebars
dt-cli	dt-cli^AUR	Rust	構成ファイル	Handlebars
GNU Stow	stow	Perl	ディレクトリベース [2]	No
Mackup	mackup^AUR	Python	アプリケーションごとに自動	No
mir.qualia	mir.qualia^AUR	Python	No	カスタムブロック
rcm	rcm^AUR	Perl	ディレクトリベース (ホストまたはタグによる)	No

Git を wrapping するツール

Git に不安がある場合は、バージョン管理システムを (多かれ少なかれ) 抽象化するこれらのツールのいずれかを使用することをお勧めします。

名前	パッケージ	言語	ファイルのグループ化	処理
dotbare	dotbare^AUR	Shell (fzf)	リポジトリ的	No
dotgit	dotgit^AUR	Python	ファイル名ベース	No
homeshick	homeshick-git^AUR	Bash	リポジトリ的	No
homesick	–	Ruby	リポジトリ的	No
Pearl	pearl-git^AUR	Python	リポジトリ的	No
vcsh	vcsh	Shell	リポジトリ的	No
yadm⁽¹⁾	yadm	Bash	ファイル名ベース (by class/OS/distro/hostname/user)[3]	組み込みのテンプレート /Jinja2/ESH [4] (オプション)

GPG または OpenSS による機密ファイルの暗号化をサポートします。 [5]

他のツール

dotbot — ドットファイルリポジトリの git サブモジュールとしてインストールすることができるミニマルなドットファイルマネージャ。

https://github.com/anishathalye/dotbot || パッケージが存在しないか AUR で検索

dotdrop — 様々なホストのドットファイルを管理するツール。

https://github.com/deadc0de6/dotdrop || dotdrop^AUR

dotfiles — $HOME のドットファイルのシンボリックリンクを簡単に管理することができるツール。

https://github.com/jbernard/dotfiles || dotfiles^AUR

dotgit — ドットファイルを管理するための包括的なソリューション。

http://github.com/Cube777/dotgit || dotgit^AUR

dots — 計画的にドットファイルを管理するためのポータブルツール。

https://github.com/EvanPurkhiser/dots || dots-manager^AUR

etckeeper — システム全体の設定が存在する /etc をバージョン管理します。バージョン管理ソフトウェアが無視するパーミッションやモードを記録することで動作します。様々な SCM システムをバックエンドとして使用可能。フックを使用することでシステムがアップグレードされる前にリポジトリに変更を自動的にコミットできます。

http://etckeeper.branchable.com/ || etckeeper

GNU Stow — リポジトリのドットファイルから $HOME ツリーにシンボリックリンクを作成します。詳しくは [6] を見てください。

https://www.gnu.org/software/stow/ || stow

homeshick — Bash で書かれた git ドットファイル同期ツール。

https://github.com/andsens/homeshick || homeshick-git^AUR

mackup — アプリケーションの設定を同期する小さな Python ユーティリティ。

https://github.com/lra/mackup || mackup^AUR

Pearl — ドットファイルやプラグイン、プログラムあるいは git から入手できるあらゆるコードのパッケージマネージャ。システム間でパッケージを簡単に共有・同期することができ、すぐに使える状態にできます。

https://github.com/pearl-core/pearl || pearl-git^AUR

rcm — リポジトリから $HOME ツリーにドットファイルのシンボリックリンクを作成できます。

https://github.com/thoughtbot/rcm || rcm^AUR

vcsh — 全てのドットファイルをひとつのリポジトリで管理するのではなく、様々なモジュール (Emacs の設定や zsh の設定など) を別々のリポジトリに分割することで管理を分けることができます。git でしか動作しません。

https://github.com/RichiH/vcsh || vcsh^AUR

yadm — ひとつの Git リポジトリを使って複数のシステムでファイルを管理します。特定の OS やホストで別のファイルを使うようにすることができます。機密情報を暗号化することでリポジトリに安全に保存することが可能。

https://github.com/TheLocehiliosan/yadm || yadm-git^AUR

複数のマシンでドットファイルを管理する

共有する設定をマスターブランチで管理して、マシンごとのブランチを作成することで、カスタマイズを加えながら様々なマシンのドットファイルを管理するという方法があります。特定のマシンの設定は専用のブランチにコミットし、共通設定はマスターブランチに追加します。そしてマスターを更新したら各マシンのブランチをリベースします。

また、特定のマシンの設定を特殊なコメントブロックに記述して qualia を使って自動的にアンコメントさせるという方法もあります。この方法は手間が少ない上にマージによる衝突が発生しません。

機密情報

ときとして、ソフトウェアはパスワードを平文で設定ファイルに保存することがあります。そのような場合、git clean フィルターを利用することで機密情報を間違ってコミットする危険を減らすことができます。例えば、以下の .gitattributes ファイルは “some-dotfile” ファイルにフィルターを適用します:

.gitattributes

some-dotfile filter=remove-pass

“some-dotfile” ファイルが git にチェックインされた場合、git は “remove-pass” フィルターを実行します。フィルターは .git/config に以下のように定義してください:

.git/config

[filter "remove-pass"]
clean = "sed -e 's/^password=.*/#password=TODO/'"

リポジトリ

作者	シェル	WM / DE	エディタ	ターミナル	マルチプレクサ	オーディオ	モニター	メール	IRC
Ambrevar	zsh	awesome	emacs	rxvt-unicode		cmus	htop/vicious	mutt
awal	fish	i3	vim	sakura	tmux		i3status		The Lounge
ayekat	zsh	karuiwm	vim	rxvt-unicode	tmux	ncmpcpp/mpd	karuibar	mutt	irssi
bamos	zsh	i3/xmonad	vim/emacs	rxvt-unicode	tmux	mpv/cmus	conky/xmobar	mutt	ERC
brisbin33	zsh	xmonad	vim	rxvt-unicode	screen		dzen	mutt	irssi
cinelli	zsh	dwm	vim	termite-git		pianobar	htop	mutt-kz	weechat
dillebidum	zsh/mksh	dwm/i3	vim/vis	st	tmux/dvtm	ncmpcpp/mpv	htop/i3blocks	mutt	ii/irssi
Earnestly	zsh	i3/orbment	vim/emacs	termite	tmux	mpd	conky	mutt	weechat
ErikBjare	zsh	xmonad/xfce4	vim	terminator	tmux		xfce4-panel		weechat
falconindy	bash	i3	vim	rxvt-unicode		ncmpcpp	conky	mutt
graysky	zsh	xfce4	vim	terminal		ncmpcpp	custom	thunderbird
hugdru	zsh	awesome	neovim	rxvt-unicode	tmux			thunderbird	weechat
insanum	bash	herbstluftwm	vim	evilvte	tmux		dzen	mutt-kz
izmntuk	zsh	xfce4	vim	rxvt-unicode/yaft	tmux	cmus	xfce4-panel		irssi
jasonwryan	bash/zsh	dwm	vim	rxvt-unicode	tmux	ncmpcpp	custom	mutt	irrsi
jdevlieghere	zsh	xmonad	vim	terminal	tmux		htop	mutt	weechat
jelly	zsh	i3	vim	termite	tmux	ncmpcpp		mutt-kz-git	weechat
maximbaz	zsh	i3-gaps	neovim	alacritty	tmux		py3status	thunderbird
meskarune	bash	herbstluftwm	vim	rxvt-unicode	screen		conky		weechat
neersighted	zsh	i3	vim	rxvt-unicode	tmux	ncmpcpp	htop	mutt	irssi
OK100	bash	dwm	vim	rxvt-unicode		cmus	conky, dzen	mutt	weechat
pid1	zsh	dwm	neovim	st	tmux		custom	mutt	weechat
polyzen	zsh	i3	vim	termite	tmux		i3status		weechat
sistematico	zsh/fish/bash	i3 Gaps	vim/nano	termite	tmux	ncmpcpp	polybar	mutt	weechat
swalladge	zsh/bash	i3	neovim/vim	termite	tmux	cmus	i3pystatus	mutt
thiagowfx	bash/zsh	i3	vim/emacs	rxvt-unicode		ncmpcpp	i3blocks
unexist	zsh	subtle	vim	rxvt-unicode		ncmpcpp		mutt	irssi
vodik	zsh	xmonad	vim	termite-git	tmux	ncmpcpp	custom	mutt	weechat
w0ng	zsh	dwm	vim	rxvt-unicode	tmux	ncmpcpp	custom	mutt	irssi
Wintervenom	bash	herbstluftwm	vim	rxvt-unicode	screen	mpd (mpc-utils)	hlwm-dzen2	mutt	weechat
wolfcore	bash	dwm	vim	rxvt-unicode	tmux	cmus	custom		weechat
zendeavor	zsh	i3	vim	rxvt-unicode	tmux	ncmpcpp	i3status		weechat

参照

gregswiki:DotFiles
XMonad Config Archive
dotshare.it
dotfiles.github.io
terminal.sexy - ターミナルのカラースキームデザイナー

@@ 51行目: / 51行目: @@
 Git ブランチのリベースが面倒だと感じる場合は、''ファイルのグループ化'' をサポートする [[#Tools|ツール]] や、さらに柔軟性を求めるなら ''加工処理'' を行うツールを使用するとよいでしょう。
-=== gitignore を使う ===
+== ツール ==
+;ファイルのグループ化
-ホームディレクトリに [https://git-scm.com/blog/2010/04/11/environment.html git ディレクトリ] を作成することで変更を直接記録することができます。インデックスに追加するファイルは {{man|1|git-add}} で選択することを推奨します。
+:設定ファイルを設定グループ (プロファイルまたはパッケージとも呼ばれる) にグループ化する方法です。
+処理
+:ホストによってカスタマイズできるように、設定ファイルを処理するツールもあります。
+{| class="wikitable sortable" style="text-align: center;"
-変更が追跡されないファイルが生じないように ({{man|1|git-clean}} で削除されます)、まずは {{man|5|gitignore}} で全てのファイルを除外してください:
+! 名前 !! パッケージ !! 言語 !! ファイルのグループ化 !! 処理
+|-
+! [https://github.com/twpayne/chezmoi chezmoi]
+| {{Pkg|chezmoi}} || Go || ディレクトリベース || Go テンプレート
+|-
+! [https://github.com/kesslern/dot-templater dot-templater]
+| {{AUR|dot-templater-git}} || Rust || ディレクトリベース || カスタムシンタックス
+|-
+! [https://deadc0de.re/dotdrop/ dotdrop]
+| {{AUR|dotdrop}} || Python || 構成ファイル || Jinja2
+|-
+! [https://github.com/jbernard/dotfiles dotfiles]
+| {{AUR|dotfiles}} || Python || {{Grey|[https://github.com/jbernard/dotfiles/pull/24 No]}} || {{Grey|No}}
+|-
+! [https://github.com/EvanPurkhiser/dots Dots]
+| {{AUR|dots-manager}} || Python || ディレクトリベース || カスタム追加ポイント
+|-
+! [https://github.com/SuperCuber/dotter dotter]
+| {{AUR|dotter-rs}} || Rust || 構成ファイル || Handlebars
+|-
+! [https://dt.cli.rs dt-cli]
+| {{AUR|dt-cli}} || Rust || 構成ファイル || Handlebars
+|-
+! [https://www.gnu.org/software/stow/ GNU Stow]
+| {{Pkg|stow}} || Perl || ディレクトリベース [http://brandon.invergo.net/news/2012-05-26-using-gnu-stow-to-manage-your-dotfiles.html] || {{Grey|No}}
+|-
+! [https://github.com/lra/mackup Mackup]
+| {{AUR|mackup}} || Python || アプリケーションごとに自動 || {{Grey|No}}
+|-
+! [https://github.com/darkfeline/mir.qualia mir.qualia]
+| {{AUR|mir.qualia}} || Python || {{Grey|No}} || カスタムブロック
+|-
+! [https://github.com/thoughtbot/rcm rcm]
+| {{AUR|rcm}} || Perl || ディレクトリベース (ホストまたはタグによる) || {{Grey|No}}
+|}
+=== Git を wrapping するツール ===
-{{hc|~/.git/info/exclude|
-*}}
+[[Git]] に不安がある場合は、バージョン管理システムを (多かれ少なかれ) 抽象化するこれらのツールのいずれかを使用することをお勧めします。
-それから {{ic|git add -f}} で追跡したいファイルだけを追加します:
+{| class="wikitable sortable" style="text-align:center;"
- $ git add -f ~/.config/*
+! 名前 !! パッケージ !! 言語 !! ファイルのグループ化 !! 処理
+|-
+! [https://github.com/kazhala/dotbare dotbare]
+| {{AUR|dotbare}} || Shell ({{Pkg|fzf}}) || リポジトリ的 || {{Grey|No}}
+|-
+! [https://github.com/kobus-v-schoor/dotgit dotgit]
+| {{AUR|dotgit}} || Python || ファイル名ベース || {{Grey|No}}
+|-
+! [https://github.com/andsens/homeshick homeshick]
+| {{AUR|homeshick-git}} || Bash || リポジトリ的 || {{Grey|No}}
+|-
+! [https://github.com/technicalpickles/homesick homesick]
+| {{-}} || Ruby || リポジトリ的 || {{Grey|No}}
+|-
+! [https://github.com/pearl-core/pearl Pearl]
+| {{AUR|pearl-git}} || Python || リポジトリ的 || {{Grey|No}}
+|-
+! [https://github.com/RichiH/vcsh vcsh]
+| {{Pkg|vcsh}} || Shell || リポジトリ的 || {{Grey|No}}
+|-
+! [https://yadm.io yadm]<sup>(1)</sup>
+| {{Pkg|yadm}} || Bash || ファイル名ベース<br>(by class/OS/distro/hostname/user)[https://yadm.io/docs/alternates] ||組み込みのテンプレート /Jinja2/ESH [https://yadm.io/docs/templates]<br>(オプション)
+|}
+# [[GPG]] または OpenSS による機密ファイルの暗号化をサポートします。 [https://yadm.io/docs/encryption]
-最後に変更を {{man|1|git-commit}} してください:
- $ git commit -a
 === 他のツール ===

「ドットファイル」の版間の差分

2022年5月30日 (月) 23:17時点における版

目次

ドットファイルを Git で直接追跡する

ホスト固有の設定

ツール

Git を wrapping するツール

他のツール

複数のマシンでドットファイルを管理する

機密情報

リポジトリ

参照

案内メニュー

個人用ツール

名前空間

変種

表示

その他

検索

案内

交流

ツール

他言語版