This repository hosts the content of the Bazel blog, available at https://blog.bazel.build/

Send a Pull Request adding a file to https://github.com/bazelbuild/bazel-blog/tree/master/_posts using the following filename format: <year>-<month>-<day>-<title>.md This filename format is required by the Jekyll processor.

Begin your post with the following lines:

---
layout: posts
title: <whatever>
authors:
  - username1  # See _config.yml for the list of authors.
  - username2
---

If you omit the layout, the blog post will not be formatted properly. If you omit the title, it won't have a title.

Write the body of your post below the "---". If you have headers in your post, use H2 and smaller headers (in makedown H2 is denoted by ##).

To build the site, you will need Jekyll version 2.5.3 or above. For instance, it can be installed with apt-get install jekyll on recent Ubuntu (tested on 16.10).

To deploy the site, you will need gsutil and to authenticate with gcloud auth login.

Or you can run a Docker container to avoid setting up Jekyll locally:

docker run --rm -it --entrypoint bash -v <path-to-bazel-blog>:/opt -w /opt -p 4000:4000 gcr.io/bazel-public/docgen

To stage the site, run bazel run //:site.

See the Jekyll site if you need more info.

The website is deployed automatically after new commits are merged into the master branch. The update time is around 30 mins - ping (bazel-dev@googlegroups.com) in case of problems.