Files
carbon-lang/website
Chandler Carruth b79ce84f33 Switch to uv for all of our Python scripts (#7242)
This removes the need to install any specific version of Python or
figure out how to configure it by instead asking users to install `uv`
and letting it manage Python. Among other advantages, `uv` is designed
to be fast enough to embed directly into our scripts.

We were already using this in `bench_runner.py` so that the script could
import non standard library dependencies. Moving to it for the rest of
our Python unifies the approach and will also enable dependencies
whenever needed.

I've left `github_tools` alone as it has special handling with its own
Bazel setup.

I've updated the contributing tools to explain the approach here.
2026-05-28 18:03:52 +00:00
..
2024-08-20 17:53:06 +00:00
2024-08-20 17:53:06 +00:00
2024-08-20 17:53:06 +00:00
2024-08-20 17:53:06 +00:00
2024-08-20 17:53:06 +00:00
2024-08-20 17:53:06 +00:00
2024-08-20 17:53:06 +00:00

Documentation website

Table of contents

Overview

Carbon's main website is the GitHub project page. Carbon remains too early and experimental to have a full-fledged website.

This directories contains infrastructure for building the convenience documentation website, which should be at https://docs.carbon-lang.dev.

Build process

Website generation is done by gh_pages_deploy.yaml. It runs prebuild.py, which prepares files for website generation, then builds the website using Jekyll, configured through _config.yml.

Development tips

rbenv can be used to set up Ruby and bundle.

To run a server, run bundle exec jekyll serve. See Jekyll docs for more commands.

To update the Gemfile.lock after Gemfile changes, run bundle update.

Domain configuration

The custom domain is configured in three places:

Note all of these require admin permissions to modify. For sharing test pages, a GitHub user and repository can be used, pushing to <username>.github.io (or getting a custom DNS setup).