dotfiles

curl -fsSL https://raw.githubusercontent.com/kenkenpa198/dotfiles/main/setup/linux/setup.sh | bash

TOC

• Setup
  • Ubuntu
  • Arch Linux
  • Windows and WSL
  • MacOS
• Tips
  • ホワイトリスト形式の .gitignore
  • Git のキャッシュ削除手順
  • PowerShell でスクリプトを実行する
  • Windows Terminal の GUID 復元手順
• Reference

Setup

Ubuntu

# 必須パッケージの存在を確認する
type "sudo" ; type "curl" ; type "git"

# 存在しなければインストールする
# sudo
apt-get update && apt-get upgrade -y
apt-get install -y sudo

# curl git
sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y curl
sudo apt-get install -y git

# セットアップ用スクリプトを実行する
curl -fsSL https://raw.githubusercontent.com/kenkenpa198/dotfiles/main/setup/linux/setup.sh | bash

Arch Linux

# 必須パッケージの存在を確認する
type "sudo" ; type "curl" ; type "git"

# 存在しなければインストールする
# sudo
pacman -Syu --noconfirm
pacman -S --noconfirm sudo

# curl git
sudo pacman -Syu --noconfirm
sudo pacman -S --noconfirm curl
sudo pacman -S --noconfirm git

# セットアップ用スクリプトを実行する
curl -fsSL https://raw.githubusercontent.com/kenkenpa198/dotfiles/main/setup/linux/setup.sh | bash

Windows and WSL

1. Windows PowerShell を管理者権限で起動し、次のコマンドを実行して WSL をセットアップする。

   wsl --install

   • 参考) WSL のインストール | Microsoft Learn

2. (Arch Linux のみ) yuk7/ArchWSL を使用して WSL へ Arch Linux をインストール・初期設定する。

   • 参考) インストール方法 | ArchWSL official documentation

3. .wslconfig を %UserProfile% ( C:\Users\[username] ) へ配置する。

4. WSL 環境のホームディレクトリ上で各環境ごとのセットアップ手順を実行する。

5. setup/windows/ 配下のスクリプトを順次実行する。

MacOS

次触った時に書く。

Tips

ホワイトリスト形式の .gitignore

.
└── .gitignore

当 dotfiles 用の .gitignore はホワイトリスト形式での記述を行い、.gitignore で指定したファイルのみしか Git の管理下に入らないようにしている。

こうすることで、新しく追加したファイルに秘匿すべき情報が含まれていた際に、誤ってコミットしてしまうミスを防げる。

Git のキャッシュ削除手順

• .gitignore_global を設定する前にコミットをしてしまった。
• 過去に追跡対象としてコミットしたファイルを .gitignore で追跡対象外にしたい。
• .gitignore を整理したので追跡対象の設定が問題ないか確認したい。

これらに該当する場合は Git のキャッシュ削除が必要になる。

次のコマンドを順に実行して対応する。

# cd
cd ~/dotfiles

# Git のキャッシュをすべてのファイルから削除する
git rm --cached -r .

# 全てのファイルをステージングする
git add -vA

# コミット対象のファイルが変更を加えたファイルのみであるか確認する
git status -s

# コミットする
git commit -m '[commit comments]'

PowerShell でスクリプトを実行する

PowerShell はネットワークから取得したスクリプトファイル ***.ps1 がデフォルトで実行できない。このため、スクリプトの実行前に実行ポリシーの変更が必要となる。

一時的に実行ポリシーを変更する場合は下記の手順で行う。

1. 管理者権限で PowerShell を実行する。

2. 現在の実行ポリシーを確認する。

   # 実行ポリシーを確認する
   > Get-ExecutionPolicy
   Restricted # 既定の実行ポリシー。構成ファイルのロードやスクリプトの実行が行えない

