passcod / blog.rust-lang.org

The Rust Programming Language Blog

The Rust blog

This is the blog of the Rust Programming Language.

It's implemented as a small static site generator, that's deployed to GitHub Pages via Travis.

Building

To build the site locally:

> git clone https://github.com/rust-lang/blog.rust-lang.org
> cd blog.rust-lang.org
> cargo run

You could do it in release mode if you'd like, but it's pretty fast in debug.

From there, the generated HTML will be in a site directory. You can use any web server to check it out in your browser:

> cd site
> python3 -m http.server

The site is now available at http://0.0.0.0:8000.

If you need to preview the site from another machine, pass the host's address via --bind. For example, if running on 192.168.72.73:

> cd site
> python3 -m http.server --bind 192.168.72.73

The site is now available at http://192.168.72.73:8000.

(As a short-cut: If you pass --bind 0.0.0.0, the server will be reachable at all of the host's IP addresses.)

Contributing

First of all, thank you!

Like everything in Rust, the blog is licensed MIT/Apache 2.0. See the two LICENSE-* files for more details. We're also governed by the Rust Code of Conduct, see CODE_OF_CONDUCT.md for more.

Please send pull requests to the master branch. If you're trying to do something big, please open an issue before working on it, so we can make sure that it's something that will eventually be accepted.

When writing a new blog post, keep in mind the file headers:

---
layout: post
title: Title of the blog post
author: Blog post author (or on behalf of which team)
release: true (to be only used for official posts about Rust releases announcements)
---