This repo contains the Thunderbird in-client Start page and the www.thunderbird.net website.
- The
prod
branch is used to update https://start.thunderbird.net and https://www.thunderbird.net. - The
master
branch is used to update https://start-stage.thunderbird.net and https://www-stage.thunderbird.net.
On Ubuntu, you would need to use apt-get instead of yum, and similarly for different package managers. Also, the website is incompatible with LESS 3.0 or above.
pip install -r requirements.txt
git clone https://github.com/thundernest/thunderbird-notes.git thunderbird_notes
git clone https://github.com/mozilla/product-details-json
sudo yum install npm
sudo npm install -g [email protected]`
If you need the localizations to display pages translated from English into other languages:
git clone https://github.com/thundernest/thunderbird.net-l10n.git locale
l10n_tools/compile.sh
A basic build is python build-site.py
.
It builds www.thunderbird.net into the thunderbird.net
directory by default.
There are additional arguments:
-
--startpage
- This builds the start page into the
site
directory.
- This builds the start page into the
-
--enus
- This restricts builds to only the 'en-US' locale, for faster testing.
-
--debug
- This logs output for each locale built and some of the templates, used to make debugging easier.
-
--watch
- This starts an HTTP server on localhost port 8000, and watches the template and assets folders for changes and then does quick rebuilds.
- Note that this only rebuilds when you modify a file. To add or remove files, you should start a new build.
-
--port
- Sets the port to be used for the localhost server. Default is 8000. Format:
--port 8000
.
- Sets the port to be used for the localhost server. Default is 8000. Format:
-
thunderbird.net templates are in the
website
directory, and start page in thestart-page
dir. Assets are shared and in theassets
dir.
To view the website for testing purposes, run python build-site.py --watch
. This also works with the start page.
You can then navigate to: https://127.0.0.1:8000 to view the website. None of the apache redirects work in this mode, so you have to click your desired locale manually in the browser, but the site should behave normally after that.
In general, you only need to manually build the website for testing and development purposes. Webhooks on each of the repositories trigger automatic rebuilds when:
- https://github.com/thundernest/thunderbird-notes.git (Release Notes) are updated.
- https://github.com/mozilla/product-details-json (Product Details) are updated. Product details contains data on what versions of Thunderbird exist.
- Currently stage doesn't update automatically from product-details changes.
Both of these update frequently enough(multiple times per week) that independent updates for localization are not necessary. Any triggered update will always use the most recent data available from all sources. If changes to one of the above repos don't produce any change in the built files, no actual update of the web server will occur.
Occasionally you need to update the site manually, for example to move changes made to this repo to stage and production, or because the automation failed, or any reason like that. You'll need to either login to the control node as described in the https://github.com/thundernest/thundernest-ansible documentation or check out and setup the thundernest-ansible scripts on your local machine. That is also covered in the documentation for thundernest-ansible.
Assuming you are logged into the control node or have thundernest-ansible set up:
For stage:
cd thundernest-ansible
source files/secrets.sh
ansible-playbook plays/website-build.yml
For prod:
cd thundernest-ansible
source files/secrets.sh
ansible-playbook --extra-vars="branch=prod" plays/website-build.yml
The website-build.yml ansible script performs complete builds of the website, including both the start page and thunderbird.net itself.
- Completed and pushed builds from automation or the website-build.yml script are checked into https://github.com/thundernest/tb-website-builds -- the
master
branch represents the files currently on stage, and theprod
branch represents the files currently on the live version of thunderbird.net.