No description
  • SCSS 31.1%
  • CSS 29.5%
  • HTML 24.4%
  • JavaScript 12.2%
  • Shell 2.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Mike Urbach b292d5a218 [CD] Request permissions to push to gh-pages branch.
The GITHUB_TOKEN used to have lots of privileges, but this has now
been locked down, so we need to explicitly request write permission
for contents to be able to push to the gh-pages branch.
2024-02-21 16:57:10 -07:00
.github/workflows [CD] Request permissions to push to gh-pages branch. 2024-02-21 16:57:10 -07:00
website Add labels to the main diagram in the homepage (#17) 2023-07-28 11:56:00 -06:00
.editorconfig Add doxygen support 2021-01-10 13:54:43 +05:30
.gitignore Add doxygen support 2021-01-10 13:54:43 +05:30
copy_docs.sh Change processing of included docs 2022-07-06 00:18:12 -07:00
process_included_docs.sh Change processing of included docs 2022-07-06 00:18:12 -07:00
README.txt just a touch to enable Github Action 2021-10-16 14:14:26 -07:00

# CIRCT WWW

This contains the source code for https://circt.llvm.org/ ; which is rendered
from the `gh-pages` branch of the same repo using GitHub pages.

To contribute, feel free to fork this repository and send a pull-request.

The website is deployed on every push to this repository using a GitHub
action defined in `.github/workflows/main.yml`. It also runs once at the end of 
each day to catch updates from the CIRCT source repository, which
is used for generating some docs.

We are using the [Hugo](https://gohugo.io/) framework for generating the
website. The source pages are written in Markdown format under the
`website/content` folder.

The expected workflow is to download hugo on your machine, and run
`hugo server` from the `website` directory. You can then access a local
version of the website from http://localhost:1313/ ; anychange you
make to the source Markdown will automatically be refreshed by the local
hugo server.

A large part of the documentation is auto-generated from the CIRCT source
code. See the workflow `.github/workflows/main.yml` for the instructions
to reproduce the entirety of https://circt.llvm.org/ locally.