Skip to content
Mozilla Webdev tools and pages
JavaScript CSS HTML
Branch: master
Clone or download
Latest commit ffbed70 Mar 30, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
.gitignore Display projects on the site and download metadata from Github. Feb 18, 2015
.travis.yml Set origin to something travis can push to. Mar 19, 2015
CODE_OF_CONDUCT.md Add Mozilla Code of Conduct file Mar 29, 2019
LICENSE
README.md
gulpfile.js
package.json Configure git on travis and include commit in deploy message. Mar 19, 2015
projects.json

README.md

Mozilla Webdev Tools and Pages

This repo serves several purposes:

  1. Contains code for building and deploying the gh-pages branch behind https://mozilla.github.io/webdev/.
  2. Contains small tools that are useful for the Mozilla Webdev group.

Developer Setup

These steps assume you have Node.js installed.

  1. Clone this repo:

    $ git clone https://github.com/mozilla/webdev.git
  2. Install dependencies:

    $ npm install -g gulp
    $ npm install
  3. (Optional) Add your Github credentials to a .env file in the repo's root. These are used by the build command when downloading metadata from Github. For security, you should probably use a Personal Access Token for the password and limit it to public_repo permissions only. For example:

    GITHUB_USERNAME=Osmose
    GITHUB_PASSWORD=some_personal_access_token
    

projects.json

projects.json contains a categorized list of projects the Webdev group is responsible for. It's intended to be manually kept up-to-date and is useful for running scripts across all Webdev projects.

Available Gulp Commands

gulp serve

Run a development server for the Github pages site on port 8000. Auto-builds the site when anything is changed in the src directory.

gulp build

Builds the site in the build directory. Runs all the HTML files through Nunjucks with the following context:

  • projects: Object containing the parsed contents of build/projects.json.

The metadata added to the projects list is downloaded from the Github API and is cached for 24 hours. The --force flag will force a re-download of this data.

Note that it's very easy to hit API limits if you haven't added your credentials to a .env file.

gulp deploy

Build the site and commit the changes to the gh-pages branch, pushing them to origin.

gulp validate_contribute_json

Fetch contribute.json files for all of the projects in projects.json and validate them. Currently only supports repos hosted on Github.

License

Licensed under the Apache 2.0 License. For details, see the LICENSE file.

You can’t perform that action at this time.