summaryrefslogtreecommitdiffstats
path: root/docs/it-IT
diff options
context:
space:
mode:
authorMatan Kushner <hello@matchai.dev>2021-01-03 03:56:07 -0500
committerGitHub <noreply@github.com>2021-01-03 09:56:07 +0100
commit4cb8b1f0e891082ae1bed58f6448f3f8df21d35c (patch)
tree1359d3b0a25bc634e23cf1f4b5cac9fd44cad2e2 /docs/it-IT
parentcfff77043e95df8b02b9f3242e42b87d0d94249a (diff)
docs(i18n): New Crowdin updates (#1941)
* New translations README.md (Spanish) * New translations README.md (Spanish) * New translations README.md (Spanish) * New translations README.md (Spanish) * New translations README.md (French) * New translations README.md (Italian) * New translations README.md (Arabic) * New translations README.md (Korean) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (Russian) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (Spanish) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Simplified) * New translations README.md (Chinese Traditional) * New translations README.md (Spanish) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Arabic) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (French) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (Spanish) * New translations README.md (Russian) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Arabic) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (French) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (Spanish) * New translations README.md (Russian) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Arabic) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (French) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (Spanish) * New translations README.md (Russian) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Arabic) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Dutch) * New translations README.md (Polish) * New translations README.md (French) * New translations README.md (Spanish) * New translations README.md (German) * New translations README.md (Japanese) * New translations README.md (Russian) * New translations README.md (Chinese Simplified) * New translations README.md (Chinese Traditional) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Turkish) * New translations README.md (Russian) * New translations README.md (Russian) * New translations README.md (Russian) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Arabic) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (French) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (Spanish) * New translations README.md (Russian) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (German) * New translations README.md (German) * New translations README.md (German) * New translations README.md (German) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Arabic) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (French) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (Spanish) * New translations README.md (Russian) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Italian) * New translations README.md (French) * New translations README.md (Spanish) * New translations README.md (Arabic) * New translations README.md (German) * New translations README.md (Japanese) * New translations README.md (Korean) * New translations README.md (Dutch) * New translations README.md (Polish) * New translations README.md (Portuguese) * New translations README.md (Russian) * New translations README.md (Turkish) * New translations README.md (Chinese Simplified) * New translations README.md (Chinese Traditional) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Arabic) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (French) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (Spanish) * New translations README.md (Russian) * New translations README.md (Portuguese) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (German) * New translations README.md (Japanese) * New translations README.md (Portuguese) * New translations README.md (Spanish) * New translations README.md (French) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Russian) * New translations README.md (Arabic) * New translations README.md (Italian) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Korean) * New translations README.md (Dutch) * New translations README.md (German) * New translations README.md (Japanese) * New translations README.md (Portuguese) * New translations README.md (Spanish) * New translations README.md (French) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Russian) * New translations README.md (Arabic) * New translations README.md (Italian) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Korean) * New translations README.md (Dutch) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (German) * New translations README.md (Japanese) * New translations README.md (Portuguese) * New translations README.md (Spanish) * New translations README.md (French) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Russian) * New translations README.md (Arabic) * New translations README.md (Italian) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Korean) * New translations README.md (Dutch) * New translations README.md (Chinese Simplified) * New translations README.md (Russian) * New translations README.md (Russian) * New translations README.md (Portuguese) * New translations README.md (Portuguese) * New translations README.md (Japanese) * New translations README.md (Japanese) * New translations README.md (German) * New translations README.md (German) * New translations README.md (Chinese Simplified) * New translations README.md (Chinese Traditional) * New translations README.md (Spanish) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Arabic) * New translations README.md (Korean) * New translations README.md (Italian) * New translations README.md (Italian) * New translations README.md (Korean) * New translations README.md (Arabic) * New translations README.md (Spanish) * New translations README.md (Turkish) * New translations README.md (French) * New translations README.md (French) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Polish) * New translations README.md (Dutch) * New translations README.md (Dutch) * New translations README.md (German) * New translations README.md (Japanese) * New translations README.md (Portuguese) * New translations README.md (Spanish) * New translations README.md (French) * New translations README.md (Portuguese, Brazilian) * New translations README.md (Chinese Traditional) * New translations README.md (Chinese Simplified) * New translations README.md (Russian) * New translations README.md (Arabic) * New translations README.md (Italian) * New translations README.md (Turkish) * New translations README.md (Polish) * New translations README.md (Korean) * New translations README.md (Dutch)
Diffstat (limited to 'docs/it-IT')
-rw-r--r--docs/it-IT/README.md112
-rw-r--r--docs/it-IT/advanced-config/README.md93
-rw-r--r--docs/it-IT/config/README.md2503
-rw-r--r--docs/it-IT/faq/README.md92
-rw-r--r--docs/it-IT/guide/README.md272
-rw-r--r--docs/it-IT/migrating-to-0.45.0/README.md267
-rw-r--r--docs/it-IT/presets/README.md89
7 files changed, 3428 insertions, 0 deletions
diff --git a/docs/it-IT/README.md b/docs/it-IT/README.md
new file mode 100644
index 000000000..b22afa4ac
--- /dev/null
+++ b/docs/it-IT/README.md
@@ -0,0 +1,112 @@
+---
+home: true
+heroImage: /logo.svg
+heroText:
+tagline: Il prompt minimalista, super veloce e infinitamente personalizzabile per qualsiasi shell!
+actionText: Inizia →
+actionLink: ./guide/
+features:
+ -
+ title: Prima la compatibilità
+ details: Funziona sulle shell e sui sistemi operativi più comuni. Usalo ovunque!
+ -
+ title: Generato in Rust
+ details: Sfrutta la velocità e sicurezza migliori di Rust, per rendere il tuo prompt il più veloce e il più affidabile.
+ -
+ title: Personalizzabile
+ details: Ogni più piccolo dettaglio è personalizzabile a piacere, per rendere questo messaggio prompt minimalista o ricco delle funzionalità che desideri.
+footer: Licenza ISC | Copyright © 2019-present Starship Collaboratori
+#Used for the description meta tag, for SEO
+metaTitle: "Starship: Cross-Shell Prompt"
+description: Starship è il prompt minimalista, super veloce ed estremamente personalizzabile per qualsiasi shell! Mostra le informazioni di cui hai bisogno, rimanendo elegante e minimale. Installazione rapida disponibile per Bash, Fish, ZSH, Ion e PowerShell.
+---
+
+<div class="center">
+ <video class="demo-video" muted autoplay loop playsinline>
+ <source src="/demo.webm" type="video/webm">
+ <source src="/demo.mp4" type="video/mp4">
+ </video>
+</div>
+
+### Installazione Veloce
+
+1. Installa il binario **starship**:
+
+
+ #### Installa l'ultima Versione
+
+ Con Shell:
+
+ ```sh
+ curl -fsSL https://starship.rs/install.sh | bash
+ ```
+
+
+ #### Installa con Package Manager
+
+ With [Homebrew](https://brew.sh/):
+
+ ```sh
+ brew install starship
+ ```
+
+ Con [Scoop](https://scoop.sh):
+
+ ```powershell
+ scoop install starship
+ ```
+
+1. Aggiungi lo script di inizializzazione al file di configurazione della shell:
+
+
+ #### Bash
+
+ Aggiungi quanto segue alla fine di `~/.bashrc`:
+
+ ```sh
+ # ~/.bashrc
+
+ eval "$(starship init bash)"
+ ```
+
+
+ #### Fish
+
+ Aggiungi quanto segue alla fine di `~/.config/fish/config.fish`:
+
+ ```sh
+ # ~/.config/fish/config.fish
+
+ starship init fish | source
+ ```
+
+
+ #### Zsh
+
+ Aggiungi quanto segue alla fine di `~/.zshrc`:
+
+ ```sh
+ # ~/.zshrc
+
+ eval "$(starship init zsh)"
+ ```
+
+
+ #### Powershell
+
+ Aggiungi quanto segue alla fine di `Microsoft.PowerShell_profile.ps1`. Puoi controllare la posizione di questo file interrogando la variabile `$PROFILE` in PowerShell. In genere il percorso è `~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1` oppure `~/.config/powershell/Microsoft.PowerShell_profile.ps1` in -Nix.
+
+ ```sh
+ Invoke-Expression (&starship init powershell)
+ ```
+
+
+ #### Ion
+
+ Aggiungi quanto segue alla fine di `~/.config/ion/initrc`:
+
+ ```sh
+ # ~/.config/ion/initrc
+
+ eval $(starship init ion)
+ ```
diff --git a/docs/it-IT/advanced-config/README.md b/docs/it-IT/advanced-config/README.md
new file mode 100644
index 000000000..1c7da93b6
--- /dev/null
+++ b/docs/it-IT/advanced-config/README.md
@@ -0,0 +1,93 @@
+# 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.
+
+::: Attenzione
+
+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
+
+```bash
+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`](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/). 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.
+
+```bash
+function blastoff(){
+ echo "🚀"
+}
+trap blastoff DEBUG # Trap DEBUG *before* running starship
+eval $(starship init 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):
+
+```bash
+function set_win_title(){
+ echo -ne "\033]0; YOUR_WINDOW_TITLE_HERE \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:
+
+```bash
+starship_precmd_user_func="set_win_title"
+```
+
+In `zsh`, aggiungi questo `precmd_functions` all'array:
+
+```bash
+precmd_functions+=(set_win_title)
+```
+
+Se ti piace il risultato, aggiungi queste righe al tuo file shell di configurazione (`~/. ashrc` 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 `~/. ashrc` or `~/.zshrc`:
+
+```bash
+function set_win_title(){
+ echo -ne "\033]0; $(basename $PWD) \007"
+}
+starship_precmd_user_func="set_win_title"
+```
+
+## Stile delle Stringhe
+
+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`
+ - `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. 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 `rosso`. Potrà diventare un errore usare `nessuno` 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](https://www.w3schools.com/colors/colors_hexadecimal.asp).
+ - Un numero compreso tra 0-255. Specifica un [codice colore ANSI a 8 bit](https://i.stack.imgur.com/KTSQa.png).
+
+Se sono specificati più colori per il primo piano/sfondo, l'ultimo nella stringa avrà la priorità.
diff --git a/docs/it-IT/config/README.md b/docs/it-IT/config/README.md
new file mode 100644
index 000000000..90628f674
--- /dev/null
+++ b/docs/it-IT/config/README.md
@@ -0,0 +1,2503 @@
+# Configuration
+
+To get started configuring starship, create the following file: `~/.config/starship.toml`.
+
+```sh
+mkdir -p ~/.config && touch ~/.config/starship.toml
+```
+
+All configuration for starship is done in this [TOML](https://github.com/toml-lang/toml) file:
+
+```toml
+# Don't print a new line at the start of the prompt
+add_newline = false
+
+# Replace the "❯" symbol in the prompt with "➜"
+[character] # The name of the module we are configuring is "character"
+success_symbol = "[➜](bold green)" # The "success_symbol" segment is being set to "➜" with the color "bold green"
+
+# Disable the package module, hiding it from the prompt completely
+[package]
+disabled = true
+```
+
+You can change default `starship.toml` file location with `STARSHIP_CONFIG` environment variable:
+
+```sh
+export STARSHIP_CONFIG=~/.starship
+```
+
+Equivalently in PowerShell (Windows) would be adding this line to your `$PROFILE`:
+
+```ps1
+$ENV:STARSHIP_CONFIG = "$HOME\.starship"
+```
+
+### Logging
+
+By default starship logs warnings and errors into a file named `~/.cache/starship/session_${STARSHIP_SESSION_KEY}.log`, where the session key is corresponding to a instance of your terminal. This, however can be changed using the `STARSHIP_CACHE` environment variable:
+
+```sh
+export STARSHIP_CACHE=~/.starship/cache
+```
+
+Equivalently in PowerShell (Windows) would be adding this line to your `$PROFILE`:
+
+```ps1
+$ENV:STARSHIP_CACHE = "$HOME\AppData\Local\Temp"
+```
+
+### Terminology
+
+**Module**: A component in the prompt giving information based on contextual information from your OS. For example, the "nodejs" module shows the version of NodeJS that is currently installed on your computer, if your current directory is a NodeJS project.
+
+**Variable**: Smaller sub-components that contain information provided by the module. For example, the "version" variable in the "nodejs" module contains the current version of NodeJS.
+
+By convention, most modules have a prefix of default terminal color (e.g. `via` in "nodejs") and an empty space as a suffix.
+
+### Format Strings
+
+Format strings are the format that a module prints all its variables with. Most modules have an entry called `format` that configures the display format of the module. You can use texts, variables and text groups in a format string.
+
+#### Variable
+
+A variable contains a `$` symbol followed by the name of the variable. The name of a variable only contains letters, numbers and `_`.
+
+For example:
+
+- `$version` is a format string with a variable named `version`.
+- `$git_branch$git_commit` is a format string with two variables named `git_branch` and `git_commit`.
+- `$git_branch $git_commit` has the two variables separated with a space.
+
+#### Text Group
+
+A text group is made up of two different parts.
+
+The first part, which is enclosed in a `[]`, is a [format string](#format-strings). You can add texts, variables, or even nested text groups in it.
+
+In the second part, which is enclosed in a `()`, is a [style string](#style-strings). This can be used style the first part.
+
+For example:
+
+- `[on](red bold)` will print a string `on` with bold text colored red.
+- `[⬢ $version](bold green)` will print a symbol `⬢` followed by the content of variable `version`, with bold text colored green.
+- `[a [b](red) c](green)` will print `a b c` with `b` red, and `a` and `c` green.
+
+#### Stile delle Stringhe
+
+Most modules in starship allow you to configure their display styles. This is done with an entry (usually called `style`) which is a string specifying the configuration. Here are some examples of style strings along with what they do. For details on the full syntax, consult the [advanced config guide](/advanced-config/).
+
+- `"fg:green bg:blue"` sets green text on a blue background
+- `"bg:blue fg:bright-green"` sets bright green text on a blue background
+- `"bold fg:27"` sets bold text with [ANSI color](https://i.stack.imgur.com/KTSQa.png) 27
+- `"underline bg:#bf5700"` sets underlined text on a burnt orange background
+- `"bold italic fg:purple"` sets bold italic purple text
+- `""` explicitly disables all styling
+
+Note that what styling looks like will be controlled by your terminal emulator. For example, some terminal emulators will brighten the colors instead of bolding text, and some color themes use the same values for the normal and bright colors. Also, to get italic text, your terminal must support italics.
+
+#### Conditional Format Strings
+
+A conditional format string wrapped in `(` and `)` will not render if all variables inside are empty.
+
+For example:
+
+- `(@$region)` will show nothing if the variable `region` is `None`, otherwise `@` followed by the value of region.
+- `(some text)` will always show nothing since there are no variables wrapped in the braces.
+- When `$all` is a shortcut for `\[$a$b\]`, `($all)` will show nothing only if `$a` and `$b` are both `None`. This works the same as `(\[$a$b\] )`.
+
+#### Escapable characters
+
+The following symbols have special usage in a format string. If you want to print the following symbols, you have to escape them with a backslash (`\`).
+
+- \$
+- \\
+- [
+- ]
+- (
+- )
+
+Note that `toml` has [its own escape syntax](https://github.com/toml-lang/toml#user-content-string). It is recommended to use a literal string (`''`) in your config. If you want to use a basic string (`""`), pay attention to escape the backslash `\`.
+
+For example, when you want to print a `$` symbol on a new line, the following configs for `format` are equivalent:
+
+```toml
+# with basic string
+format = "\n\\$"
+
+# with multiline basic string
+format = """
+
+\\$"""
+
+# with literal string
+format = '''
+
+\$'''
+```
+
+## Prompt
+
+This is the list of prompt-wide configuration options.
+
+### Options
+
+| Option | Default | Description |
+| -------------- | ------------------------------ | ----------------------------------------------------- |
+| `format` | [link](#default-prompt-format) | Configure the format of the prompt. |
+| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). |
+| `add_newline` | `true` | Add a new line before the start of the prompt. |
+
+### Example
+
+```toml
+# ~/.config/starship.toml
+
+# Use custom format
+format = """
+[┌───────────────────>](bold green)
+[│](bold green)$directory$rust$package
+[└─>](bold green) """
+
+# Wait 10 milliseconds for starship to check files under the current directory.
+scan_timeout = 10
+
+# Disable the newline at the start of the prompt
+add_newline = false
+```
+
+### Default Prompt Format
+
+The default `format` is used to define the format of the prompt, if empty or no `format` is provided. The default is as shown:
+
+```toml
+format = "$all"
+
+# Which is equivalent to
+format = """
+$username\
+$hostname\
+$shlvl\
+$kubernetes\
+$directory\
+$git_branch\
+$git_commit\
+$git_state\
+$git_status\
+$hg_branch\
+$docker_context\
+$package\
+$cmake\
+$dart\
+$dotnet\
+$elixir\
+$elm\
+$erlang\
+$golang\
+$helm\
+$java\
+$julia\
+$kotlin\
+$nim\
+$nodejs\
+$ocaml\
+$perl\
+$php\
+$purescript\
+$python\
+$ruby\
+$rust\
+$swift\
+$terraform\
+$zig\
+$nix_shell\
+$conda\
+$memory_usage\
+$aws\
+$gcloud\
+$openstack\
+$env_var\
+$crystal\
+$custom\
+$cmd_duration\
+$line_break\
+$lua\
+$jobs\
+$battery\
+$time\
+$status\
+$character"""
+```
+
+## AWS
+
+The `aws` module shows the current AWS region and profile. This is based on `AWS_REGION`, `AWS_DEFAULT_REGION`, and `AWS_PROFILE` env var with `~/.aws/config` file.
+
+When using [aws-vault](https://github.com/99designs/aws-vault) the profile is read from the `AWS_VAULT` env var.
+
+### Options
+
+| Option | Default | Description |
+| ---------------- | ------------------------------------------------ | --------------------------------------------------------------- |
+| `format` | `'on [$symbol$profile(\($region\))]($style) '` | The format for the module. |
+| `symbol` | `"☁️ "` | The symbol used before displaying the current AWS profile. |
+| `region_aliases` | | Table of region aliases to display in addition to the AWS name. |
+| `style` | `"bold yellow"` | The style for the module. |
+| `disabled` | `false` | Disables the `AWS` module. |
+
+### Variables
+
+| Variable | Example | Description |
+| --------- | ---------------- | ------------------------------------ |
+| region | `ap-northeast-1` | The current AWS region |
+| profile | `astronauts` | The current AWS profile |
+| symbol | | Mirrors the value of option `symbol` |
+| style\* | | Mirrors the value of option `style` |
+
+\*: This variable can only be used as a part of a style string
+
+### Examples
+
+#### Display everything
+
+```toml
+# ~/.config/starship.toml
+
+[aws]
+format = 'on [$symbol$profile(\($region\))]($style) '
+style = "bold blue"
+symbol = "🅰 "
+[aws.region_aliases]
+ap-southeast-2 = "au"
+us-east-1 = "va"
+```
+
+#### Display region
+
+```toml
+# ~/.config/starship.toml
+
+[aws]
+format = "on [$symbol$region]($style) "
+style = "bold blue"
+symbol = "🅰 "
+[aws.region_aliases]
+ap-southeast-2 = "au"
+us-east-1 = "va"
+```
+
+#### Display profile
+
+```toml
+# ~/.config/starship.toml
+
+[aws]
+format = "on [$symbol$profile]($style) "
+style = "bold blue"
+symbol = "🅰 "
+```
+
+## Battery
+
+The `battery` module shows how charged the device's battery is and its current charging status. The module is only visible when the device's battery is below 10%.
+
+### Options
+
+| Option | Default | Description |
+| -------------------- | --------------------------------- | --------------------------------------------------- |
+| `full_symbol` | `""` | The symbol shown when the battery is full. |
+| `charging_symbol` | `""` | The symbol shown when the battery is charging. |
+| `discharging_symbol` | `""` | The symbol shown when the battery is discharging. |
+| `unknown_symbol` | `""` | The symbol shown when the battery state is unknown. |
+| `empty_symbol` | `""` | The symbol shown when the battery state is empty. |
+| `format` | `"[$symbol$percentage]($style) "` | The format for the module. |
+| `display` | [link](#battery-display) | Display threshold and style for the module. |
+| `disabled` | `false` | Disables the `battery` module. |
+
+
+### Example
+
+```toml
+# ~/.config/starship.toml
+
+[battery]
+full_symbol = "🔋"
+charging_symbol = "⚡️"
+discharging_symbol = "💀"
+```
+
+### Battery Display
+
+The `display` configuration option is used to define when the battery indicator should be shown (threshold) and what it looks like (style). If no `display` is provided. The default is as shown:
+
+```toml
+[[battery.display]]
+threshold = 10
+style = "bold red"
+```
+
+#### Options
+
+The `display` option is an array of the following table.
+
+| Option | Description |
+| ----------- | ----------------------------------------------- |
+| `threshold` | The upper bound for the display option. |
+| `style` | The style used if the display option is in use. |
+
+#### Example
+
+```toml
+[[battery.display]] # "bold red" style when capacity is between 0% and 10%
+threshold = 10
+style = "bold red"
+
+[[battery.display]] # "bold yellow" style when capacity is between 10% and 30%
+threshold = 30
+style = "bold yellow"
+
+# when capacity is over 30%, the battery indicator will not be displayed
+
+```
+
+## Character
+
+The `character` module shows a character (usually an arrow) beside where the text is entered in your terminal.
+
+The character will tell you whether the last command was successful or not. It can do this in two ways:
+
+- changing color (`red`/`green`)
+- changing shape (`❯`/`✖`)
+
+By default it only changes color. If you also want to change it's shape take a look at [this example](#with-custom-error-shape).
+
+### Options
+
+| Option | Default | Description |
+| ---------------- | ------------------- | -------------------------------------------------------------------------------- |
+| `format` | `"$symbol "` | The format string used before the text input. |
+| `success_symbol` | `"[❯](bold green)"` | The format string used before the text input if the previous command succeeded. |
+| `error_symbol` | `"[❯](bold red)"` | The format string used before the text input if the previous command failed. |
+| `vicmd_symbol` | `"[❮](bold green)"` | The format string used before the text input if the shell is in vim normal mode. |
+| `disabled` | `false` | Disables the `character` module. |
+
+### Variables
+
+| Variable | Example | Description |
+| -------- | ------- | --------------------------------------------------------------------- |
+| symbol | | A mirror of either `success_symbol`, `error_symbol` or `vicmd_symbol` |
+
+### Examples
+
+#### With custom error shape
+
+```toml
+# ~/.config/starship.toml
+
+[character]
+success_symbol = "[➜](bold green) "
+error_symbol = "[✗](bold red) "
+```
+
+#### Without custom error shape
+
+```toml
+# ~/.config/starship.toml
+
+[character]
+success_symbol = "[➜](bold green) "
+error_symbol = "[➜](bold red) "
+```
+
+#### With custom vim shape
+
+```toml
+# ~/.config/starship.toml
+
+[character]
+vicmd_symbol = "[V](bold green) "
+```
+
+## CMake
+
+The `cmake` module shows the currently installed version of CMake if any of the following conditions are met:
+
+- The current directory contains a `CMakeLists.txt` file
+- The current directory contains a `CMakeCache.txt` file
+
+### Options
+
+| Option | Default | Description |
+| ---------- | ---------------------------------- | -------------------------------------------- |
+| `format` | `"via [$symbol$version]($style) "` | The format for the module. |
+| `symbol` | `"喝 "` | The symbol used before the version of cmake. |
+| `style` | `"bold blue"` | The style for the module. |
+| `disabled` | `false` | Disables the `cmake` module. |
+
+### Variables
+
+| Variable | Example | Description |
+| --------- | --------- | ------------------------------------ |
+| version | `v3.17.3` | The version of cmake |
+| symbol | | Mirrors the value of option `symbol` |
+| style\* | | Mirrors the value of option `style` |
+
+\*: This variable can only be used as a part of a style string
+
+## Command Duration
+
+The `cmd_duration` module shows how long the last command took to execute. The module will be shown only if the command took longer than two seconds, or the `min_time` config value, if it exists.
+
+::: warning Do not hook the DEBUG trap in Bash
+
+If you are running Starship in `bash`, do not hook the `DEBUG` trap after running `eval $(starship init $0)`, or this module **will** break.
+
+:::
+
+Bash users who need preexec-like functionality can use [rcaloras's bash_preexec framework](https://github.com/rcaloras/bash-preexec). Simply define the arrays `preexec_functions` and `precmd_functions` before running `eval $(starship init $0)`, and then proceed as normal.
+
+### Options
+
+| Option | Default | Description |
+| -------------------- | ----------------------------- | ---------------------------------------------------------- |
+| `min_time` | `2_000` | Shortest duration to show time for (in milliseconds). |
+| `show_milliseconds` | `false` | Show milliseconds in addition to seconds for the duration. |
+| `format` | `"took [$duration]($style) "` | The format for the module. |
+| `style` | `"bold yellow"` | The style for the module. |
+| `disabled` | `false` | Disables the `cmd_duration` module. |
+| `show_notifications` | `false` | Show desktop notifications when command completes. |
+| `min_time_to_notify` | `45_000` | Shortest duration for notification (in milliseconds). |
+
+::: tip
+
+Showing desktop notifications requires starship to be built with `rust-notify` support. You check if your starship supports notifications by running `STARSHIP_LOG=debug starship module cmd_duration -d 60000` when `show_notifications` is set to `true`.
+
+:::
+
+### Variables
+
+| Variable | Example | Description |
+| --------- | -------- | --------------------------------------- |
+| duration | `16m40s` | The time it took to execute the command |
+| style\* | | Mirrors the value of option `style` |
+
+\*: This variable can only be used as a part of a style string
+
+### Example
+
+```toml
+# ~/.config/starship.toml
+
+[cmd_duration]
+min_time = 500
+format = "underwent [$duration](bold yellow)"
+```
+
+## Conda
+
+The `conda` module shows the current conda environment, if `$CONDA_DEFAULT_ENV` is set.
+
+::: tip
+
+This does not suppress conda's own prompt modifier, you may want to run `conda config --set changeps1 False`.
+
+:::
+
+### Options
+
+| Option | Default | Description |
+| ------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `truncation_length` | `1` | The number of directories the environment path should be truncated to, if the environment was created via `conda create -p [path]`. `0` means no truncation. Also see the [`directory`](#directory) module. |
+| `symbol` | `"🅒 "` | The symbol used before the environment name. |
+| `style` | `"bold green"` | The style for the module. |
+| `format` | `"via [$symbol$environment]($style) "` | The format for the module. |
+| `ignore_base` | `true` | Ignores `base` environment when activated. |
+| `disabled` | `false` | Disables the `conda` module.