Toolbox v19 update (#1072)

<!-- 🚀 Thank you for contributing! -->
This PR updates the documentation to the latest version of Vapor
Toolbox, which added Linux distribution via Homebrew and removed some
deprecated commands
<!-- Describe your changes clearly and use examples if possible. -->

<!-- When this PR is merged, the title and body will be -->
<!-- used to generate a release automatically. -->

---------

Co-authored-by: Tim Condon <0xTim@users.noreply.github.com>
This commit is contained in:
Francesco Paolo Severino 2025-03-18 19:26:23 +01:00 committed by GitHub
parent fe2ba1d320
commit 1585a83d0b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
13 changed files with 97 additions and 55 deletions

View File

@ -18,15 +18,11 @@
Für den Fall, dass du den Pfad zu deinem Projekt nicht kennst, kannst du mit Hilfe des Terminal-Befehls 'pwd' den Pfad ganz einfach herausfinden.
```
# verify we are in vapor project folder
vapor --version
```sh
# get path to this folder
pwd
```
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -28,9 +28,7 @@ En el editor de esquemas, elige la acción _App_ y la pestaña _Options_. Selecc
Puedes obtener la dirección completa a la raíz de tu proyecto ejecutando `pwd` en una ventana de terminal ubicada en el proyecto.
```fish
# verificar que estamos en la carpeta del proyecto de vapor
vapor --version
```sh
# obtener la dirección de la carpeta
pwd
```
@ -38,7 +36,5 @@ pwd
Deberías obtener una salida similar a la que se muestra a continuación.
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -28,9 +28,7 @@ Nell'editor dello schema, scegliere l'azione _App_ e la scheda _Options_. Selezi
Si può ottenere il percorso completo alla cartella principale del progetto eseguendo `pwd` da una finestra del terminale aperta lì.
```fish
# verificare di essere nella cartella del progetto vapor
vapor --version
```sh
# ottenere il percorso di questa cartella
pwd
```
@ -38,7 +36,5 @@ pwd
Si dovrebbe vedere un output simile al seguente.
```
framework: 4.x.x
toolbox: 18.x.x
/percorso/al/progetto
```

View File

@ -28,9 +28,7 @@
プロジェクトのルートへのフルパスは、その場所で開いたターミナルウィンドウから `pwd` を実行することで取得できます。
```fish
# verify we are in vapor project folder
vapor --version
```sh
# get path to this folder
pwd
```
@ -38,7 +36,5 @@ pwd
以下のような出力が表示されるはずです。
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -28,9 +28,7 @@ scheme editor에서 Options탭을 선택한 후 Use custom working directory를
프로젝트의 루트 폴더의 전체 경로를 얻으려면 해당 위치에서 터미널 창을 열고 `pwd`를 실행하세요.
```fish
# verify we are in vapor project folder
vapor --version
```sh
# get path to this folder
pwd
```
@ -38,7 +36,5 @@ pwd
다음과 유사한 출력이 나타날 것입니다.
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -28,9 +28,7 @@ In the scheme editor, choose the _App_ action and the _Options_ tab. Check _Use
You can get the full path to your project's root by running `pwd` from a terminal window open there.
```fish
# verify we are in vapor project folder
vapor --version
```sh
# get path to this folder
pwd
```
@ -38,7 +36,5 @@ pwd
You should see output similar to the following.
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -28,9 +28,7 @@ Kies in de schema editor de actie _App_ en het tabblad _Options_. Vink _Use cust
U kunt het volledige pad naar de root van uw project krijgen door `pwd` uit te voeren vanuit een terminal venster dat daar geopend is.
```fish
# controleer of we in de Vapor project map zijn
vapor --version
```sh
# haal het pad naar deze map op
pwd
```
@ -38,7 +36,5 @@ pwd
U zou uitvoer moeten zien zoals hieronder.
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -29,8 +29,6 @@ W edytorze schematów wybierz akcję _App_ i zakładkę _Options_. Zaznacz opcj
Możesz uzyskać pełną ścieżkę do katalogu głównego projektu, uruchamiając `pwd` z otwartego tam okna terminala.
```sh
# Sprawdź, czy jesteśmy w folderze projektu vapor
vapor --version
# Uzyskaj ścieżkę do tego folderu
pwd
```
@ -38,7 +36,5 @@ pwd
Powinieneś zobaczyć dane wyjściowe podobne do poniższych.
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -28,9 +28,7 @@ Xcode 将默认在 _DerivedData_ 目录运行项目。这与项目的根目录
你可以在终端中运行 `pwd` 来获取你项目根目录的绝对目录。
```fish
# 确认我们在 vapor 项目目录
vapor --version
```sh
# 获取当前目录的路径
pwd
```
@ -38,7 +36,5 @@ pwd
你应该能看见类似下面的输出。
```
framework: 4.x.x
toolbox: 18.x.x
/path/to/project
```

View File

@ -51,9 +51,27 @@ Puoi anche usare le immagini Docker ufficiali di Swift che includono il compilat
## Installare la Toolbox
Ora che hai installato Swift, puoi installare la [Toolbox di Vapor](https://github.com/vapor/toolbox). Questo strumento CLI non è necessario per usare Vapor, ma include degli strumenti utili.
Ora che hai installato Swift, puoi installare la [Vapor Toolbox](https://github.com/vapor/toolbox). Questo strumento da linea di comando non è necessario per usare Vapor, ma aiuta nella creazione dei progetti Vapor.
Su Linux, dovrai compilare la toolbox dal codice sorgente. Guarda le <a href="https://github.com/vapor/toolbox/releases" target="_blank"> release </a> della toolbox su GitHub per trovare l'ultima versione.
### Homebrew
La Toolbox è distribuita tramite Homebrew. Se non hai ancora Homebrew, visita <a href="https://brew.sh" target="_blank">brew.sh</a> per le istruzioni di installazione.
```sh
brew install vapor
```
Controlla che l'installazione sia andata a buon fine stampando l'aiuto.
```sh
vapor --help
```
Dovresti vedere una lista di comandi disponibili.
### Makefile
Se vuoi, puoi compilare la Toolbox dal codice sorgente. Guarda le <a href="https://github.com/vapor/toolbox/releases" target="_blank"> release </a> della Toolbox su GitHub per trovare l'ultima versione.
```sh
git clone https://github.com/vapor/toolbox.git
@ -72,4 +90,4 @@ Dovresti vedere una lista di comandi disponibili.
## Come continuare
Dopo aver installato Swift, puoi iniziare a creare il tuo primo progetto usando [Inizio &rarr; Ciao, mondo](../getting-started/hello-world.it.md).
Dopo aver installato Swift e la Vapor Toolbox, puoi iniziare a creare il tuo primo progetto usando [Inizio &rarr; Ciao, mondo](../getting-started/hello-world.it.md).

View File

@ -51,9 +51,27 @@ You can also use Swift's official Docker images which come with the compiler pre
## Install Toolbox
Now that you have Swift installed, let's install the [Vapor Toolbox](https://github.com/vapor/toolbox). This CLI tool is not required to use Vapor, but it includes helpful utilities.
Now that you have Swift installed, let's install the [Vapor Toolbox](https://github.com/vapor/toolbox). This CLI tool is not required to use Vapor, but it helps to create new Vapor projects.
On Linux, you will need to build the toolbox from source. View the toolbox's <a href="https://github.com/vapor/toolbox/releases" target="_blank">releases</a> on GitHub to find the latest version.
### Homebrew
The Toolbox is distributed via Homebrew. If you do not have Homebrew yet, visit <a href="https://brew.sh" target="_blank">brew.sh</a> for install instructions.
```sh
brew install vapor
```
Double check to ensure that the installation was successful by printing help.
```sh
vapor --help
```
You should see a list of available commands.
### Makefile
If you want, you can also build the Toolbox from source. View the Toolbox's <a href="https://github.com/vapor/toolbox/releases" target="_blank">releases</a> on GitHub to find the latest version.
```sh
git clone https://github.com/vapor/toolbox.git
@ -72,4 +90,4 @@ You should see a list of available commands.
## Next
After you have installed Swift, create your first app in [Getting Started &rarr; Hello, world](../getting-started/hello-world.md).
Now that you have installed Swift and the Vapor Toolbox, create your first app in [Getting Started &rarr; Hello, world](../getting-started/hello-world.md).

View File

@ -27,9 +27,11 @@ Vapor 4 richiede Swift 5.9 o superiore.
## Installare la Toolbox
Ora che hai installato Swift, puoi installare la [Vapor Toolbox](https://github.com/vapor/toolbox). Questo strumento da linea di comando non è necessario per usare Vapor, ma include strumenti utili come il creatore di nuovi progetti.
Ora che hai installato Swift, puoi installare la [Vapor Toolbox](https://github.com/vapor/toolbox). Questo strumento da linea di comando non è necessario per usare Vapor, ma aiuta nella creazione dei progetti Vapor.
La toolbox è distribuita tramite Homebrew. Se non hai ancora Homebrew, visita <a href="https://brew.sh" target="_blank">brew.sh</a> per le istruzioni di installazione.
### Homebrew
La Toolbox è distribuita tramite Homebrew. Se non hai ancora Homebrew, visita <a href="https://brew.sh" target="_blank">brew.sh</a> per le istruzioni di installazione.
```sh
brew install vapor
@ -43,6 +45,25 @@ vapor --help
Dovresti vedere una lista di comandi disponibili.
### Makefile
Se vuoi, puoi compilare la Toolbox dal codice sorgente. Guarda le <a href="https://github.com/vapor/toolbox/releases" target="_blank"> release </a> della Toolbox su GitHub per trovare l'ultima versione.
```sh
git clone https://github.com/vapor/toolbox.git
cd toolbox
git checkout <desired version>
make install
```
Controlla che l'installazione sia andata a buon fine stampando l'aiuto.
```sh
vapor --help
```
Dovresti vedere una lista di comandi disponibili.
## Come continuare
Dopo aver installato Vapor, puoi iniziare a creare il tuo primo progetto usando [Inizio &rarr; Ciao, mondo](../getting-started/hello-world.it.md).
Dopo aver installato Swift e la Vapor Toolbox, puoi iniziare a creare il tuo primo progetto usando [Inizio &rarr; Ciao, mondo](../getting-started/hello-world.it.md).

View File

@ -27,9 +27,11 @@ Vapor 4 requires Swift 5.9 or greater.
## Install Toolbox
Now that you have Swift installed, let us install the [Vapor Toolbox](https://github.com/vapor/toolbox). This CLI tool is not required to use Vapor but it includes helpful utilities like a new project creator.
Now that you have Swift installed, let's install the [Vapor Toolbox](https://github.com/vapor/toolbox). This CLI tool is not required to use Vapor, but it helps to create new Vapor projects.
Toolbox is distributed via Homebrew. If you do not have Homebrew yet, visit <a href="https://brew.sh" target="_blank">brew.sh</a> for install instructions.
### Homebrew
The Toolbox is distributed via Homebrew. If you do not have Homebrew yet, visit <a href="https://brew.sh" target="_blank">brew.sh</a> for install instructions.
```sh
brew install vapor
@ -43,6 +45,25 @@ vapor --help
You should see a list of available commands.
### Makefile
If you want, you can also build the Toolbox from source. View the Toolbox's <a href="https://github.com/vapor/toolbox/releases" target="_blank">releases</a> on GitHub to find the latest version.
```sh
git clone https://github.com/vapor/toolbox.git
cd toolbox
git checkout <desired version>
make install
```
Double check the installation was successful by printing help.
```sh
vapor --help
```
You should see a list of available commands.
## Next
Now that you have installed Swift and Vapor Toolbox, create your first app in [Getting Started &rarr; Hello, world](../getting-started/hello-world.md).