<commit_before># Web Fundamentals on DevSite

[![Build Status](https://travis-ci.org/google/WebFundamentals.svg?branch=master)](https://travis-ci.org/google/WebFundamentals)

Welcome to the new Web**Fundamentals**! An effort to showcase best practices and tools for modern Web Development.


### What's changed?

* We're now using the [DevSite](https://developers.google.com/) infrastructure
  * New [style guide](https://petele-scratch.appspot.com/web/resources/style-guide)
  * New [widgets](https://petele-scratch.appspot.com/web/resources/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](https://petele-scratch.appspot.com/web/resources/writing-an-article#yaml-front-matter)

### What stays the same?

* GitHub is still our source of truth for content,
* We want your contributions, either PRs, issues, whatever!
* The latest is staged at https://web-central.appspot.com/web/

## Cloning the repo
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
```

## Getting set up
The new DevSite infrastructure simplifies the dependencies a lot. Ensure
you have a recent version of [Node](https://nodejs.org/en/) and the
[AppEngine SDK for Python](https://cloud.google.com/appengine/downloads#Google_App_Engine_SDK_for_Python)
already installed.

1. Run `npm install` (needed for the build process)

## Build the auto-generated files
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:

```
npm run build
```

## Start Local Server

To view the site locally, just run:

```
npm start
```

## Update the code labs
To update the Code Labs, you'll need the
[`claat`](https://github.com/googlecodelabs/tools/tree/master/claat) tool, and<commit_msg>Update  README.md (#5231)<commit_after># Web Fundamentals on DevSite

[![Build Status](https://travis-ci.org/google/WebFundamentals.svg?branch=master)](https://travis-ci.org/google/WebFundamentals)

Welcome to the new Web**Fundamentals**! An effort to showcase best practices and tools for modern Web Development.


### What's changed?

* We're now using the [DevSite](https://developers.google.com/) infrastructure
  * New [style guide](https://petele-scratch.appspot.com/web/resources/style-guide)
  * New [widgets](https://petele-scratch.appspot.com/web/resources/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](https://petele-scratch.appspot.com/web/resources/writing-an-article#yaml-front-matter)

### What stays the same?

* GitHub is still our source of truth for content,
* We want your contributions, either PRs, issues, whatever!
* The latest is staged at https://web-central.appspot.com/web/

## Cloning the repo
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
```

## Getting set up
The new DevSite infrastructure simplifies the dependencies a lot. Ensure
you have a recent version of [Node](https://nodejs.org/en/) and the
[AppEngine SDK for Python](https://cloud.google.com/appengine/downloads#Google_App_Engine_SDK_for_Python)
already installed.

1. Run `npm install` (needed for the build process)

## Build the auto-generated files
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:

```
npm run build
```

## Start Local Server

To view the site locally, just run:

```
npm start
```

## Update the code labs
To update the Code Labs, you'll need the
[`claat`](https://github.com/googlecodelabs/tools/tree/master/claat) tool and
{'fraction_non_alphanumeric': 0.10865051903114187, 'fraction_numerical': 0.001384083044982699, 'mean_word_length': 4.804551539491299, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 22, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6010433', 'n_tokens_mistral': 1317, 'n_tokens_neox': 1246, 'n_words': 477}