From 2da45e79842b4d8c8a1a2606cfbb1b965ce9dcd9 Mon Sep 17 00:00:00 2001 From: Matan Kushner Date: Thu, 21 Mar 2024 20:42:05 +0900 Subject: [PATCH] docs(i18n): new Crowdin updates (#5818) * New translations readme.md (French) * New translations readme.md (French) * New translations readme.md (French) * New translations readme.md (French) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (Arabic) * New translations readme.md (Arabic) * New translations readme.md (Arabic) * 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 (Italian) * New translations readme.md (Italian) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Korean) * New translations readme.md (Korean) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Dutch) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Norwegian) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Polish) * New translations readme.md (Polish) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Portuguese) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Russian) * New translations readme.md (Russian) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Turkish) * New translations readme.md (Turkish) * New translations readme.md (Turkish) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Chinese Traditional) * New translations readme.md (Chinese Traditional) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Vietnamese) * New translations readme.md (Vietnamese) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Indonesian) * New translations readme.md (Indonesian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Bengali) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (French) * New translations readme.md (French) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Polish) * New translations readme.md (Russian) * New translations readme.md (Russian) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Indonesian) * New translations readme.md (French) * New translations readme.md (Bengali) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Indonesian) * New translations readme.md (Indonesian) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Spanish) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Ukrainian) * New translations readme.md (Indonesian) * New translations readme.md (Dutch) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Dutch) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (French) * New translations readme.md (Ukrainian) * New translations readme.md (Spanish) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (French) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) * New translations readme.md (Spanish) * New translations readme.md (Arabic) * New translations readme.md (German) * New translations readme.md (Italian) * New translations readme.md (Japanese) * New translations readme.md (Korean) * New translations readme.md (Dutch) * New translations readme.md (Norwegian) * New translations readme.md (Polish) * New translations readme.md (Portuguese) * New translations readme.md (Russian) * New translations readme.md (Turkish) * New translations readme.md (Ukrainian) * New translations readme.md (Chinese Simplified) * New translations readme.md (Chinese Traditional) * New translations readme.md (Vietnamese) * New translations readme.md (Portuguese, Brazilian) * New translations readme.md (Indonesian) * New translations readme.md (French) * New translations readme.md (Bengali) * New translations readme.md (Sorani (Kurdish)) --- docs/ar-SA/README.md | 23 ++--- docs/ar-SA/config/README.md | 100 +++++++++++++------- docs/ar-SA/guide/README.md | 10 +- docs/ar-SA/installing/README.md | 2 +- docs/bn-BD/README.md | 23 ++--- docs/bn-BD/config/README.md | 100 +++++++++++++------- docs/bn-BD/guide/README.md | 12 +-- docs/ckb-IR/README.md | 23 ++--- docs/ckb-IR/config/README.md | 100 +++++++++++++------- docs/ckb-IR/guide/README.md | 8 +- docs/de-DE/README.md | 27 +++--- docs/de-DE/config/README.md | 104 ++++++++++++++------- docs/de-DE/guide/README.md | 12 +-- docs/de-DE/installing/README.md | 2 +- docs/es-ES/README.md | 23 ++--- docs/es-ES/advanced-config/README.md | 2 +- docs/es-ES/config/README.md | 132 +++++++++++++++++---------- docs/es-ES/guide/README.md | 10 +- docs/fr-FR/README.md | 23 ++--- docs/fr-FR/advanced-config/README.md | 10 +- docs/fr-FR/config/README.md | 103 ++++++++++++++------- docs/fr-FR/guide/README.md | 10 +- docs/fr-FR/installing/README.md | 2 +- docs/id-ID/README.md | 25 ++--- docs/id-ID/advanced-config/README.md | 2 +- docs/id-ID/config/README.md | 102 ++++++++++++++------- docs/id-ID/guide/README.md | 12 +-- docs/id-ID/installing/README.md | 8 +- docs/it-IT/README.md | 23 ++--- docs/it-IT/config/README.md | 102 ++++++++++++++------- docs/it-IT/guide/README.md | 6 +- docs/it-IT/installing/README.md | 2 +- docs/ja-JP/README.md | 23 ++--- docs/ja-JP/config/README.md | 102 ++++++++++++++------- docs/ja-JP/guide/README.md | 10 +- docs/ja-JP/installing/README.md | 2 +- docs/ko-KR/README.md | 25 ++--- docs/ko-KR/advanced-config/README.md | 2 +- docs/ko-KR/config/README.md | 100 +++++++++++++------- docs/ko-KR/guide/README.md | 10 +- docs/nl-NL/README.md | 23 ++--- docs/nl-NL/config/README.md | 100 +++++++++++++------- docs/nl-NL/guide/README.md | 40 ++++---- docs/no-NO/README.md | 23 ++--- docs/no-NO/config/README.md | 100 +++++++++++++------- docs/no-NO/guide/README.md | 10 +- docs/pl-PL/README.md | 23 ++--- docs/pl-PL/config/README.md | 100 +++++++++++++------- docs/pl-PL/guide/README.md | 10 +- docs/pl-PL/installing/README.md | 2 +- docs/pt-BR/README.md | 23 ++--- docs/pt-BR/advanced-config/README.md | 2 +- docs/pt-BR/config/README.md | 108 +++++++++++++++------- docs/pt-BR/faq/README.md | 2 +- docs/pt-BR/guide/README.md | 10 +- docs/pt-BR/installing/README.md | 2 +- docs/pt-PT/README.md | 23 ++--- docs/pt-PT/config/README.md | 100 +++++++++++++------- docs/pt-PT/guide/README.md | 10 +- docs/ru-RU/README.md | 23 ++--- docs/ru-RU/config/README.md | 102 ++++++++++++++------- docs/ru-RU/guide/README.md | 10 +- docs/tr-TR/README.md | 23 ++--- docs/tr-TR/advanced-config/README.md | 2 +- docs/tr-TR/config/README.md | 100 +++++++++++++------- docs/tr-TR/guide/README.md | 10 +- docs/tr-TR/installing/README.md | 2 +- docs/uk-UA/README.md | 23 ++--- docs/uk-UA/advanced-config/README.md | 2 +- docs/uk-UA/config/README.md | 86 ++++++++++++----- docs/uk-UA/faq/README.md | 2 +- docs/uk-UA/guide/README.md | 10 +- docs/vi-VN/README.md | 23 ++--- docs/vi-VN/config/README.md | 102 ++++++++++++++------- docs/vi-VN/guide/README.md | 10 +- docs/vi-VN/installing/README.md | 2 +- docs/zh-CN/README.md | 23 ++--- docs/zh-CN/advanced-config/README.md | 2 +- docs/zh-CN/config/README.md | 104 ++++++++++++++------- docs/zh-CN/guide/README.md | 10 +- docs/zh-CN/installing/README.md | 2 +- docs/zh-TW/README.md | 23 ++--- docs/zh-TW/config/README.md | 102 ++++++++++++++------- docs/zh-TW/guide/README.md | 10 +- docs/zh-TW/installing/README.md | 2 +- 85 files changed, 1836 insertions(+), 1102 deletions(-) diff --git a/docs/ar-SA/README.md b/docs/ar-SA/README.md index 3d4d006f..28884f71 100644 --- a/docs/ar-SA/README.md +++ b/docs/ar-SA/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: التخصيص البسيط و السريع و الغير محدود لي ال"shell"! actions: - - theme: brand + - + theme: brand text: البدء مع Starship ← link: ./guide/ features: - - + - title: التوافق أولاً details: يعمل على أكثر موجهات الأوامر شيوعاً في أكثر نظم التشغيل شيوعاً. استخدمه في كل مكان! - - + - title: Rust-Powered details: Brings the best-in-class speed and safety of Rust, to make your prompt as quick and reliable as possible. - - + - title: قابل للتخصيص details: Every little detail is customizable to your liking, to make this prompt as minimal or feature-rich as you'd like it to be. footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -
- -
+ ### المتطلبات الأساسية @@ -58,6 +57,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/ar-SA/config/README.md b/docs/ar-SA/config/README.md index ca6c57ff..50bab597 100644 --- a/docs/ar-SA/config/README.md +++ b/docs/ar-SA/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | الافتراضي | الوصف | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | الافتراضي | الوصف | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | الوصف | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | الافتراضي | الوصف | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | مثال | الوصف | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | مثال | الوصف | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | مثال | الوصف | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | الافتراضي | الوصف | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | الافتراضي | الوصف | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### مثال +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/ar-SA/guide/README.md b/docs/ar-SA/guide/README.md index 52335d7a..c10cf9a8 100644 --- a/docs/ar-SA/guide/README.md +++ b/docs/ar-SA/guide/README.md @@ -40,11 +40,11 @@

- الموقع + الموقع · التثبيت · - الإعدادات + الإعدادات

@@ -171,7 +171,7 @@ - **Easy:** سريع التثبيت – استخدمها في دقائق معدودة.

-تصفّح مستندات Starship  ▶ +تصفّح مستندات Starship  ▶

@@ -431,10 +431,6 @@ If you're looking to further customize Starship: Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/ar-SA/installing/README.md b/docs/ar-SA/installing/README.md index fa8fd67e..94165355 100644 --- a/docs/ar-SA/installing/README.md +++ b/docs/ar-SA/installing/README.md @@ -5,7 +5,7 @@ 1. ثبت ملفات **starship** على جهازك 1. تنبيه موجه الأوامر بإن يقوم بجعل سطر الأوامر ل starship وذلك بتعديل كود الإبتداء -غالبية المستخدمين [الصفحة الرئيسية ](../guide/#🚀-installation) سوف تلبي احتياجاتهم. لكن، من أجل الاستخدام المتقدم، هناك حاجة لتوجيهات أخرى. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. لكن، من أجل الاستخدام المتقدم، هناك حاجة لتوجيهات أخرى. هناك العديد من الحالات التي لا تلبي المعلومات في ملف README.md احتياجها ولذلك هذه بعض إرشادات التثبيت الإضافية مقدمة من مجتمع starship. إذا كانت لديك ملاحظة وقمت بحلها ولم تجد هذا الحل لها ضمن الحلول التالية، الرجاء أضفها هنا! diff --git a/docs/bn-BD/README.md b/docs/bn-BD/README.md index d467d2fd..a9d66601 100644 --- a/docs/bn-BD/README.md +++ b/docs/bn-BD/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: আপনার টার্মিনাল এর জন্য একটি সহজ, প্রচণ্ড দ্রুত এবং অশেষভাবে কাস্টমাইজ করার মতো সুবিধাসম্পন্ন একটি প্রম্প্ট! actions: - - theme: brand + - + theme: brand text: Get Started → link: ./guide/ features: - - + - title: Compatibility First details: Works on the most common shells on the most common operating systems. Use it everywhere! - - + - title: Rust-Powered details: Brings the best-in-class speed and safety of Rust, to make your prompt as quick and reliable as possible. - - + - title: Customizable details: Every little detail is customizable to your liking, to make this prompt as minimal or feature-rich as you'd like it to be. footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -

- -
+ ### পূর্বশর্ত @@ -58,6 +57,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ::: আপনার Nushell env ফাইলের (Nushell এ `$nu.env-path` কমান্ডটি রান করে ফাইলটি খুঁজে বের করুন) শেষে নিম্নলিখিত লাইনগুলি যোগ করুন: + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/bn-BD/config/README.md b/docs/bn-BD/config/README.md index 328ab8c4..7b4f5106 100644 --- a/docs/bn-BD/config/README.md +++ b/docs/bn-BD/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Example | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | Example | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | Example | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Example +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/bn-BD/guide/README.md b/docs/bn-BD/guide/README.md index 96c49a1a..c96afd38 100644 --- a/docs/bn-BD/guide/README.md +++ b/docs/bn-BD/guide/README.md @@ -40,11 +40,11 @@

- ওয়েবসাইট - · + ওয়েবসাইট + · ইন্সটল · - কনফিগ + কনফিগ

@@ -171,7 +171,7 @@ - **সহজ:** অনায়াসে ইন্সটল করুন – মিনিটের মধ্যে ব্যবহার শুরু করে দিন ।

-Starship এর ডকুমেন্টেশন ঘুরে দেখুন  ▶ +Starship এর ডকুমেন্টেশন ঘুরে দেখুন  ▶

@@ -431,10 +431,6 @@ eval "$(starship init zsh)" [একজন স্পনসর হয়ে](https://github.com/sponsors/starship) এই প্রোজেক্টটিকে আর্থিক ভাবে সহায়তা করুন । আপনার নাম অথবা লোগো নিম্নে দেখা যাবে আপনার ওয়েবসাইট এর লিঙ্ক সহ । -**সমর্থক স্তর** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/ckb-IR/README.md b/docs/ckb-IR/README.md index 7a00da5f..13fa363b 100644 --- a/docs/ckb-IR/README.md +++ b/docs/ckb-IR/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: promptـێکی سوکەڵە، خێرا، و بێسنور دڵخوازکراو بۆ هەر شێڵێک! actions: - - theme: brand + - + theme: brand text: دەستپێبکە ← link: ./guide/ features: - - + - title: سەرەتا گونجان details: کاردەکات لەسەر زۆربەی شێڵە باوەکان لەسەر زۆربەی سیستەمە باوەکان. لە هەموو شوێنێک بەکاری بهێنە! - - + - title: Rust لە پشتە details: باشترینی هاوتاکانی لە خێرایی و سەلامەتی Rust بەکارئەهێنێ بۆ ئەوەی promptـەکەت خێراترین و پشت پێبەستراوین بێ. - - + - title: دڵخوازکراو details: هەموو وردەکارییەکی دڵخواز ئەکرێ بەوجۆرەی حەزت لێیە، بۆ ئەوەی promptـەکە سوکەڵە بێ و پڕ تایبەتمەندی بێت بەوجۆرەی حەزت لێیە ببێ. footer: لەژێر مۆڵەتی ISCـە | مافی پارێزراوە © 2019-ئێستا بەژداریکەرانی Starship @@ -24,12 +25,10 @@ metaTitle: "Starship: یەکێ لە Promptـە شێڵ نەناسەکان" description: 'Starship: یەکێ لە promptـە سوکەڵە، خێرا، و بێسنور دڵخوازکراوەکان بۆ هەر شێڵێک! ئەو زانیارییانە پشان دەدات کە پێویستە، لەوکاتەیا بە ئارامی و سوکەڵەیی ئەمێنێتەوە. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell.' --- -

- -
+ ### پێشمەرجەکان @@ -58,6 +57,7 @@ description: 'Starship: یەکێ لە promptـە سوکەڵە، خێرا، و ب ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: 'Starship: یەکێ لە promptـە سوکەڵە، خێرا، و ب ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/ckb-IR/config/README.md b/docs/ckb-IR/config/README.md index 63ccc62b..27cfd5a3 100644 --- a/docs/ckb-IR/config/README.md +++ b/docs/ckb-IR/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | گۆڕاو | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| گۆڕاو | نموونە | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| گۆڕاو | نموونە | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| گۆڕاو | نموونە | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### نموونە +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/ckb-IR/guide/README.md b/docs/ckb-IR/guide/README.md index 79964b17..ec24904f 100644 --- a/docs/ckb-IR/guide/README.md +++ b/docs/ckb-IR/guide/README.md @@ -40,7 +40,7 @@

- ماڵپەڕ · دامەزراندن · رێکخستن + ماڵپەڕ · دامەزراندن · رێکخستن

@@ -167,7 +167,7 @@ - **ئاسان:** خێرا لە دامەزراندن – دەست ئەکەیت بە بەکارهێنانی لە چەند خولەکێکدا.

-بەڵگەنامەکانی Starship بگەڕێ  ◀ +بەڵگەنامەکانی Starship بگەڕێ  ◀

@@ -427,10 +427,6 @@ If you're looking to further customize Starship: Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


ئایکۆنی مووشەکی Starship diff --git a/docs/de-DE/README.md b/docs/de-DE/README.md index f657670c..4230f5ab 100644 --- a/docs/de-DE/README.md +++ b/docs/de-DE/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null - tagline: Minimale, super schnelle und unendlich anpassbare Prompt für jede Shell! + text: + tagline: Der minimalistische, super schnelle und unendlich anpassbare Prompt für jede Shell! actions: - - theme: brand + - + theme: brand text: Loslegen → - link: ./guide/ + link: ./de-DE/guide/ features: - - + - title: Kompatibel details: Läuft mit den beliebtesten Shells auf den beliebtesten Betriebssystemen. Überall einsetzbar! - - + - title: Rust-Powered details: Bringt die Schnelligkeit und Sicherheit von Rust in deine Shell-Prompt. - - + - title: Individualisierbar details: Jedes noch so kleine Detail kann nach Deinen Wünschen angepasst werden, um die Eingabeaufforderung so minimal oder funktionsreich zu gestalten, wie Du es möchtest. footer: ICS lizenziert | Copyright © 2019-heute Starship-Mitwirkende @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship ist eine minimale, super schnelle, und extrem anpassbare Prompt für jede Shell! Sie zeigt die Information, die man benötigt an, während sie schnell und minimal bleibt. Schnell-Installation verfügbar für Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, und PowerShell. --- -

- -
+ ### Voraussetzungen @@ -58,6 +57,7 @@ description: Starship ist eine minimale, super schnelle, und extrem anpassbare P ```sh brew install starship ``` + Mit [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship ist eine minimale, super schnelle, und extrem anpassbare P ::: Füge folgendes zum Ende deiner Nushell env Datei hinzu (finde sie, indem du `$nu.env-path` in Nushell ausführst): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/de-DE/config/README.md b/docs/de-DE/config/README.md index c9b43645..61840003 100644 --- a/docs/de-DE/config/README.md +++ b/docs/de-DE/config/README.md @@ -159,7 +159,7 @@ Hier sind ein paar Beispiele: #### Style-Strings -Die meisten Module in Starship lassen dich den Darstellungsstil verändern. Dies passiert meistens an einem bestimmten Eintrag (gewöhnlich `style` genannt), der einen String mit den Einstellungen darstellt. Es folgen ein paar Beispiele für solche Strings zusammen der mit Beschreibungen, was sie bewirken. Details zur vollen Syntax findest du im [Erweiterten Konfigurationshandbuch](../advanced-config/). +Die meisten Module in Starship lassen dich den Darstellungsstil verändern. Dies passiert meistens an einem bestimmten Eintrag (gewöhnlich `style` genannt), der einen String mit den Einstellungen darstellt. Es folgen ein paar Beispiele für solche Strings zusammen der mit Beschreibungen, was sie bewirken. 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 @@ -198,16 +198,16 @@ Dies ist eine Liste mit Prompt-weiten Konfigurationsoptionen. ### Optionen -| Option | Standartwert | Beschreibung | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Das Aussehen des Prompts festlegen. | -| `right_format` | `''` | Sieh [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout für das Scannen von Dateien (in Millisekunden). | -| `command_timeout` | `500` | Maximale Zeit für von Starship ausgeführte Kommandos. | -| `add_newline` | `true` | Fügt leere Zeilen zwischen Shell Prompts ein. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| Option | Standartwert | Beschreibung | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Das Aussehen des Prompts festlegen. | +| `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | +| `scan_timeout` | `30` | Timeout für das Scannen von Dateien (in Millisekunden). | +| `command_timeout` | `500` | Maximale Zeit für von Starship ausgeführte Kommandos. | +| `add_newline` | `true` | Fügt leere Zeilen zwischen Shell Prompts ein. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -301,6 +301,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1889,7 +1890,7 @@ The following variables can be used in `format`: | Variable | Beschreibung | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3357,7 +3358,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - Das aktuelle Verzeichnis enthält eine `.python-version`-Datei - Das aktuelle Verzeichnis enthält eine `Pipfile`-Datei @@ -3429,16 +3430,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Optionen + +| Option | Standartwert | Beschreibung | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Das Format für das Modul. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | Stil für dieses Modul. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Beispiel | Beschreibung | +| --------- | --------- | ------------------------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbol | | Spiegelt den Wert der Option `symbol` | +| style\* | | Spiegelt den Wert der Option `style` | + +*: This variable can only be used as a part of a style string ## R @@ -3585,11 +3607,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | Beispiel | Beschreibung | -| --------- | -------- | ------------------------------------- | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Spiegelt den Wert der Option `symbol` | -| style\* | | Spiegelt den Wert der Option `style` | +| Variable | Beispiel | Beschreibung | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Spiegelt den Wert der Option `symbol` | +| style\* | | Spiegelt den Wert der Option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4184,6 +4207,7 @@ Das `username` Modul zeigt den Namen des aktiven Benutzers. Das Modul wird gezei - Der aktuelle Benutzer ist nicht der eingeloggte Benutzer - Der Benutzer ist aktuell via SSH verbunden - Die Variable `show_always` ist auf true gesetzt +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4193,13 +4217,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Optionen -| Option | Standartwert | Beschreibung | -| ------------- | ----------------------- | ---------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | Stil wenn der Benutzer nicht unter root läuft. | -| `format` | `'[$user]($style) in '` | Das Format für das Modul. | -| `show_always` | `false` | Immer das `username` Modul anzeigen. | -| `disabled` | `false` | Deavktiviert das `username` Modul. | +| Option | Standartwert | Beschreibung | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | Stil wenn der Benutzer nicht unter root läuft. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | Das Format für das Modul. | +| `show_always` | `false` | Immer das `username` Modul anzeigen. | +| `disabled` | `false` | Deavktiviert das `username` Modul. | ### Variables @@ -4210,6 +4235,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Beispiel +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4221,6 +4248,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/de-DE/guide/README.md b/docs/de-DE/guide/README.md index a0b5a52a..b84883e5 100644 --- a/docs/de-DE/guide/README.md +++ b/docs/de-DE/guide/README.md @@ -40,11 +40,11 @@

- Website + Website · Installation · - Konfiguration + Konfiguration

@@ -161,7 +161,7 @@ align="right" /> -**Minimale, super schnelle und unendlich anpassbare Prompt für jede Shell!** +**Der minimalistische, super schnelle und unendlich anpassbare Prompt für jede Shell!** - **Schnell:** sie ist schnell – _sehr, sehr_ schnell! 🚀 - **Konfigurierbar:** konfiguriere jedes Detail der Prompt. @@ -171,7 +171,7 @@ - **Einfach:** schnell zu installieren – Betriebsbereit in nur wenigen Minuten.

-Schau dir die Starship-Dokumentation an  ▶ +Schau dir die Starship-Dokumentation an  ▶

@@ -431,10 +431,6 @@ Schaut euch bitte auch die Projekte an, die die Entstehung von Starship inspirie Unterstütze dieses Projekt, indem du [ein Sponsor wirst](https://github.com/sponsors/starship). Dein Name und Logo wird hier mit einem Link zu deiner Website erscheinen. -**Unterstützer** - -- [Appwrite](https://appwrite.io/) -


Starship Raketen-Symbol diff --git a/docs/de-DE/installing/README.md b/docs/de-DE/installing/README.md index f21000a7..5779d264 100644 --- a/docs/de-DE/installing/README.md +++ b/docs/de-DE/installing/README.md @@ -5,7 +5,7 @@ Um Starship zu installieren, musst du zwei Dinge tun: 1. Lade die **starship** Datei auf den Computer herunter 1. Weise deine Shell an die Starship Datei als Eingabeaufforderung zu nutzen, indem du eines der Initialisierungs-Skripte benutzt -Die Anleitung auf [der Hauptseite](../guide/#🚀-installation) wird für die meisten Benutzer ausreichend sein. Für einige speziellere Plattformen wird jedoch eine speziellere Anleitung benötigt. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. Für einige speziellere Plattformen wird jedoch eine speziellere Anleitung benötigt. Es gibt sehr viele Plattformen, sodass diese nicht alle in die Hauptanleitung passen, aus diesem Grund sind hier ein paar Installationsanweisungen für ein paar Plattformen von der Community. Ist deine Platform nicht dabei? Dann füge bitte deine hinzu, sobald du herausgefunden hast wie man starship mit dieser benutzt! diff --git a/docs/es-ES/README.md b/docs/es-ES/README.md index c8b9b11e..c2a6ab56 100644 --- a/docs/es-ES/README.md +++ b/docs/es-ES/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: '¡El prompt minimalista, ultrarápido e infinitamente personalizable para cualquier intérprete de comandos!' actions: - - theme: brand + - + theme: brand text: Comenzar → link: ./guide/ features: - - + - title: Compatibilidad primero details: Funciona en los intérprete de comandos más comunes de los sistemas operativos más comunes. ¡Úsalo en todas partes! - - + - title: Desarrollado en Rust details: Obtén la mayor velocidad y seguridad de Rust, para hacer tu prompt lo más rápida y segura posible. - - + - title: Personalizable details: Puedes personalizar cada pequeño detalle a tu gusto, de manera que puedes tener un prompt minimalista o rico en funcionalidades. footer: Bajo una licencia ISC | Derechos de autor © 2019-presente Colaboradores de Starship @@ -24,12 +25,10 @@ metaTitle: "Starship: el prompt multi-intérprete" description: '¡Starship es el prompt minimalista, ultrarápido e infinitamente personalizable para cualquier intérprete de comandos! Muestra la información que necesitas, a la par que es elegante y minimalista. Instalación rápida disponible para Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, y PowerShell.' --- -

- -
+ ### Prerequisitos @@ -58,6 +57,7 @@ description: '¡Starship es el prompt minimalista, ultrarápido e infinitamente ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: '¡Starship es el prompt minimalista, ultrarápido e infinitamente ::: Añade lo siguiente al final de tu archivo Nushell env (encuéntralo ejecutando `$nu.env-path` en Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/es-ES/advanced-config/README.md b/docs/es-ES/advanced-config/README.md index 5f61d4fb..2d37d4b7 100644 --- a/docs/es-ES/advanced-config/README.md +++ b/docs/es-ES/advanced-config/README.md @@ -223,7 +223,7 @@ Invoke-Expression (&starship init powershell) Algunos intérpretes de comandos soportan un prompt derecho que se renderiza en la misma línea que la entrada. Starship puede establecer el contenido del prompt derecho usando la opción `right_format`. Cualquier módulo que pueda ser usado en `format` también es soportado en `right_format`. La variable `$all` solo contendrá módulos no utilizados explícitamente en `format` o `right_format`. -Nota: El prompt derecho es una sola línea siguiendo la ubicación de entrada. Para alinear los módulos arriba de la línea de entrada en un prompt multi-línea, vea el [módulo `fill`](../config/#fill). +Nota: El prompt derecho es una sola línea siguiendo la ubicación de entrada. Para alinear los módulos arriba de la línea de entrada en un prompt multi-línea, vea el [módulo de `relleno`](../config/#fill). `right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. diff --git a/docs/es-ES/config/README.md b/docs/es-ES/config/README.md index 757bcc0a..784e8daf 100644 --- a/docs/es-ES/config/README.md +++ b/docs/es-ES/config/README.md @@ -158,7 +158,7 @@ Por ejemplo: #### Cadenas de Estilo -La mayoría de los módulos de starship permiten configurar sus estilos de visualización. Esto se consigue con una entrada (normalmente llamada `style`) que no es más que un texto donde se especifica la configuración. A continuación mostramos algunos ejemplos de cadenas de estilo junto con su funcionalidad. Para más detalles sobre la sintaxis completa, consultar [la guía de configuración avanzada](../advanced-config/). +La mayoría de los módulos de starship permiten configurar sus estilos de visualización. Esto se consigue con una entrada (normalmente llamada `style`) que no es más que un texto donde se especifica la configuración. A continuación mostramos algunos ejemplos de cadenas de estilo junto con su funcionalidad. Para más detalles sobre la sintaxis completa, consultar la [guía de configuración avanzada](../advanced-config/). - `'fg:green bg:blue'` define el texto con color verde y el color de fondo azul - `'bg:blue fg:bright-green'` sets bright green text on a blue background @@ -197,16 +197,16 @@ Esta es la lista de opciones de configuración del prompt. ### Opciones -| Opción | Predeterminado | Descripción | -| ----------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [ver aquí](#default-prompt-format) | Configura el formato del prompt. | -| `right_format` | `''` | Ver [Habilitar prompt derecho](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Tiempo de espera tras el que Starship escanea archivos (en milisegundos). | -| `command_timeout` | `500` | Tiempo de espera para los comandos ejecutados por Starship (en milisegundos). | -| `add_newline` | `true` | Inserta un línea en blanco entre las instrucciones del intérprete de comandos. | -| `paleta` | `''` | Establece la paleta de color de `paletas` a utilizar. | +| Opción | Predeterminado | Descripción | +| ----------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [ver aquí](#default-prompt-format) | Configura el formato del prompt. | +| `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | +| `scan_timeout` | `30` | Tiempo de espera tras el que Starship escanea archivos (en milisegundos). | +| `command_timeout` | `500` | Tiempo de espera para los comandos ejecutados por Starship (en milisegundos). | +| `add_newline` | `true` | Inserta un línea en blanco entre las instrucciones del intérprete de comandos. | +| `paleta` | `''` | Establece la paleta de color de `paletas` a utilizar. | | `paletas` | `{}` | Colección de paletas de colores que asignan [colores](../advanced-config/#style-strings) a nombres definidos por el usuario. Tenga en cuenta que las paletas de colores no pueden hacer referencia a sus propias definiciones de color. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -529,7 +530,7 @@ La opción `display` es un arreglo de la siguiente tabla. | Opción | Predeterminado | Descripción | | -------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `threshold` | `10` | El umbral para la opción de visualización. | -| `style` | `'red bold'` | El estilo usado cuando si la opción `display` está activa. | +| `style` | `'red bold'` | El estilo usado cuando si la opción <0>display está activa. | | `charging_symbol` | | Símbolo opcional que se muestra si la opción de visualización está en uso, por defecto en la opción `charging_symbol` de la batería. | | `discharging_symbol` | | Símbolo opcional que se muestra si la opción de visualización está en uso, por defecto en la opción `discharging_symbol` de la batería. | @@ -1888,7 +1889,7 @@ Las siguientes variables se pueden utilizar en `format`: | Variable | Descripción | | ----------------- | ------------------------------------------------------------------------------------------------------------------------ | -| `all_status` | Atajo para `$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Muestra la cadena de formato de `diverged` `ahead` o `behind` o `up_to_date` basado en el estado actual del repositorio. | | `conflicted` | Muestra `conflicted` cuando esta rama tiene conflictos de fusión. | | `sin seguimiento` | Muestra `untracked` cuando hay archivos sin rastrear en el directorio de trabajo. | @@ -2196,23 +2197,23 @@ El módulo `hostname` muestra el nombre de host del sistema. ### Opciones -| Opción | Predeterminado | Descripción | -| ----------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `ssh_only` | `true` | Mostrar sólo el nombre de host cuando esté conectado a una sesión SSH. | -| `ssh_symbol` | `'🌐 '` | Una cadena de formato que representa el símbolo cuando se conecta a la sesión SSH. | -| `trim_at` | `'.'` | Cadena en la que el nombre del host se corta, después de la primera coincidencia. `'.'` will stop after the first dot. `''` deshabilitará cualquier truncamiento. | -| `detect_env_vars` | `[]` | Qué variable(s) de entorno deben activar este módulo. | -| `format` | `'[$ssh_symbol$hostname]($style) in '` | El formato del módulo. | -| `style` | `'negrita oscurecida verde'` | El estilo del módulo. | -| `disabled` | `false` | Deshabilita el módulo `hostname`. | - +| Opción | Predeterminado | Descripción | +| ----------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `ssh_only` | `true` | Mostrar sólo el nombre de host cuando esté conectado a una sesión SSH. | +| `ssh_symbol` | `'🌐 '` | Una cadena de formato que representa el símbolo cuando se conecta a la sesión SSH. | +| `trim_at` | `'.'` | Cadena en la que el nombre del host se corta, después de la primera coincidencia. `'.'` will stop after the first dot. `''` deshabilitará cualquier truncamiento. | +| `detect_env_vars` | `[]` | Qué variable(s) de entorno deben activar este módulo. | +| `format` | `'[$ssh_symbol$hostname]($style) in '` | El formato del módulo. | +| `style` | `'negrita oscurecida verde'` | El estilo del módulo. | +| `disabled` | `false` | Deshabilita el módulo `hostname`. | ### Variables -| Variable | Ejemplo | Descripción | -| nombre del host | `computadora` | El nombre de host de la computadora | -| style\* | | Refleja el valor de la opción `style` | -| ssh_symbol | `'🌏 '` | El símbolo a representar cuando está conectado a la sesión SSH | +| Variable | Ejemplo | Descripción | +| --------------- | ------------- | -------------------------------------------------------------- | +| nombre del host | `computadora` | El nombre de host de la computadora | +| style\* | | Refleja el valor de la opción `style` | +| ssh_symbol | `'🌏 '` | El símbolo a representar cuando está conectado a la sesión SSH | *: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Muestra la versión de python dentro de un entorno virtual local. -# -# Ten en cuenta que esto solo funcionará cuando el venv esté dentro del proyecto y sólo -# funcionará en el directorio que contiene el directorio venv dir pero ¿tal vez esté bien? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Opciones + +| Opción | Predeterminado | Descripción | +| ------------------- | ------------------------------------ | --------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | El formato del módulo. | +| `version_format` | `'v${raw}'` | El formato de versión. Las variables disponibles son `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | El estilo del módulo. | +| `detect_extensions` | `['.qmd']` | Qué extensiones deberían activar este módulo. | +| `detect_files` | `['_quarto.yml']` | Qué nombres de archivo deberían activar este módulo. | +| `detect_folders` | `[]` | Qué carpetas deberían activar este módulo. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Ejemplo | Descripción | +| --------- | --------- | -------------------------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | + +*: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo ## R @@ -3584,11 +3606,12 @@ Starship obtiene la versión actual de Ruby ejecutando `ruby -v`. ### Variables -| Variable | Ejemplo | Descripción | -| --------- | -------- | -------------------------------------- | -| version | `v2.5.1` | La versión de `ruby` | -| symbol | | Refleja el valor de la opción `symbol` | -| style\* | | Refleja el valor de la opción `style` | +| Variable | Ejemplo | Descripción | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | La versión de `ruby` | +| symbol | | Refleja el valor de la opción `symbol` | +| style\* | | Refleja el valor de la opción `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: Esta variable solamente puede ser usada como parte de una cadena de caracteres de estilo @@ -4183,6 +4206,7 @@ El módulo `username` muestra el nombre de usuario activo. El módulo se mostrar - El usuario actual no es el mismo que el que está conectado - El usuario está actualmente conectado como una sesión SSH - La variable `show_always` se establece en true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ La conexión SSH se detecta comprobando las variables de entorno `SSH_CONNECTION ### Opciones -| Opción | Predeterminado | Descripción | -| ------------- | ----------------------- | ------------------------------------------------ | -| `style_root` | `'bold red'` | El estilo usado cuando el usuario es root/admin. | -| `style_user` | `'bold yellow'` | El estilo usado para usuarios no root. | -| `format` | `'[$user]($style) in '` | El formato del módulo. | -| `show_always` | `false` | Siempre muestra el módulo `username`. | -| `disabled` | `false` | Deshabilita el módulo `username`. | +| Opción | Predeterminado | Descripción | +| ----------------- | ----------------------- | ----------------------------------------------------- | +| `style_root` | `'bold red'` | El estilo usado cuando el usuario es root/admin. | +| `style_user` | `'bold yellow'` | El estilo usado para usuarios no root. | +| `detect_env_vars` | `[]` | Qué variable(s) de entorno deben activar este módulo. | +| `format` | `'[$user]($style) in '` | El formato del módulo. | +| `show_always` | `false` | Siempre muestra el módulo `username`. | +| `disabled` | `false` | Deshabilita el módulo `username`. | ### Variables @@ -4209,6 +4234,8 @@ La conexión SSH se detecta comprobando las variables de entorno `SSH_CONNECTION ### Ejemplo +#### Mostrar siempre el nombre del host + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Ocultar el nombre de host en sesiones remotas de tmux + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant El módulo `vagrant` muestra la versión instalada de [Vagrant](https://www.vagrantup.com/). Por defecto, el módulo se mostrará si se cumplen cualquiera de las siguientes condiciones: diff --git a/docs/es-ES/guide/README.md b/docs/es-ES/guide/README.md index 852abc3a..af421e5d 100644 --- a/docs/es-ES/guide/README.md +++ b/docs/es-ES/guide/README.md @@ -40,11 +40,11 @@

- Sitio web + Sitio web Instalación -Configuración +Configuración

@@ -171,7 +171,7 @@ - **Fácil:** rápido de instalar – empieza a usarlo en minutos.

-Explora la documentación de Starship  ▶ +Explora la documentación de Starship  ▶

@@ -431,10 +431,6 @@ Por favor, revisa estas obras anteriores que ayudaron a inspirar la creación de Apoya este proyecto [convirtiéndote en patrocinador](https://github.com/sponsors/starship). Tu nombre o logo aparecerá aquí con un enlace a tu sitio web. -**Patrocinadores** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/fr-FR/README.md b/docs/fr-FR/README.md index eb114c81..a7557be9 100644 --- a/docs/fr-FR/README.md +++ b/docs/fr-FR/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: L'invite minimaliste, ultra-rapide et personnalisable à l'infini pour n'importe quel shell ! actions: - - theme: brand + - + theme: brand text: Commencez → link: ./guide/ features: - - + - title: Compatibilité avant tout details: Fonctionne sur tous les principaux shells et système d'exploitation. Utilisez-le partout ! - - + - title: Propulsé par Rust details: Profitez de toute la rapidité et la sécurité de Rust pour rendre votre invite de commandes la plus rapide et fiable possible. - - + - title: Personnalisable details: Tous les petits détails sont personnalisable à votre goût, pour rendre votre invite de commandes aussi légère ou complète que le vous souhaitez. footer: Licence ISC | Copyright © 2019-présent Contributeurs Starship @@ -24,12 +25,10 @@ metaTitle: "Starship : Invite Multi-Shell" description: Starship est une invite minimaliste, ultra-rapide et hautement personnalisable pour n'importe quel shell ! Montre les informations dont vous avez besoin tout en restant élégante et minimaliste. Installation rapide disponible pour Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, et PowerShell. --- -

- -
+ ### Pré-requis @@ -58,6 +57,7 @@ description: Starship est une invite minimaliste, ultra-rapide et hautement pers ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship est une invite minimaliste, ultra-rapide et hautement pers ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/fr-FR/advanced-config/README.md b/docs/fr-FR/advanced-config/README.md index 55014941..d971587d 100644 --- a/docs/fr-FR/advanced-config/README.md +++ b/docs/fr-FR/advanced-config/README.md @@ -10,7 +10,7 @@ Les configurations dans cette section sont sujettes à modification dans les fut ## TransientPrompt in PowerShell -It is possible to replace the previous-printed prompt with a custom string. This is useful in cases where all the prompt information is not always needed. To enable this, run `Enable-TransientPrompt` in the shell session. To make it permanent, put this statement in your `$PROFILE`. Transience can be disabled on-the-fly with `Disable-TransientPrompt`. +Il est possible de remplacer le prompt précédent avec une string personnalisée. Ceci est utile lorsque toutes les informations fournies par l'invité de commande ne sont pas nécessaire. Pour activer ceci, exécutez `Enable-TransientPrompt` dans la session shell. Pour que la modification soit permanente, ajoutez cette commande dans votre `$PROFILE`. Transience can be disabled on-the-fly with `Disable-TransientPrompt`. By default, the left side of input gets replaced with `>`. To customize this, define a new function called `Invoke-Starship-TransientFunction`. For example, to display Starship's `character` module here, you would do @@ -26,13 +26,13 @@ Enable-TransientPrompt ## TransientPrompt and TransientRightPrompt in Cmd -Clink allows you to replace the previous-printed prompt with custom strings. This is useful in cases where all the prompt information is not always needed. To enable this, run `clink set prompt.transient ` where \ can be one of: +Clink allows you to replace the previous-printed prompt with custom strings. Ceci est utile lorsque toutes les informations fournies par l'invité de commande ne sont pas nécessaire. To enable this, run `clink set prompt.transient ` where \ can be one of: - `always`: always replace the previous prompt - `same_dir`: replace the previous prompt only if the working directory is same - `off`: do not replace the prompt (i.e. turn off transience) -You need to do this only once. Make the following changes to your `starship.lua` to customize what gets displayed on the left and on the right: +Il est nécessaire de faire cela qu'une fois. Modifiez votre `starship.lua` pour customiser ce qui sera présenté à gauche et à droite: - By default, the left side of input gets replaced with `>`. To customize this, define a new function called `starship_transient_prompt_func`. This function receives the current prompt as a string that you can utilize. For example, to display Starship's `character` module here, you would do @@ -56,7 +56,7 @@ load(io.popen('starship init cmd'):read("*a"))() ## TransientPrompt et TransientRightPrompt dans Fish -It is possible to replace the previous-printed prompt with a custom string. This is useful in cases where all the prompt information is not always needed. To enable this, run `enable_transience` in the shell session. To make it permanent, put this statement in your `~/.config/fish/config.fish`. Transience can be disabled on-the-fly with `disable_transience`. +Il est possible de remplacer le prompt précédent avec une string personnalisée. Ceci est utile lorsque toutes les informations fournies par l'invité de commande ne sont pas nécessaire. To enable this, run `enable_transience` in the shell session. To make it permanent, put this statement in your `~/.config/fish/config.fish`. Transience can be disabled on-the-fly with `disable_transience`. Note that in case of Fish, the transient prompt is only printed if the commandline is non-empty, and syntactically correct. @@ -223,7 +223,7 @@ Invoke-Expression (&starship init powershell) Certains shells peuvent gérer une invite de commande à droite, sur la même ligne que l’entrée utilisateur. Starship peut définir le contenu de cet invite à droite en utilisant l’option `right_format`. N’importe quel module qui peut être utilisé dans `format` est aussi géré dans `right_format`. La variable `$all` va seulement contenir les modules qui ne sont explicitement utilisés ni dans `format`, ni dans `right_format`. -Note: l’invite à droite est une seule ligne, sur la même ligne que l’entrée. Pour aligner à droite les modules au-dessus de la ligne d’entrée d’une invite multiligne, voir le [module `fill`](../config/#fill). +Note: l’invite à droite est une seule ligne, sur la même ligne que l’entrée. To right align modules above the input line in a multi-line prompt, see the [`fill` module](../config/#fill). `right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. diff --git a/docs/fr-FR/config/README.md b/docs/fr-FR/config/README.md index 0791b5ee..6bb5972e 100644 --- a/docs/fr-FR/config/README.md +++ b/docs/fr-FR/config/README.md @@ -158,7 +158,7 @@ Par exemple : #### Chaînes de style -La plupart des modules de Starship vous permettent de configurer leurs styles d'affichage. Cela se fait avec une entrée (généralement appelée `style`) qui est une chaîne de caractères spécifiant la configuration. Voici quelques exemples de chaînes de style avec ce qu'elles font. Pour plus de détails sur la syntaxe complète, consultez le [guide de configuration avancé](../advanced-config/). +La plupart des modules de Starship vous permettent de configurer leurs styles d'affichage. Cela se fait avec une entrée (généralement appelée `style`) qui est une chaîne de caractères spécifiant la configuration. Voici quelques exemples de chaînes de style avec ce qu'elles font. 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 @@ -197,16 +197,16 @@ Voici la liste des options de configuration globales de l'invite de commandes. ### Options -| Option | Défaut | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [lien](#default-prompt-format) | Configure le format de l'invite. | -| `right_format` | `''` | Voir [Activer le prompt à droite](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Délai maximal pour le scan des fichiers par starship (en millisecondes). | -| `command_timeout` | `500` | Délai maximal pour les commandes exécutées par starship (en millisecondes). | -| `add_newline` | `true` | Insère une ligne vide entre les invites du shell. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| Option | Défaut | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [lien](#default-prompt-format) | Configure le format de l'invite. | +| `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | +| `scan_timeout` | `30` | Délai maximal pour le scan des fichiers par starship (en millisecondes). | +| `command_timeout` | `500` | Délai maximal pour les commandes exécutées par starship (en millisecondes). | +| `add_newline` | `true` | Insère une ligne vide entre les invites du shell. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ Les variables suivantes peuvent être utilisées pour la valeur de `format`: | Variable | Description | | -------------- | --------------------------------------------------------------------------------------------------------------------- | -| `all_status` | Raccourci pour `$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Affiche la chaine de formatage `diverged`, `ahead`, `behind` ou `up_to_date` en se basant sur l’état actuel du dépôt. | | `conflicted` | Affiche `conflicted` lorsque la branche courante a des conflits de fusion. | | `untracked` | Affiche `untracked` lorsqu'il y a des fichiers non suivis dans le répertoire de travail. | @@ -3428,17 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Affiche la version de python depuis l'intérieur d'un venv local. -# -# Notez que cela ne fonctionnera que lorsque le venv est à l'intérieur du projet, -# et uniquement lorsque vous vous situez dans le répertoire contenant le dossier du venv -# mais peut-être que c'est suffisant? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +Par défaut, le module sera affiché si l’une de ces conditions est remplie: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Défaut | Description | +| ------------------------------------ | ------------------------------------ | ------------------------------------------------------------------------------------------ | +| `format` | `'via [$symbol($version )]($style)'` | Format du module. | +| `version_format` | `'v${raw}'` | Le format de la version. Les variables disponibles sont `raw`, `major`, `minor`, & `patch` | +| `symbole` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | Le style pour le module. | +| `detect_extensionsdetect_extensions` | `['.qmd']` | Les extensions qui déclenchent ce module. | +| `detect_files` | `['_quarto.yml']` | Les fichiers qui activent ce module. | +| `detect_folders` | `[]` | Les dossiers qui activent ce module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Exemple | Description | +| --------- | --------- | -------------------------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbole | | Reflète la valeur de l'option `symbol` | +| style\* | | Reflète la valeur de l'option `style` | + +*: Cette variable peut uniquement être utilisée dans une chaine de style ## R @@ -3585,11 +3606,12 @@ Starship obtient la version actuelle de Ruby en exécutant `ruby -v`. ### Variables -| Variable | Exemple | Description | -| --------- | -------- | -------------------------------------- | -| version | `v2.5.1` | La version de `ruby` | -| symbole | | Reflète la valeur de l'option `symbol` | -| style\* | | Reflète la valeur de l'option `style` | +| Variable | Exemple | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | La version de `ruby` | +| symbole | | Reflète la valeur de l'option `symbol` | +| style\* | | Reflète la valeur de l'option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: Cette variable peut uniquement être utilisée dans une chaine de style @@ -4184,6 +4206,7 @@ Le module `username` affiche le nom de l’utilisateur actif. Le module sera aff - L'utilisateur courant est différent de celui connecté - L'utilisateur est actuellement connecté en tant que session SSH - La variable `show_always` est définie à true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4193,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Défaut | Description | -| ------------- | ----------------------- | ---------------------------------------------------- | -| `style_root` | `'bold red'` | Le style utilisé quand l'utilisateur est root/admin. | -| `style_user` | `'bold yellow'` | Le style utilisé pour les utilisateurs non-root. | -| `format` | `'[$user]($style) in '` | Format du module. | -| `show_always` | `false` | Toujours afficher le module `username`. | -| `disabled` | `false` | Désactive le module `username`. | +| Option | Défaut | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | Le style utilisé quand l'utilisateur est root/admin. | +| `style_user` | `'bold yellow'` | Le style utilisé pour les utilisateurs non-root. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | Format du module. | +| `show_always` | `false` | Toujours afficher le module `username`. | +| `disabled` | `false` | Désactive le module `username`. | ### Variables @@ -4210,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Exemple +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4221,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant Le module `vagrant` affiche la version de [Vagrant](https://www.vagrantup.com/) installée. Par défaut, le module sera affiché si l’une de ces conditions est remplie: diff --git a/docs/fr-FR/guide/README.md b/docs/fr-FR/guide/README.md index 917027fc..03ddb1cb 100644 --- a/docs/fr-FR/guide/README.md +++ b/docs/fr-FR/guide/README.md @@ -40,11 +40,11 @@

- Site web + Site web · Installation · - Configuration + Configuration

@@ -171,7 +171,7 @@ - **Facile:** rapide à installer – commencez à l'utiliser en quelques minutes.

-Consultez la documentation de Starship  ▶ +Consultez la documentation de Starship  ▶

@@ -431,10 +431,6 @@ Voyez ces travaux précédents qui ont contribué à inspirer la création de St Soutenez ce projet en [devenant un collaborateur](https://github.com/sponsors/starship). Votre nom ou logo apparaîtra ici avec un lien vers votre site Web. -**Palier Collaborateur** - -- [Appwrite](https://appwrite.io/) -


Icône de roquette de Starship diff --git a/docs/fr-FR/installing/README.md b/docs/fr-FR/installing/README.md index 868152a4..acb135dc 100644 --- a/docs/fr-FR/installing/README.md +++ b/docs/fr-FR/installing/README.md @@ -5,7 +5,7 @@ Pour installer starship, vous devez faire deux choses: 1. Installez le binaire **starship** sur votre ordinateur 1. Dire à votre shell d'utiliser le binaire de starship comme invite en modifiant ses scripts d'initialisation -Pour la plupart des utilisateurs, les instructions sur [la page principale](../guide/#🚀-installation) fonctionneront bien. Cependant, pour certaines plateformes plus spécialisées, des instructions différentes sont nécessaires. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. Cependant, pour certaines plateformes plus spécialisées, des instructions différentes sont nécessaires. Il y a tellement de plates-formes, qu'il aurait été déraisonnable de les faire apparaître dans le README principal, voici donc quelques instructions d'installation supplémentaires pour celles-ci, écrites par la communauté. La vôtre n'est pas là ? S'il vous plaît, ajoutez-la ici pour les suivants ! diff --git a/docs/id-ID/README.md b/docs/id-ID/README.md index 6050e89c..1bf25cd3 100644 --- a/docs/id-ID/README.md +++ b/docs/id-ID/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Prompt yang minimal, super cepat, dan dapat disesuaikan tanpa batas untuk shell apa pun! actions: - - theme: brand + - + theme: brand text: Mari Mulai → link: ./guide/ features: - - + - title: Kompatibilitas Yang Utama details: Dapat berfungsi di shells standar dengan sistem operasi yang paling biasa. Pakai di mana saja! - - + - title: Dibuat dengan Rust details: Menggunakan kecepatan dan keamanan dari Rust, untuk membuat prompt kamu bekerja secepat dan seandal mungkin. - - + - title: Dapat Dikustomisasi details: Kamu dapat mengatur semua detail kecil dengan sesukamu, entah itu untuk membuatnya sebagai prompt yang seminimal mungkin atau kaya akan fitur yang kamu mau. footer: Berlisensi ISC | Hak Cipta © 2019-sekarang Kontributor Starship @@ -24,12 +25,10 @@ metaTitle: "Starship: Prompt Lintas Shell" description: Starship merupakan sebuah prompt yang minimal, super cepat, dan sangat bisa untuk dikustomisasi untuk shell apapun! Bisa menampilkan informasi yang kamu butuhkan, namun tetap bisa tampil dengan ramping dan minimal. Instalasi sederhana tersedia untuk Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, dan PowerShell. --- -

- -
+ ### Prasyarat @@ -58,6 +57,7 @@ description: Starship merupakan sebuah prompt yang minimal, super cepat, dan san ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -156,7 +156,8 @@ description: Starship merupakan sebuah prompt yang minimal, super cepat, dan san ::: - Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + Tambahkan baris berikut di akhir env file Nushell anda (dengan menjalankan `$nu.env-path` di Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/id-ID/advanced-config/README.md b/docs/id-ID/advanced-config/README.md index 575a89e2..d7570a27 100644 --- a/docs/id-ID/advanced-config/README.md +++ b/docs/id-ID/advanced-config/README.md @@ -223,7 +223,7 @@ Invoke-Expression (&starship init powershell) Sebagian shells mendukung right prompt yang mana dirender di baris yang sama sesuai dengan masukannya. Starship mampu mengatur konten right prompt dengan menggunakan opsi `right_format`. Semua modul yang bisa digunakan di dalam `format` juga dapat digunakan di dalam `right_format`. Variabel `$all` hanya akan memuat modul yang tidak digunakan secara eksplisit di dalam `format` ataupun `right_format`. -Catatan: Right propmt merupakan sebuah baris yang mengikuti lokasi baris inputan. Untuk membuat modul rata ke kanan di atas baris masukan di dalam multi-line prompt, lihat [`fill` module](../config/#fill). +Catatan: Right propmt merupakan sebuah baris yang mengikuti lokasi baris inputan. To right align modules above the input line in a multi-line prompt, see the [`fill` module](../config/#fill). `right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. diff --git a/docs/id-ID/config/README.md b/docs/id-ID/config/README.md index 798f68ba..64becc08 100644 --- a/docs/id-ID/config/README.md +++ b/docs/id-ID/config/README.md @@ -158,7 +158,7 @@ Sebagai contoh: #### Penataan String -Sebagian besar modul starship memungkinkan kamu untuk mengkonfigurasi gaya tampilannya. Hal ini dilakukan dengan sebuah entri (biasanya `style`) yang konfigurasinya ditentukan oleh string. Berikut adalah beberapa contoh penataan pada string dan kegunaannya. Untuk detail sintaksis yang lebih lengkap, lihat [panduan konfigurasi lanjutan](../advanced-config/). +Sebagian besar modul starship memungkinkan kamu untuk mengkonfigurasi gaya tampilannya. Hal ini dilakukan dengan sebuah entri (biasanya `style`) yang konfigurasinya ditentukan oleh string. Berikut adalah beberapa contoh penataan pada string dan kegunaannya. 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 @@ -197,16 +197,16 @@ Berikut adalah opsi konfigurasi dari list yang bersifat prompt-wide. ### Opsi -| Opsi | Bawaan | Deskripsi | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `fromat` | [link](#default-prompt-format) | Mengkonfigurasi format pada prompt. | +| Opsi | Bawaan | Deskripsi | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `fromat` | [link](#default-prompt-format) | Mengkonfigurasi format pada prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Batas waktu starpship untuk memindai file (dalam milidetik). | -| `command_timeout` | `500` | Batas waktu untuk perintah yang dijalankan starship (dalam milidetik). | -| `add_newline` | `true` | Memasukkan baris kosong antara prompt shell. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Batas waktu starpship untuk memindai file (dalam milidetik). | +| `command_timeout` | `500` | Batas waktu untuk perintah yang dijalankan starship (dalam milidetik). | +| `add_newline` | `true` | Memasukkan baris kosong antara prompt shell. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variabel | Deskripsi | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Opsi + +| Opsi | Bawaan | Deskripsi | +| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- | +| `fromat` | `'via [$symbol($version )]($style)'` | Format dari modul. | +| `version_format` | `'v${raw}'` | Format dari versi. Variabel yang tersedia adalah `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | Gaya penataan untuk modul. | +| `detect_extensions` | `['.qmd']` | Ekstensi mana yang sebaiknya memicu modul ini. | +| `detect_files` | `['_quarto.yml']` | filenames mana yang sebaiknya memicu modul ini. | +| `detect_folders` | `[]` | Folder mana yang sebaiknya memicul modul ini. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variabel + +| Variabel | Contoh | Deskripsi | +| --------- | --------- | --------------------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbol | | Menyalin nilai dari opsi `symbol` | +| style\* | | Menyalin nilai dari opsi `style` | + +*: Variabel tersebut hanya dapat digunakan sebagai bagian dari penataan string ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variabel -| Variabel | Contoh | Deskripsi | -| --------- | -------- | --------------------------------- | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Menyalin nilai dari opsi `symbol` | -| style\* | | Menyalin nilai dari opsi `style` | +| Variabel | Contoh | Deskripsi | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Menyalin nilai dari opsi `symbol` | +| style\* | | Menyalin nilai dari opsi `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: Variabel tersebut hanya dapat digunakan sebagai bagian dari penataan string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Opsi -| Opsi | Bawaan | Deskripsi | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `fromat` | `'[$user]($style) in '` | Format dari modul. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Opsi | Bawaan | Deskripsi | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `fromat` | `'[$user]($style) in '` | Format dari modul. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variabel @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Contoh +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). Secara bawaan, modul akan aktif jika beberapa syarat berikut telah terpenuhi: diff --git a/docs/id-ID/guide/README.md b/docs/id-ID/guide/README.md index 6a6c3359..9f773cbb 100644 --- a/docs/id-ID/guide/README.md +++ b/docs/id-ID/guide/README.md @@ -40,11 +40,11 @@

- Situs Web + Situs Web · Pemasangan · - Konfigurasi + Konfigurasi

@@ -171,7 +171,7 @@ - **Mudah:** pemasangan singkat – mulai menggunakannya dalam hitungan menit.

-Jelajahi dokumentasi Starship  ▶ +Jelajahi dokumentasi Starship  ▶

@@ -338,7 +338,7 @@ eval $(starship init ion)
Nushell -Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): +Tambahkan baris berikut di akhir env file Nushell anda (dengan menjalankan `$nu.env-path` di Nushell): ```sh mkdir ~/.cache/starship @@ -431,10 +431,6 @@ Please check out these previous works that helped inspire the creation of starsh Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Ikon roket Starship diff --git a/docs/id-ID/installing/README.md b/docs/id-ID/installing/README.md index d738fe5a..f0828d9b 100644 --- a/docs/id-ID/installing/README.md +++ b/docs/id-ID/installing/README.md @@ -1,11 +1,11 @@ -# Advanced Installation +# Instalasi Lanjutan Untuk memasang starship, ada dua hal yang perlu anda lakukan: -1. Get the **starship** binary onto your computer -1. Tell your shell to use the starship binary as its prompt by modifying its init scripts +1. Dapatkan binary **starship** di komputer anda +1. Atur shell anda untuk menggunakan binary tersebut sebagai prompt dengan mengedit init scripts nya -For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. However, for some more specialized platforms, different instructions are needed. +Untuk kebayakan pengguna, instruksi pada [halaman utama](../guide/#🚀-installation) akan berjalan lancar. Namun, untuk sebagian platfrom khusus, instruksi khusus diperlukan. There are so many platforms out there that they didn't fit into the main README.md file, so here are some installation instructions for other platforms from the community. Is yours not here? Please do add it here if you figure it out! diff --git a/docs/it-IT/README.md b/docs/it-IT/README.md index 2f88e4fe..85e6f099 100644 --- a/docs/it-IT/README.md +++ b/docs/it-IT/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Il prompt minimalista, super veloce e infinitamente personalizzabile per qualsiasi shell! actions: - - theme: brand + - + theme: brand text: Inizia → link: ./guide/ features: - - + - title: Prima la compatibilità details: Funziona sulle shell e sui sistemi operativi più comuni. Usalo ovunque! - - + - title: Scritto in Rust details: Sfrutta la velocità e sicurezza 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 prompt minimalista o ricco di tutte le funzionalità che desideri. footer: Licenza ISC | Copyright © 2019-present Starship Collaboratori @@ -24,12 +25,10 @@ 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. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -

- -
+ ### Prerequisiti @@ -58,6 +57,7 @@ description: Starship è il prompt minimalista, super veloce ed estremamente per ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship è il prompt minimalista, super veloce ed estremamente per ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/it-IT/config/README.md b/docs/it-IT/config/README.md index ed765891..9a6a638c 100644 --- a/docs/it-IT/config/README.md +++ b/docs/it-IT/config/README.md @@ -158,7 +158,7 @@ Per esempio: #### Stringhe di stile -La maggior parte dei moduli in starship ti permettono di configurare i loro stili di visualizzazione. Questo viene fatto con una voce (solitamente chiamata `style`) che è una stringa che specifica la configurazione. Ecco alcuni esempi di stringhe di stile per quello che fanno. Per maggiori dettagli sulla sintassi completa, consulta la [guida di configurazione avanzata](../advanced-config/). +La maggior parte dei moduli in starship ti permettono di configurare i loro stili di visualizzazione. Questo viene fatto con una voce (solitamente chiamata `style`) che è una stringa che specifica la configurazione. Ecco alcuni esempi di stringhe di stile per quello che fanno. 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 @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Opzioni -| Opzione | Default | Descrizione | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configura il formato del prompt. | +| Opzione | Default | Descrizione | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configura il formato del prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout per starship per scansionare i file (in millisecondi). | -| `command_timeout` | `500` | Timeout per i comandi eseguiti da starship (in millisecondi). | -| `add_newline` | `true` | Inserisce una riga vuota tra i prompt della shell. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout per starship per scansionare i file (in millisecondi). | +| `command_timeout` | `500` | Timeout per i comandi eseguiti da starship (in millisecondi). | +| `add_newline` | `true` | Inserisce una riga vuota tra i prompt della shell. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | Descrizione | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Opzioni + +| Opzione | Default | Descrizione | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | Il formato della versione. Le variabili disponibili sono `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | Lo stile per il modulo. | +| `detect_extensions` | `['.qmd']` | Quali estensioni dovrebbero attivare questo modulo. | +| `detect_files` | `['_quarto.yml']` | Quali nomi di file dovrebbero attivare questo modulo. | +| `detect_folders` | `[]` | Quali cartelle dovrebbero attivare questo modulo. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Esempio | Descrizione | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | Esempio | Descrizione | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | Esempio | Descrizione | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Opzioni -| Opzione | Default | Descrizione | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Opzione | Default | Descrizione | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Esempio +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/it-IT/guide/README.md b/docs/it-IT/guide/README.md index f4c9a6c3..295c9eb5 100644 --- a/docs/it-IT/guide/README.md +++ b/docs/it-IT/guide/README.md @@ -171,7 +171,7 @@ - **Facile:** veloce da installare - inizia ad usarlo in pochi minuti.

-Esplora la documentazione di Starship  ▶ +Esplora la documentazione di Starship  ▶

@@ -431,10 +431,6 @@ Ti invito di controllare questi lavori precedenti che hanno contribuito a ispira Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/it-IT/installing/README.md b/docs/it-IT/installing/README.md index e37ccb26..4fe9a47c 100644 --- a/docs/it-IT/installing/README.md +++ b/docs/it-IT/installing/README.md @@ -5,7 +5,7 @@ Per installare starship, è necessario fare due cose: 1. Ottieni il binario **starship** sul tuo computer 1. Indica alla tua shell di usare il binario starship come prompt modificando i suoi script in init -Per la maggior parte degli utenti, le istruzioni nella [pagina principale](../guide/#🚀-installation) funzioneranno bene. Tuttavia, per alcune piattaforme più specializzate, sono necessarie istruzioni diverse. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. Tuttavia, per alcune piattaforme più specializzate, sono necessarie istruzioni diverse. Ci sono così tante piattaforme là fuori che non sono tutte inserite nel README.md principale, così ecco alcune istruzioni di installazione per altre piattaforme della community. La tua non c'è? Per favore, aggiungilo qui se capisci che manca! diff --git a/docs/ja-JP/README.md b/docs/ja-JP/README.md index 91590f42..9c921c31 100644 --- a/docs/ja-JP/README.md +++ b/docs/ja-JP/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: シェル用の最小限の、非常に高速で、無限にカスタマイズ可能なプロンプトです！ actions: - - theme: brand + - + theme: brand text: Get Started → link: ./guide/ features: - - + - title: 互換性優先 details: 一般的なほとんどのOSの一般的なほとんどのシェル上で動作します。 あらゆるところで使用してください！ - - + - title: Rust製 details: Rustの最高レベルの速度と安全性を用いることで、可能な限り高速かつ信頼性を高くしています。 - - + - title: カスタマイズ可能 details: それぞれの細かい点は好みにカスタマイズが出来るため、ミニマルにも多機能にも好きなようにプロンプトを設定することができます。 footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship はミニマルで、非常に高速で、カスタマイズ性の高い、あらゆるシェルのためのプロンプトです！ ミニマルかつ洗練された形で、あなたに必要な情報を表示します。 Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, PowerShellで簡単に利用できます。 --- -

- -
+ ### 必要なもの @@ -58,6 +57,7 @@ description: Starship はミニマルで、非常に高速で、カスタマイ ```sh brew install starship ``` + [Winget](https://github.com/microsoft/winget-cli)を使用する ```powershell @@ -157,6 +157,7 @@ description: Starship はミニマルで、非常に高速で、カスタマイ ::: そして、Nushellの設定ファイルの最後に以下を追加してください（ `$nu.config-path` を実行してください）: + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/ja-JP/config/README.md b/docs/ja-JP/config/README.md index 1b8c67a1..75268119 100644 --- a/docs/ja-JP/config/README.md +++ b/docs/ja-JP/config/README.md @@ -158,7 +158,7 @@ line2 #### スタイルの設定 -Starshipのほとんどのモジュールでは、表示スタイルを設定できます。 これは、設定を指定する文字列であるエントリ（`style`）で行われます。 スタイル文字列の例とその機能を次に示します。 完全な構文の詳細については、詳細は [高度な設定](../advanced-config/)を参照してください 。 +Starshipのほとんどのモジュールでは、表示スタイルを設定できます。 これは、設定を指定する文字列であるエントリ（`style`）で行われます。 スタイル文字列の例とその機能を次に示します。 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 @@ -197,16 +197,16 @@ detect_extensions = ['ts', '!video.ts', '!audio.ts'] ### オプション -| オプション | デフォルト | 説明 | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | プロンプトの形式を設定します。 | -| `right_format` | `''` | [右プロンプトの有効化](../advanced-config/#enable-right-prompt)を参照してください。 | -| `scan_timeout` | `30` | ファイルをスキャンする際のタイムアウト時間 (milliseconds) です。 | -| `command_timeout` | `500` | Starshipによって実行されたコマンドのタイムアウト時間 (milliseconds) です。 | -| `add_newline` | `true` | シェルプロンプトの間に空行を挿入します。 | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| オプション | デフォルト | 説明 | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | プロンプトの形式を設定します。 | +| `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | +| `scan_timeout` | `30` | ファイルをスキャンする際のタイムアウト時間 (milliseconds) です。 | +| `command_timeout` | `500` | Starshipによって実行されたコマンドのタイムアウト時間 (milliseconds) です。 | +| `add_newline` | `true` | シェルプロンプトの間に空行を挿入します。 | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ WSL環境のWindowsディレクトリ(例: `/mnt/c/`以下) では、Git Status | 変数 | 説明 | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +デフォルトでは次の条件のいずれかが満たされると、モジュールが表示されます。 + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### オプション + +| オプション | デフォルト | 説明 | +| ------------------- | ------------------------------------ | ------------------------------------------------------ | +| `format` | `'via [$symbol($version )]($style)'` | module のフォーマットです。 | +| `version_format` | `'v${raw}'` | バージョンのフォーマット。 使用可能な変数は`raw`、`major`、`minor`と`patch`です。 | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | モジュールのスタイルです。 | +| `detect_extensions` | `['.qmd']` | どの拡張子がこのモジュールをアクティブにするか | +| `detect_files` | `['_quarto.yml']` | どのファイル名がこのモジュールをアクティブにするか | +| `detect_folders` | `[]` | どのフォルダーがこのモジュールをアクティブにするか | +| `disabled` | `false` | Disables the `quarto` module. | + +### 変数 + +| 変数 | 設定例 | 説明 | +| --------- | --------- | ----------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbol | | オプション `symbol` の値をミラーする | +| style\* | | オプション `style` の値をミラーする | + +*: この変数は、スタイル文字列の一部としてのみ使用することができます。 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### 変数 -| 変数 | 設定例 | 説明 | -| --------- | -------- | ----------------------- | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | オプション `symbol` の値をミラーする | -| style\* | | オプション `style` の値をミラーする | +| 変数 | 設定例 | 説明 | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | オプション `symbol` の値をミラーする | +| style\* | | オプション `style` の値をミラーする | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: この変数は、スタイル文字列の一部としてのみ使用することができます。 @@ -4183,6 +4206,7 @@ The `typst` module shows the current installed version of Typst used in a projec - カレントユーザーが、ログインしているユーザーとは異なる - ユーザーがSSHセッションとして接続されている - `show_always`変数がtrueに設定されている +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### オプション -| オプション | デフォルト | 説明 | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | 非rootユーザーに使用されるスタイルです。 | -| `format` | `'[$user]($style) in '` | module のフォーマットです。 | -| `show_always` | `false` | `username` モジュールを常に表示します。 | -| `disabled` | `false` | `username` モジュールを無効にします。 | +| オプション | デフォルト | 説明 | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | 非rootユーザーに使用されるスタイルです。 | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | module のフォーマットです。 | +| `show_always` | `false` | `username` モジュールを常に表示します。 | +| `disabled` | `false` | `username` モジュールを無効にします。 | ### 変数 @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### 設定例 +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant `vagrant`モジュールは、現在インストールされている[Vagrant](https://www.vagrantup.com/)のバージョンを表示します。 デフォルトでは次の条件のいずれかが満たされると、モジュールが表示されます。 diff --git a/docs/ja-JP/guide/README.md b/docs/ja-JP/guide/README.md index 815925b8..1d3b668b 100644 --- a/docs/ja-JP/guide/README.md +++ b/docs/ja-JP/guide/README.md @@ -40,11 +40,11 @@

- ウェブサイト + ウェブサイト · インストール · - 設定 + 設定

@@ -171,7 +171,7 @@ - **簡単:** 迅速なインストールが可能であり、数分で使用開始可能です。

-Starshipのドキュメントを見る  ▶ +Starshipのドキュメントを見る  ▶

@@ -431,10 +431,6 @@ Starshipのさらなるカスタマイズを目指すなら以下を参考にし [スポンサーになることで](https://github.com/sponsors/starship)このプロジェクトをサポートできます。 名前やロゴがあなたのホームページへのリンクとともに表示されます。 -**スポンサーティア** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/ja-JP/installing/README.md b/docs/ja-JP/installing/README.md index 1d00825b..357f8a65 100644 --- a/docs/ja-JP/installing/README.md +++ b/docs/ja-JP/installing/README.md @@ -5,7 +5,7 @@ Starship をインストールするには、以下の2つのことを行う必 1. ** starship ** のバイナリをコンピューター上に取得する 1. Init スクリプトを修正することで、Starship バイナリをプロンプトとして使用するようシェルに指示する -ほとんどのユーザーの場合、[メインページ](../guide/#🚀-installation)の説明でうまく動作します。 しかし、より特殊なプラットフォームでは、別の操作が必要になることがあります。 +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. しかし、より特殊なプラットフォームでは、別の操作が必要になることがあります。 プラットフォームは無数に存在するため、メインの README.md ファイルには書ききれません。そこで、このページでは、コミュニティにより提供された他のプラットフォーム向けのインストール方法について紹介します。 あなたが使用しているプラットフォームが見当たりませんか？ その場合は是非、見つけた方法をここに追加してください。 diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md index 41736c73..3654f0ba 100644 --- a/docs/ko-KR/README.md +++ b/docs/ko-KR/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null - tagline: 아무 셸에나 적용할 수 있는 작고, 매우 빠르며, 무한히 커스텀 가능한 프롬프트입니다! + text: + tagline: 아무 셸에나 적용할 수 있는 간결하고, 매우 빠르며, 무한히 커스텀 가능한 프롬프트입니다! actions: - - theme: brand + - + theme: brand text: 시작하기 → link: ./guide/ features: - - + - title: 호환성 우선 details: 거의 모든 운영 체제의 거의 모든 셸에서 동작합니다. 모든 곳에서 사용해 보세요! - - + - title: Rust 기반 details: Rust의 최고 수준의 속도와 안정성으로 프롬프트를 가능한 한 빠르고 안정적으로 만들어 보세요. - - + - title: 커스텀 가능 details: 모든 사소한 디테일들을 마음대로 커스텀할 수 있어, 프롬프트를 원하는 만큼 간단하게 만들거나 기능이 풍부하게 만들 수 있습니다. footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: 크로스-셸 프롬프트" description: Starship은 아무 셸에나 적용할 수 있는 작고, 매우 빠르며, 무한히 커스텀 가능한 프롬프트입니다! 필요한 정보를 깔끔하고 간략하게 표시합니다. Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, 및 PowerShell에 빠르게 설치할 수 있습니다. --- -

- -
+ ### 준비 사항 @@ -58,6 +57,7 @@ description: Starship은 아무 셸에나 적용할 수 있는 작고, 매우 ```sh brew install starship ``` + [Winget](https://github.com/microsoft/winget-cli)으로 설치: ```powershell @@ -157,6 +157,7 @@ description: Starship은 아무 셸에나 적용할 수 있는 작고, 매우 ::: 다음 내용을 Nushell env 파일 (찾으려면 Nushell에서 `$nu.env-path` 실행) 마지막 부분에 추가하세요: + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/ko-KR/advanced-config/README.md b/docs/ko-KR/advanced-config/README.md index 49006e12..b084813a 100644 --- a/docs/ko-KR/advanced-config/README.md +++ b/docs/ko-KR/advanced-config/README.md @@ -223,7 +223,7 @@ Invoke-Expression (&starship init powershell) 일부 셸은 입력과 같은 줄에 렌더링되는 오른쪽 프롬프트를 지원합니다. Starship에서는 `right_format` 옵션을 사용하여 오른쪽 프롬프트의 내용을 설정할 수 있습니다. `format`에서 사용할 수 있는 모든 모듈은 `right_format`에서도 지원됩니다. `$all` 변수는 `format` 또는 `right_format`에서 명시적으로 사용하지 않는 모듈만 포함합니다. -알림: 오른쪽 프롬프트는 입력 위치에 따라 한 줄로 표시됩니다. 여러 줄 프롬프트에서 입력 선 위의 모듈을 오른쪽 정렬하려면, [`fill` 모듈](../config/#fill)을 참고하세요. +알림: 오른쪽 프롬프트는 입력 위치에 따라 한 줄로 표시됩니다. To right align modules above the input line in a multi-line prompt, see the [`fill` module](../config/#fill). `right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. diff --git a/docs/ko-KR/config/README.md b/docs/ko-KR/config/README.md index d32ea029..8558d4f4 100644 --- a/docs/ko-KR/config/README.md +++ b/docs/ko-KR/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `기호` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | 예시 | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 기호 | | 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | 예시 | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| 기호 | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | 예시 | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| 기호 | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### 예시 +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/ko-KR/guide/README.md b/docs/ko-KR/guide/README.md index 84c86983..90da03cd 100644 --- a/docs/ko-KR/guide/README.md +++ b/docs/ko-KR/guide/README.md @@ -40,11 +40,11 @@

- 웹사이트 + 웹사이트 · 설치 · - 설정 + 설정

@@ -171,7 +171,7 @@ - **쉬움:** 빠른 설치 - 몇 분만 투자하면 바로 사용할 수 있습니다.

-Starship 문서 보기  ▶ +Starship 문서 보기  ▶

@@ -431,10 +431,6 @@ Starship 을 만드는 데에 영감이 되었던 이전 작업들도 살펴보 이 [프로젝트를 후원](https://github.com/sponsors/starship)하여 프로젝트를 지원해 주세요. 여러분의 웹사이트로 이동하는 링크가 걸린 이름 혹은 로고가 여기에 걸립니다. -**후원자 티어** - -- [Appwrite](https://appwrite.io/) -


Starship 로켓 아이콘 diff --git a/docs/nl-NL/README.md b/docs/nl-NL/README.md index 0d92c555..42829c8a 100644 --- a/docs/nl-NL/README.md +++ b/docs/nl-NL/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: De minimalistische, razend snelle en oneindig aanpasbare prompt voor elke shell! actions: - - theme: brand + - + theme: brand text: Get Started → link: ./guide/ features: - - + - title: Compatibility First details: Works on the most common shells on the most common operating systems. Use it everywhere! - - + - title: Rust-Powered details: Brings the best-in-class speed and safety of Rust, to make your prompt as quick and reliable as possible. - - + - title: Customizable details: Every little detail is customizable to your liking, to make this prompt as minimal or feature-rich as you'd like it to be. footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -

- -
+ ### Benodigdheden @@ -58,6 +57,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/nl-NL/config/README.md b/docs/nl-NL/config/README.md index 328ab8c4..7b4f5106 100644 --- a/docs/nl-NL/config/README.md +++ b/docs/nl-NL/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Example | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | Example | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | Example | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Example +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/nl-NL/guide/README.md b/docs/nl-NL/guide/README.md index 31f01227..4f92b22a 100644 --- a/docs/nl-NL/guide/README.md +++ b/docs/nl-NL/guide/README.md @@ -35,16 +35,16 @@ Stand With Ukraine

- Website + Website · Installatie · - Configuratie + Configuratie

@@ -124,7 +124,7 @@ >Українська   -Verken de Starship-documentatie  ▶ +Verken de Starship-documentatie  ▶

@@ -180,7 +180,7 @@ ### Benodigdheden -- A [Nerd Font](https://www.nerdfonts.com/) installed and enabled in your terminal (for example, try the [FiraCode Nerd Font](https://www.nerdfonts.com/font-downloads)). +- Een [Nerd Font](https://www.nerdfonts.com/) is geïnstalleerd en ingeschakeld in je terminal (probeer bijvoorbeeld het [Firacode Nerd Font](https://www.nerdfonts.com/font-downloads)). ### Stap 1. Installeer Starship @@ -202,11 +202,11 @@ Installeer Starship met één van de volgende pakketbeheerders: Installeer Starship met één van de volgende pakketbeheerders: -| Distribution | Repository | Instructies | -| ------------ | -------------------------------------------------------- | --------------------------------- | -| **_Any_** | **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` | -| FreeBSD | [FreshPorts](https://www.freshports.org/shells/starship) | `pkg install starship` | -| NetBSD | [pkgsrc](https://pkgsrc.se/shells/starship) | `pkgin install starship` | +| Distributie | Repository | Instructies | +| ------------------ | -------------------------------------------------------- | --------------------------------- | +| **_Eender welke_** | **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` | +| FreeBSD | [FreshPorts](https://www.freshports.org/shells/starship) | `pkg install starship` | +| NetBSD | [pkgsrc](https://pkgsrc.se/shells/starship) | `pkgin install starship` |
@@ -219,13 +219,13 @@ Install the latest version for your system: curl -sS https://starship.rs/install.sh | sh ``` -Alternatively, install Starship using any of the following package managers: +Als alternatief kan je Starship installeren met een van de volgende pakketbeheerders: -| Distribution | Repository | Instructies | +| Distributie | Repository | Instructies | | ------------------ | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | -| **_Any_** | **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` | -| _Any_ | [conda-forge](https://anaconda.org/conda-forge/starship) | `conda install -c conda-forge starship` | -| _Any_ | [Linuxbrew](https://formulae.brew.sh/formula/starship) | `brew install starship` | +| **_Eender welke_** | **[crates.io](https://crates.io/crates/starship)** | `cargo install starship --locked` | +| _Eender welke_ | [conda-forge](https://anaconda.org/conda-forge/starship) | `conda install -c conda-forge starship` | +| _Eender welke_ | [Linuxbrew](https://formulae.brew.sh/formula/starship) | `brew install starship` | | Alpine Linux 3.13+ | [Alpine Linux Packages](https://pkgs.alpinelinux.org/packages?name=starship) | `apk add starship` | | Arch Linux | [Arch Linux Extra](https://archlinux.org/packages/extra/x86_64/starship) | `pacman -S starship` | | CentOS 7+ | [Copr](https://copr.fedorainfracloud.org/coprs/atim/starship) | `dnf copr enable atim/starship`
`dnf install starship` | @@ -246,7 +246,7 @@ Install the latest version for your system: curl -sS https://starship.rs/install.sh | sh ``` -Alternatively, install Starship using any of the following package managers: +Als alternatief kan je Starship installeren met een van de volgende pakketbeheerders: | Repository | Instructies | | -------------------------------------------------------- | --------------------------------------- | @@ -260,7 +260,7 @@ Alternatively, install Starship using any of the following package managers:
Windows -Install the latest version for your system with the MSI-installers from the [releases section](https://github.com/starship/starship/releases/latest). +Installeer de nieuwste versie voor uw systeem met de MSI-installers van de [releases sectie](https://github.com/starship/starship/releases/latest). Installeer Starship met één van de volgende pakketbeheerders: @@ -431,10 +431,6 @@ Please check out these previous works that helped inspire the creation of starsh Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/no-NO/README.md b/docs/no-NO/README.md index 0d94d3ef..6f82d6a9 100644 --- a/docs/no-NO/README.md +++ b/docs/no-NO/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Minimal, blendende rask og uendelig tilpasningsdyktig ledetekst for alle skall! actions: - - theme: brand + - + theme: brand text: Get Started → link: ./guide/ features: - - + - title: Compatibility First details: Works on the most common shells on the most common operating systems. Use it everywhere! - - + - title: Rust-Powered details: Brings the best-in-class speed and safety of Rust, to make your prompt as quick and reliable as possible. - - + - title: Customizable details: Every little detail is customizable to your liking, to make this prompt as minimal or feature-rich as you'd like it to be. footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -

- -
+ ### Nødvendig forutsetninger @@ -58,6 +57,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ::: Legg til følgende i slutten av Nushell env filen (finn den ved å kjøre `$nu.env-path` i Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/no-NO/config/README.md b/docs/no-NO/config/README.md index 328ab8c4..7b4f5106 100644 --- a/docs/no-NO/config/README.md +++ b/docs/no-NO/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Example | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | Example | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | Example | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Example +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/no-NO/guide/README.md b/docs/no-NO/guide/README.md index 918c93f8..9d680570 100644 --- a/docs/no-NO/guide/README.md +++ b/docs/no-NO/guide/README.md @@ -40,11 +40,11 @@

- Nettside + Nettside · Installasjon · - Konfigurasjon + Konfigurasjon

@@ -171,7 +171,7 @@ - **Lett:** raskt å installere - start å bruke det på minutter.

-Utforsk Starship dokumentasjon  ▶ +Utforsk Starship dokumentasjon  ▶

@@ -431,10 +431,6 @@ Please check out these previous works that helped inspire the creation of starsh Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/pl-PL/README.md b/docs/pl-PL/README.md index eb4861b3..828d2b1d 100644 --- a/docs/pl-PL/README.md +++ b/docs/pl-PL/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Minimalny, szybki i nieskończenie konfigurowalny wiersz poleceń dla dowolnej powłoki! actions: - - theme: brand + - + theme: brand text: Pierwsze kroki → link: ./guide/ features: - - + - title: Kompatybilność przede wszystkim details: Działa na większości powszechnych powłokach, na większości najpopularniejszych systemach. Używaj go wszędzie! - - + - title: Napędzany językiem Rust details: Zapewnia najlepszą w swojej klasie prędkość i bezpieczeństwo języka Rust, w celu zapewnienia jak najszybszej i niezawodnej odpowiedzi. - - + - title: Konfigurowalny details: Każdy mały detal jest konfigurowalny do Twoich preferencji, aby wiersz poleceń był tak minimalny lub tak bogaty w funkcje, jak tylko zechcesz. footer: Licencja ISC | Copyright © 2019-obecnie Kontrybutorzy Starship @@ -24,12 +25,10 @@ metaTitle: "Starship: Wiersz poleceń dla dowolnej powłoki" description: Starship to minimalny, szybki i ekstremalnie konfigurowalny wiersz poleceń dla każdej powłoki! Pokazuje informacje których potrzebujesz, pozostając elegancki i minimalny. Szybka instalacja dostępna dla powłok Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd i PowerShell. --- -

- -
+ ### Wymagania wstępne @@ -58,6 +57,7 @@ description: Starship to minimalny, szybki i ekstremalnie konfigurowalny wiersz ```sh brew install starship ``` + Za pomocą [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship to minimalny, szybki i ekstremalnie konfigurowalny wiersz ::: Dodaj następujący kod na koniec twojego pliku env Nushell (możesz go znaleść za pomocą `$nu.env-path` w Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/pl-PL/config/README.md b/docs/pl-PL/config/README.md index 92291fa6..53200eee 100644 --- a/docs/pl-PL/config/README.md +++ b/docs/pl-PL/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: porada @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Zmienne | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Zmienne | Example | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Zmienne | Example | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Zmienne | Example | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: porada @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Example +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/pl-PL/guide/README.md b/docs/pl-PL/guide/README.md index bc313993..0d95f87b 100644 --- a/docs/pl-PL/guide/README.md +++ b/docs/pl-PL/guide/README.md @@ -40,11 +40,11 @@

- Strona internetowa + Strona internetowa · Instalacja · - Konfiguracja + Konfiguracja

@@ -171,7 +171,7 @@ - **Łatwy w obsłudze:** szybka instalacja - zacznij korzystać w kilka minut.

-Przeglądaj dokumentację Starship  ▶ +Przeglądaj dokumentację Starship  ▶

@@ -431,10 +431,6 @@ Zapoznaj się z wcześniejszymi projektami, które zainspirowały nas do stworze Wspomóż ten projekt [stając się sponsorem](https://github.com/sponsors/starship). Twoja nazwa bądź logo pojawi się tutaj wraz z linkiem do Twojej witryny. -**Poziom Supporter** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/pl-PL/installing/README.md b/docs/pl-PL/installing/README.md index 6f7a0408..fb70353d 100644 --- a/docs/pl-PL/installing/README.md +++ b/docs/pl-PL/installing/README.md @@ -5,7 +5,7 @@ Aby zainstalować starship, musisz zrobić dwie rzeczy: 1. Pobrać plik wykonywalny **starship** na swój komputer 1. Skonfigurować swoją powłokę żeby używała pliku wykonywalnego starship jako wiersza poleceń poprzez modyfikację skryptów inicjalizacyjnych -Dla większości użytkowników instrukcje na [stronie głównej](../guide/#🚀-installation) są wystarczające. Jednakże, dla niektórych wyspecjalizowanych platform, potrzebne będą inne. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. Jednakże, dla niektórych wyspecjalizowanych platform, potrzebne będą inne. Istnieje tak wiele platform, że nie zmieściły się one w głównym pliku README.md, więc poniżej znajdują się instrukcje instalacji dla innych platform od społeczności. Nie ma tutaj Twojej? Jeśli się o tym dowiesz, dodaj je tutaj! diff --git a/docs/pt-BR/README.md b/docs/pt-BR/README.md index ec8274a0..20ee29d6 100644 --- a/docs/pt-BR/README.md +++ b/docs/pt-BR/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: O prompt minimalista, extremamente rápido e infinitamente personalizável para qualquer shell! actions: - - theme: brand + - + theme: brand text: Primeiros passos → link: ./guide/ features: - - + - title: Compatibilidade primeiro details: Funciona nos principais shells nos principais sistemas operacionais. Use em qualquer lugar! - - + - title: Poder do Rust details: Tenha o melhor da velocidade e segurança do Rust, para tornar seu prompt o mais rápido e confiável possível. - - + - title: Personalizável details: Cada pequeno detalhe é personalizável ao seu gosto, para tornar esse prompt o mínimo possível ou rico em recursos, como você preferir. footer: Licenciado pelo ISC | Todos os direitos reservados © 2019-Presente | Contribuidores Starship @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: O Starship é o prompt minimalista, extremamente rápido e extremamente personalizável para qualquer shell! Mostra as informações que você precisa, mantendo-se elegante e minimalista. Instalação rápida disponível para Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd e PowerShell. --- -

- -
+ ### Pré-requisitos @@ -58,6 +57,7 @@ description: O Starship é o prompt minimalista, extremamente rápido e extremam ```sh brew install starship ``` + Com o [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: O Starship é o prompt minimalista, extremamente rápido e extremam ::: Adicione o seguinte ao final do seu arquivo env do Nushell (enconte-o rodando `$nu.env-path` no Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/pt-BR/advanced-config/README.md b/docs/pt-BR/advanced-config/README.md index ea6fabd2..4169424b 100644 --- a/docs/pt-BR/advanced-config/README.md +++ b/docs/pt-BR/advanced-config/README.md @@ -223,7 +223,7 @@ Invoke-Expression (&starship init powershell) Alguns shells suportam um prompt direito que é renderizado na mesma linha que a entrada. Starship pode definir o conteúdo do prompt correto usando a opção `right_format`. Qualquer módulo que pode ser usado no `format` também é compatível com `right_format`. A variável `$all` conterá apenas módulos não usado explicitamente em `format` ou `right_format`. -Nota: O prompt direito é uma única linha após o local de entrada. Para alinhar módulos à direita acima da linha de entrada em um prompt de várias linhas, consulte o [módulo `fill`](../config/#fill). +Nota: O prompt direito é uma única linha após o local de entrada. To right align modules above the input line in a multi-line prompt, see the [`fill` module](../config/#fill). `right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. diff --git a/docs/pt-BR/config/README.md b/docs/pt-BR/config/README.md index 8f6a9ffd..ad3b7aa7 100644 --- a/docs/pt-BR/config/README.md +++ b/docs/pt-BR/config/README.md @@ -106,7 +106,7 @@ format = ''' \$''' -# com string básica multilinha +# com string básica multilinha format = """ \\$""" @@ -158,7 +158,7 @@ Por exemplo: #### Estilo dos textos -A maioria dos módulos no starship permite que você configure seus estilos de exibição. Isso é feito com uma entrada (normalmente chamada de `estilo`) que é uma string especificando a configuração. Aqui estão alguns exemplos de strings de estilo junto com o que elas fazem. Para obter detalhes sobre a sintaxe completa, consulte o [guia de configuração avançada](../advanced-config/). +A maioria dos módulos no starship permite que você configure seus estilos de exibição. Isso é feito com uma entrada (normalmente chamada de `estilo`) que é uma string especificando a configuração. Aqui estão alguns exemplos de strings de estilo junto com o que elas fazem. For details on the full syntax, consult the [advanced config guide](../advanced-config/). - `"fg:green bg:blue"` define o texto para verde e o fundo azul - `"bg:blue fg:bright-green"` define o texto para verde brilhante e o fundo azul @@ -197,16 +197,16 @@ Esta é a lista de opções de configuração em todo o prompt. ### Opções -| Opções | Padrão | Descrição | -| ----------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configura o formato do prompt. | -| `right_format` | `''` | Veja [Ativa o prompt direito](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Tempo limite para escanear arquivos (em milissegundos). | -| `command_timeout` | `500` | Tempo limite de execução de comandos pelo starship (em milissegundos). | -| `add_newline` | `true` | Insere linha vazia entre os prompts do shell. | -| `palette` | `''` | Define qual a paleta de cores de `palettes` será usada. | -| `palettes` | `{}` | Coleção de paletas de cores que atribuem [cores](../advanced-config/#style-strings) aos nomes definidos pelo usuário. Note que paletas de cores não podem referir-se a suas próprias definições de cores. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| Opções | Padrão | Descrição | +| ----------------- | ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configura o formato do prompt. | +| `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | +| `scan_timeout` | `30` | Tempo limite para escanear arquivos (em milissegundos). | +| `command_timeout` | `500` | Tempo limite de execução de comandos pelo starship (em milissegundos). | +| `add_newline` | `true` | Insere linha vazia entre os prompts do shell. | +| `palette` | `''` | Define qual a paleta de cores de `palettes` será usada. | +| `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note que paletas de cores não podem referir-se a suas próprias definições de cores. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ As variáveis a seguir podem ser usadas no `format`: | Variável | Descrição | | -------------- | ---------------------------------------------------------------------------------------------------------- | -| `all_status` | Atalhos para `$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Exibe `diverged`, `ahead`, `behind` or `up_to_date` conforme o formato da string do status do repositório. | | `conflicted` | Exibe `conflicted` quando este braço tenha conflitos no merge. | | `untracked` | Exibe `untracked` quando há arquivos não rastreados no diretório atual. | @@ -3356,7 +3357,7 @@ O módulo `python` exibe a versão atual instalada do [Python](https://www.pytho Se o `pyenv_version_name` estiver definido como `true`, será exibido o nome da versão do pyenv. Caso contrario, ele exibirá o número da versão do `python --version`. -Por padrão o módulo vai exibir se uma das condições a seguir for atendida: +Por padrão, o módulo será exibido se qualquer das seguintes condições for atendida: - O diretório atual tenha um arquivo `.python-version` - O diretório atual tenha um arquivo `Pipfile` @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Exibe a versão do python de dentro de um venv local. -# -# Note que isso só funcionará quando o venv estiver dentro do projeto e só -# funcionará apenas no diretório que contém o diretório venv, mas talvez isso seja ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +Por padrão, o módulo será exibido se qualquer das seguintes condições for atendida: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Opções + +| Opções | Padrão | Descrição | +| ------------------- | ------------------------------------ | ----------------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | O formato do módulo. | +| `version_format` | `'v${raw}'` | A versão formatada. As variáveis disponíveis são `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | O estilo do módulo. | +| `detect_extensions` | `['.qmd']` | Quais extensões devem ativar este módulo. | +| `detect_files` | `['_quarto.yml']` | Quais nomes de arquivos devem ativar este módulo. | +| `detect_folders` | `[]` | Quais pastas devem ativar este módulo. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variáveis + +| Variável | Exemplo | Descrição | +| --------- | --------- | --------------------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbol | | Espelha o valor da opção `symbol` | +| style\* | | Espelha o valor da opção `style` | + +*: Esta variável só pode ser usada como parte de uma string de estilo ## R @@ -3584,11 +3606,12 @@ O Starship pega a versão atual do Ruby rodando `ruby -v`. ### Variáveis -| Variável | Exemplo | Descrição | -| --------- | -------- | --------------------------------- | -| version | `v2.5.1` | A versão do `ruby` | -| symbol | | Espelha o valor da opção `symbol` | -| style\* | | Espelha o valor da opção `style` | +| Variável | Exemplo | Descrição | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | A versão do `ruby` | +| symbol | | Espelha o valor da opção `symbol` | +| style\* | | Espelha o valor da opção `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: Esta variável só pode ser usada como parte de uma string de estilo @@ -4183,6 +4206,7 @@ O módulo `username` mostra o nome de usuário do usuário ativo. O módulo ser - O usuário atual não é o mesmo que está logado - O usuário atual esta conectado em uma sessão SSH - A variável `show_always` esta definida como true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ Conexões SSH são detectadas checando as variáveis de ambiente `SSH_CONNECTION ### Opções -| Opções | Padrão | Descrição | -| ------------- | ----------------------- | --------------------------------------------- | -| `style_root` | `'bold red'` | O estilo usado quando o usuário é root/admin. | -| `style_user` | `'bold yellow'` | O estilo usado para usuários não root. | -| `format` | `'[$user]($style) in '` | O formato do módulo. | -| `show_always` | `false` | Sempre exibe o módulo `username`. | -| `disabled` | `false` | Desabilita o módulo `username`. | +| Opções | Padrão | Descrição | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | O estilo usado quando o usuário é root/admin. | +| `style_user` | `'bold yellow'` | O estilo usado para usuários não root. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | O formato do módulo. | +| `show_always` | `false` | Sempre exibe o módulo `username`. | +| `disabled` | `false` | Desabilita o módulo `username`. | ### Variáveis @@ -4209,6 +4234,8 @@ Conexões SSH são detectadas checando as variáveis de ambiente `SSH_CONNECTION ### Exemplo +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant O módulo `vagrant` exibe a versão atual instalada do [Vagrant](https://www.vagrantup.com/). Por padrão o módulo vai exibir se uma das condições a seguir for atendida: diff --git a/docs/pt-BR/faq/README.md b/docs/pt-BR/faq/README.md index 3fb3a62c..1c97f803 100644 --- a/docs/pt-BR/faq/README.md +++ b/docs/pt-BR/faq/README.md @@ -58,7 +58,7 @@ curl -sS https://starship.rs/install.sh | sh -s -- --platform unknown-linux-musl ## Porque eu vejo alertas de `Executing command "..." timed out.`? -O Starship executa comandos diferentes para recuperar as informações para exibir no prompt, por exemplo a versão de um programa ou o status atual do git. Para ter certeza de que o starship não travou durante uma execução destes comandos nos definimos um limite de tempo, se um comando ultrapassar este limite o starship vai parar a execução do comando e exibe o alerta acima, esse é um comportamento esperado. Este limite de tempo é configurado usando o [`command_timeout`key](../config/#prompt) então se você quiser você pode aumentar este limite. Você pode também seguir os passos para debugar para ver qual comando esta demorando e se você pode otimizar ele. Finalmente você pode definir a variável de ambiente `STARSHIP_LOG` para `error` para esconder estes alertas. +O Starship executa comandos diferentes para recuperar as informações para exibir no prompt, por exemplo a versão de um programa ou o status atual do git. Para ter certeza de que o starship não travou durante uma execução destes comandos nos definimos um limite de tempo, se um comando ultrapassar este limite o starship vai parar a execução do comando e exibe o alerta acima, esse é um comportamento esperado. Este limite de tempo é configurado usando a [chave](../config/#prompt) `command_timeout` então se você quiser você pode aumentar este limite. Você pode também seguir os passos para debugar para ver qual comando esta demorando e se você pode otimizar ele. Finalmente você pode definir a variável de ambiente `STARSHIP_LOG` para `error` para esconder estes alertas. ## Eu vejo símbolos que não entendo ou não esperado, o que isso significa? diff --git a/docs/pt-BR/guide/README.md b/docs/pt-BR/guide/README.md index 2113c713..f28401c8 100644 --- a/docs/pt-BR/guide/README.md +++ b/docs/pt-BR/guide/README.md @@ -40,11 +40,11 @@

- Site + Site · Instalação · - Configuração + Configuração

@@ -171,7 +171,7 @@ - **Fácil:**Instalação rápida – comece a usar em minutos.

-Consulte a documentação  ▶ +Consulte a documentação  ▶

@@ -431,10 +431,6 @@ Por favor, confira esses trabalhos anteriores que ajudaram a inspirar a criaçã Apoie este projeto [tornando-se um patrocinador](https://github.com/sponsors/starship). O seu nome ou logotipo aparecerá aqui com um link para o seu site. -**Rank de Apoiadores** - -- [Appwrite](https://appwrite.io/) -


Ícone de foguete do Starship diff --git a/docs/pt-BR/installing/README.md b/docs/pt-BR/installing/README.md index 8decd90d..9380f9a6 100644 --- a/docs/pt-BR/installing/README.md +++ b/docs/pt-BR/installing/README.md @@ -5,7 +5,7 @@ Para instalar o starship, você precisa de duas coisas: 1. O binário do **Starship** em seu computador 1. Altere seu shell para usar o binário do starship como seu prompt alterando os scripts init -Para a maioria dos usuários as instruções na [pagina principal](../guide/#🚀-installation) irá funcionar perfeitamente. No entanto para algumas plataformas mais especificas, instruções diferentes são necessárias. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. No entanto para algumas plataformas mais especificas, instruções diferentes são necessárias. Existem tantas plataformas que elas não cabem no arquivo README.md principal, então aqui estão algumas instruções de instalação para outras plataformas da comunidade. A sua não está aqui? Por favor, adicione-o aqui se você descobrir! diff --git a/docs/pt-PT/README.md b/docs/pt-PT/README.md index 5e34dbae..baeca74a 100644 --- a/docs/pt-PT/README.md +++ b/docs/pt-PT/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: The minimal, blazing-fast, and infinitely customizable prompt for any shell! actions: - - theme: brand + - + theme: brand text: Get Started → link: ./guide/ features: - - + - title: Compatibility First details: Works on the most common shells on the most common operating systems. Use it everywhere! - - + - title: Rust-Powered details: Brings the best-in-class speed and safety of Rust, to make your prompt as quick and reliable as possible. - - + - title: Customizable details: Every little detail is customizable to your liking, to make this prompt as minimal or feature-rich as you'd like it to be. footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship is the minimal, blazing fast, and extremely customizable prompt for any shell! Shows the information you need, while staying sleek and minimal. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -

- -
+ ### Prerequisites @@ -58,6 +57,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship is the minimal, blazing fast, and extremely customizable p ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/pt-PT/config/README.md b/docs/pt-PT/config/README.md index 328ab8c4..7b4f5106 100644 --- a/docs/pt-PT/config/README.md +++ b/docs/pt-PT/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Example | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | Example | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | Example | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Example +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/pt-PT/guide/README.md b/docs/pt-PT/guide/README.md index f567beea..29fbbb3c 100644 --- a/docs/pt-PT/guide/README.md +++ b/docs/pt-PT/guide/README.md @@ -40,11 +40,11 @@

- Website + Website · Installation · - Configuration + Configuration

@@ -171,7 +171,7 @@ - **Easy:** quick to install – start using it in minutes.

-Explore the Starship docs  ▶ +Explore the Starship docs  ▶

@@ -431,10 +431,6 @@ Please check out these previous works that helped inspire the creation of starsh Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/ru-RU/README.md b/docs/ru-RU/README.md index ef1da373..5f18a1f6 100644 --- a/docs/ru-RU/README.md +++ b/docs/ru-RU/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Минималистичное, быстрое и бесконечно настраиваемое приглашение командной строки для любой оболочки! actions: - - theme: brand + - + theme: brand text: Начало работы → link: ./guide/ features: - - + - title: Совместивость в первую очередь details: Работает на большинстве распространенных оболочек и наиболее распространенных операционных системах. Используйте везде! - - + - title: Основана на Rust details: Приносит наилучшую в своем классе скорость и безопасность Rust, чтобы сделать вашу оболочку как можно быстрее и надежнее. - - + - title: Настраиваемая details: Каждая маленькая деталь настраивается по вашему вкусу, чтобы сделать эту оболочку минималистичной или функциональной, как вы захотите. footer: Под лицензией ISC | Авторское право © 2019-настоящее Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship - минимальная, быстрая и бесконечная настраиваемая командная строка для любой оболочки! Показывает нужную вам информацию, оставаясь красивой и минималистичной. Быстрая установка доступна для Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, и PowerShell. --- -

- -
+ ### Обязательные условия @@ -58,6 +57,7 @@ description: Starship - минимальная, быстрая и бесконе ```sh brew install starship ``` + С помощью [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship - минимальная, быстрая и бесконе ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/ru-RU/config/README.md b/docs/ru-RU/config/README.md index 8abcb70e..a27a0257 100644 --- a/docs/ru-RU/config/README.md +++ b/docs/ru-RU/config/README.md @@ -158,7 +158,7 @@ line2 #### Строки стиля -В Starship, большинство модулей позволяют настроить стили отображения. Это делается записью (обычно называется `style`), которая представляет собой строку, определяющую конфигурацию. Ниже приведены несколько примеров стилей строк, а также, их действия. Подробнее о полном синтаксисе можно прочитать в [расширенном разделе конфигурации](../advanced-config/). +В Starship, большинство модулей позволяют настроить стили отображения. Это делается записью (обычно называется `style`), которая представляет собой строку, определяющую конфигурацию. Ниже приведены несколько примеров стилей строк, а также, их действия. 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 @@ -197,16 +197,16 @@ detect_extensions = ['ts', '!video.ts', '!audio.ts'] ### Опции -| Параметр | По умолчанию | Описание | -| ----------------- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [ссылка](#default-prompt-format) | Настройка форматирования оболочки. | +| Параметр | По умолчанию | Описание | +| ----------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [ссылка](#default-prompt-format) | Настройка форматирования оболочки. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Тайм-аут запуска сканирования файлов (в миллисекундах). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Тайм-аут запуска сканирования файлов (в миллисекундах). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Переменная | Описание | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - Текущий каталог содержит файл `.python-version` - Текущий каталог содержит файл `Pipfile` @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Опции + +| Параметр | По умолчанию | Описание | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | Стиль модуля. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Переменные + +| Переменная | Пример | Описание | +| ---------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| symbol | | Отражает значение параметра `symbol` | +| style\* | | Отражает значение параметра `style` | + +*: Эта переменная может использоваться только в качестве части строки style ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Переменные -| Переменная | Пример | Описание | -| ---------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Отражает значение параметра `symbol` | -| style\* | | Отражает значение параметра `style` | +| Переменная | Пример | Описание | +| ---------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Отражает значение параметра `symbol` | +| style\* | | Отражает значение параметра `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: Эта переменная может использоваться только в качестве части строки style @@ -4183,6 +4206,7 @@ By default, the module will be shown if any of the following conditions are met: - Текущий пользователь отличается от залогиненного - Пользователь подключен к SSH-сессии - Переменная `show_always` равна true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Опции -| Параметр | По умолчанию | Описание | -| ------------- | ----------------------- | ------------------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | Стиль, используемый для всех пользователей, кроме root. | -| `format` | `'[$user]($style) in '` | Формат модуля. | -| `show_always` | `false` | Всегда показывать модуль `username`. | -| `disabled` | `false` | Отключает модуль `username`. | +| Параметр | По умолчанию | Описание | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | Стиль, используемый для всех пользователей, кроме root. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | Формат модуля. | +| `show_always` | `false` | Всегда показывать модуль `username`. | +| `disabled` | `false` | Отключает модуль `username`. | ### Переменные @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Пример +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/ru-RU/guide/README.md b/docs/ru-RU/guide/README.md index a7614592..dbdf5b2d 100644 --- a/docs/ru-RU/guide/README.md +++ b/docs/ru-RU/guide/README.md @@ -40,11 +40,11 @@

- Сайт + Сайт · Установка · - Конфигурация + Конфигурация

@@ -171,7 +171,7 @@ - **Легкая:** быстрая установка - начните использовать ее в считанные минуты.

-Изучите документацию Starship  ▶ +Изучите документацию Starship  ▶

@@ -431,10 +431,6 @@ eval "$(starship init zsh)" Поддержите этот проект, [став спонсором](https://github.com/sponsors/starship). Ваше имя или логотип будут отображаться здесь со ссылкой на ваш сайт. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Иконка ракеты Starship diff --git a/docs/tr-TR/README.md b/docs/tr-TR/README.md index 6eeb9c5f..f7dac204 100644 --- a/docs/tr-TR/README.md +++ b/docs/tr-TR/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Sade, hızlı, dilediğiniz gibi özelleştirilebilen ve istenilen shell'de kullanılabilen prompt! actions: - - theme: brand + - + theme: brand text: Kullanmaya Başlayın → link: ./guide/ features: - - + - title: Önce Uyumluluk details: En yaygın işletim sistemlerindeki en yaygın shell'ler üzerinde çalışır. Use it everywhere! - - + - title: Rust-Powered details: Prompt'u mümkün olduğunca hızlı ve güvenilir hale getirmek için sınıfının en iyisi Rust hızını ve güvenliğini sağlar. - - + - title: Özelleştirilebilir details: Her küçük ayrıntı beğeninize göre özelleştirilebilir, böylece bu prompt'u istediğiniz kadar minimal veya zengin özelliklere sahip hale getirirsiniz. footer: ISC Lisanslı | Telif Hakkı © 2019-günümüz Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship, her prompt için minimal, son derece hızlı ve son derece özelleştirilebilir bir shelldir! Şık ve minimal kalırken ihtiyacınız olan bilgileri gösterir. Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd ve PowerShell için hızlı kurulum mevcuttur. --- -

- -
+ ### Ön koşullar @@ -58,6 +57,7 @@ description: Starship, her prompt için minimal, son derece hızlı ve son derec ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship, her prompt için minimal, son derece hızlı ve son derec ::: Nushell env dosyanızın sonuna aşağıdakileri ekleyin (Nushell'de `$nu.env-path` komutunu çalıştırarak bulabilirsiniz): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/tr-TR/advanced-config/README.md b/docs/tr-TR/advanced-config/README.md index 2a616245..9f00d7f2 100644 --- a/docs/tr-TR/advanced-config/README.md +++ b/docs/tr-TR/advanced-config/README.md @@ -137,7 +137,7 @@ echo "🚀" starship_precmd_user_func="fırlatıldı" ``` -- Özel bir işlemi başlatmadan hemen önce komut istemini çalıştırıp, [`DEBUG`filtreleme mekanizmasını](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/) kullanabilirsiniz. Bununla birlikte, Starship başlatılmadan hemen _önce_, DEBUG sinyalini filtrelemek **zorundasınız**! Starship, DEBUG filtrelemesinin ardından bazı değerleri içerisinde barındırabilir ancak filtreleme işlemi starship başlatıldıktan sonra yazılırsa bazı fonksiyonlar devre dışı kalabilir. +- Özel bir işlemi başlatmadan hemen önce komut istemini çalıştırıp, [`DEBUG`filtreleme mekanizmasını](https://jichu4n.com/posts/debug-trap-and-prompt_command-in-bash/) kullanabilirsiniz. Bununla birlikte, Starship başlatılmadan hemen _önce_, DEBUG sinyalini filtrelemek**zorundasınız.**! Starship, DEBUG filtrelemesinin ardından bazı değerleri içerisinde barındırabilir ancak filtreleme işlemi starship başlatıldıktan sonra yazılırsa bazı fonksiyonlar devre dışı kalabilir. ```bash function blastoff(){ diff --git a/docs/tr-TR/config/README.md b/docs/tr-TR/config/README.md index 96c40ec3..f4670b6b 100644 --- a/docs/tr-TR/config/README.md +++ b/docs/tr-TR/config/README.md @@ -197,16 +197,16 @@ This is the list of prompt-wide configuration options. ### Options -| Option | Default | Description | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | +| Option | Default | Description | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | Variable | Description | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Options + +| Option | Default | Description | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `stil` | `'bold #75AADB'` | The style for the module. | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Variables + +| Variable | Example | Description | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Variables -| Variable | Example | Description | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| Variable | Example | Description | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. The module will be shown if - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Options -| Option | Default | Description | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Option | Default | Description | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Variables @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Example +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/tr-TR/guide/README.md b/docs/tr-TR/guide/README.md index 7f639186..9b5ffd19 100644 --- a/docs/tr-TR/guide/README.md +++ b/docs/tr-TR/guide/README.md @@ -40,11 +40,11 @@

- Website + Website · Kurulum · - Yapılandırma + Yapılandırma

@@ -171,7 +171,7 @@ - **Kolay:** hızlı kurulum -  dakikalar içinde kullanmaya başla.

-Starship dokümantasyonunu incele   ▶ +Starship dokümantasyonunu incele   ▶

@@ -431,10 +431,6 @@ Lütfen starship'in oluşmasında ilham kaynağı olan çalışmalara da göz at Support this project by [becoming a sponsor](https://github.com/sponsors/starship). Your name or logo will show up here with a link to your website. -**Supporter Tier** - -- [Appwrite](https://appwrite.io/) -


Starship roket simgesi diff --git a/docs/tr-TR/installing/README.md b/docs/tr-TR/installing/README.md index bd3be65e..7164823a 100644 --- a/docs/tr-TR/installing/README.md +++ b/docs/tr-TR/installing/README.md @@ -5,7 +5,7 @@ Starship'i kurmak için, 2 şeye ihtiyacınız var: 1. **Starship** binary dosyalarını bilgisayarınıza alın 1. Kabuğunuza Starship binary scriptini kullanmasını söyleyin -Çoğu kullanıcı için, [ana sayfadaki](../guide/#🚀-installation) talimatlar gayet iyi çalışacaktır. Fakat, bazı özel platformlar için, farklı talimatlara ihtiyaç vardır. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. Fakat, bazı özel platformlar için, farklı talimatlara ihtiyaç vardır. Birçok platform var ki ana sisteme uymuyorlar. README.md belgesi ile diğer platformlar için bazı kurulum talimatları. Seninki burada değil mi? Anlarsan lütfen buraya ekle! diff --git a/docs/uk-UA/README.md b/docs/uk-UA/README.md index c654da98..e85fc1f0 100644 --- a/docs/uk-UA/README.md +++ b/docs/uk-UA/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Простий, супер швидкий та безмежно адаптивний командний рядок для будь-якої оболонки! actions: - - theme: brand + - + theme: brand text: Початок роботи → link: ./guide/ features: - - + - title: Сумісність на першому місці details: Працює з більшістю оболонок у всіх популярних операційних системах. Можна використовувати будь-де! - - + - title: Rust під капотом details: Використовує найкращу в класі швидкість та безпеку застосунків створених за допомогою Rust, що робить ваш командний рядок швидким та надійним. - - + - title: Персоналізація details: Кожна дрібничка налаштовується відповідно до ваших потреб, щоб зробити командний рядок аскетичним чи багатофункціональним, таким, яким ви б хотіли б його бачити. footer: Ліцензія ISC | Авторське право © 2019-по сьогодні Учасники Starship @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Простий, супер швидкий та безмежно адаптивний командний рядок для будь-якої оболонки! Показує потрібну інформацію залишаючись блискучим та мінімальним. Швидке встановлення доступне для Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd і PowerShell. --- -

- -
+ ### Вимоги @@ -58,6 +57,7 @@ description: Простий, супер швидкий та безмежно а ```sh brew install starship ``` + [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Простий, супер швидкий та безмежно а ::: Додайте наступне в кінець вашого файлу env (його можна знайти за допомогою змінної `$nu.env-path` в Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/uk-UA/advanced-config/README.md b/docs/uk-UA/advanced-config/README.md index a1e385e5..0550015e 100644 --- a/docs/uk-UA/advanced-config/README.md +++ b/docs/uk-UA/advanced-config/README.md @@ -223,7 +223,7 @@ Invoke-Expression (&starship init powershell) Деякі оболонки підтримують вивід командного рядка праворуч. Starship може встановити вміст правої частини командного рядка за допомогою параметра `right_format`. Будь-який модуль, який можна використовувати у `format`, також підтримується у `right_format`. Змінна `$all` міститиме лише модулі, які явно не використовується, а ні в `format`, а ні в `right_format`. -Примітка: командний рядок праворуч – це один рядок, що знаходиться праворуч у рядку вводу. Щоб вирівняти модулі праворуч над рядком введення в багаторядковому запиті, перегляньте модуль [`fill`](../config/#fill). +Примітка: командний рядок праворуч – це один рядок, що знаходиться праворуч у рядку вводу. Щоб вирівняти модулі праворуч над рядком введення в багаторядковому запиті, перегляньте [модуль `fill`](../config/#fill). `right_format` наразі підтримується для таких оболонок: elvish, fish, zsh, xonsh, cmd, nushell, bash. diff --git a/docs/uk-UA/config/README.md b/docs/uk-UA/config/README.md index 480aa197..6aec18e6 100644 --- a/docs/uk-UA/config/README.md +++ b/docs/uk-UA/config/README.md @@ -200,12 +200,12 @@ detect_extensions = ['ts', '!video.ts', '!audio.ts'] | Параметр | Стандартно | Опис | | ----------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `format` | [link](#default-prompt-format) | Налаштовує формат командного рядка. | -| `right_format` | `''` | Див [Увімкнути командний рядок праворуч](../advanced-config/#enable-right-prompt) | +| `right_format` | `''` | Дивіться [Увімкнути вивід праворуч](../advanced-config/#enable-right-prompt) | | `scan_timeout` | `30` | Тайм-аут для сканування файлів (у мілісекундах). | | `command_timeout` | `500` | Тайм-аут для команд, виконаних starship (у мілісекундах). | | `add_newline` | `true` | Вставити порожній рядок між командними рядками в оболонці. | | `palette` | `''` | Встановлює кольорову палітру використовуючи `palettes`. | -| `palettes` | `{}` | Колекція кольорових палітр, для призначення [кольорів](../advanced-config/#style-strings) до назв визначених користувачем. Зверніть увагу, що кольорові палітри не можуть посилатися на їх власні визначення кольору. | +| `palettes` | `{}` | Колекція колірних палітр, для призначення [кольорів](../advanced-config/#style-strings) до назв визначених користувачем. Зверніть увагу, що кольорові палітри не можуть посилатися на їх власні визначення кольору. | | `follow_symlinks` | `true` | Перевіряти символічні посилання чи вони посилаються на теки; використовується в таких модулях як git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ format = '[+$added]($added_style)/[-$deleted]($deleted_style) ' | Змінна | Опис | | -------------- | --------------------------------------------------------------------------------------------------- | -| `all_status` | Скорочення для `$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Скорочення для `$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Показує `diverged`, `ahead`, `behind` чи `up_to_date` в залежності від поточного стану репозиторію. | | `conflicted` | Показує `conflicted`, коли поточна гілка має конфлікт злиття. | | `untracked` | Показує `untracked` коли в робочій теці є файли що ще не включені до відстеження у репозиторії. | @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Показувати версію python з venv. -# -# Зауважте, що це працюватиме лише тоді, коли venv знаходиться всередині проєкту, і він працюватиме -# лише в теці, яка містить теку venv, якщо це нормально? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +Типово, модуль показується, якщо виконується будь-яка з наступних умов: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Параметри + +| Параметр | Стандартно | Опис | +| ------------------- | ------------------------------------ | ----------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Формат модуля. | +| `version_format` | `'v${raw}'` | Формат версії. Доступні змінні `raw`, `major`, `minor` та `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | Стиль модуля. | +| `detect_extensions` | `['.qmd']` | Які розширення повинні запускати цей модуль. | +| `detect_files` | `['_quarto.yml']` | Які імена файлів мають запускати цей модуль. | +| `detect_folders` | `[]` | В яких теках цей модуль має запускатись. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Змінні + +| Змінна | Приклад | Опис | +| --------- | --------- | ---------------------------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbol | | Віддзеркалює значення параметра `symbol` | +| style\* | | Віддзеркалює значення параметра `style` | + +*: Ця змінна може бути використана лише як частина стилю рядка ## R @@ -3584,11 +3606,12 @@ Starship отримує поточну версію Ruby командою `ruby ### Змінні -| Змінна | Приклад | Опис | -| --------- | -------- | ---------------------------------------- | -| version | `v2.5.1` | Версія `ruby` | -| symbol | | Віддзеркалює значення параметра `symbol` | -| style\* | | Віддзеркалює значення параметра `style` | +| Змінна | Приклад | Опис | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | Версія `ruby` | +| symbol | | Віддзеркалює значення параметра `symbol` | +| style\* | | Віддзеркалює значення параметра `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: Ця змінна може бути використана лише як частина стилю рядка @@ -4183,6 +4206,7 @@ time_range = '10:00:00-14:00:00' - Поточний користувач не є таким же, як той, який увійшов до системи - Користувач зараз підключений через SSH - Змінна `show_always` встановлена в true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ time_range = '10:00:00-14:00:00' ### Параметри -| Параметр | Стандартно | Опис | -| ------------- | ----------------------- | ---------------------------------------------------------- | -| `style_root` | `'bold red'` | Стиль, який використовується коли користувач є root/admin. | -| `style_user` | `'bold yellow'` | Стиль для звичайних користувачів. | -| `format` | `'[$user]($style) in '` | Формат модуля. | -| `show_always` | `false` | Завжди показувати модуль `username`. | -| `disabled` | `false` | Вимикає модуль `username`. | +| Параметр | Стандартно | Опис | +| ----------------- | ----------------------- | ---------------------------------------------------------- | +| `style_root` | `'bold red'` | Стиль, який використовується коли користувач є root/admin. | +| `style_user` | `'bold yellow'` | Стиль для звичайних користувачів. | +| `detect_env_vars` | `[]` | Які змінні середовища повинні запускати цей модуль. | +| `format` | `'[$user]($style) in '` | Формат модуля. | +| `show_always` | `false` | Завжди показувати модуль `username`. | +| `disabled` | `false` | Вимикає модуль `username`. | ### Змінні @@ -4209,6 +4234,8 @@ time_range = '10:00:00-14:00:00' ### Приклад +#### Завжди показувати hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Приховувати hostname для віддалених сеансів tmux + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant Модуль `vagrant` показує поточну встановлену версію [Vagrant](https://www.vagrantup.com/). Типово, модуль показується, якщо виконується будь-яка з наступних умов: diff --git a/docs/uk-UA/faq/README.md b/docs/uk-UA/faq/README.md index 613db64d..8a3f5f2d 100644 --- a/docs/uk-UA/faq/README.md +++ b/docs/uk-UA/faq/README.md @@ -58,7 +58,7 @@ curl -sS https://starship.rs/install.sh | sh -s -- --platform unknown-linux-musl ## Чому я бачу попередження `Executing command "..." timed out.`? -Starship виконує різні команди, щоб отримати інформацію для показу в командному рядку, наприклад версію програми або поточного статусу git. Щоб переконатися, що starship не підвис, намагаючись виконати ці команди, ми встановлюємо ліміт, якщо виконання команди займе більше часу, starship зупинить виконання команди та видасть попередження, це очікувана поведінка. Цей ліміт часу можна налаштувати за допомогою [ ключа `command_timeout`](../config/#prompt), так що, якщо ви хочете, ви можете збільшити ліміт часу. Ви можете також виконати дії для відлагодження, щоб побачити, яка команда є повільною і подивитися, чи ви можете її оптимізувати. Нарешті ви можете встановити `STARSHIP_LOG` у `error`, щоб приховати ці попередження. +Starship виконує різні команди, щоб отримати інформацію для показу в командному рядку, наприклад версію програми або поточного статусу git. Щоб переконатися, що starship не підвис, намагаючись виконати ці команди, ми встановлюємо ліміт, якщо виконання команди займе більше часу, starship зупинить виконання команди та видасть попередження, це очікувана поведінка. Цей ліміт часу можна налаштувати за допомогою [ключа `command_timeout`](../config/#prompt), так що, якщо ви хочете, ви можете збільшити ліміт часу. Ви можете також виконати дії для відлагодження, щоб побачити, яка команда є повільною і подивитися, чи ви можете її оптимізувати. Нарешті ви можете встановити `STARSHIP_LOG` у `error`, щоб приховати ці попередження. ## Я бачу якісь символи, але не розумію, що вони значать? diff --git a/docs/uk-UA/guide/README.md b/docs/uk-UA/guide/README.md index 377de794..064539c7 100644 --- a/docs/uk-UA/guide/README.md +++ b/docs/uk-UA/guide/README.md @@ -40,11 +40,11 @@

- Вебсайт + Вебсайт · Встановлення · - Налаштування + Налаштування

@@ -171,7 +171,7 @@ - **Простий:** швидка інсталяція дозволяє почати роботу за лічені хвилини.

-Ознайомтесь з документацією Starship   ▶ +Ознайомтесь з документацією Starship   ▶

@@ -431,10 +431,6 @@ eval "$(starship init zsh)" Підтримайте цей проєкт [ставши спонсором](https://github.com/sponsors/starship). Ваше імʼя або логотип показуватимуться тут з посиланням на ваш сайт. -**Підтримувачі** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/vi-VN/README.md b/docs/vi-VN/README.md index 34321796..8a62c9de 100644 --- a/docs/vi-VN/README.md +++ b/docs/vi-VN/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: Nhỏ gọn, cực nhanh, và khả năng tuỳ chỉnh vô hạn prompt cho bất kì shell nào! actions: - - theme: brand + - + theme: brand text: Bắt đầu → link: ./guide/ features: - - + - title: Khả năng tương thích details: Những công việc trên đa số các shell phổ biến trên đa số các hệ điều hành phổ biến. Sử dụng nó ở mọi nơi! - - + - title: Sức mạnh của Rust details: Mang lại tốc độ và độ an toàn tốt nhất của Rust, giúp prompt của bạn thực thi nhanh chóng và đáng tin cậy nhất có thể. - - + - title: Khả năng tuỳ biến details: Mọi chi tiết nhỏ được tuỳ biến theo ý thích của bạn, giúp prompt này nhỏ nhất có thể hoặc phong phú về tính năng như bạn muốn. footer: Cấp phép bởi ISC | Bản quyền © 2019-nay Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship: Cross-Shell Prompt" description: Starship là prompt nhỏ, cực nhanh, và khả năng tuỳ biến mạnh mẽ cho bất kì shell nào! Hiển thị thông tin bạn cần, trong khi vẫn giữ cho đẹp và nhỏ gọn. Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -

- -
+ ### Yêu cầu @@ -58,6 +57,7 @@ description: Starship là prompt nhỏ, cực nhanh, và khả năng tuỳ biế ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship là prompt nhỏ, cực nhanh, và khả năng tuỳ biế ::: Thêm đoạn code dưới đây vào cuối file Nushell env của bạn (Bạn có thể tìm đường dẫn tới file Nushell env bằng cách chạy `$nu.env-path` trong Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/vi-VN/config/README.md b/docs/vi-VN/config/README.md index 6b9435b3..714edc02 100644 --- a/docs/vi-VN/config/README.md +++ b/docs/vi-VN/config/README.md @@ -158,7 +158,7 @@ Ví dụ: #### Các chuỗi kiểu -Đa số các module trong starship cho phép bạn cấu hình kiểu hiển thị của chúng. This is done with an entry (thường được gọi là `kiểu`) cái là một cuỗi cấu hình đặc biệt. Đây là vài ví dụ của các chuỗi kiểu cũng với những gì chúng làm. Cú pháp chi tiết đầy đủ, tham khảo [hướng dẫn cấu hình nâng cao](../advanced-config/). +Đa số các module trong starship cho phép bạn cấu hình kiểu hiển thị của chúng. This is done with an entry (thường được gọi là `kiểu`) cái là một cuỗi cấu hình đặc biệt. Đây là vài ví dụ của các chuỗi kiểu cũng với những gì chúng làm. 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 @@ -197,16 +197,16 @@ Cái này là danh sách các tuỳ chọn cho cấu hình prompt-wide. ### Các tuỳ chọn -| Tuỳ chọn | Mặc định | Mô tả | -| ----------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [link](#default-prompt-format) | Cấu hình định dạng của prompt. | +| Tuỳ chọn | Mặc định | Mô tả | +| ----------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [link](#default-prompt-format) | Cấu hình định dạng của prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout của starship cho việc quét các tập tin (tính theo milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Chèn dòng trắng giữa các dấu nhắc lệnh. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout của starship cho việc quét các tập tin (tính theo milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Chèn dòng trắng giữa các dấu nhắc lệnh. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ Các biến dưới đây có thể được sử dụng trong `format`: | Biến | Mô tả | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut cho `$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Hiển thị `conflicted` khi nhánh này có merge conflicts. | | `untracked` | Hiển thị `untracked` khi có tệp tin untracked trong thư mục làm việc. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: +By default, the module will be shown if any of the following conditions are met: - The current directory contains a `.python-version` file - The current directory contains a `Pipfile` file @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### Các tuỳ chọn + +| Tuỳ chọn | Mặc định | Mô tả | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | Định dạng cho module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | Kiểu cho module. | +| `detect_extensions` | `['.qmd']` | Những tiện ích mở rộng nào sẽ kích hoạt mô-đun này. | +| `detect_files` | `['_quarto.yml']` | Những tên tệp nào sẽ kích hoạt mô-đun này. | +| `detect_folders` | `[]` | Những thư mục nào sẽ kích hoạt mô-đun này. | +| `disabled` | `false` | Disables the `quarto` module. | + +### Các biến + +| Biến | Ví dụ | Mô tả | +| --------- | --------- | -------------------------------- | +| version | `1.4.549` | The version of `quarto` | +| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | +| style\* | | Giá trị ghi đè của `style` | + +*: Biến này có thể chỉ được sử dụng như một phần của style string ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### Các biến -| Biến | Ví dụ | Mô tả | -| --------- | -------- | -------------------------------- | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | -| style\* | | Giá trị ghi đè của `style` | +| Biến | Ví dụ | Mô tả | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Giá trị ghi đè tuỳ chọn `symbol` | +| style\* | | Giá trị ghi đè của `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: Biến này có thể chỉ được sử dụng như một phần của style string @@ -4183,6 +4206,7 @@ The `username` module shows active user's username. Module cho sẽ được hi - The current user isn't the same as the one that is logged in - The user is currently connected as an SSH session - The variable `show_always` is set to true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Các tuỳ chọn -| Tuỳ chọn | Mặc định | Mô tả | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | The style used for non-root users. | -| `format` | `'[$user]($style) in '` | Định dạng cho module. | -| `show_always` | `false` | Always shows the `username` module. | -| `disabled` | `false` | Disables the `username` module. | +| Tuỳ chọn | Mặc định | Mô tả | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | The style used for non-root users. | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | Định dạng cho module. | +| `show_always` | `false` | Always shows the `username` module. | +| `disabled` | `false` | Disables the `username` module. | ### Các biến @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### Ví dụ +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). Mặc định module sẽ được hiển thị nếu có bất kì điều kiện nào dưới đây thoả mãn: diff --git a/docs/vi-VN/guide/README.md b/docs/vi-VN/guide/README.md index 13a31929..c965df40 100644 --- a/docs/vi-VN/guide/README.md +++ b/docs/vi-VN/guide/README.md @@ -40,11 +40,11 @@

- Website + Website · Cài đặt · - Cấu hình + Cấu hình

@@ -171,7 +171,7 @@ - **Dễ dàng:** cài đặt nhanh chóng – bắt đầu sử dụng nó trong vài phút.

-Khám phá tài liệu của Starship  ▶ +Khám phá tài liệu của Starship  ▶

@@ -431,10 +431,6 @@ Xin hãy xem qua những công việc này trước đây, những thứ đã gi Hỗ trợ project này bằng việc [trở thành nhà tài trợ](https://github.com/sponsors/starship). Tên hoặc logo của nhà tài trợ sẽ được hiển thị với một liên kết dẫn tới trang web của họ. -**Nhà tài trợ ủng hộ** - -- [Appwrite](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/vi-VN/installing/README.md b/docs/vi-VN/installing/README.md index fed17391..e7b26d43 100644 --- a/docs/vi-VN/installing/README.md +++ b/docs/vi-VN/installing/README.md @@ -5,7 +5,7 @@ 1. Lấy tệp tin **starship** nhị phân về máy tính của bạn 1. Nói với shell của bạn để sử dụng tệp tin starship nhị phân như là prompt của nó bằng việc chỉnh sửa những đoạn mã khởi tạo của nó -Đối với đa số người dùng, các hướng dẫn trên [trang chính](../guide/#🚀-installation) sẽ làm việc tốt. Tuy nhiên, với một vài nền tảng đặc biệt hơn, các hướng dẫn khác nhau là cần thiết. +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. Tuy nhiên, với một vài nền tảng đặc biệt hơn, các hướng dẫn khác nhau là cần thiết. Có rất nhiều nền tảng bên ngoài, rằng chúng đã không khớp như trong tệp tin README.md, do đó đây là vài hướng dẫn cài đặt cho những nền tảng khác đến từ cộng đồng. Của bạn không có ở đây? Xin hãy thêm nó vào đây nếu bạn tìm ra nó! diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index 3a01b614..ec91c61a 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: 轻量、迅速、客制化的高颜值终端！ actions: - - theme: brand + - + theme: brand text: 快速上手 → link: ./guide/ features: - - + - title: 兼容性优先 details: Starship 可以在常见的操作系统和 shell 上运行。 尝试着在各种地方使用它吧！ - - + - title: 基于 Rust details: Rust 特有的的速度与安全性，让你的提示尽可能的快速可靠。 - - + - title: 客制化 details: 每个小细节都可以按您喜欢的客制化，不论是最小化以求速度，还是更大以获得最完善的功能。 footer: ISC 许可 | 版权所有 © 2019至今 - Starship 贡献者 @@ -24,12 +25,10 @@ metaTitle: "Starship：可用于各种 Shell 的提示符" description: Starship是一款轻量、迅速、可客制化的高颜值终端！ 只显示所需要的信息，将优雅和轻量化合二为一。 可以为Bash、Fish、ZSH、Ion、Tcsh、Elvish、Nu、Xonsh、Cmd和PowerShell执行快速安装。 --- -

- -
+ ### 前置要求 @@ -58,6 +57,7 @@ description: Starship是一款轻量、迅速、可客制化的高颜值终端 ```sh brew install starship ``` + 使用 [ Winget](https://github.com/microsoft/winget-cli)： ```powershell @@ -157,6 +157,7 @@ description: Starship是一款轻量、迅速、可客制化的高颜值终端 ::: 在您的 Nushell 环境文件的最后（使用 `$nu.env-path` 来获取它的路径），添加以下内容： + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/zh-CN/advanced-config/README.md b/docs/zh-CN/advanced-config/README.md index 79d6118a..45598936 100644 --- a/docs/zh-CN/advanced-config/README.md +++ b/docs/zh-CN/advanced-config/README.md @@ -223,7 +223,7 @@ Invoke-Expression (&starship init powershell) 一些 Shell 支持右侧提示, 它与输入区渲染在同一行。 使用 `right_format` 选项来设置 Starship 的右侧提示。 所有支持 `format` 的组件也同时支持 `right_format`。 未显式在 `format` 或 `right_format` 中使用的组件，会保存在变量 `$all` 中。 -注意：右侧提示和输入区显示在同一行。 如果需要在输入区的上方显示右对齐的组件，请查阅 [`fill` 组件](../config/#fill)。 +注意：右侧提示和输入区显示在同一行。 To right align modules above the input line in a multi-line prompt, see the [`fill` module](../config/#fill). `right_format` is currently supported for the following shells: elvish, fish, zsh, xonsh, cmd, nushell, bash. diff --git a/docs/zh-CN/config/README.md b/docs/zh-CN/config/README.md index 39dd985a..e2c0110b 100644 --- a/docs/zh-CN/config/README.md +++ b/docs/zh-CN/config/README.md @@ -17,7 +17,7 @@ add_newline = true # 将提示符中的 '❯' 替换为 '➜' [character] # 此组件名称为 'character' -success_symbol = '[➜](bold green)' # 将 'success_symbol' 字段设置成颜色为 'bold green' 的 '➜' +success_symbol = '[➜](bold green)' # 将 'success_symbol' 字段设置成颜色为 'bold green' 的 '➜' # 禁用 'package' 组件，将其隐藏 [package] @@ -158,7 +158,7 @@ line2 #### 样式字符串 -Starship 中的大多数组件允许您为其设置显示样式。 显示样式可以通过一个字符串字段（一般是 `style`）来设置。 以下的例子给出了一些样式字符串并描述了它们的效果。 样式字符串的完整语法请查阅 [高级配置指南](../advanced-config/)。 +Starship 中的大多数组件允许您为其设置显示样式。 显示样式可以通过一个字符串字段（一般是 `style`）来设置。 以下的例子给出了一些样式字符串并描述了它们的效果。 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 @@ -197,16 +197,16 @@ detect_extensions = ['ts', '!video.ts', '!audio.ts'] ### 配置项 -| 选项 | 默认值 | 描述 | -| ----------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [见下文](#default-prompt-format) | 配置提示符的格式。 | +| 选项 | 默认值 | 描述 | +| ----------------- | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [见下文](#default-prompt-format) | 配置提示符的格式。 | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Starship 扫描文件的超时时间（单位：毫秒）。 | -| `command_timeout` | `500` | Startship 执行命令的超时时间（单位：毫秒）。 | -| `add_newline` | `true` | 在 shell 提示符之间插入空行。 | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Starship 扫描文件的超时时间（单位：毫秒）。 | +| `command_timeout` | `500` | Startship 执行命令的超时时间（单位：毫秒）。 | +| `add_newline` | `true` | 在 shell 提示符之间插入空行。 | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | 字段 | 描述 | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww 如果`pyenv_version_name`被设置为`true`, 本组件将会展示pyenv版本名。 否则则显示通过`python --version`获得的版本号 -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - 当前目录包含 `.python-version` 文件 - 当前目录包含 `Pipfile` 文件 @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### 配置项 + +| 选项 | 默认值 | 描述 | +| ------------------- | ------------------------------------ | ------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | 组件格式化模板。 | +| `version_format` | `'v${raw}'` | 版本格式 可用的有 `raw`, `major`, `minor` 和 `patch` | +| `符号` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | 此组件的样式。 | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | 哪些文件应触发此组件 | +| `detect_folders` | `[]` | 那些文件夹应该触发此组件 | +| `disabled` | `false` | Disables the `quarto` module. | + +### 变量 + +| 字段 | 示例 | 描述 | +| --------- | --------- | ----------------------- | +| version | `1.4.549` | The version of `quarto` | +| 符号 | | `symbol`对应值 | +| style\* | | `style`对应值 | + +*: 此变量只能作为样式字符串的一部分使用 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### 变量 -| 字段 | 示例 | 描述 | -| --------- | -------- | --------------------- | -| version | `v2.5.1` | The version of `ruby` | -| 符号 | | `symbol`对应值 | -| style\* | | `style`对应值 | +| 字段 | 示例 | 描述 | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| 符号 | | `symbol`对应值 | +| style\* | | `style`对应值 | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: 此变量只能作为样式字符串的一部分使用 @@ -4183,6 +4206,7 @@ By default, the module will be shown if any of the following conditions are met: - 当前用户与登录用户不相同 - 用户正通过 SSH 会话连接访问 - 字段 `show_always` 被设置为 true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### 配置项 -| 选项 | 默认值 | 描述 | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | 非 root 用户使用的样式。 | -| `format` | `'[$user]($style) in '` | 组件格式化模板。 | -| `show_always` | `false` | 总是显示 `username` 组件。 | -| `disabled` | `false` | 禁用 `username` 组件。 | +| 选项 | 默认值 | 描述 | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | 非 root 用户使用的样式。 | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | 组件格式化模板。 | +| `show_always` | `false` | 总是显示 `username` 组件。 | +| `disabled` | `false` | 禁用 `username` 组件。 | ### 变量 @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### 示例 +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/zh-CN/guide/README.md b/docs/zh-CN/guide/README.md index 663d4538..e3c9985b 100644 --- a/docs/zh-CN/guide/README.md +++ b/docs/zh-CN/guide/README.md @@ -40,11 +40,11 @@

- 网站 + 网站 · 安装 · - 配置 + 配置

@@ -171,7 +171,7 @@ - **易用：** 安装快速 —— 几分钟就可上手。

-探索 Starship 文档 +探索 Starship 文档

@@ -431,10 +431,6 @@ eval "$(starship init zsh)" 通过 [成为赞助商 ](https://github.com/sponsors/starship)来支持这个项目。 您的名字或 LOGO 将在此处显示，并链接到您的网站。 -**支持者级别** - -- [Appwrite](https://appwrite.io/) -


Starship 图标 diff --git a/docs/zh-CN/installing/README.md b/docs/zh-CN/installing/README.md index 2d40cdbc..2d7c7a2a 100644 --- a/docs/zh-CN/installing/README.md +++ b/docs/zh-CN/installing/README.md @@ -5,7 +5,7 @@ 1. 下载 **Starship** 的可执行文件 1. 修改 shell 的初始化脚本，将 Starship 设置为命令提示符 -大部分用户按照[主页](../guide/#🚀-installation)上的步骤安装即可， 但有一些特殊系统上的安装步骤不同。 +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. 但有一些特殊系统上的安装步骤不同。 现有平台众多，README 中无法全部展示，所以这里是社区中对其他平台 的一些安装说明。 找不到你的平台？ 如果你知道怎么安装，请添加到这里！ diff --git a/docs/zh-TW/README.md b/docs/zh-TW/README.md index 938cf435..74ab5271 100644 --- a/docs/zh-TW/README.md +++ b/docs/zh-TW/README.md @@ -2,20 +2,21 @@ layout: home hero: image: /logo.svg - text: null + text: tagline: 適合任何 shell 的最小、極速、無限客製化的提示字元！ actions: - - theme: brand + - + theme: brand text: 馬上開始 → link: ./guide/ features: - - + - title: 相容性優先 details: 能夠在最常見的作業系統之中最常見的 shell 上運作。 在各處使用它吧！ - - + - title: 以 Rust 開發 details: 帶來同類中最快的速度以及 Rust 的安全性，讓你的提示字元盡可能快速與可靠。 - - + - title: 可客製化 details: 任何些微的細節都可以隨你喜愛地客製化，讓你的提示字元可以隨你所欲地最小化或是充滿各種特色。 footer: ISC Licensed | Copyright © 2019-present Starship Contributors @@ -24,12 +25,10 @@ metaTitle: "Starship：跨 Shell 提示字元" description: Starship 是適合任何 shell 的最小、極速、高度客製化的提示字元！ 顯示你需要的訊息，同時保持順暢與最小化。 Quick installation available for Bash, Fish, ZSH, Ion, Tcsh, Elvish, Nu, Xonsh, Cmd, and PowerShell. --- -

- -
+ ### 先決要求 @@ -58,6 +57,7 @@ description: Starship 是適合任何 shell 的最小、極速、高度客製化 ```sh brew install starship ``` + With [Winget](https://github.com/microsoft/winget-cli): ```powershell @@ -157,6 +157,7 @@ description: Starship 是適合任何 shell 的最小、極速、高度客製化 ::: Add the following to the end of your Nushell env file (find it by running `$nu.env-path` in Nushell): + ```sh mkdir ~/.cache/starship starship init nu | save -f ~/.cache/starship/init.nu diff --git a/docs/zh-TW/config/README.md b/docs/zh-TW/config/README.md index 20511fc8..95576ec6 100644 --- a/docs/zh-TW/config/README.md +++ b/docs/zh-TW/config/README.md @@ -158,7 +158,7 @@ In the second part, which is enclosed in a `()`, is a [style string](#style-stri #### 風格字串 -Starship 內大多數的模組允許你設定他們的顯示風格。 這要透過一個條目 (通常叫做 `style`)，這個條目使用一個字串來進行設定。 這裡給幾個風格字串的例子，以及這些字串的功用。 對於完整語法的詳細說明，請參照 [進階設定指南](../advanced-config/)。 +Starship 內大多數的模組允許你設定他們的顯示風格。 這要透過一個條目 (通常叫做 `style`)，這個條目使用一個字串來進行設定。 這裡給幾個風格字串的例子，以及這些字串的功用。 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 @@ -197,16 +197,16 @@ detect_extensions = ['ts', '!video.ts', '!audio.ts'] ### 選項 -| 選項 | 預設 | 說明 | -| ----------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `format` | [連結](#default-prompt-format) | Configure the format of the prompt. | +| 選項 | 預設 | 說明 | +| ----------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `format` | [連結](#default-prompt-format) | Configure the format of the prompt. | | `right_format` | `''` | See [Enable Right Prompt](../advanced-config/#enable-right-prompt) | -| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | -| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | -| `add_newline` | `true` | Inserts blank line between shell prompts. | -| `palette` | `''` | Sets which color palette from `palettes` to use. | +| `scan_timeout` | `30` | Timeout for starship to scan files (in milliseconds). | +| `command_timeout` | `500` | Timeout for commands executed by starship (in milliseconds). | +| `add_newline` | `true` | Inserts blank line between shell prompts. | +| `palette` | `''` | Sets which color palette from `palettes` to use. | | `palettes` | `{}` | Collection of color palettes that assign [colors](../advanced-config/#style-strings) to user-defined names. Note that color palettes cannot reference their own color definitions. | -| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | +| `follow_symlinks` | `true` | Follows symlinks to check if they're directories; used in modules such as git. | ::: tip @@ -300,6 +300,7 @@ $php\ $pulumi\ $purescript\ $python\ +$quarto\ $raku\ $rlang\ $red\ @@ -1888,7 +1889,7 @@ The following variables can be used in `format`: | 變數 | 說明 | | -------------- | ------------------------------------------------------------------------------------------------------------- | -| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$staged$untracked` | +| `all_status` | Shortcut for`$conflicted$stashed$deleted$renamed$modified$typechanged$staged$untracked` | | `ahead_behind` | Displays `diverged`, `ahead`, `behind` or `up_to_date` format string based on the current status of the repo. | | `conflicted` | Displays `conflicted` when this branch has merge conflicts. | | `untracked` | Displays `untracked` when there are untracked files in the working directory. | @@ -3356,7 +3357,7 @@ The `python` module shows the currently installed version of [Python](https://ww If `pyenv_version_name` is set to `true`, it will display the pyenv version name. Otherwise, it will display the version number from `python --version`. -By default the module will be shown if any of the following conditions are met: +By default, the module will be shown if any of the following conditions are met: - 目前資料夾中有一個 `.python-version` 檔案 - 目前資料夾中有一個 `Pipfile` 檔案 @@ -3428,16 +3429,37 @@ python_binary = 'python3' detect_extensions = [] ``` -```toml -# ~/.config/starship.toml +## Quarto -[python] -# Display the version of python from inside a local venv. -# -# Note this will only work when the venv is inside the project and it will only -# work in the directory that contains the venv dir but maybe this is ok? -python_binary = ['./venv/bin/python', 'python', 'python3', 'python2'] -``` +The `quarto` module shows the current installed version of Quarto used in a project. + +By default, the module will be shown if any of the following conditions are met: + +- The current directory contains a `_quarto.yml` file +- The current directory contains any `*.qmd` file + +### 選項 + +| 選項 | 預設 | 說明 | +| ------------------- | ------------------------------------ | ------------------------------------------------------------------------- | +| `format` | `'via [$symbol($version )]($style)'` | The format for the module. | +| `version_format` | `'v${raw}'` | The version format. Available vars are `raw`, `major`, `minor`, & `patch` | +| `symbol` | `'⨁ '` | A format string representing the symbol of Quarto | +| `style` | `'bold #75AADB'` | 這個模組的風格。 | +| `detect_extensions` | `['.qmd']` | Which extensions should trigger this module. | +| `detect_files` | `['_quarto.yml']` | Which filenames should trigger this module. | +| `detect_folders` | `[]` | Which folders should trigger this module. | +| `disabled` | `false` | Disables the `quarto` module. | + +### 變數 + +| 變數 | 範例 | 說明 | +| --------- | --------- | ------------------------------------ | +| version | `1.4.549` | The version of `quarto` | +| 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 ## R @@ -3584,11 +3606,12 @@ Starship gets the current Ruby version by running `ruby -v`. ### 變數 -| 變數 | 範例 | 說明 | -| --------- | -------- | ------------------------------------ | -| version | `v2.5.1` | The version of `ruby` | -| symbol | | Mirrors the value of option `symbol` | -| style\* | | Mirrors the value of option `style` | +| 變數 | 範例 | 說明 | +| --------- | -------- | ------------------------------------------- | +| version | `v2.5.1` | The version of `ruby` | +| symbol | | Mirrors the value of option `symbol` | +| style\* | | Mirrors the value of option `style` | +| gemset | `test` | Optional, gets the current RVM gemset name. | *: This variable can only be used as a part of a style string @@ -4183,6 +4206,7 @@ By default, the module will be shown if any of the following conditions are met: - 目前使用者並非登入時的使用者 - 使用者透過 SSH session 進行連線 - 變數 `show_always` 被設為 true +- The array `detect_env_vars` contains at least the name of one environment variable, that is set ::: tip @@ -4192,13 +4216,14 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### 選項 -| 選項 | 預設 | 說明 | -| ------------- | ----------------------- | ------------------------------------------- | -| `style_root` | `'bold red'` | The style used when the user is root/admin. | -| `style_user` | `'bold yellow'` | 非 root 使用者時使用的風格。 | -| `format` | `'[$user]($style) in '` | The format for the module. | -| `show_always` | `false` | 總是顯示 `username` 模組。 | -| `disabled` | `false` | 停用 `username` 模組。 | +| 選項 | 預設 | 說明 | +| ----------------- | ----------------------- | --------------------------------------------------------- | +| `style_root` | `'bold red'` | The style used when the user is root/admin. | +| `style_user` | `'bold yellow'` | 非 root 使用者時使用的風格。 | +| `detect_env_vars` | `[]` | Which environment variable(s) should trigger this module. | +| `format` | `'[$user]($style) in '` | The format for the module. | +| `show_always` | `false` | 總是顯示 `username` 模組。 | +| `disabled` | `false` | 停用 `username` 模組。 | ### 變數 @@ -4209,6 +4234,8 @@ SSH connection is detected by checking environment variables `SSH_CONNECTION`, ` ### 範例 +#### Always show the hostname + ```toml # ~/.config/starship.toml @@ -4220,6 +4247,17 @@ disabled = false show_always = true ``` +#### Hide the hostname in remote tmux sessions + +```toml +# ~/.config/starship.toml + +[hostname] +ssh_only = false +detect_env_vars = ['!TMUX', 'SSH_CONNECTION'] +disabled = false +``` + ## Vagrant The `vagrant` module shows the currently installed version of [Vagrant](https://www.vagrantup.com/). By default the module will be shown if any of the following conditions are met: diff --git a/docs/zh-TW/guide/README.md b/docs/zh-TW/guide/README.md index b0964761..f1d2ec26 100644 --- a/docs/zh-TW/guide/README.md +++ b/docs/zh-TW/guide/README.md @@ -40,11 +40,11 @@

- 網站 + 網站 · 安裝 · - 設定 + 設定

@@ -171,7 +171,7 @@ - **易用：**安裝快速 – 幾分鐘內即可開始使用。

-探索 Starship 文件  ▶ +探索 Starship 文件  ▶

@@ -431,10 +431,6 @@ eval "$(starship init zsh)" 你可以[成爲一個贊助者](https://github.com/sponsors/starship)來支持這個專案！ 你的名字和頭像會在這裏顯示，並且會帶有一個前往你網站的鏈接。 -**贊助者等級** - -- [後端](https://appwrite.io/) -


Starship rocket icon diff --git a/docs/zh-TW/installing/README.md b/docs/zh-TW/installing/README.md index bc8a6cad..2cb44861 100644 --- a/docs/zh-TW/installing/README.md +++ b/docs/zh-TW/installing/README.md @@ -5,7 +5,7 @@ 1. 下載 **starship** 執行檔到你的電腦裡 1. 修改 shell 的初始化腳本，讓其使用 starship 作為提示字元 -對大部分的使用者來說，在[主頁面](../guide/#🚀-installation)的安裝指引皆足以正常運作。 然而，對於一些較特別的平台，我們需要不同的安裝指引。 +For most users, the instructions on [the main page](../guide/#🚀-installation) will work great. 然而，對於一些較特別的平台，我們需要不同的安裝指引。 有太多平台不適用於主要的 README.md 檔案了，所以這裡有一些來自社群的其他平台的安裝指引。 你的平台不在這裡嗎？ 如果你找出怎麼安裝，請幫我們加上你的指引！