-
-
Notifications
You must be signed in to change notification settings - Fork 1.4k
/
Copy pathREADME.md
executable file
·68 lines (46 loc) · 4.64 KB
/
README.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
[](https://github.com/SeleniumHQ/seleniumhq.github.io/actions?query=workflow%3A%22Publish+Selenium+Site%22)
[](https://github.com/SeleniumHQ/seleniumhq.github.io/actions/workflows/java-examples.yml)
[](https://github.com/SeleniumHQ/seleniumhq.github.io/actions/workflows/kotlin-examples.yml)
[](https://github.com/SeleniumHQ/seleniumhq.github.io/actions/workflows/python-examples.yml)
[](https://github.com/SeleniumHQ/seleniumhq.github.io/actions/workflows/js-examples.yml)
[](https://github.com/SeleniumHQ/seleniumhq.github.io/actions/workflows/ruby-examples.yml)
[](https://github.com/SeleniumHQ/seleniumhq.github.io/actions/workflows/dotnet-examples.yml)
<a href="https://selenium.dev"><img src="https://selenium.dev/images/selenium_logo_square_green.png" width="200" alt="Selenium"/></a>
# Selenium Site and Documentation
This is the repository used to build and publish the official Selenium [website](https://selenium.dev).
## Quick start
We use [Hugo](https://gohugo.io/) and the [Docsy theme](https://www.docsy.dev/)
to build and render the site. You will need the **extended**
Sass/SCSS version of the Hugo binary to work on this site. We recommend
to use **[Hugo 0.125.4](https://github.com/gohugoio/hugo/releases/tag/v0.125.4)**
Steps needed to have this working locally and work on it:
- Follow the [Install Hugo](https://www.docsy.dev/docs/get-started/other-options/#install-hugo) instructions from Docsy
- [Install go](https://go.dev/doc/install)
- Clone this repository
- Run `cd website_and_docs`
- Run `hugo server`
A full contribution guideline can be seen at [contributing](https://selenium.dev/documentation/about/contributing/)
## How to get involved?
Please check all the information available at <https://selenium.dev/getinvolved/>
### Do not want to clone the repository to contribute? Use GitPod
[](https://gitpod.io/#https://github.com/SeleniumHQ/seleniumhq.github.io)
## For Selenium Site and Documentation maintainers
### How does the site and docs get build?
GitHub actions runs for every commit on each PR and protected branch. The regular CI execution will
build the site with Hugo to verify that the commit works. The description of these steps can be seen
at the actions configuration file, [one for testing a PR](./.github/workflows/test.yml), and [one for deploying the site](./.github/workflows/deploy.yml)
### How are the site and docs deployed?
After each CI execution that happens in the `trunk` branch, the script [build-site.sh](./build-site.sh) is executed for deployment. This script checks for the string `[deploy site]` in the commit message.
If the commit message contains that string, and the commit is in `trunk`, a [GitHub action](./.github/workflows/deploy.yml) is triggered to build and deploy the site.
The site and docs will be built, and the changes will be committed to the branch `publish` by the user [Selenium-CI](https://github.com/selenium-ci/).
*What is important to take into account is that the source files for the site are in the `trunk`
branch, and the files that get deployed are pushed to the `publish` branch.*
The site is deployed using GitHub pages, and the configuration for this can be seen at the
repo [settings](https://github.com/SeleniumHQ/seleniumhq.github.io/settings) (if you are a maintainer
you should be able to access the link).
The selenium.
domain is managed at <https://www.gandi.net/en>, if you need access to it, reach out to any of the [PLC](https://www.selenium.dev/project/structure/#plc) or [TLC](https://www.selenium.dev/project/structure/#tlc)
members, who can help you with that.
If for any reason, you need to setup the domain redirection again,
we followed this [guide](http://spector.io/how-to-set-up-github-pages-with-a-custom-domain-on-gandi/),
but any tutorial/guide showing how to redirect a domain to GitHub pages should do.