3. 実行ポリシーを一時的に変更する。

   # そのプロセスでのみ有効にする
   # Set-ExecutionPolicy -ExecutionPolicy [実行ポリシー] -Scope [スコープ]
   # RemoteSigned ... 署名されたスクリプトが実行できる実行ポリシー
   # Process      ... 実行ポリシーを現在の PowerShell プロセスのみに影響させる
   > Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
   
   実行ポリシーの変更
   実行ポリシーは、信頼されていないスクリプトからの保護に役立ちます。実行ポリシーを変更すると、about_Execution_Policies のヘルプ トピック
   (https://go.microsoft.com/fwlink/?LinkID=135170) で説明されているセキュリティ上の危険にさらされる可能性があります。実行ポリシーを変更しますか?
   [Y] はい(Y)  [A] すべて続行(A)  [N] いいえ(N)  [L] すべて無視(L)  [S] 中断(S)  [?] ヘルプ (既定値は "N"): y
   
   # 確認する
   > Get-ExecutionPolicy
   RemoteSigned
   
   # スクリプトを実行する
   > hoge.ps1

Windows Terminal の GUID 復元手順

Windows Terminal の設定ファイルを上書きする際、環境によっては WSL を Windows Terminal で実行できなくなる場合がある。Ubuntu のバージョンに紐づけられた GUID が上書き前後で変わってしまったため。（※ 理解が正確でないかも）

この場合、下記の手順で上書き前の GUID を復元する。

1. Ctrl + , で設定を開く。
2. 新しいプロファイルを追加します を選択する。
3. プロファイルを複製する から Ubuntu など目的のプロファイルを選んで 複製 をクリックする。
4. 複製されたプロファイルの GUID を既存のプロファイルへ記述する。

Reference

dotfiles

• ようこそdotfilesの世界へ #Vim - Qiita
• Windows と Mac で開発環境を揃える Tips 集 - Neo's World
• dotfilesのこだわりを晒す - エムスリーテックブログ
• dotfilesのすゝめ | kouki’s blog > CI

XDG Base Directory

• XDG Base Directory - ArchWiki
• Dotfiles の整頓とバージョン管理：XDG Base Directory Specification と YADM の活用ガイド #dotfiles - Qiita

zsh

• Introduction - sheldon docs
• 高速で設定しやすいZsh/BashプラグインマネージャーSheldonの紹介
• zsh で使う plugin manager を sheldon に移行 – ぶっちろぐ
• zsh設定ファイル（.zshrc）を分割する - fnwiya's quine

shell script

• シェルスクリプトを高級言語のような書き味に近づける Tips 集
• 使いやすいシェルスクリプトを書く | Taichi Nakashima
• 初心者向け、「上手い」シェルスクリプトの書き方メモ #初心者 - Qiita
• bashのヒアドキュメントを活用する #Bash - Qiita

Windows PowerShell

• 実行ポリシーについて - PowerShell | Microsoft Learn
• Set-ExecutionPolicy (Microsoft.PowerShell.Security) - PowerShell | Microsoft Learn
• PowerShellでこのシステムではスクリプトの実行が無効になっているため、ファイル hoge.ps1 を読み込むことができません。となったときの対応方法 #Windows10 - Qiita
• PowerShellの.bashrc的な設定ファイルこと$Profileについての紹介 #PowerShell - Qiita

Git

• Git - Git の設定
• github/gitignore: A collection of useful .gitignore templates
• gitignoreのホワイトリストの書き方 #Git - Qiita
• 最低限しておくといいgitconfigの設定 #Git - Qiita
• .gitconfigにinclude書くと捗る - 時計を壊せ

AutoHotKey v2

• クイックリファレンス｜AutoHotkey v2
• k-ayaki/IMEv2.ahk
• AutoHotKey : Google Chrome専用スクリプト - imani-cの日記
• IME制御 - eamat @Cabinet - atwiki（アットウィキ）
• Autohotkey v2.0のIME制御用 関数群 IMEv2.ahk #AutoHotkey - Qiita
• WindowsのAlt空打ちで日本語入力(IME)を切り替えるツールを作った - karakaram-blog
• kskmori/US-AltIME.ahk
• AutoHotkey：キー押しっぱなし病・ホットキーすり抜け病対策の研究
• 快適キーボード操作のためのキーカスタマイズ 〜AutoHotKeyのキー押しっぱなし問題とScrollLockの非推奨～ | さくらのナレッジ
• AutoHotkey スレッド part30 > >>770

xremap

• k0kubun/xremap: Key remapper for X11 and Wayland
  • xremap/example/emacs.yml at master · k0kubun/xremap
• Linux用キーリマッパーxremapをRustで書き直した - k0kubun's blog
• evdev/src/scancodes.rs at 1d020f11b283b0648427a2844b6b980f1a268221 · emberian/evdev
• SandSをLinuxでやってる人はxremapを導入してxmodmapとxcapeを捨ててください - Lambdaカクテル
• xremapを利用して特殊なショートカットをマッピングしてみる（Alt+c → Shift+Ctrl+c など ) – Roguer
• xremap + wayland + KDE6でキーリマップしよう #Linux - Qiita

CI

• GitHub Actions のクイックスタート - GitHub Docs
• dotfilesのすゝめ | kouki’s blog > CI

この他、処理ごとの参考文献は各スクリプトにコメントで記載しています。