starship/docs/it-IT/advanced-config

Configurazione Avanzata

Nonostante Starship sia una shell versatile, a volte devi fare qualche modifica in più in starship.toml per ottenere alcune cose. Questa pagina descrive alcune tecniche di configurazione avanzate utilizzate in Starship.

::: warning

Le configurazioni in questa sezione sono soggette a modifiche nelle future versioni di Starship.

:::

Comandi personalizzati di pre-prompt e pre-esecuzione per Bash

Bash non ha un framework preexec/precmd formale come la maggior parte delle altre shell. Per questo motivo, è difficile fornire hook completamente personalizzabile in bash. Tuttavia, Starship dà la limitata possibilità di inserire le tue funzioni nella procedura prompt-rendering:

• Per eseguire una funzione personalizzata a destra del prompt prima che venga disegnato, definisci una nuova funzione e assegna il suo nome a starship_precmd_user_func. Per esempio, per visualizzare l'icona di un razzo prima del prompt, si può usare il codice seguente

function blastoff(){
    echo "🚀"
}
starship_precmd_user_func="blastoff"

• Per eseguire una funzione personalizzata prima dell'esecuzione di un comando, è possibile utilizzare il meccanismo trappola DEBUG. Tuttavia, devi intrappolare il segnale DEBUG prima di inizializzare Starship! Starship può preservare il valore trappola di DEBUG, ma se la trappola viene sovrascritta dopo l'avvio di Starship, alcune funzionalità non funzioneranno.

function blastoff(){
    echo "🚀"
}
trap blastoff DEBUG # Trap DEBUG *prima* di eseguire starship
eval $(starship bash)

Cambia il titolo della finestra

Alcune shell prompt cambieranno automaticamente il titolo della finestra (ad esempio per riflettere la directory di lavoro). Fish lo fa per impostazione predefinita. Starship non lo fa, ma è abbastanza semplice aggiungere questa funzionalità a bash o zsh.

Innanzitutto, bisogna definire una funzione per il cambio del titolo della finestra (identica sia per bash che zsh):

function set_win_title(){
    echo -ne "\033]0; IL_TUO_TITOLO_QUI \007"
}

Puoi usare delle variabili per personalizzare questo titolo ($USER, $HOSTNAME, e $PWD sono le scelte più popolari).

In bash, impostare questa funzione per essere la precmd Starship function:

starship_precmd_user_func="set_win_title"

In zsh, aggiungi questo precmd_functions all'array:

precmd_functions+=(set_win_title)

Se ti piace il risultato, aggiungi queste righe al tuo file shell di configurazione (~/.bashrc o ~/.zshrc) per renderlo permanente.

Ad esempio, se desideri visualizzare la directory corrente nel titolo della scheda del terminale, aggiungi la seguente snippet al tuo ~/.bashrc or ~/.zshrc:

function set_win_title(){
    echo -ne "\033]0; $(basename "$PWD") \007"
}
starship_precmd_user_func="set_win_title"

Stringhe di stile

Le stringhe di stile sono un elenco di parole, separate da spazi bianchi. Le parole non sono sensibili alle maiuscole (cioè grassetto e BoLd sono considerate la stessa stringa). Ogni parola può essere una delle seguenti:

• bold
• underline
• dimmed
• inverted
• bg:<color>
• fg:<color>
• <color>
• none

dove <color> è un colore specifico (discusso in seguito). fg:<color> e <color> attualmente fanno la stessa cosa, anche se questo potrebbe cambiare in futuro. inverted scambia lo sfondo e i colori in primo piano. L'ordine delle parole nella stringa non conta.

Il token none sovrascrive tutti gli altri token in una stringa se non fa parte di uno specificatore bg:, così ad esempio fg:red none fg:blue creerà una stringa senza stile. bg:none imposta come colore di sfondo quello predefinito così fg:red bg:none è equivalente a red o fg:red e bg:green fg:red bg:none è equivalente a fg:red o red. Potrà diventare un errore usare none in combinazione con altri token in futuro.

Uno colore specifico può essere uno di questi:

• Uno dei colori standard del terminale: nero, rosso, verde, blu, giallo, viola, ciano, bianco. Puoi eventualmente utilizzare il prefisso bright- per ottenere la versione luminosa (es. bright-white).
• Un # seguito da un valore esadecimale a sei cifre. Questo specifica un colore esagesimale in RGB.
• Un numero compreso tra 0-255. Specifica un codice colore ANSI a 8 bit.

Se sono specificati più colori per il primo piano/sfondo, l'ultimo nella stringa avrà la priorità.