.. | ||
README.md |
Foire aux questions
Quelle est la configuration utilisée dans le GIF de démonstration ?
- Émulateur de terminal: iTerm2
- Thème : Minimal
- Palette de couleurs: Snazzy
- Police: FiraCode Nerd Font
- Shell : Fish Shell
- Configuration: Dotfiles de matchai
- Invite de commande: Starship
Est-ce que l'option globale format
et <module>.disabled
font la même chose ?
Oui, ils peuvent tous deux être utilisés pour désactiver les modules dans l'invite de commande. Si tout ce que vous prévoyez de faire est de désactiver les modules, <module>.disabled
est le meilleur moyen de le faire pour ces raisons :
- Disabling modules is more explicit than omitting them from the top level
format
- Les modules nouvellement créés seront ajoutés à l'invite de commande au fur et à mesure que Starship sera mis à jour
La doc dit que Starship est cross-shell, mais il ne supporte pas X shell. Pourquoi ?
Étant donné la façon dont Starship est construit, il devrait être possible d'ajouter le support pour pratiquement n'importe quel shell. Le binaire de Starship est sans état et agnostique, donc tant que votre shell supporte la personnalisation rapide et l'expansion du shell, Starship peut être utilisé.
Voici un petit exemple pour que Starship fonctionne avec bash :
# Récupère le code d'état de la dernière commande exécutée
STATUS=$?
# Récupère le nombre de tâches en cours d'exécution.
NUM_JOBS=$(jobs -p | wc -l)
# Set the prompt to the output of `starship prompt`
PS1="$(starship prompt --status=$STATUS --jobs=$NUM_JOBS)"
L'implémentation Bash intégrée dans Starship est légèrement plus complexe pour permettre des fonctionnalités avancées comme le module Durée de commande et pour s'assurer que Starship est compatible avec les configurations Bash préinstallées.
Pour une liste de tous les flags acceptés par starship prompt
, utilisez la commande suivante :
starship prompt --help
L'invite de commande utilisera toutes les données contextuelles fournies, mais aucun indicateur n'est "requis".
Comment utiliser Starship sur des distributions Linux avec des versions de glibc plus ancienne ?
Si vous obtenez une erreur du type "version 'GLIBC_2.18' not found (required by starship)" lors de l'utilisation du binaire précompilé (par exemple sur CentOS 6 ou 7), vous pouvez utiliser un binaire compilé avec musl
au lieu de glibc
:
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
orja_JP.UTF-8
. IfLC_ALL
is not a UTF-8 value, you will need to change it. - 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 is a popular choice.
- You are using a Nerd Font.
To test your system, run the following commands in a terminal:
echo -e "\xf0\x9f\x90\x8d"
echo -e "\xee\x82\xa0"
The first line should produce a snake emoji, while the second should produce a powerline branch symbol (e0a0).
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!
How do I uninstall Starship?
Starship is just as easy to uninstall as it is to install in the first place.
- Remove any lines in your shell config (e.g.
~/.bashrc
) used to initialize Starship. - 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:
# Locate and delete the starship binary
rm "$(which starship)"