/fusion

Fusion API documentation

Primary LanguageSCSSApache License 2.0Apache-2.0

Overview

Fusion API doc.

Written in markdown using the Slate doc format.

Requirements

  • Slate 2.3.1
  • Linux / macOS (Windows supported using WSL2)
  • Ruby > v2.3.1
  • Bundler

Getting started

Instructions below detail how to compile Slate using WSL2 & Ubuntu 20.04 LTS

Installing dependencies

  • Install WSL2 using Ubuntu distro
  • Run the commands below use Bash on Ubuntu on Windows or Windows Terminal
    • sudo apt-get update
    • sudo apt install make g++ zlibc zlib1g zlib1g-dev nodejs ruby-bundler ruby-full
    • sudo apt install ruby ruby-dev build-essential libffi-dev zlib1g-dev liblzma-dev nodejs patch
    • sudo gem update --system
    • sudo gem install bundler
  • Change to the documentation install directory e.g. Run cd /mnt/c/Docs.UnifyCloudPOS/doc
  • Run bundle install

Using slate

Update the page by editing markdown under slate/source.

Run bundle exec middleman server to start the middleman process. This will convert the site markdown to HTML on-the-fly each time you refresh the page. When you run middleman it will display the URL for your site, e.g. something like http://127.0.0.1:4567 (note: use 127.0.0.1 if you can't access the IP provided)

To build static HTML files for production deployment, run bundle exec middleman build --clean. Static HTML files will be exported to slate/build.

Stylesheets be be edited under source/stylesheets

  • added extra ToC heading to 'all_nosearch.js' in the javascript folder to allow the search engine to include the new ToC heading

Notes

Updated ToC as per https://github.com/slatedocs/slate/wiki/Deeper-Nesting

Version History

v1.0.0 ??