GithubHelp home page GithubHelp logo

lauraxt / fhr-jelly Goto Github PK

View Code? Open in Web Editor NEW

This project forked from mozilla/fhr-jelly

0.0 1.0 0.0 1.76 MB

Content that will appear in about:healthreport

License: Other

JavaScript 75.34% CSS 14.17% Python 10.05% Shell 0.45%

fhr-jelly's Introduction

Firefox Health Report - Jelly

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 SVN, but do not exist yet. Check them out into the subdirectory "locale" to pull in translations.

cd fhr-jelly
svn checkout https://svn.mozilla.org/projects/l10n-misc/trunk/firefoxhealthreport/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 --output-dir html -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]>

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

dzeber avatar fwenzel avatar jpetto avatar lauraxt avatar lonnen avatar pascalchevrel avatar rnewman avatar sancus avatar solarce avatar

Watchers

 avatar

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.