PeachCloud
/
peach-devdocs
0
0
Fork 0
Code Issues 1 Pull Requests Projects Releases Wiki Activity
Developer documentation for PeachCloud in the form of a Markdown book.
35 Commits 1 Branch 0 Tags 461 KiB
JavaScript 41.6%
CSS 33.4%
Handlebars 25%
Go to file
mycognosist c75a9b5705 Update notes with question about RTC 2020-10-16 10:44:19 +01:00
src Add Scuttlebutt and device-related features for MVP release 2020-10-15 10:28:27 +01:00
.gitignore Add nginx configuration section 2020-07-08 11:02:10 +01:00
.travis.yml Add config for building and testing with Travis CI on each push 2020-05-15 12:04:10 +01:00
README.md Fix version badge 2020-05-25 11:42:42 +01:00
book.toml Initial commit with draft chapter outline 2019-10-14 19:01:25 +01:00
notes Update notes with question about RTC 2020-10-16 10:44:19 +01:00

README.md

peach-devdocs

Build Status Generic badge

Developer documentation for PeachCloud in the form of a Markdown book.

Read online here >> 📖

PeachCloud physical interface

Development

Dependencies:

  • mdBook (release binaries or cargo install)
$ git clone https://github.com/peachcloud/peach-devdocs
$ cd peach-devdocs
$ mdbook serve

This serves the current state of the book at localhost:3000. When changes to any files are saved, the browser view will automatically refresh to reflect the new state.

NOTES:

  • this assumes mdbook is in your PATH
    • the command for adding the default cargo bin directory is export PATH=$PATH:~/.cargo/bin.
    • if you downloaded the prebuilt binary then make sure the directory is in your PATH

Build a release

$ mdbook serve

This builds the book into a static release ready for publishing. Currently outputs to book/ directory.

Hosting

The PeachCloud developer documentation book is hosted at docs.peachcloud.org using a simple Nginx deployment on a virtual server. HTTPS configuration is pending.

This tutorial from Digital Ocean describes the deployment process: How To Set Up Nginx Server Blocks (Virtual Hosts) on Ubuntu 16.04.

Licensing

AGPL-3.0