Skip to content

Commit e626eb0

Browse files
committed
docs(readme): remove duplicated legacy block and keep new content
1 parent 4bbc5d9 commit e626eb0

1 file changed

Lines changed: 0 additions & 117 deletions

File tree

README.md

Lines changed: 0 additions & 117 deletions
Original file line numberDiff line numberDiff line change
@@ -47,123 +47,6 @@ Este repositorio sirve como un lugar para guardar y versionar configuraciones (d
4747
```
4848
En Windows:
4949
```powershell
50-
.\scripts\install.ps1 modules/shell/bash
51-
```
52-
53-
### Nota sobre cambios a nivel sistema
54-
Los instaladores incluidos (`scripts/install.sh` y `scripts/install.ps1`) aplican únicamente dotfiles de usuario (en `$HOME`) y **no** modifican archivos de sistema (`/etc/*`) de forma automática. Si necesitas aplicar configuraciones de sistema (por ejemplo, archivos de `X11`), sigue las instrucciones manuales en `docs/INSTALL.md`.
55-
56-
## Hooks Git
57-
Este repositorio incluye un pre-commit hook en `.githooks/` que marca archivos con `shebang` como ejecutables en el índice al hacer commit para evitar problemas en entornos Unix.
58-
59-
- Activación automática: los instaladores (`scripts/install.sh` y `scripts/install.ps1`) configuran `core.hooksPath` a `.githooks` para la copia local del repo cuando se ejecutan (esta operación es idempotente y segura). Si prefieres hacerlo manualmente, ejecuta:
60-
```bash
61-
./scripts/setup-githooks.sh
62-
```
63-
- Para revertir la configuración en tu copia local:
64-
```bash
65-
git config --unset core.hooksPath
66-
```
67-
68-
## Desarrollo y contribuciones
69-
- Pull requests: bienvenidas. Haz PRs pequeños y fáciles de revisar.
70-
- Issues: usa GitHub Issues para reportar errores o proponer mejoras.
71-
72-
## Licencias
73-
Revisa `CC-SA-4.0` y `GPL-2.0` en la raíz del repositorio; hay archivos con diferentes licencias, revisa los archivos individuales si es necesario.
74-
75-
## Notas sobre Git LFS
76-
Este repositorio usa Git LFS para recursos grandes (por ejemplo, `assets/poni`). Antes de clonar o trabajar con estos assets, asegúrate de tener `git-lfs` instalado y ejecutado.
77-
78-
## Contacto
79-
Si tienes preguntas o sugerencias, abre un issue o contacta al mantenedor (ver perfil `JotaRandom` en GitHub).
80-
81-
````
82-
**Dotfiles**
83-
84-
Breve colección de configuraciones, ajustes y archivos de configuración personalizados usados por mí en varias máquinas (laptops antiguas y nuevas). El repositorio agrupa dotfiles para diferentes equipos y entornos, junto con extras y notas históricas.
85-
86-
**One-line Quick Start (Linux / WSL)**
87-
Para clonar, preparar y aplicar la configuración en una sola línea (Linux / WSL):
88-
```bash
89-
git clone --recurse-submodules https://github.com/JotaRandom/dotfiles.git ~/dotfiles && cd ~/dotfiles && git lfs install && git lfs pull && git submodule update --init --recursive && ./scripts/install.sh
90-
```
91-
92-
**One-line Quick Start (PowerShell / Windows)**
93-
Para clonar, preparar y aplicar la configuración en una sola línea (PowerShell):
94-
```powershell
95-
git clone https://github.com/JotaRandom/dotfiles.git $HOME\dotfiles; cd $HOME\dotfiles; git lfs install; git lfs pull; git submodule update --init --recursive; .\scripts\install.ps1
96-
```
97-
98-
Lee `docs/INSTALL.md` si necesitas más detalle o alternativas (stow, configuraciones por distro, o ajustes manuales).
99-
100-
**Estructura**
101-
- **`modules/`**: módulos de dotfiles por función listos para usar con `stow` (ej. `modules/shell/bash`, `modules/desktop/xfce`, `modules/system/etc`).
102-
- **`machines/`**: archivos específicos por máquina (histórico) — ahora incluye `machines/L420` (mi máquina actual) y `machines/Toshiba` (antigua).
103-
- **`assets/`**: recursos multimedia y binarios (por ejemplo `assets/poni` con imágenes de `ponysay`).
104-
- **`distros/`**: configuraciones ajustadas por distribución (PopOS, PKGBUILD, etc.).
105-
- **`distros/PKGBUILD/`**: algunas carpetas de PKGBUILD se mantienen como submodules apuntando a sus repos en AUR; revisa `docs/CONTRIBUTING.md` para instrucciones sobre cómo actualizar.
106-
- **`CC-SA-4.0`**, **`GPL-2.0`**: Archivos de licencia presentes en la raíz del repositorio.
107-
108-
**Descripción rápida**
109-
- **Propósito**: Guardar y versionar configuraciones útiles (por ejemplo, `.bashrc`, `.zshrc`, archivos de `X11`, `udev`, `modprobe.d`, etc.) para poder replicarlas o consultarlas en el futuro.
110-
- **Alcance**: Incluye configuraciones activas y antiguas. Algunas carpetas son históricas y se mantienen por referencia.
111-
112-
**Instalación y uso**
113-
- **Clonar el repositorio**:
114-
- Linux/macOS: `git clone https://github.com/JotaRandom/dotfiles.git ~/dotfiles`
115-
- Windows PowerShell: `git clone https://github.com/JotaRandom/dotfiles.git $HOME\dotfiles`
116-
- **Desplegar dotfiles (ejemplos)**:
117-
- Con `stow` (recomendado en sistemas Unix):
118-
1. `cd ~/dotfiles`
119-
2. `stow modules/shell/bash` (por ejemplo `stow modules/shell/bash` para enlazar `.bashrc` al `$HOME`).
120-
- Enlace manual (Linux/macOS): `ln -s ~/dotfiles/.bashrc ~/.bashrc`.
121-
- Enlace manual (PowerShell, requiere permisos/Developer Mode): `New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\\.bashrc" -Target "$pwd\\.bashrc"`
122-
123-
**Notas importantes**
124-
- **Symlinks en Windows**: Crear enlaces simbólicos en Windows puede requerir permisos de administrador o activar el modo desarrollador.
125-
- **Archivos históricos**: Algunas carpetas (por ejemplo `Toshiba/`) están aquí solo como referencia y no todas las configuraciones están garantizadas para funcionar en hardware moderno.
126-
- **Archivos históricos**: Las máquinas antiguas (por ejemplo `machines/Toshiba`) se encuentran en `machines/` como referencia. Para despliegue, utiliza los módulos en `modules/`.
127-
128-
**Preparar el repositorio (checklist rápido)**
129-
- Clona y prepara submodules y LFS:
130-
```bash
131-
git clone --recurse-submodules https://github.com/JotaRandom/dotfiles.git ~/dotfiles
132-
cd ~/dotfiles
133-
git lfs install
134-
git lfs pull
135-
git submodule update --init --recursive
136-
```
137-
- Instala dotfiles (stow / scripts):
138-
```bash
139-
./scripts/install.sh # Unix/WSL (usa stow)
140-
.\scripts\install.ps1 # PowerShell (Windows - ejecutar con permisos si requiere symlinks)
141-
```
142-
- Opcional: actualizar PKGBUILD submodules (todos o un paquete específico):
143-
144-
opciones manuales:
145-
- Xorg (recomendado para X11): copia los archivos relevantes desde `modules/system/etc/X11/` a `/etc/X11/xorg.conf.d/`.
146-
```bash
147-
./scripts/update-submodules.sh # Actualiza todos los submodules
148-
./scripts/update-submodules.sh micropolis-java # Actualiza solo micropolis-java
149-
```
150-
151-
- Xorg (recomendado para X11): copia `modules/system/etc/X11/+.conf` a `/etc/X11/xorg.conf.d/` y reinicia la sesión gráfica para aplicar los cambios.
152-
153-
Revisa `docs/INSTALL.md` para más detalles e instrucciones manuales.
154-
155-
156-
Para más detalles y alternativas (subtree, CI, etc), revisa `docs/INSTALL.md` y `docs/CONTRIBUTING.md`.
157-
158-
**Quick start — Reinstalación**
159-
```bash
160-
git clone https://github.com/JotaRandom/dotfiles.git ~/dotfiles
161-
cd ~/dotfiles
162-
git lfs install
163-
git lfs pull
164-
./scripts/install.sh
165-
# o especifica los módulos que quieres aplicar:
166-
./scripts/install.sh modules/shell/bash modules/shell/fish modules/editor/nvim modules/editor/vscode
16750
```
16851
Nota: El instalador `./scripts/install.sh` aplica solo dotfiles de usuario en `$HOME` (stow), y no modifica archivos de sistema como `/etc/*`. Para cambios a nivel sistema aplica los archivos manualmente con permisos root según las instrucciones en `docs/INSTALL.md`.
16952

0 commit comments

Comments
 (0)