Giter VIP home page Giter VIP logo

fhr-jelly's Introduction

This project is not active anymore. about:healthreport was removed from Firefox in version 59 (bug 1352497).

Firefox Health Report - Jelly

Build Status

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.

Usage

Checkout

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

Choosing a build version

Specify a version to build in settings.py. Available versions are 'passive' and 'urgent'. 'Passive' is the default.

Generating output files

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

Extracting .lang files

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.

Enable Debug Mode

To render the FHR page using a custom JSON payload, follow these steps:

  1. Clone this repo:

    git clone git://github.com/mozilla/fhr-jelly.git

  2. 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

    usage

    $ server

    alias server='python -m SimpleHTTPServer && open http://localhost:8000'

From the command line run the following:

  1. cp js/config.js-local js/config.js

  2. cp json/payload.json-local json/payload.json

  3. Next, open up json/payload.json and paste your custom JSON in here.

  4. Run generate:

    ./generate.py --output-dir html -f

  5. Open up your browser and point it to about:healthreport

License

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 *****

fhr-jelly's People

Contributors

april avatar bsmedberg avatar dexterp37 avatar dzeber avatar flodolo avatar fwenzel avatar georgf avatar jpetto avatar kparlante avatar lauraxt avatar lonnen avatar ncalexan avatar pascalchevrel avatar poiru avatar rnewman avatar sancus avatar solarce avatar swarnava avatar wh0 avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

fhr-jelly's Issues

[feature] Interactive Raw Data JSON

I've been working a lot with FHR and having to always look at the Raw Data tab gets tiring when dumping a huge plain json object as text all day long.

I made a greasemonkey extension to colorize and add folding to the JSON there (see attached gif) and figured this might be useful for more people (maybe with a different style? ) if an iteration of this would be part of the actual about:healthreport page so I wanted to get your opinion on this

fhr-raw-data

Set protected status on production branch

The production branch on this repository is not protected against force pushes. This setting is recommended as part of Mozilla's Guidelines for a Sensitive Repository.

Anyone with admin permissions for this repository can correct the setting using this URL.

If you have any questions, or believe this issue was opened in error, please contact us and mention SOGH0001 and this repository.

Thank you for your prompt attention to this issue.
--Firefox Security Operations team

Error on string extraction (trailing spaces)

I tried to run l10n_extract.py on FHR but I get this error for all locales (en-US included).

I believe the problem is the final blank space (I can see it in the .lang file, but generate.py doesn't).

WARNING:root:Unknown text "You are currently sharing your health report with Mozilla. " for language XXX
WARNING:root:Unknown text "You are currently not sharing your health report with Mozilla. " for language XXX

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.