Quick start

Your first APIdocs website is just a few steps away.

  1. Clone APIdocs starter project.

    git clone https://github.com/carrotsearch/gatsby-starter-apidocs.git
  2. Install dependencies.

    Make sure you have Node.JS version 10 or later and yarn installed. Then fetch APIdocs dependencies:

    cd gatsby-starter-apidocs
    yarn install
  3. Edit site title and description.

    Open gatsby-config.js and edit metadata of your side located in the siteMetadata node. The title property is the title to display in browser's tab, description is the text to use in the description meta tag. You can also customize the HTML lang attribute.

  4. Start Gatsby in development mode.

    yarn develop

    Once Gatsby development server starts, open http://localhost:8000 in your browser to see the website you're building. Gatsby will automatically update the page as you edit the content.

  5. Customize logo and footer.

    Use your favorite IDE to edit src/logo.html and src/footer.html. Contents of both files must contain valid HTML, but feel free to use in-line SVG to include logos in both files.

    Once you save the changes, you should see them applied in real time in the browser.

  6. Start documenting!

    For each article in your documentation, add an HTML file to the src/content/ folder. The root tag of each HTML file must be an article and it must contain an h1 child tag containing the article's title.

    Edit src/navigation.json to add newly-created articles to the navigation menu. Currently, only two-level navigation is supported.

  7. Build and deploy.

    Once you've completed editing your documentation, you can build the final optimized static site by running:

    yarn clean
    yarn build

    The public/ folder will contain the static site to deploy.