diff --git a/examples/java/build.gradle b/examples/java/build.gradle
new file mode 100644
index 000000000000..42fa2c0c303e
--- /dev/null
+++ b/examples/java/build.gradle
@@ -0,0 +1,27 @@
+plugins {
+ id 'java'
+}
+
+group 'dev.selenium'
+version '1.0-SNAPSHOT'
+
+repositories {
+ mavenCentral()
+}
+ext {
+ seleniumVersion = '4.4.0'
+ junitVersion = '5.9.0'
+ webdrivermanagerVersion = '5.2.3'
+}
+
+dependencies {
+ testImplementation 'org.seleniumhq.selenium:selenium-java:$seleniumVersion'
+ testImplementation 'org.seleniumhq.selenium:selenium-grid:$seleniumVersion'
+ testImplementation 'io.github.bonigarcia:webdrivermanager:$webdrivermanagerVersion'
+ testImplementation 'org.junit.jupiter:junit-jupiter-api:$junitVersion'
+ testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:$junitVersion'
+}
+
+test {
+ useJUnitPlatform()
+}
\ No newline at end of file
diff --git a/examples/java/gradle/wrapper/gradle-wrapper.jar b/examples/java/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 000000000000..41d9927a4d4f
Binary files /dev/null and b/examples/java/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/examples/java/gradle/wrapper/gradle-wrapper.properties b/examples/java/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 000000000000..41dfb87909a8
--- /dev/null
+++ b/examples/java/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/examples/java/gradlew b/examples/java/gradlew
new file mode 100755
index 000000000000..1b6c787337ff
--- /dev/null
+++ b/examples/java/gradlew
@@ -0,0 +1,234 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+#
+# Gradle start up script for POSIX generated by Gradle.
+#
+# Important for running:
+#
+# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+# noncompliant, but you have some other compliant shell such as ksh or
+# bash, then to run this script, type that shell name before the whole
+# command line, like:
+#
+# ksh Gradle
+#
+# Busybox and similar reduced shells will NOT work, because this script
+# requires all of these POSIX shell features:
+# * functions;
+# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+# * compound commands having a testable exit status, especially «case»;
+# * various built-in commands including «command», «set», and «ulimit».
+#
+# Important for patching:
+#
+# (2) This script targets any POSIX shell, so it avoids extensions provided
+# by Bash, Ksh, etc; in particular arrays are avoided.
+#
+# The "traditional" practice of packing multiple parameters into a
+# space-separated string is a well documented source of bugs and security
+# problems, so this is (mostly) avoided, by progressively accumulating
+# options in "$@", and eventually passing that to Java.
+#
+# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+# see the in-line comments for details.
+#
+# There are tweaks for specific operating systems such as AIX, CygWin,
+# Darwin, MinGW, and NonStop.
+#
+# (3) This script is generated from the Groovy template
+# https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+# within the Gradle project.
+#
+# You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+ APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
+ [ -h "$app_path" ]
+do
+ ls=$( ls -ld "$app_path" )
+ link=${ls#*' -> '}
+ case $link in #(
+ /*) app_path=$link ;; #(
+ *) app_path=$APP_HOME$link ;;
+ esac
+done
+
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
+
+APP_NAME="Gradle"
+APP_BASE_NAME=${0##*/}
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+ echo "$*"
+} >&2
+
+die () {
+ echo
+ echo "$*"
+ echo
+ exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in #(
+ CYGWIN* ) cygwin=true ;; #(
+ Darwin* ) darwin=true ;; #(
+ MSYS* | MINGW* ) msys=true ;; #(
+ NONSTOP* ) nonstop=true ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD=$JAVA_HOME/jre/sh/java
+ else
+ JAVACMD=$JAVA_HOME/bin/java
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD=java
+ which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+ case $MAX_FD in #(
+ max*)
+ MAX_FD=$( ulimit -H -n ) ||
+ warn "Could not query maximum file descriptor limit"
+ esac
+ case $MAX_FD in #(
+ '' | soft) :;; #(
+ *)
+ ulimit -n "$MAX_FD" ||
+ warn "Could not set maximum file descriptor limit to $MAX_FD"
+ esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+# * args from the command line
+# * the main class name
+# * -classpath
+# * -D...appname settings
+# * --module-path (only if needed)
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+ APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+ CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+ JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ for arg do
+ if
+ case $arg in #(
+ -*) false ;; # don't mess with options #(
+ /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
+ [ -e "$t" ] ;; #(
+ *) false ;;
+ esac
+ then
+ arg=$( cygpath --path --ignore --mixed "$arg" )
+ fi
+ # Roll the args list around exactly as many times as the number of
+ # args, so each arg winds up back in the position where it started, but
+ # possibly modified.
+ #
+ # NB: a `for` loop captures its iteration list before it begins, so
+ # changing the positional parameters here affects neither the number of
+ # iterations, nor the values presented in `arg`.
+ shift # remove old arg
+ set -- "$@" "$arg" # push replacement arg
+ done
+fi
+
+# Collect all arguments for the java command;
+# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
+# shell script including quotes and variable substitutions, so put them in
+# double quotes to make sure that they get re-expanded; and
+# * put everything else in single quotes, so that it's not re-expanded.
+
+set -- \
+ "-Dorg.gradle.appname=$APP_BASE_NAME" \
+ -classpath "$CLASSPATH" \
+ org.gradle.wrapper.GradleWrapperMain \
+ "$@"
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+# set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+ printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+ xargs -n1 |
+ sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+ tr '\n' ' '
+ )" '"$@"'
+
+exec "$JAVACMD" "$@"
diff --git a/examples/java/gradlew.bat b/examples/java/gradlew.bat
new file mode 100644
index 000000000000..107acd32c4e6
--- /dev/null
+++ b/examples/java/gradlew.bat
@@ -0,0 +1,89 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/examples/ruby/Gemfile b/examples/ruby/Gemfile
index 9e0d2ea56d48..2573ef2ab753 100644
--- a/examples/ruby/Gemfile
+++ b/examples/ruby/Gemfile
@@ -7,6 +7,6 @@ gem 'rake', '~> 13.0'
gem 'rspec', '~> 3.0'
gem 'rubocop', '~> 1.35'
gem 'rubocop-rspec', '~> 2.12'
-gem 'selenium-webdriver', '~> 4.0'
+gem 'selenium-webdriver', '~> 4.4'
gem 'webdrivers', '~> 5.0'
gem 'ffi', '~> 1.15', '>= 1.15.5'
\ No newline at end of file
diff --git a/examples/ruby/Gemfile.lock b/examples/ruby/Gemfile.lock
index 9c06bf2c4726..64481ad65ab2 100644
--- a/examples/ruby/Gemfile.lock
+++ b/examples/ruby/Gemfile.lock
@@ -4,6 +4,7 @@ GEM
ast (2.4.2)
childprocess (4.1.0)
diff-lcs (1.5.0)
+ ffi (1.15.5)
json (2.6.2)
nokogiri (1.13.8-x86_64-darwin)
racc (~> 1.4)
@@ -64,11 +65,12 @@ PLATFORMS
x86_64-linux
DEPENDENCIES
+ ffi (~> 1.15, >= 1.15.5)
rake (~> 13.0)
rspec (~> 3.0)
rubocop (~> 1.35)
rubocop-rspec (~> 2.12)
- selenium-webdriver (~> 4.0)
+ selenium-webdriver (~> 4.4)
webdrivers (~> 5.0)
BUNDLED WITH
diff --git a/website_and_docs/assets/scss/_tabs.scss b/website_and_docs/assets/scss/_tabs.scss
index a16c7d14ae7e..b792b6c12dfb 100644
--- a/website_and_docs/assets/scss/_tabs.scss
+++ b/website_and_docs/assets/scss/_tabs.scss
@@ -66,3 +66,10 @@
.td-content .highlight {
margin: 1rem 0;
}
+
+// Default is 5rem which results in an overlap when h3 is in a tab
+.tab-pane h3 {
+ &:before {
+ height: 6rem;
+ }
+}
diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_library.en.md b/website_and_docs/content/documentation/webdriver/getting_started/install_library.en.md
index 364e6c7b8581..e3fc60faaedd 100644
--- a/website_and_docs/content/documentation/webdriver/getting_started/install_library.en.md
+++ b/website_and_docs/content/documentation/webdriver/getting_started/install_library.en.md
@@ -24,39 +24,39 @@ Installation of Selenium libraries for Java is accomplished using a build tool.
You can see all available versions on
[Maven Repository](https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java)
-For Maven, add the _selenium-java_ dependency in your project `pom.xml` file:
-
-```xml
-
- org.seleniumhq.selenium
- selenium-java
- 4.4.0
-
-```
+### Maven
+in the project's `pom.xml` file:
-For Gradle, add the _selenium-java_ dependency in your project `build.gradle` file:
+1. specify the version in `properties`:
-```text
-dependencies {
- compile group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+{{< gh-codeblock path="examples/java/pom.xml#L11-L12" >}}
-Gradle 7.0 and above:
+2. specify the dependency in `dependencies`
-```text
-dependencies {
- implementation group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+{{< gh-codeblock path="examples/java/pom.xml#L30-L35" >}}
+
+### Gradle
+in the project `build.gradle` file:
+
+1. specify the version in extra properties (`ext`):
+
+{{< gh-codeblock path="examples/java/build.gradle#L11-L12" >}}
+
+2. specify the dependency as `testImplementation` in `dependencies`
+{{< gh-codeblock path="examples/java/build.gradle#L17-L18" >}}
{{< /tab >}}
{{< tab header="Python" >}}
- Installation of Selenium libraries for Python can be done using pip:
+
+### Pip
```shell
pip install selenium
```
+### Download
+
Alternatively you can download the [PyPI source archive](https://pypi.org/project/selenium/#files)
(selenium-x.x.x.tar.gz) and install it using _setup.py_:
@@ -64,25 +64,43 @@ Alternatively you can download the [PyPI source archive](https://pypi.org/projec
python setup.py install
```
+### Require in project
+
+To use it in a project, add it to the `requirements.txt` file:
+{{< gh-codeblock path="examples/python/requirements.txt#L1" >}}
+
{{< /tab >}}
{{< tab header="CSharp" >}}
- Installation of Selenium libraries for C# can be done using NuGet in one of two ways
- * Using a Packet Manager:
+### Packet Manager
+
```shell
Install-Package Selenium.WebDriver
```
- * Using .NET CLI
+
+### .NET CLI
+
```shell
dotnet add package Selenium.WebDriver
```
-## Supported .NET Versions
+
+### CSProj
+
+in the project's `csproj` file, specify the dependency as a `PackageReference` in `ItemGroup`:
+
+{{< gh-codeblock language="xml" path="examples/dotnet/SeleniumDocs/SeleniumDocs.csproj#L13" >}}
+
+### Additional considerations
+
+Further items of note for using Selenium with .NET:
+
+#### Supported .NET Versions
Make sure to use the .NET SDK version compatible with relevant [Selenium package](https://www.nuget.org/packages/Selenium.WebDriver).
Check the dependencies section to find out the [supported .NET version](https://dotnet.microsoft.com/en-us/download/dotnet).
At the time of this update, .NET 5.0 (Visual Studio 2019) is known to be supported, and .NET 6.0 is not supported.
You can download [MSBuild Tools 2019 from here](https://docs.microsoft.com/en-us/visualstudio/install/create-an-offline-installation-of-visual-studio?view=vs-2019) to install the needed components and dependencies such as .NET SDK and NuGet Package Manager.
-## Using Visual Studio Code (vscode) and C#
+#### Using Visual Studio Code (vscode) and C#
This is a quick guide to help you get started with vscode and C#, however, more research may be required.
Install the compatible .NET SDK as per the section above.
Also install the vscode extensions (Ctrl-Shift-X) for C# and NuGet.
@@ -109,26 +127,34 @@ Now you can use the examples in the documentation related to C# with vscode.
{{< /tab >}}
{{< tab header="Ruby" >}}
- Installation of Selenium libraries for Ruby can be done using gem:
+
+### Install locally
```shell
gem install selenium-webdriver
```
-Or add it to your `Gemfile`:
+### Add to project
-```rb
-gem 'selenium-webdriver', '~> 4.4'
-```
+In your project's `Gemfile`:
+
+{{< gh-codeblock language="ruby" path="examples/ruby/Gemfile#L10" >}}
{{< /tab >}}
{{< tab header="JavaScript" >}}
- Installation of Selenium libraries for JavaScript can be done using npm:
+
+### Install locally
```shell
npm install selenium-webdriver
```
+### Add to project
+
+In your project's `package.json`, add requirement to `dependencies`:
+
+{{< gh-codeblock path="examples/javascript/package.json#L9-L10" >}}
+
{{< /tab >}}
{{< tab header="Kotlin" >}}
Use the Java bindings for Kotlin.
diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_library.ja.md b/website_and_docs/content/documentation/webdriver/getting_started/install_library.ja.md
index b118d5be2daf..a6b0b9066a22 100644
--- a/website_and_docs/content/documentation/webdriver/getting_started/install_library.ja.md
+++ b/website_and_docs/content/documentation/webdriver/getting_started/install_library.ja.md
@@ -16,62 +16,87 @@ aliases: [
{{< tabpane disableCodeBlock=true >}}
{{< tab header="Java" >}}
-JavaへのSeleniumライブラリのインストールはMavenを使います。
+
+Installation of Selenium libraries for Java is accomplished using a build tool.
+You can see all available versions on
+[Maven Repository](https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java)
+
+### JavaへのSeleniumライブラリのインストールはMavenを使います。
プロジェクトのpom.xmlに _selenium-java_ の依存関係を追加してください。
-```xml
-
- org.seleniumhq.selenium
- selenium-java
- 4.4.0
-
-```
+1. specify the version in `properties`:
-For Gradle, add the _selenium-java_ dependency in your project `build.gradle` file:
+{{< gh-codeblock path="examples/java/pom.xml#L11-L12" >}}
-```text
-dependencies {
- compile group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+2. specify the dependency in `dependencies`
-Gradle 7.0 and above:
+{{< gh-codeblock path="examples/java/pom.xml#L30-L35" >}}
-```text
-dependencies {
- implementation group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+### Gradle
+in the project `build.gradle` file:
+
+1. specify the version in extra properties (`ext`):
+
+{{< gh-codeblock path="examples/java/build.gradle#L11-L12" >}}
+
+2. specify the dependency as `testImplementation` in `dependencies`
+
+{{< gh-codeblock path="examples/java/build.gradle#L17-L18" >}}
{{< /tab >}}
{{< tab header="Python" >}}
- PythonへのSeleniumライブラリのインストールはpipを使います。
+
+### pipを使います。
```shell
pip install selenium
```
+### ダウンロード
+
また、[PyPI source archive](https://pypi.org/project/selenium/#files)
(selenium-x.x.x.tar.gz)をダウンロードして、 _setup.py_ でインストールすることもできます。
```shell
python setup.py install
```
+
+### Require in project
+
+To use it in a project, add it to the `requirements.txt` file:
+{{< gh-codeblock path="examples/python/requirements.txt#L1" >}}
+
{{< /tab >}}
{{< tab header="CSharp" >}}
- C#へのSeleniumライブラリのインストールはNuGetを使います。
+### Packet Manager
```shell
-# Using package manager
Install-Package Selenium.WebDriver
-# or using .Net CLI
+```
+
+### .NET CLI
+
+```shell
dotnet add package Selenium.WebDriver
```
-## Supported .NET Versions
+
+### CSProj
+
+in the project's `csproj` file, specify the dependency as a `PackageReference` in `ItemGroup`:
+
+{{< gh-codeblock language="xml" path="examples/dotnet/SeleniumDocs/SeleniumDocs.csproj#L13" >}}
+
+### Additional considerations
+
+Further items of note for using Selenium with .NET:
+
+#### Supported .NET Versions
Make sure to use the .NET SDK version compatible with relevant [Selenium package](https://www.nuget.org/packages/Selenium.WebDriver).
Check the dependencies section to find out the [supported .NET version](https://dotnet.microsoft.com/en-us/download/dotnet).
At the time of this update, .NET 5.0 (Visual Studio 2019) is known to be supported, and .NET 6.0 is not supported.
You can download [MSBuild Tools 2019 from here](https://docs.microsoft.com/en-us/visualstudio/install/create-an-offline-installation-of-visual-studio?view=vs-2019) to install the needed components and dependencies such as .NET SDK and NuGet Package Manager.
-## Using Visual Studio Code (vscode) and C#
+#### Using Visual Studio Code (vscode) and C#
This is a quick guide to help you get started with vscode and C#, however, more research may be required.
Install the compatible .NET SDK as per the section above.
Also install the vscode extensions (Ctrl-Shift-X) for C# and NuGet.
@@ -98,18 +123,34 @@ Now you can use the examples in the documentation related to C# with vscode.
{{< /tab >}}
{{< tab header="Ruby" >}}
- RubyへのSeleniumライブラリのインストールはgemを使います。
+
+### Install locally
```shell
gem install selenium-webdriver
```
+
+### Add to project
+
+In your project's `Gemfile`:
+
+{{< gh-codeblock language="ruby" path="examples/ruby/Gemfile#L10" >}}
+
{{< /tab >}}
{{< tab header="JavaScript" >}}
- JavaScriptへのSeleniumライブラリのインストールはnpmを使います。
+
+### Install locally
```shell
npm install selenium-webdriver
```
+
+### Add to project
+
+In your project's `package.json`, add requirement to `dependencies`:
+
+{{< gh-codeblock path="examples/javascript/package.json#L9-L10" >}}
+
{{< /tab >}}
{{< tab header="Kotlin" >}}
Kotlinのネイティブ言語バインディングが欠落しているため、Javaバインディングを使用する必要があります。
diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_library.pt-br.md b/website_and_docs/content/documentation/webdriver/getting_started/install_library.pt-br.md
index 4d9676a8bfe0..cdc3e255af4b 100644
--- a/website_and_docs/content/documentation/webdriver/getting_started/install_library.pt-br.md
+++ b/website_and_docs/content/documentation/webdriver/getting_started/install_library.pt-br.md
@@ -17,62 +17,86 @@ O processo de instalação de bibliotecas depende da linguagem que você escolhe
{{< tabpane disableCodeBlock=true >}}
{{< tab header="Java" >}}
-A instalação de bibliotecas Selenium para Java pode ser feita usando Maven.
-Adicione a dependência selenium-java em seu pom.xml:
-
-```xml
-
- org.seleniumhq.selenium
- selenium-java
- 4.4.0
-
-```
+Installation of Selenium libraries for Java is accomplished using a build tool.
+You can see all available versions on
+[Maven Repository](https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java)
-For Gradle, add the _selenium-java_ dependency in your project `build.gradle` file:
+### Maven
+in the project's `pom.xml` file:
-```text
-dependencies {
- compile group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+1. specify the version in `properties`:
-Gradle 7.0 and above:
+{{< gh-codeblock path="examples/java/pom.xml#L11-L12" >}}
-```text
-dependencies {
- implementation group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+2. specify the dependency in `dependencies`
+
+{{< gh-codeblock path="examples/java/pom.xml#L30-L35" >}}
+
+### Gradle
+in the project `build.gradle` file:
+
+1. specify the version in extra properties (`ext`):
+
+{{< gh-codeblock path="examples/java/build.gradle#L11-L12" >}}
+
+2. specify the dependency as `testImplementation` in `dependencies`
+
+{{< gh-codeblock path="examples/java/build.gradle#L17-L18" >}}
{{< /tab >}}
- {{< tab header="Python" >}}
- A instalação de bibliotecas Selenium para Python pode ser feita usando pip:
+ {{< tab header="Python" >}}
+
+### pip
```shell
pip install selenium
```
+### você pode baixar
+
Como alternativa, você pode baixar o [arquivo de origem do PyPI](https://pypi.org/project/selenium/#files)
(selenium-x.x.x.tar.gz) e instale-o usando _setup.py_:
```shell
python setup.py install
```
+
+### Require in project
+
+To use it in a project, add it to the `requirements.txt` file:
+{{< gh-codeblock path="examples/python/requirements.txt#L1" >}}
+
{{< /tab >}}
{{< tab header="CSharp" >}}
- A instalação de bibliotecas Selenium para C# pode ser feita usando NuGet:
+### Packet Manager
```shell
-# Using package manager
Install-Package Selenium.WebDriver
-# or using .Net CLI
+```
+
+### .NET CLI
+
+```shell
dotnet add package Selenium.WebDriver
```
-## Versões Suportadas .NET
+
+### CSProj
+
+in the project's `csproj` file, specify the dependency as a `PackageReference` in `ItemGroup`:
+
+{{< gh-codeblock language="xml" path="examples/dotnet/SeleniumDocs/SeleniumDocs.csproj#L13" >}}
+
+### Additional considerations
+
+Further items of note for using Selenium with .NET:
+
+#### Versões Suportadas .NET
Tenha certeza de utilizar a versão .NET SDK compatível com os [Pacotes Selenium](https://www.nuget.org/packages/Selenium.WebDriver) relevantes.
Veja a seção de dependências em [Versões suportadas .NET](https://dotnet.microsoft.com/en-us/download/dotnet).
Até esta atualização, .NET 5.0 (Visual Studio 2019) é suportada e .NET 6.0 não é suportada.
Você pode fazer o download [MSBuild Tools 2019 aqui](https://docs.microsoft.com/en-us/visualstudio/install/create-an-offline-installation-of-visual-studio?view=vs-2019) e instalar os componentes e dependências necessárias, como .NET SDK e NuGet Package Manager.
-## Usando Visual Studio Code (vscode) e C#
+#### Usando Visual Studio Code (vscode) e C#
Este é um guia rápido para você iniciar com VSCode e C#, no entanto, mais pesquisas podem ser necessárias.
Instale o .NET SDK compativel como mostrado na seção acima.
Além disso instale as extensões (Ctrl-Shift-X) C# e NuGet no VSCode.
@@ -96,20 +120,34 @@ Agora você pode utilizar os exemplos na documentação relacionada para C# com
{{< /tab >}}
{{< tab header="Ruby" >}}
- A instalação de bibliotecas Selenium para Ruby pode ser feita usando gem:
+
+### Install locally
```shell
gem install selenium-webdriver
```
+### Add to project
+
+In your project's `Gemfile`:
+
+{{< gh-codeblock language="ruby" path="examples/ruby/Gemfile#L10" >}}
+
{{< /tab >}}
{{< tab header="JavaScript" >}}
- A instalação de bibliotecas Selenium para JavaScript pode ser feita usando npm:
+
+### Install locally
```shell
npm install selenium-webdriver
```
+### Add to project
+
+In your project's `package.json`, add requirement to `dependencies`:
+
+{{< gh-codeblock path="examples/javascript/package.json#L9-L10" >}}
+
{{< /tab >}}
{{< tab header="Kotlin" >}}
Devido à ausência de vínculos de linguagem nativo para Kotlin, você deve usar vínculos Java, por exemplo, com Maven [Java](#java)
diff --git a/website_and_docs/content/documentation/webdriver/getting_started/install_library.zh-cn.md b/website_and_docs/content/documentation/webdriver/getting_started/install_library.zh-cn.md
index 65b3bac3cbbd..96971d7bd03a 100644
--- a/website_and_docs/content/documentation/webdriver/getting_started/install_library.zh-cn.md
+++ b/website_and_docs/content/documentation/webdriver/getting_started/install_library.zh-cn.md
@@ -16,63 +16,87 @@ aliases: [
{{< tabpane disableCodeBlock=true >}}
{{< tab header="Java" >}}
-可以使用 Maven 安装 Java 的 Selenium 库。
+Installation of Selenium libraries for Java is accomplished using a build tool.
+You can see all available versions on
+[Maven Repository](https://mvnrepository.com/artifact/org.seleniumhq.selenium/selenium-java)
+
+### 可以使用 Maven 安装 Java 的 Selenium 库。
在项目 pom.xml 中添加 _selenium-java_ 依赖项：
-```xml
-
- org.seleniumhq.selenium
- selenium-java
- 4.4.0
-
-```
+1. specify the version in `properties`:
-For Gradle, add the _selenium-java_ dependency in your project `build.gradle` file:
+{{< gh-codeblock path="examples/java/pom.xml#L11-L12" >}}
-```text
-dependencies {
- compile group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+2. specify the dependency in `dependencies`
-Gradle 7.0 and above:
+{{< gh-codeblock path="examples/java/pom.xml#L30-L35" >}}
-```text
-dependencies {
- implementation group: 'org.seleniumhq.selenium', name: 'selenium-java', version: '4.4.0'
-```
+### Gradle
+in the project `build.gradle` file:
+
+1. specify the version in extra properties (`ext`):
+
+{{< gh-codeblock path="examples/java/build.gradle#L11-L12" >}}
+
+2. specify the dependency as `testImplementation` in `dependencies`
+
+{{< gh-codeblock path="examples/java/build.gradle#L17-L18" >}}
{{< /tab >}}
{{< tab header="Python" >}}
- 可以使用 pip 安装 Python 的 Selenium 库：
+
+### pip
```shell
pip install selenium
```
+### 下载
+
或者，您也可以下载 [PyPI source archive](https://pypi.org/project/selenium/#files)
(selenium-x.x.x.tar.gz) 并使用 _setup.py_ 进行安装：
```shell
python setup.py install
```
+
+### Require in project
+
+To use it in a project, add it to the `requirements.txt` file:
+{{< gh-codeblock path="examples/python/requirements.txt#L1" >}}
+
{{< /tab >}}
{{< tab header="CSharp" >}}
- 可以使用 NuGet 安装 C# 的 Selenium 库：
+### Packet Manager
```shell
-# Using package manager
Install-Package Selenium.WebDriver
-# or using .Net CLI
+```
+
+### .NET CLI
+
+```shell
dotnet add package Selenium.WebDriver
```
-## 支持的 .NET 版本
+
+### CSProj
+
+in the project's `csproj` file, specify the dependency as a `PackageReference` in `ItemGroup`:
+
+{{< gh-codeblock language="xml" path="examples/dotnet/SeleniumDocs/SeleniumDocs.csproj#L13" >}}
+
+### Additional considerations
+
+Further items of note for using Selenium with .NET:
+
+#### 支持的 .NET 版本
确保使用与.NET SDK版本兼容的相关[Selenium包](https://www.nuget.org/packages/Selenium.WebDriver).
检查依赖的部分用以找出[支持的 .NET 版本](https://dotnet.microsoft.com/en-us/download/dotnet).
在本次升级时, .NET 5.0 (Visual Studio 2019) 是已知的被支持的版本, 并且 .NET 6.0 并未支持.
您可以下载 [MSBuild Tools 2019 于此](https://docs.microsoft.com/en-us/visualstudio/install/create-an-offline-installation-of-visual-studio?view=vs-2019)
以安装所需的组件和依赖项, 例如 .NET SDK 和 NuGet 包管理器.
-## 使用 Visual Studio Code (vscode) 以及 C#
+#### 使用 Visual Studio Code (vscode) 以及 C#
这是一个快速指南, 可帮助您开始使用 vscode 和 C#, 但可能需要进行更多调研.
按照上一节安装兼容的 .NET SDK.
还要安装适用于 C# 和 NuGet 的 vscode 扩展 (Ctrl-Shift-X).
@@ -108,19 +132,34 @@ dotnet add package Selenium.WebDriver
{{< /tab >}}
{{< tab header="Ruby" >}}
- 可以使用 gem 安装 Ruby 的 Selenium 库：
+
+### Install locally
```shell
gem install selenium-webdriver
```
+### Add to project
+
+In your project's `Gemfile`:
+
+{{< gh-codeblock language="ruby" path="examples/ruby/Gemfile#L10" >}}
+
{{< /tab >}}
{{< tab header="JavaScript" >}}
- 可以使用 npm 安装 JavaScript 的 Selenium 库
+
+### Install locally
```shell
npm install selenium-webdriver
```
+
+### Add to project
+
+In your project's `package.json`, add requirement to `dependencies`:
+
+{{< gh-codeblock path="examples/javascript/package.json#L9-L10" >}}
+
{{< /tab >}}
{{< tab header="Kotlin" >}}
由于缺少Kotlin的原生语言的绑定, 您不得不借助Java的生态环境, 例如Maven [Java](#java)
diff --git a/website_and_docs/layouts/shortcodes/gh-codeblock.html b/website_and_docs/layouts/shortcodes/gh-codeblock.html
index 1ed932d49cf2..556c42f51634 100644
--- a/website_and_docs/layouts/shortcodes/gh-codeblock.html
+++ b/website_and_docs/layouts/shortcodes/gh-codeblock.html
@@ -25,8 +25,9 @@
{{ $apiUrl := printf "%s/%s/%s/contents%s?ref=%s" $apiBaseUrl $org $repo $path $branch }}
{{ $webUrl := printf "%s/%s/%s/blob/%s/%s" $webBaseUrl $org $repo $branch $fullPath }}
-{{ $slicedPath := split $path "/" }}
-{{ $language := index (last 1 (split (index (last 1 $slicedPath) 0) ".")) 0 }}
+{{ $filename := index (last 1 (split $path "/")) 0 }}
+{{ $fileExtension := (cond (in $filename ".") (index (last 1 (split $filename ".")) 0) "txt") }}
+{{ $language := .Get "language" | default $fileExtension }}
{{ $githubToken := (getenv "SELENIUM_CI_TOKEN") }}
{{ if $githubToken }}
@@ -50,7 +51,7 @@
{{ highlight $codeSnippet $language }}
-