Skip to content

tinkerbell/tinkerbell.org

Repository files navigation

Tinkerbell

For complete documentation visit tinkerbell.org

Tinkerbell is a bare metal provisioning engine. It’s built and maintained with love by the Tinkerbell Community.

This repository is Experimental meaning that it's based on untested ideas or techniques and not yet established or finalized or involves a radically new and innovative style! This means that support is best effort (at best!) and we strongly encourage you to NOT use this in production.

Contributing

This website uses Hugo to generate static HTML pages. It's hosted and automatically build by Netlify (see netlify.toml for more details).

Build the site locally

Make sure you have installed Hugo on your system. Follow the instructions to clone this repository and build the docs locally.

  • Clone the repository
git clone https://github.com/tinkerbell/tinkerbell.org
cd tinkerbell.org
  • Fetch the theme submodule
git submodule update --init --recursive
  • Start local server
hugo server -D

Site can be viewed at http://localhost:1313

Generate custom css files

  • Run npm insall
npm install
  • Development
npm run watch
  • Production
npm run production

Making changes

Adding a new documentation page

# example: adding new documentation page under section
hugo new section/name-of-new-page.md

Modifying an existing documentation page

Find the documentation page file (.md file) under content/ and edit it.

Publishing your changes

Create a Pull Request with your changes. When the PR is merged site will be updated automatically by Netlify.

Licensing

The code snippets and the documentation is licensed under Apache license. See LICENSE for the full license text.