Git Product home page Git Product logo

doc-site's Introduction

TigerGraph Documentation Site Build

This repository contains the Antora playbook used to build the TigerGraph documentation site.

Install dependencies

To install dependencies, navigate to this repository and run:

npm install

Build site locally

To build the site locally, run:

npm run build

The build will be available in the build/ folder in the root directory.

Important
Though the files are all in the /build folder, you won’t be able to access other pages through the links if the files are not served by a server. To preview locally, you can Run a local server to view the build. If you really don’t want to use a local server, edit the antora-playbook.yml file in your local environment, and change the html_extension_style under urls to default. This allows you to open the static files and have the links work.

Build from your local content source repository

To have Antora build the site from your local content source repository, change the corresponding content source in the file antora-playbook.yml to point to your local git repository.

See Use local content repositories on Antora’s documentation.

Watch Mode

Watch Mode launches a local web server for preview. It will continue watching your local content source repository changes and rebuild the site.

npm run dev

You can access the web server at http://localhost:5000.

Run a local server to view the build

To open the build, run:

$ npm i -g http-server
$ http-server build/site -c-1

Upon launching the command, the local address of the web server will be displayed in your terminal. You should see the following output in your terminal:

Starting up http-server, serving build/site
Available on:
  http://127.0.0.1:8080
  http://192.168.1.8:8080
Hit CTRL-C to stop the server

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.