clementtalleu/website

The API Platform website

api-platform.com

This repository contains the source code and documentation powering api-platform.com.

Single Page Application built with React and powered by Gatsby.

Project structure

For an overview of the project structure, please refer to the Gatsby documentation.

Installation and usage

To run the installation script, you will need jq. Be sure to install them first and to have the binaries in your path.

# Checkout project

git clone https://github.com/api-platform/website.git

# Install dependencies

yarn install

# Retrieve documentation

bin/retrieve-documentation

# Run project locally (for development)

yarn gatsby develop
# Go to http://localhost:8000/

# Build the project (for production)

yarn gatsby build

# Test the built project locally

yarn gatsby serve
# Go to http://localhost:9000

Publishing Docs For New Versions

1. Create a branch for the new version in the api-platform/docs repository.
2. Update Algolia DocSearch configuration

{
  "index_name": "api-platform",
  "start_urls": [
    {
      "url": "https://api-platform.com/docs/(?P<version>.*?)/",
      "variables": {
        "version": [
          "master",
          "2.5",
          "2.4",
          "2.3",
          "2.2",
          "2.1"
        ]
      }
    },
    // ...
  },
  // ...
}

3. Add the new version in constants.js

module.exports = Object.freeze({
  // ...
  versions: ['master', '2.4', '2.3', '2.2', '2.1'],
  currentVersion: '2.5',
  masterVersion: '2.6',
  // ...
});