dotfiles/README.md
2026-07-13 09:17:03 +01:00

44 lines
No EOL
1.4 KiB
Markdown

# 💻 My Dotfiles
Este repositório contém as minhas configurações pessoais para o meu ambiente de trabalho em **Fedora Linux**. A gestão dos ficheiros (*symlinks*) é feita através do **GNU Stow**.
## 🛠️ Ferramentas Base
* **OS:** Fedora Linux
* **Shell:** Zsh
* **Terminal:** Alacritty
* **Editor:** Emacs
* **Compositor:** Niri
---
## 🚀 Como instalar num sistema novo
### 1. Instalar as dependências do sistema
Numa instalação fresca do Fedora, o primeiro passo é instalar as aplicações e o `stow`:
```bash
sudo dnf update -y
sudo dnf install -y git stow zsh util-linux-user alacritty emacs
```
### 2. Clonar este repositório
Como ainda não tens as chaves SSH configuradas na máquina nova, terás de clonar usando HTTPS (ou gerar a chave antes):
```bash
git clone https://<teu-dominio-forgejo>/<teu-user>/dotfiles.git ~/dotfiles
cd ~/dotfiles
```
### 3. Aplicar as configurações
Usa o Stow para criar as ligações simbólicas de cada ferramenta.
Aviso: Se o sistema já tiver criado ficheiros padrão (como o ~/.zshrc), o Stow vai dar um erro de conflito. Se isso acontecer, apaga ou faz backup do ficheiro existente (mv ~/.zshrc ~/.zshrc.bak) e volta a correr o Stow.
```bash
stow zsh alacritty emacs niri
```
### Nota:
Para atualizar as configurações no futuro, basta alterar os ficheiros normalmente (ou diretamente dentro da pasta ~/dotfiles), fazer um git commit e git push.