This project is not active anymore. about:healthreport was removed from Firefox in version 59 (bug 1352497).
This is a very simple static website generator for the content ("jelly") that will be injected into the about:healthreport page.
Based on nocturnal, it takes a single jinja2 template, throws in some translations from .lang files, and generates a bunch of static, localized output files.
git clone git://github.com/mozilla/fhr-jelly.git
The localization files will live in another Git repository and do not exist yet. Check them out into the subdirectory "locale" to pull in translations.
cd fhr-jelly
git clone https://github.com/mozilla-l10n/fhr-l10n.git locale
Specify a version to build in settings.py. Available versions are 'passive' and 'urgent'. 'Passive' is the default.
Specify an output directory (it shouldn't be the same directory as the repo) and allow a few seconds for the script to scrape Mozilla's FTP server.
./generate.py --output-dir html
To delete the output dir before generating the output (careful!), use the --force option.
./generate.py --output-dir html -f
The build version can be overwritten with the --version command line argument.
./generate.py --version urgent -f
If you change localizable strings in the templates, you'll want to extract those strings and add them to the .lang files.
./l10n_extract.py
should do the trick.
To render the FHR page using a custom JSON payload, follow these steps:
-
Clone this repo:
git clone git://github.com/mozilla/fhr-jelly.git
-
You need to run this on a simple web server. The easiest is to use the built in server that comes with Python. Add the following to your .bash_profile
alias server='python -m SimpleHTTPServer && open http://localhost:8000'
From the command line run the following:
-
cp js/config.js-local js/config.js
-
cp json/payload.json-local json/payload.json
-
Next, open up json/payload.json and paste your custom JSON in here.
-
Run generate:
./generate.py --output-dir html -f
-
Open up your browser and point it to about:healthreport
This software is licensed under the Mozilla Tri-License:
***** BEGIN LICENSE BLOCK *****
Version: MPL 1.1/GPL 2.0/LGPL 2.1
The contents of this file are subject to the Mozilla Public License Version
1.1 (the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.mozilla.org/MPL/
Software distributed under the License is distributed on an "AS IS" basis,
WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
for the specific language governing rights and limitations under the
License.
The Original Code is Nocturnal.
The Initial Developer of the Original Code is Mozilla.
Portions created by the Initial Developer are Copyright (C) 2012
the Initial Developer. All Rights Reserved.
Contributor(s):
Matthew Riley MacPherson <[email protected]>
James Long <[email protected]>
Fred Wenzel <[email protected]>
Laura Thomson <[email protected]>
Benjamin Smedberg <[email protected]>
Katie Parlante <[email protected]>
Georg Fritzsche <[email protected]>
Alternatively, the contents of this file may be used under the terms of
either the GNU General Public License Version 2 or later (the "GPL"), or
the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
in which case the provisions of the GPL or the LGPL are applicable instead
of those above. If you wish to allow use of your version of this file only
under the terms of either the GPL or the LGPL, and not to allow others to
use your version of this file under the terms of the MPL, indicate your
decision by deleting the provisions above and replace them with the notice
and other provisions required by the GPL or the LGPL. If you do not delete
the provisions above, a recipient may use your version of this file under
the terms of any one of the MPL, the GPL or the LGPL.
***** END LICENSE BLOCK *****