schaam / free-pdk.github.io

Source of the Free PDK documentation website.

Free PDK Online Documentation

This repository holds the source of the documentation available at https://free-pdk.github.io/.

Local Setup

This site uses Jekyll. Jekyll is a static site generator that takes markdown files and transforms them to HTML.

To run Jekyll locally, install ruby >=2.5.0 and the bundler gem (gem install bundler). Then install dependencies by running bundle install and build the site by calling bundle exec jekyll serve --livereload.

Deployment

Every commit on the production branch is built and deployed by a GitHub Action and the result is force-pushed to the master branch, which is deployed to https://free-pdk.github.io by GitHub Pages.

The production branch is also automatically deployed by netlify to https://free-pdk-preview.netlify.app/. Logs can be viewed by clicking on this badge:

All pull requests are also built and deployed by netlify so that you can easily review pull requests without having to check them out locally.

There is one difference between the versions deployed to netlify and the version deployed to GitHub Pages: All URLs on netlify are automatically transformed to lower case, whereas URLs on GitHub Pages are case sensitive. For example, the URL /chips/PFS173 works as expected on GitHub Pages and redirects to /chips/pfs173 on netlify, whereas the URL /chips/pfs173 works on netlify but returns 404 on GitHub Pages.