mirror of
https://github.com/Llewellynvdm/starship.git
synced 2024-12-11 05:42:21 +00:00
93 lines
5.1 KiB
Markdown
93 lines
5.1 KiB
Markdown
# Preguntas frecuentes (FAQ)
|
|
|
|
## ¿Cuál es la configuración usada en el GIF de demostración?
|
|
|
|
- **Emulador de terminal**: [iTerm2](https://iterm2.com/)
|
|
- **Tema**: Mínimo
|
|
- **Esquema de color**: [Snazzy](https://github.com/sindresorhus/iterm2-snazzy)
|
|
- **Font**: [FiraCode Nerd Font](https://www.nerdfonts.com/font-downloads)
|
|
- **Interfaz de línea de comandos**: [Fish Shell](https://fishshell.com/)
|
|
- **Configuración**: [archivos de configuración de matchai](https://github.com/matchai/dotfiles/blob/b6c6a701d0af8d145a8370288c00bb9f0648b5c2/.config/fish/config.fish)
|
|
- **Prompt**: [Starship](https://starship.rs/)
|
|
|
|
## How do I get command completion as shown in the demo GIF?
|
|
|
|
Completion support is provided by your shell of choice. In the case of the demo, the demo was done with [Fish Shell](https://fishshell.com/), which provides completions by default. If you use Z Shell (zsh), I'd suggest taking a look at [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions).
|
|
|
|
## Do top level `format` and `<module>.disabled` do the same thing?
|
|
|
|
Sí, se pueden usar ambos para desactivar los módulos en el símbolo del sistema. Si todo lo que planeas es desactivar módulos, `<module>.disabled` es el método preferido por las siguientes razones:
|
|
|
|
- Disabling modules is more explicit than omitting them from the top level `format`
|
|
- Los nuevos módulos se añadirán al símbolo del sistema en cuanto Starship se actualice
|
|
|
|
## La documentación dice que Starship es compatible con cualquier intérprete de comandos pero no soporta X Shell. ¿Por qué?
|
|
|
|
Por la forma en que Starshp está construído, debería ser posible añadir soporte para prácticamente cualquier intérprete de comandos. El binario de Starship es sin estado y agnóstico, por lo que mientras que tu intérprete de comandos se pueda ampliar y soporte la personalización del símbolo del sistema, puede utilizar Starship.
|
|
|
|
Aquí tienes un pequeño ejemplo haciendo que Starship funcione con bash:
|
|
|
|
```sh
|
|
# Obtener el código de estado del último comando ejecutado
|
|
STATUS=$?
|
|
|
|
# Calcula el número de tareas ejecutándose.
|
|
NUM_JOBS=$(jobs -p | wc -l)
|
|
|
|
# Set the prompt to the output of `starship prompt`
|
|
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
|
|
```
|
|
|
|
La [implementación de Bash](https://github.com/starship/starship/blob/master/src/init/starship.bash) en Starship es sensíblemente is ligeramente más compleja para permitir características avanzadas como [el módulo de duración de comando](https://starship.rs/config/#Command-Duration) y para asegurar que Starship es compatible con las configuraciones preinstaladas de Bash.
|
|
|
|
Para obtener una lista de todos los parámetros aceptados por `el símbolo del sistema starship`, usa el siguiente comando:
|
|
|
|
```sh
|
|
starship prompt --help
|
|
```
|
|
|
|
El símbolo de sistema usará tanto contexto como le proveas, pero no hay parámetros "obligatorios".
|
|
|
|
## ¿Cómo lanzo Starship en distribuciones Linux con versiones antiguas de glibc?
|
|
|
|
Si obtienes un error como "_version 'GLIBC_2.18' not found (required by starship)_" al usar el binario precompilado (por ejemplo, en CentOS 6 o 7), puedes usar el binario compilado con `musl` en vez de `glibc`:
|
|
|
|
```sh
|
|
curl -fsSL https://starship.rs/install.sh | bash -s -- --platform unknown-linux-musl
|
|
```
|
|
|
|
## Why don't I see a glyph symbol in my prompt?
|
|
|
|
The most common cause of this is system misconfiguration. Some Linux distros in particular do not come with font support out-of-the-box. You need to ensure that:
|
|
|
|
- Your locale is set to a UTF-8 value, like `de_DE.UTF-8` or `ja_JP.UTF-8`. If `LC_ALL` is not a UTF-8 value, [you will need to change it](https://www.tecmint.com/set-system-locales-in-linux/).
|
|
- You have an emoji font installed. Most systems come with an emoji font by default, but some (notably Arch Linux) do not. You can usually install one through your system's package manager--[noto emoji](https://www.google.com/get/noto/help/emoji/) is a popular choice.
|
|
- You are using a [Nerd Font](https://www.nerdfonts.com/).
|
|
|
|
To test your system, run the following commands in a terminal:
|
|
|
|
```sh
|
|
echo -e "\xf0\x9f\x90\x8d"
|
|
echo -e "\xee\x82\xa0"
|
|
```
|
|
|
|
The first line should produce a [snake emoji](https://emojipedia.org/snake/), while the second should produce a [powerline branch symbol (e0a0)](https://github.com/ryanoasis/powerline-extra-symbols#glyphs).
|
|
|
|
If either symbol fails to display correctly, your system is still misconfigured. Unfortunately, getting font configuration correct is sometimes difficult. Users on the Discord may be able to help. If both symbols display correctly, but you still don't see them in starship, [file a bug report!](https://github.com/starship/starship/issues/new/choose)
|
|
|
|
## How do I uninstall Starship?
|
|
|
|
Starship is just as easy to uninstall as it is to install in the first place.
|
|
|
|
1. Remove any lines in your shell config (e.g. `~/.bashrc`) used to initialize Starship.
|
|
1. Delete the Starship binary.
|
|
|
|
If Starship was installed using a package manager, please refer to their docs for uninstallation instructions.
|
|
|
|
If Starship was installed using the `curl | bash` script, the following command will delete the binary:
|
|
|
|
```sh
|
|
# Locate and delete the starship binary
|
|
rm "$(which starship)"
|
|
```
|