Welcome to the new WebFundamentals! 
- We're now using the DevSite infrastructure
- New style guide
- New widgets allow inline JavaScript, common links, related guide and more
- Jekyll has been eliminated, instead pages are rendered at request time
- Front-matter has been eliminated from the markdown, but files now require a simple set of tags
- GitHub is still our source of truth for content,
- We want your contributions, either PR's, issues, whatever!
- The latest will be staged at https://web-central.appspot.com/web/
If you have a high bandwidth connection, I recommend starting with a fresh clone of the repo.
git clone https://github.com/google/WebFundamentals.git
The new DevSite infrastructure simplifies the dependencies a lot. Ensure you have a recent version of Node, Gulp and the AppEngine SDK for Python already installed.
- Run
npm install(needed for the build process)
Some files (contributors includes, some pages for updates, showcases, etc) are
automatically generated. The first time you clone the repo and run npm install,
this is done for you. However, when you add a case study, update, etc., you'll
need to re-build those files using:
gulp build
To update the Code Labs, you'll need the
claat tool, and
access to the original Doc files. This will likely only work for Googlers.
- Download the
claattool and place it in yourtoolsdirectory. - Run
tools/update-codelabs.sh - Check the latest changes into GitHub
- Run
npm start
Please run your changes through gulp test before submitting a PR. The test looks for things that may cause issues with DevSite and tries to keep our content consistent. It's part of the deployment process, so PRs will fail if there are any errors! To run:
gulp test