From 22bdb2badf95d5d93185663439ef3a95b0893e3f Mon Sep 17 00:00:00 2001 From: Diego Molina Date: Fri, 4 Nov 2022 15:29:31 +0100 Subject: [PATCH] Mentioning Selenium Manager in docs (#1212) * Mentioning Selenium Manager in docs * Addressing comments * Updating link to blog post [deploy site] --- .../documentation/grid/getting_started.en.md | 4 ++- .../documentation/grid/getting_started.ja.md | 4 ++- .../grid/getting_started.pt-br.md | 4 ++- .../grid/getting_started.zh-cn.md | 4 ++- .../getting_started/install_drivers.en.md | 21 +++++++++---- .../getting_started/install_drivers.ja.md | 30 +++++++++++++++---- .../getting_started/install_drivers.pt-br.md | 30 +++++++++++++++---- .../getting_started/install_drivers.zh-cn.md | 30 +++++++++++++++---- 8 files changed, 103 insertions(+), 24 deletions(-) diff --git a/website_and_docs/content/documentation/grid/getting_started.en.md b/website_and_docs/content/documentation/grid/getting_started.en.md index b7382771232..8e6f3bcc9f1 100644 --- a/website_and_docs/content/documentation/grid/getting_started.en.md +++ b/website_and_docs/content/documentation/grid/getting_started.en.md @@ -15,7 +15,9 @@ aliases: [ 1. Prerequisites * Java 11 or higher installed * Browser(s) installed - * Browser driver(s) [installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#2-the-path-environment-variable" >}}) + * Browser driver(s) + * If using Selenium 4.6, Selenium Manager will configure the drivers for Chrome, Firefox, and Edge [if they are not found on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#1-selenium-manager-beta" >}}). + * [Installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#3-the-path-environment-variable" >}}) * Download the Selenium Server jar file from the [latest release](https://github.com/SeleniumHQ/selenium/releases/latest) 1. Start the Grid * `java -jar selenium-server-.jar standalone` diff --git a/website_and_docs/content/documentation/grid/getting_started.ja.md b/website_and_docs/content/documentation/grid/getting_started.ja.md index 7ce72c69078..0ac694ba62c 100644 --- a/website_and_docs/content/documentation/grid/getting_started.ja.md +++ b/website_and_docs/content/documentation/grid/getting_started.ja.md @@ -25,7 +25,9 @@ aliases: [ 1. Prerequisites * Java 11 or higher installed * Browser(s) installed - * Browser driver(s) [installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#2-the-path-environment-variable" >}}) + * Browser driver(s) + * If using Selenium 4.6, Selenium Manager will configure the drivers for Chrome, Firefox, and Edge [if they are not found on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#1-selenium-manager-beta" >}}). + * [Installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#3-the-path-environment-variable" >}}) * Download the Selenium Server jar file from the [latest release](https://github.com/SeleniumHQ/selenium/releases/latest) 1. Start the Grid * `java -jar selenium-server-.jar standalone` diff --git a/website_and_docs/content/documentation/grid/getting_started.pt-br.md b/website_and_docs/content/documentation/grid/getting_started.pt-br.md index e35bac9cf30..5cbd3e830ae 100644 --- a/website_and_docs/content/documentation/grid/getting_started.pt-br.md +++ b/website_and_docs/content/documentation/grid/getting_started.pt-br.md @@ -25,7 +25,9 @@ aliases: [ 1. Prerequisites * Java 11 or higher installed * Browser(s) installed - * Browser driver(s) [installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#2-the-path-environment-variable" >}}) + * Browser driver(s) + * If using Selenium 4.6, Selenium Manager will configure the drivers for Chrome, Firefox, and Edge [if they are not found on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#1-selenium-manager-beta" >}}). + * [Installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#3-the-path-environment-variable" >}}) * Download the Selenium Server jar file from the [latest release](https://github.com/SeleniumHQ/selenium/releases/latest) 1. Start the Grid * `java -jar selenium-server-.jar standalone` diff --git a/website_and_docs/content/documentation/grid/getting_started.zh-cn.md b/website_and_docs/content/documentation/grid/getting_started.zh-cn.md index 5b8f475cf54..a22e3791dde 100644 --- a/website_and_docs/content/documentation/grid/getting_started.zh-cn.md +++ b/website_and_docs/content/documentation/grid/getting_started.zh-cn.md @@ -25,7 +25,9 @@ aliases: [ 1. Prerequisites * Java 11 or higher installed * Browser(s) installed - * Browser driver(s) [installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#2-the-path-environment-variable" >}}) + * Browser driver(s) + * If using Selenium 4.6, Selenium Manager will configure the drivers for Chrome, Firefox, and Edge [if they are not found on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#1-selenium-manager-beta" >}}). + * [Installed and on the `PATH`]({{< ref "../webdriver/getting_started/install_drivers.md#3-the-path-environment-variable" >}}) * Download the Selenium Server jar file from the [latest release](https://github.com/SeleniumHQ/selenium/releases/latest) 1. Start the Grid * `java -jar selenium-server-.jar standalone` diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.en.md b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.en.md index 867c476937a..3d808560a6e 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.en.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.en.md @@ -23,9 +23,20 @@ This section explains the basic requirements for getting started with the differ Read about more advanced options for starting a driver in our [driver configuration]({{< ref "/documentation/webdriver/drivers/" >}}) documentation. -## Three Ways to Use Drivers +## Four Ways to Use Drivers -### 1. Driver Management Software +### 1. Selenium Manager (Beta) + +{{< badge-version version="4.6" >}} + +Selenium Manager helps you to get a working environment to run Selenium out of the box. Beta 1 +of Selenium Manager will configure the drivers for Chrome, Firefox, and Edge if they are not +found on the `PATH`. No extra configuration is needed. Future releases of Selenium Manager +will eventually even download browsers if necessary. + +Read more at the blog announcement for [Selenium Manager ](/blog/2022/introducing-selenium-manager/). + +### 2. Driver Management Software Most machines automatically update the browser, but the driver does not. To make sure you get the correct driver for your browser, there are many third party libraries to assist you. @@ -148,7 +159,7 @@ fun chrome(): WebDriver { {{% /tab %}} {{< /tabpane >}} -### 2. The `PATH` Environment Variable +### 3. The `PATH` Environment Variable This option first requires manually downloading the driver (See [Quick Reference Section](#quick-reference) for links). This is a flexible option to change location of drivers without having to update your code, and will work @@ -219,9 +230,9 @@ ChromeDriver was started successfully. You can regain control of your command prompt by pressing Ctrl+C -### 3. Hard Coded Location +### 4. Hard Coded Location -Similar to Option 2 above, you need to manually download the driver (See [Quick Reference Section](#quick-reference) for links). +Similar to Option 3 above, you need to manually download the driver (See [Quick Reference Section](#quick-reference) for links). Specifying the location in the code itself has the advantage of not needing to figure out Environment Variables on your system, but has the drawback of making the code much less flexible. diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.ja.md b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.ja.md index e70169c7fff..a6b2f3a46af 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.ja.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.ja.md @@ -23,9 +23,29 @@ Internet Explorerを除くすべてのドライバーの実装は、ブラウザ Read about more advanced options for starting a driver in our [driver configuration]({{< ref "/documentation/webdriver/drivers/" >}}) documentation. -## ドライバーを使用する3つの方法 +{{% pageinfo color="warning" %}} +

+ + Page being translated from English to Japanese. + Do you speak Japanese? Help us to translate + it by sending us pull requests! +

+{{% /pageinfo %}} -### 1. ドライバー管理ソフトウェア +## Four Ways to Use Drivers + +### 1. Selenium Manager (Beta) + +{{< badge-version version="4.6" >}} + +Selenium Manager helps you to get a working environment to run Selenium out of the box. Beta 1 +of Selenium Manager will configure the drivers for Chrome, Firefox, and Edge if they are not +found on the `PATH`. No extra configuration is needed. Future releases of Selenium Manager +will eventually even download browsers if necessary. + +Read more at the blog announcement for [Selenium Manager ](/blog/2022/introducing-selenium-manager/). + +### 2. ドライバー管理ソフトウェア ほとんどのマシンはブラウザを自動的に更新しますが、ドライバは更新しません。 ブラウザに適切なドライバを確実に入手するために、多くのサードパーティライブラリが役立ちます。 @@ -147,7 +167,7 @@ fun chrome(): WebDriver { {{% /tab %}} {{< /tabpane >}} -### 2. `PATH` 環境変数 +### 3. `PATH` 環境変数 このオプションでは、最初に手動でドライバーをダウンロードする必要があります （リンクについては[クイックリファレンス](#クイックリファレンス)を参照してください）。 @@ -221,9 +241,9 @@ ChromeDriver was started successfully. Ctrl+C を押して、コマンドプロンプトの制御を取り戻すことができます。 -### 3. ハードコードされた場所 +### 4. ハードコードされた場所 -上記のオプション2と同様に、ドライバーを手動でダウンロードする必要があります。 +上記のオプション3と同様に、ドライバーを手動でダウンロードする必要があります。 （リンクについては [クイックリファレンス](#クイックリファレンス) を参照してください）。 コードそのものに場所を指定することには、システム上の環境変数を把握する必要がないという利点がありますが、 コードの柔軟性が大幅に低下するという欠点があります。 diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.pt-br.md b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.pt-br.md index 36fa7350471..acd7664c493 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.pt-br.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.pt-br.md @@ -24,9 +24,29 @@ Esta seção explica os requisitos básicos para você começar a usar os difere Leia mais sobre opções avançadas para iniciar um driver na nossa documentação de [configuração de driver]({{< ref "/documentation/webdriver/drivers/" >}}). -## Três maneiras diferentes de usar os drivers +{{% pageinfo color="warning" %}} +

+ + Page being translated from English to Portuguese. + Do you speak Portuguese? Help us to translate + it by sending us pull requests! +

+{{% /pageinfo %}} -### 1. Software de gerenciamento de Driver +## QuatroTrês maneiras diferentes de usar os drivers + +### 1. Selenium Manager (Beta) + +{{< badge-version version="4.6" >}} + +Selenium Manager helps you to get a working environment to run Selenium out of the box. Beta 1 +of Selenium Manager will configure the drivers for Chrome, Firefox, and Edge if they are not +found on the `PATH`. No extra configuration is needed. Future releases of Selenium Manager +will eventually even download browsers if necessary. + +Read more at the blog announcement for [Selenium Manager ](/blog/2022/introducing-selenium-manager/). + +### 2. Software de gerenciamento de Driver A maioria das máquinas atualiza automaticamente o navegador, mas não o driver. Para certificar de obter o driver correto para o seu navegador de internet, existem diversas bibliotecas de terceiros para auxiliá-lo. @@ -148,7 +168,7 @@ fun chrome(): WebDriver { {{% /tab %}} {{< /tabpane >}} -### 2. A variável de ambiente `PATH` +### 3. A variável de ambiente `PATH` Esta opção requer primeiro o download manual do driver (Vejá a [sessão de Consulta de referencia rápida](#quick-reference) para links). Esta é uma opção flexível para alterar a localização dos drivers sem precisar atualizar seu código e funcionará @@ -220,9 +240,9 @@ ChromeDriver was started successfully. Você pode recuperar o controle do seu prompt de comando pressionando Ctrl+C -### 3. Localização definida no código +### 4. Localização definida no código -Semelhante à opção 2 acima, você precisará baixar manualmente o driver (Vejá a [sessão de Consulta de referencia rápida](#quick-reference) para links). +Semelhante à opção 3 acima, você precisará baixar manualmente o driver (Vejá a [sessão de Consulta de referencia rápida](#quick-reference) para links). Especificar a localização no próprio código tem a vantagem de você não precisar se preocupar em descobrir variáveis de ambiente no seu sistema, mas tem a desvantagem de tornar o código muito menos flexível. diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.zh-cn.md b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.zh-cn.md index 715be343eb6..2a474701364 100644 --- a/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/getting_started/install_drivers.zh-cn.md @@ -25,9 +25,29 @@ WebDriver尽量使用浏览器内置的自动化支持 在我们的[驱动程序配置]({{< ref "/documentation/webdriver/drivers/" >}}) 文档中 阅读有关启动驱动程序的更多高级选项. -## 使用驱动的三种方式 +{{% pageinfo color="warning" %}} +

+ + Page being translated from English to Chinese. + Do you speak Chinese? Help us to translate + it by sending us pull requests! +

+{{% /pageinfo %}} -### 1. 驱动管理软件 +## Four Ways to Use Drivers + +### 1. Selenium Manager (Beta) + +{{< badge-version version="4.6" >}} + +Selenium Manager helps you to get a working environment to run Selenium out of the box. Beta 1 +of Selenium Manager will configure the drivers for Chrome, Firefox, and Edge if they are not +found on the `PATH`. No extra configuration is needed. Future releases of Selenium Manager +will eventually even download browsers if necessary. + +Read more at the blog announcement for [Selenium Manager ](/blog/2022/introducing-selenium-manager/). + +### 2. 驱动管理软件 大多数机器会自动更新浏览器, 但驱动程序不会. @@ -153,7 +173,7 @@ fun chrome(): WebDriver { {{% /tab %}} {{< /tabpane >}} -### 2. `PATH` 环境变量 +### 3. `PATH` 环境变量 此选项首先需要手动下载驱动程序 (有关链接, 请参阅[快速参考](#快速参考) 部分). @@ -232,9 +252,9 @@ ChromeDriver was started successfully. 想要重新控制命令提示符可以按下 Ctrl+C -### 3. 硬编码位置 +### 4. 硬编码位置 -与上面的选项2类似, +与上面的选项3类似, 您需要手动下载驱动程序(有关链接, 请参阅[快速参考](#快速参考) 部分). 在代码中指定位置本身的优点是 不需要指出系统上的环境变量,