Skip to content

Commit 24cff52

Browse files
shellutilsshellutils
authored
A Dynamic Collection of Shell Scripts with Educational Purpose
1 parent bbdee4e commit 24cff52

File tree

2 files changed

+149
-103
lines changed

2 files changed

+149
-103
lines changed

‎README_es.html‎

Lines changed: 149 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,149 @@
1+
<!DOCTYPE html>
2+
<html lang="es">
3+
<head>
4+
<meta charset="UTF-8">
5+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6+
<title>Shell Utils Framework</title>
7+
<style>
8+
.center {
9+
text-align: center;
10+
}
11+
body {
12+
max-width: 1200px;
13+
margin: 0 auto;
14+
padding: 20px;
15+
font-family: system-ui, -apple-system, sans-serif;
16+
}
17+
pre {
18+
background-color: #f6f8fa;
19+
padding: 16px;
20+
border-radius: 6px;
21+
overflow-x: auto;
22+
}
23+
img {
24+
max-width: 100%;
25+
height: auto;
26+
}
27+
</style>
28+
</head>
29+
<body>
30+
31+
<h1><a href="https://github.com/felipefacundes/shell_utils">Shell Utils Framework 🐚</a></h1>
32+
33+
<p>
34+
<a href="./README_pt.html"><img src="https://img.shields.io/badge/lang-pt--BR-green.svg" alt="pt-BR"></a>
35+
<a href="./README_es.html"><img src="https://img.shields.io/badge/lang-es-yellow.svg" alt="es"></a>
36+
<a href="./README.html"><img src="https://img.shields.io/badge/lang-en-red.svg" alt="en"></a>
37+
</p>
38+
39+
<div class="center">
40+
<img src="./icons/logo.png" alt="Shell Utils Logo">
41+
42+
<p><em>Una Colección Dinámica de Scripts Shell con Propósito Educacional</em></p>
43+
44+
<img src="https://img.shields.io/github/stars/felipefacundes/shell_utils?style=social" alt="GitHub stars">
45+
<img src="https://img.shields.io/github/forks/felipefacundes/shell_utils?style=social" alt="GitHub forks">
46+
<img src="https://img.shields.io/github/issues/felipefacundes/shell_utils" alt="GitHub issues">
47+
<img src="https://img.shields.io/github/license/felipefacundes/shell_utils" alt="GitHub license">
48+
</div>
49+
50+
<h2>🌟 Visión General</h2>
51+
52+
<p>Shell Utils es un marco educativo diseñado para hacer que la programación en shell sea accesible y poderosa. Es el resultado de un trabajo exhaustivo durante muchos años, ahora disponible en GitHub. Con más de 280 scripts documentados, atiende tanto a principiantes como a usuarios avanzados. Su gran diferenciador es la capacidad de interactuar con los principales shells: <strong>Bash, Zsh y Fish</strong>.</p>
53+
54+
<p>✅ Incluye scripts de terceros, como los de <a href="http://www.fmwconcepts.com/imagemagick/index.php">Fred's Imagemagick</a> <em>(créditos mantenidos en los scripts)</em>.</p>
55+
56+
<h3>✨ Características Principales</h3>
57+
58+
<ul>
59+
<li>Reconocimiento dinámico de scripts, funciones, variables y alias</li>
60+
<li>Documentación completa y menús de ayuda</li>
61+
<li>Compatibilidad entre shells (fish, zsh, bash)</li>
62+
<li>Rica colección de scripts utilitarios</li>
63+
<li>Recursos educativos y tutoriales</li>
64+
</ul>
65+
66+
<p>📌 El script <code>help_shell</code> lista funciones como <code>sed_info</code> (para ayudar con el uso de sed), proporcionando tutoriales rápidos sobre comandos de Linux. Para crear una función simple, solo crea un archivo <code>función.sh</code> y guárdalo en <code>~/.shell_utils/scripts/helps/</code>. El script <code>help_shell</code> podrá leerlos y mostrar una lista completa de funciones pedagógicas y mucho más.</p>
67+
68+
<h2>📁 Estructura de Directorios</h2>
69+
70+
<pre>
71+
~/.shell_utils/
72+
├── scripts/ # Scripts principales
73+
│ ├── faqs/ # Scripts de tutorial y guías
74+
│ └── helps/ # Funciones auxiliares educativas
75+
├── functions/ # Funciones personalizadas
76+
├── variables/ # Variables de entorno
77+
└── aliases/ # Alias del shell
78+
</pre>
79+
80+
<h2>🔧 Recursos y Herramientas</h2>
81+
82+
<ul>
83+
<li><strong>Alarma</strong>: Alarma multilingüe, con capacidad de ejecutar comandos externos, función de repetición y más.</li>
84+
<li><strong>Calendario</strong>: Calendario completo con soporte para días festivos</li>
85+
<li><strong>Herramientas de Video</strong>: Grabador de pantalla y administradores de videos</li>
86+
<li><strong>Herramientas de Audio</strong>: Generar frecuencias de audio y administradores de sonido</li>
87+
<li><strong>Herramientas de Procesamiento de Imágenes</strong>: Convertir, redimensionar y manipular imágenes</li>
88+
<li><strong>Gestión de Temas</strong>:
89+
<ul>
90+
<li>Temas de GRUB</li>
91+
<li>Temas de Terminal</li>
92+
<li>Colecciones de arte ASCII</li>
93+
</ul>
94+
</li>
95+
<li><strong>Utilidades de Color</strong>:
96+
<ul>
97+
<li>Paleta de colores ANSI</li>
98+
<li>Convertidor de Hex a ANSI</li>
99+
</ul>
100+
</li>
101+
<li><strong>Herramientas para Gestores de Ventanas</strong>: Soporte para i3, awesome, openbox y otros</li>
102+
<li><strong>Integración con Herramientas de Terceros</strong>: Incluyendo scripts de <a href="http://www.fmwconcepts.com/imagemagick/index.php">"Fred's Imagemagick"</a></li>
103+
</ul>
104+
105+
<h2>🚀 Instalación</h2>
106+
107+
<h3>Opción 1: Instalación en Una Línea</h3>
108+
<pre>bash -c "$(curl -fsSL https://raw.githubusercontent.com/felipefacundes/shell_utils/refs/heads/main/install.sh)"</pre>
109+
110+
<h3>Opción 2: Instalación Manual</h3>
111+
<pre>git clone https://github.com/felipefacundes/shell_utils ~/.shell_utils
112+
bash ~/.shell_utils/install.sh</pre>
113+
114+
<h2>🔄 Dependencias</h2>
115+
116+
<p>El instalador detecta automáticamente tu shell (fish, zsh o bash) e instala las dependencias necesarias:</p>
117+
<ul>
118+
<li>Para usuarios de bash: oh-my-bash</li>
119+
<li>Para usuarios de zsh: oh-my-zsh</li>
120+
</ul>
121+
122+
<h2>🤝 Contribuyendo</h2>
123+
124+
<p>¡Las contribuciones son bienvenidas! Siéntete libre de enviar un Pull Request. Para cambios importantes, por favor abre un issue primero para discutir lo que te gustaría cambiar.</p>
125+
126+
<h2>📜 Licencia</h2>
127+
128+
<p>Este proyecto está licenciado bajo la Licencia GPLv3 - consulta el archivo <a href="LICENSE">LICENSE</a> para obtener detalles.</p>
129+
130+
<h2>👏 Créditos</h2>
131+
132+
<ul>
133+
<li>Creador original: <a href="https://github.com/felipefacundes">Felipe Facundes</a></li>
134+
<li>Agradecimientos especiales a todos los contribuyentes y a <a href="http://www.fmwconcepts.com/imagemagick/index.php">Fred's Imagemagick</a> por algunos scripts incluidos</li>
135+
</ul>
136+
137+
<hr>
138+
139+
<div class="center">
140+
<p><strong>Hecho con ❤️ por la comunidad Shell Utils</strong></p>
141+
142+
<p>
143+
<a href="https://github.com/felipefacundes/shell_utils/issues">Reportar Bug</a> ·
144+
<a href="https://github.com/felipefacundes/shell_utils/issues">Solicitar Recurso</a>
145+
</p>
146+
</div>
147+
148+
</body>
149+
</html>

‎README_es.md‎

Lines changed: 0 additions & 103 deletions
This file was deleted.

0 commit comments

Comments
 (0)