Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wildzarek/42env-nr
42 Environment Configuration Script (without sudo)
https://github.com/wildzarek/42env-nr
42school bash dotfiles linux termux ubuntu
Last synced: about 1 month ago
JSON representation
42 Environment Configuration Script (without sudo)
- Host: GitHub
- URL: https://github.com/wildzarek/42env-nr
- Owner: WildZarek
- License: other
- Created: 2024-10-01T16:06:30.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2024-11-20T16:01:25.000Z (2 months ago)
- Last Synced: 2024-11-20T16:33:36.330Z (2 months ago)
- Topics: 42school, bash, dotfiles, linux, termux, ubuntu
- Language: Shell
- Homepage:
- Size: 900 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
42 ENVironment Configuration Script
Automatiza la instalación y configuración del entorno básico para empezar a programar en el Cursus de 42.
# Distribuciones Compatibles
Testeado en las siguientes distribuciones:
| Distribución | Codename | Estado |
| ---------------- | ------------- | ------ |
| [Ubuntu 22.04 LTS (42)](https://releases.ubuntu.com/jammy/) | Jammy | Ok |
| [Android Termux](https://f-droid.org/es/packages/com.termux/) | Termux | Ok |
# Índice
1. [Software](#software)
2. [Recomendaciones](#recomendaciones)
3. [Instalación](#instalación)
4. [Durante la ejecución](#durante-la-ejecución)
5. [Neovim](#neovim)
- [Uso básico de NeoVim](#uso-básico-de-neovim)
6. [Extras](#extras)
- [Oh-My-Zsh](#oh-my-zsh)
- [zsh-autosuggestions](#zsh-autosuggestions)
- [zsh-syntax-highlighting](#zsh-syntax-highlighting)
- [LSD (LSDeluxe)](#lsd-lsdeluxe)
- [BAT (batcat)](#batcat)
- [xclip](#xclip)
7. [42env](#42env)
# Software
Este script instala el siguiente software en el caso de que no esté instalado:
- **zsh |** [Shell ZSH](https://www.zsh.org/)
- **oh-my-zsh |** [Oh-My-Zsh](https://ohmyz.sh/)
- **zsh-autosuggestions |** [Plugin zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions)
- **zsh-syntax-highlighting |** [Plugin zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting)
- **git |** [Git Fast Version Control](https://git-scm.com/doc)
- **python3 |** [Python 3.11.2](https://www.python.org/downloads/release/python-3112/)
- **pip3 |** [Package Installer for Python](https://pip.pypa.io/en/stable/)
- **neovim |** [Hyperextensible Vim-based text editor](https://neovim.io/) + vim-plug + 42 plugins
- **nerd fonts |** [Iconic font aggregator, collection, and patcher](https://www.nerdfonts.com/) | Hack Nerd Font
- **lsd |** [The next gen ls command](https://github.com/lsd-rs/lsd)
- **bat |** [A cat clone with wings](https://github.com/sharkdp/bat)
- **xclip |** [Command line interface to the X11 clipboard](https://github.com/astrand/xclip)
- Atajos de teclado para 'nvim' y config para .zshrc
# Instalación
Primero clonamos este repositorio y entramos en la carpeta `42env-nr` creada.
```bash
git clone https://github.com/WildZarek/42env-nr.git; cd 42env-nr
```
Asigna permisos de ejecución al script y ejecútalo. Se recomienda tener siempre maximizada la ventana de la shell.
```bash
chmod +x 42env-nr.sh; ./42env-nr.sh
```
# Durante la ejecución
Al ejecutar el script, te pedirá tu usuario de la Intra 42, escríbelo y pulsa `Enter`
Este usuario se usará para configurar el header de 42 para nvim.
Después de finalizar la instalación ejecuta `nvim`, acto seguido escribe `:PlugInstall` para que se complete la configuración de Neovim.
```bash
nvim
```
> [!NOTE]
> Si estás instalando este entorno en 42 Málaga (sin permisos sudo), en lugar de `nvim` deberás utilizar el alias `nv` en la terminal.
# NeoVim
Si ejecutas `nvim` sin ningún nombre de archivo, se abrirá a la izquierda el explorador de archivos en la ruta actual para que puedas navegar entre las distintas carpetas y archivos. Si se ejecuta pasando un nombre de archivo, entonces el foco cambia directamente a la ventana del archivo.
## Uso básico de NeoVim
En NeoVim se han definido multitud de atajos de teclado para el uso diario que funcionan solo en el modo NORMAL y nos facilitan la tarea de escribir codigo:
**Tecla F1:** Inserta el header de 42 y pone el editor en modo `Insert`.
**Tecla F2:** Formatea automáticamente el código siguiendo la Norma para presentarlo a la `norminette`.
**Tecla F3:** Ejecuta `norminette` con las flags `-R CheckForbiddenSourceHeader` sobre el archivo actual.
**Tecla Ctrl+q:** Fuerza el cierre de la ventana activa [Equivale a `:q!`]
**Tecla Ctrl+s:** Guarda el documento activo [Equivale a `:w`]
**Tecla Ctrl+f:** Guarda y cierra el documento activo [Equivale a `:wq`]
**Tecla F4:** Abre o cierra el explorador de archivos.
> [!NOTE]
> Puedes ver los demás [atajos de teclado aquí](#atajos-de-teclado-neovim)
# Extras
## Oh-My-Zsh
Oh My Zsh es una capa de personalización en formato framework que se instala sobre Zsh. Proporciona una amplia gama de características y mejoras, como autocompletado avanzado, atajos de teclado, sugerencias de comandos, temas personalizables y una amplia biblioteca de plugins.
## zsh-autosuggestions
zsh-autosuggestions es un plugin que a medida que escribimos un comando, nos sugiere y recuerda comandos escritos anteriormente (que residen en el historial de la terminal) en color gris de fondo, para que sea más sencillo para nosotros identificarlos. Pulsando la tecla → le decimos a zsh que lo recupere íntegro, lo que puede ser útil para comandos largos. Similar a como lo hace la shell `fish` por defecto.
## zsh-syntax-highlighting
zsh-syntax-highlighting proporciona resaltado de color de comandos, el cuál viene de una característica que incorporaba inicialmente la shell `fish`. Al escribir un comando en la terminal nos aparecerá en rojo si no está instalado en el sistema o en verde si está disponible para utilizar. De esta forma sabremos, a medida que vamos escribiendo los comandos, si los estamos escribiendo bien (o por lo contrario, tenemos erratas) o si no se encuentra instalado un comando, por ejemplo, incluso antes de pulsar la tecla ENTER
## LSD (LSDeluxe)
Se incluye `lsd` ya que mejora la legibilidad en la terminal aprovechando las Hack Nerd Fonts instaladas en el sistema. El alias `ll` equivale a:
```bash
/usr/bin/lsd -lha --group-dirs=first
```
Si por comodidad queremos ver los permisos de los archivos y carpetas en base octal, `llo` es un alias de:
```bash
/usr/bin/lsd -lha --group-dirs=first --permission octal
```
## BAT (batcat)
bat es una alternativa moderna al clásico comando `cat` de Linux. Ofrece algunas características únicas, como números de línea de impresión bonita, paginación y resaltado de sintaxis.
El alias `bat` (admite un parámetro para indicar el nombre del archivo) equivale a:
```bash
/usr/bin/batcat
```
## xclip
xclip es una aplicación que nos permite introducir texto en el portapapeles y recuperar texto de él desde la línea de comandos. El texto recuperado puede haber sido introducido por cualquier otra aplicación.
Asímismo, el texto que se introduce en el portapapeles a través de xclip puede ser utilizado por cualquier otra aplicación.
Ejemplos de uso:
```bash
echo "Hola mundo" | xclip -i
```
El texto «Hola mundo» pasará a estar disponible para el resto de aplicaciones.
Del mismo modo, para recuperar el texto del portapapeles y enviarlo a la salida estándar debe especificarse la opción `-o`:
```bash
xclip -o
Hola mundo
```
Podemos usar pipes para enviar al portapapeles lo que queramos, por ejemplo el contenido completo de un archivo:
```bash
cat archivo.txt | xclip
```
En definitiva, es una herramienta muy útil que nos ahorra tiempo a la hora de trabajar con el portapapeles.
## Atajos de teclado NeoVim
> [!NOTE]
> Estos atajos son para utilizar en el modo **NORMAL**
| Atajo | Descripción |
| --- | --- |
| `F1` | Añade el header de 42 |
| `F2` | Aplica auto-formato al código C en base a la Norma v3 de 42 |
| `F3` | Ejecuta Norminette sobre el archivo actual y muestra los errores de norma |
| `F4` | Muestra u oculta explorador de archivos NERDTree |
| `F5` | Muestra u oculta el plugin Tagbar a la derecha |
| `Ctrl` + `q` | Cierra la ventana actual sin guardar los cambios (:q!) |
| `Ctrl` + `s` | Guarda los cambios en el documento actual (:w) |
| `Ctrl` + `f` | Guarda los cambios en el documento actual y cierra Nvim (:wq) |
| `Ctrl` + `h` | Cambia el foco a la división del lado izquierdo |
| `Ctrl` + `l` | Cambia el foco a la división del lado derecho |
| `Ctrl` + `j` | Cambia el foco a la división del lado inferior |
| `Ctrl` + `k` | Cambia el foco a la división del lado superior |
| `Ctrl` + `↑` | Cambia el tamaño de la división activa hacia arriba (horizontalmente) |
| `Ctrl` + `↓` | Cambia el tamaño de la división activa hacia abajo (horizontalmente) |
| `Ctrl` + `←` | Cambia el tamaño de la división activa hacia la izquierda (verticalmente) |
| `Ctrl` + `→` | Cambia el tamaño de la división activa hacia la derecha (verticalmente) |
# Terminal
## Terminator (instalado en 42)
Terminator es una excelente opción si buscas un emulador de terminal que combine velocidad, personalización y funcionalidad avanzada, ideal para usuarios que desean aprovechar al máximo su entorno de trabajo en la terminal. Permite dividir la pantalla en varias terminales dentro de una misma ventana, facilitando la multitarea sin necesidad de usar múltiples ventanas. Terminator es un proyecto de código abierto con un desarrollo activo, lo que significa que recibe actualizaciones frecuentes y mejoras continuas.
## Atajos de teclado (Terminator)
| Atajo | Descripción |
| --- | --- |
| `Ctrl` + `Shift` + `Q` | Finaliza la ejecución de Terminator |
| `Ctrl` + `Shift` + `W` | Cierra la terminal o la ventana activa |
| `Ctrl` + `Shift` + `I` | Abre una nueva ventana (la cual es parte del proceso actual de Terminator)
| `Ctrl` + `Shift` + `T` | Abre una nueva pestaña en el directorio actual |
| `Ctrl` + `Shift` + `O` | Divide la terminal horizontalmente |
| `Ctrl` + `Shift` + `E` | Divide la terminal horizontalmente |
| `Ctrl` + `Shift` + `→` | Modifica el tamaño de la terminal verticalmente |
| `Ctrl` + `Shift` + `←` | Modifica el tamaño de la terminal verticalmente |
| `Ctrl` + `Shift` + `↑` | Modifica el tamaño de la terminal horizontalmente |
| `Ctrl` + `Shift` + `↓` | Modifica el tamaño de la terminal horizontalmente |
| `Ctrl` + `Shift` + `S` | Oculta/Muestra la barra de scroll de la terminal activa |
| `Ctrl` + `Shift` + `F` | Muestra la barra de búsqueda |
| `Ctrl` + `Shift` + `N` | Cambia a la siguiente terminal en la misma pestaña |
| `Ctrl` + `Shift` + `P` | Cambia a la anterior terminal en la misma pestaña |
| `Ctrl` + `Shift` + `X` | Cambia entre mostrar todas las terminales o maximizar la actual |
| `Ctrl` + `Shift` + `Z` | Cambia entre mostrar todas las terminales o una visión ampliada de la actual (zoom) |
| `Ctrl` + `PageDown` | Cambia a la siguiente terminal |
| `Ctrl` + `PageUp` | Cambia a la terminal anterior |
| `Alt` + `→` | Cambia a la terminal justo a la derecha de la actual |
| `Alt` + `←` | Cambia a la terminal justo a la izquierda de la actual |
| `Alt` + `↑` | Cambia a la terminal justo encima de la actual |
| `Alt` + `↓` | Cambia a la terminal justo debajo de la actual |
| `Ctrl` + `Shift` + `C` | Copia el texto seleccionado a la clipboard |
| `Ctrl` + `Shift` + `V` | Pega el contenido de la clipboard a la terminal actual |
| `Ctrl` + `Plus` (+) | Aumenta el tamaño de la fuente para la terminal actual (es posible que debas presionar `Shift` dependiendo del teclado) |
| `Ctrl` + `Minus` (-) | Reduce el tamaño de la fuente para la terminal actual (es posible que debas presionar `Shift` dependiendo del teclado) |
| `Ctrl` + `Zero` (0) | Reinicia el tamaño de la fuente para la terminal actual (a los valores de configuración por defecto) |
| `F11` | Activa o desactiva la pantalla completa |
| `Ctrl` + `Shift` + `R` | Reinicia el estado de la terminal |
| `Ctrl` + `Shift` + `G` | Reinicia el estado de la terminal y limpia la pantalla |
# 42env
Si quieres instalar una versión más completa de este proyecto en tu máquina virtual, ve a [42env](https://github.com/WildZarek/42env)
> [!NOTE]
> Si consideras útil este proyecto, apóyalo dando ★ Star en el repositorio. ¡Gracias!
### LICENCIA
This work is published under the terms of **[42 Unlicense](https://github.com/gcamerli/42unlicense)**.
# ¡Happy hacking & coding! 😎
[Volver al índice](#índice)