Files
Plugin/Handbook

The SenseGlove Unreal Engine Handbook

Prerequisites

  • GNU Make
  • Git
  • The Rust Toolchain

Microsoft Windows Prerequisites Installation Notes

  • Download and install Git Bash for Windows.
  • Download and install the Rust Toolchain.
  • Download a without-guile binary build of GNU Make for Windows from ezwinports, e.g. make-4.4.1-without-guile-w32-bin.zip.
  • make-*-without-guile-w32-bin.zip/* contents should be extracted and copied to your Git\mingw64\, e.g. C:\Program Files\Git\mingw64\, merging the folders, WITHOUT overwriting/replacing any existing files.
  • After Git Bash installation, the changes to environment variables require a reboot. In order for these changes to take effect reboot the system, then proceed to the build section.

How to preview, build, and deploy?

In order to generate the handbook, on either GNU/Linux and Microsoft Windows everything is done through running the make command. Simply entering the make or make help inside your desired terminal will show you all the available make targets:

$ make help

Available make targets:

  - make build
  - make clean
  - make deploy
  - make help
  - make info
  - make serve

make info

This target prints the build and version information.

make clean

This target cleans up the output directory for the generated handbook, which is the /Documentation folder.

make serve

This tatget could be used for viewing or live-previwing the handbook while editing simultaneously editing it. Simply run this tatget and leave your terminal open and inside your web browser of choice head to http://localhost:8000/. You can modify the handbook source code inside any text editor and upon saving your web browser will refresh in realtime once a change is detected.

make build

This tatget builds the final handbook and outputs it to the /Documentation folder.

If you're building a release handbook, please make sure:

  • You are either on a release tag, e.g. v2.1.0, or on the master branch.
  • No commit has been made since the targeted tag.
  • The Git tree state is clean.
  • The Git version and plugin version match each other.

If you're building an unstable handbook for the next release, please make sure:

  • You're building from the dev branch.
  • The Git version value evaluates to empty.

make deploy

This tatget is used to build and upload the final draft of the handbook. This tatget first runs the clean target and then the build target; and only then attempts to upload the content. Thus, any rule that applies to the build target, will apply to this target as well.