|
1 | | -# Slate |
| 1 | +## SynBioHub Documentation |
2 | 2 |
|
3 | | - Modern IRC client built with web technologies and node.js for OSX, Linux, and eventually Windows. |
| 3 | +This API documentation is live at https://synbiohub.github.io/api-docs/ |
4 | 4 |
|
5 | | -  |
| 5 | +This project is a customized API documentation site based on Slate. |
6 | 6 |
|
7 | | -  |
| 7 | +📄 Forked from: [slatedocs/slate](https://github.com/slatedocs/slate) |
8 | 8 |
|
9 | | -## Features |
| 9 | +🐳 Built using Docker: Follows instructions from [Using Slate in Docker](https://github.com/slatedocs/slate/wiki/Using-Slate-in-Docker) |
10 | 10 |
|
11 | | - - themable with CSS |
12 | | - - scriptable with JavaScript |
13 | | - - keyboard shortcuts and mapping |
14 | | - - third-party plugin support |
15 | | - - entirely built with web technologies for extensibility |
| 11 | +⚙️ Automated Build: GitHub Actions workflow adapted from [Slate Documentation Builder](https://github.com/marketplace/actions/slate-documentation-builder) |
16 | 12 |
|
17 | | -## Installation |
| 13 | +✏️ Key Differences from the Original Slate Repo: |
| 14 | +Customized `index.html.md` with project-specific API details |
18 | 15 |
|
19 | | - TODO: when we have distribution set up |
| 16 | +Updated logo for branding |
20 | 17 |
|
21 | | -## About |
| 18 | +This `README.md` for clear project guidance |
22 | 19 |
|
23 | | - Slate is/was a single day hack project that was intended to be a kickstarter, however I ran out of time so now it's a partially-implemented IRC client! I had pretty lofty goals but unfortunately there's not enough time to go around, there are still many features missing, and it's not quite in a usable state, but with some community interest and love maybe it will get there some day! If not at least some useful/clean IRC libs are available at [https://github.com/slate](https://github.com/slate). |
24 | 20 |
|
25 | | - Conceptually I really just wanted a clean, minimalistic IRC client, completely extensible through plugins. Ideally most of the core is written using such plugins. The entire thing should be themable, and the default theme should be programmer-friendly, aka get all the clutter out of my way, I just want to see chat logs. |
26 | 21 |
|
27 | | -## Usage |
| 22 | +### Run a local instance: |
28 | 23 |
|
29 | | - - press `?` to display the shortcut dialog |
| 24 | +#### Building Slate: |
30 | 25 |
|
31 | | -## Building |
| 26 | +Grab the slate image: |
32 | 27 |
|
33 | | - Install node, [node-webkit](https://github.com/rogerwang/node-webkit) and clone the repo. |
| 28 | +```docker pull slatedocs/slate``` |
34 | 29 |
|
35 | | - Build and run with: |
| 30 | +To use Docker to just build your site, run: |
36 | 31 |
|
37 | | -``` |
38 | | -$ make |
39 | | -``` |
| 32 | +```docker run --rm --name slate -v $(pwd)/build:/srv/slate/build -v $(pwd)/source:/srv/slate/source slatedocs/slate build``` |
40 | 33 |
|
41 | | - Build with: |
| 34 | +#### Running Slate: |
42 | 35 |
|
43 | | -``` |
44 | | -$ make build |
45 | | -``` |
| 36 | +If you wish to run the development server for Slate to aid in working on the site, run: |
46 | 37 |
|
47 | | - Continuous build with: |
| 38 | +```docker run --rm --name slate -p 4567:4567 -v $(pwd)/source:/srv/slate/source slatedocs/slate serve``` |
| 39 | +and you will be able to access your site at http://localhost:4567 until you stop the running container process. |
48 | 40 |
|
49 | | -``` |
50 | | -$ watch make build |
51 | | -``` |
| 41 | +#### Publishing Your Docs to GitHub Pages: |
52 | 42 |
|
53 | | -# License |
| 43 | +```git commit -a -m "Update index.md``` |
54 | 44 |
|
55 | | - MIT |
| 45 | +```git push``` |
56 | 46 |
|
| 47 | +```./deploy.sh``` |
0 commit comments