This is the repository used to build and publish the official Selenium website.
We use Hugo to build and render the site and docs, which are two separate Hugo projects.
After cloning the repository, if you want to make changes to the
site, work on the site_source_files
directory. To make changes to the docs,
switch to the docs_source_files
directory. To see a live preview of your
changes, run hugo server
on each directory.
% cd site_source_files/docs_source_files
% hugo server
A full contribution guideline can be seen at contributing
Please check all the information available at https://selenium.dev/getinvolved/
Travis CI runs for every commit on each PR and protected branch. The regular CI execution will just build the site with Hugo to verify that the commit works. The description of these steps can be seen at the Travis configuration file here.
After each CI execution that happens in the master branch, the script 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 master, deploy.sh is invoked from build-site.sh. The site and docs will be built, and the changes will be committed to master by the user Selenium-CI.
The site and docs are deployed using GitHub pages, and the configuration for this can be seen at the repo settings (if you are a maintainer you should be able to access the link).
The selenium.dev domain is managed at https://www.gandi.net/en, if you need access to it, reach out to any of the PLC or TLC members, who can help you with that.
If for any reason, you need to setup the domain redirection again, we followed this guide, but any tutorial/guide showing how to redirect a domain to GitHub pages should do.