Merge pull request linode#45 from leslitagordita/local-api-docs-build

[New] Add way to build the api docs site from a local spec file

Author: alioso

develop.sh

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+bash ./getDependencies.sh ${1}
+gatsby develop;

getDependencies.sh

@@ -1,24 +1,37 @@
 BLUE='\033[0;34m'
 NC='\033[0m' # No Color
 
+SPEC_FILE=""
+if [ -n ${1} ]; then
+  SPEC_FILE=${1}
+  echo $([ -f $SPEC_FILE ])
+fi
+
 echo
-echo "${BLUE}Fetching base theme${NC}"
+printf "${BLUE}Fetching base theme${NC}\n"
 if
   cd linode-hugo-theme; then
   git pull origin development; else
   git clone https://github.com/linode/linode-hugo-theme.git;
 fi
 
-echo
-echo "${BLUE}Fetching API specs${NC}"
-cd -
-curl https://raw.githubusercontent.com/linode/linode-api-docs/master/openapi.yaml > static/api/docs/v4/openapi.yaml
+if [ -f "$SPEC_FILE" ]; then
+  echo
+  printf "${BLUE}Using local spec file at: ${SPEC_FILE}${NC}\n"
+  cat $SPEC_FILE > static/api/docs/v4/openapi.yaml;
+else
+  echo
+  printf "${BLUE}Fetching API specs${NC}\n"
+  cd -
+  curl https://raw.githubusercontent.com/linode/linode-api-docs/master/openapi.yaml > static/api/docs/v4/openapi.yaml;
+fi
+
 
 echo
-echo "${BLUE}Removing faulty data${NC}"
+printf "${BLUE}Removing faulty data${NC}\n"
 sed -i.bak '/backgroundColor:/d' static/api/docs/v4/openapi.yaml
 rm static/api/docs/v4/openapi.yaml.bak
 
 echo
-echo "${BLUE}Converting YAML to JSON${NC}"
-./node_modules/yamljs/bin/yaml2json static/api/docs/v4/openapi.yaml > static/api/docs/v4/spec.json
+printf "${BLUE}Converting YAML to JSON${NC}\n"
+node_modules/yamljs/bin/yaml2json static/api/docs/v4/openapi.yaml > static/api/docs/v4/spec.json

package.json

@@ -50,7 +50,7 @@
   ],
   "scripts": {
     "build": "./getDependencies.sh && gatsby build && node search/buildIndex.js",
-    "develop": "./getDependencies.sh && gatsby develop",
+    "develop": "./develop.sh",
     "start": "npm run develop",
     "serve": "gatsby serve",
     "test": "echo \"Write tests! -> https://gatsby.app/unit-testing\""