/zilong88.github.io

Primary LanguageJavaScriptOtherNOASSERTION

Huobi API Documentation Project

Introduction

ddd This is the project for the official API documents of Huobi. This README will introduce how this project is structured and how to work with it.

API Tool

Huobi's API documentation is generated with Slate. This project is an fork of https://github.com/lord/slate slate.

Repo Structure and Overall Workflow

Huobi currently supports two versions of API (v1, v2) and two languages of API documents (English, Chinese), so we have a total of four versions of API documents sit in four branches: v1_en, v1_cn, v2_en, v2_cn. To access the web page of a specific version you can visit https://huobi.github.io/api_doc/{version}/{language}, e.g. for v1 english version visit https://huobi.github.io/api_doc/v1/en.

Recommended way to make a change by CI

  • Just need to make changes to ./source/index.html.md in specific branch and commit, let CI complete next two steps.

To make a change to a specific version of the documentation

  1. Checkout the target version's branch, e.g. if you want to update v1 chinese documents, checkout v1_cn

  2. Make changes to source/index.html.md in this branch and commit

  3. Run deploy.sh to deploy the changes to the website.

  4. Confirm the result on the web page, if all look good, push the changes.

To make a change to common files (logo, style, layout)

  1. Checkout master branch

  2. Make the common file changes

  3. Commit and push the changes

  4. Checkout each version's branch, merge/cherry-pick, then run deploy.sh

Make Changes

There are two main types of changes: appearance and content.

Appearance Change

Content Change

Build and Deploy the API

Set Up Slate Build and Deploy Environment Locally

https://github.com/lord/slate/wiki/Installing-Slate

Publish API Documents

https://github.com/lord/slate/wiki/Deploying-Slate