This repository contains the source code for https://adoptium.net.

The main branch contains the source code necessary for development. The production site is hosted on Netlify which also supports pull request staging.

This is is a Node.js / npm driven stack with AsciiDoc used for static content and Gatsby as the rendering engine etc.

This assumes you already have Node.js and npm installed. At time of writing we use Node.js 16.14.0 and npm 8.3.1. We recommend using nvm to manage your versions.

1. Install your dependencies

   npm install
   npm install --global gatsby-cli

2. Start the site up. Gatsby will build all of the various parts of the site (Asciidoc etc). Note that this command takes some time to execute.

   gatsby develop

3. Open the source code and start editing!

   Your site is now running at http://localhost:8000!

   Note: You'll also see a second link:http://localhost:8000/___graphql. This is a tool you can use to experiment with querying your data. Learn more about using this tool in the Gatsby tutorial.

   Open the directory in your code editor of choice and edit relevant files under the src/ directory. Save your changes and the browser will update in real time!

gatsby-config.js is effectively your build script and gatsby-node.js is where the Asciidoc rendering takes place.

See CONTRIBUTING.md