Skip to content

Commit 141663d

Browse files
author
cl117
committed
update README
1 parent ac2932e commit 141663d

File tree

1 file changed

+24
-33
lines changed

1 file changed

+24
-33
lines changed

README.md

Lines changed: 24 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,56 +1,47 @@
1-
# Slate
1+
## SynBioHub Documentation
22

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/
44

5-
![slate irc client](https://dl.dropboxusercontent.com/u/6396913/slate/Screen%20Shot%202013-10-19%20at%2011.45.08%20AM.png)
5+
This project is a customized API documentation site based on Slate.
66

7-
![](https://dl.dropboxusercontent.com/u/6396913/slate/Screen%20Shot%202013-09-17%20at%207.47.36%20AM.png)
7+
📄 Forked from: [slatedocs/slate](https://github.com/slatedocs/slate)
88

9-
## Features
9+
🐳 Built using Docker: Follows instructions from [Using Slate in Docker](https://github.com/slatedocs/slate/wiki/Using-Slate-in-Docker)
1010

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)
1612

17-
## Installation
13+
✏️ Key Differences from the Original Slate Repo:
14+
Customized `index.html.md` with project-specific API details
1815

19-
TODO: when we have distribution set up
16+
Updated logo for branding
2017

21-
## About
18+
This `README.md` for clear project guidance
2219

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).
2420

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.
2621

27-
## Usage
22+
### Run a local instance:
2823

29-
- press `?` to display the shortcut dialog
24+
#### Building Slate:
3025

31-
## Building
26+
Grab the slate image:
3227

33-
Install node, [node-webkit](https://github.com/rogerwang/node-webkit) and clone the repo.
28+
```docker pull slatedocs/slate```
3429

35-
Build and run with:
30+
To use Docker to just build your site, run:
3631

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```
4033

41-
Build with:
34+
#### Running Slate:
4235

43-
```
44-
$ make build
45-
```
36+
If you wish to run the development server for Slate to aid in working on the site, run:
4637

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.
4840

49-
```
50-
$ watch make build
51-
```
41+
#### Publishing Your Docs to GitHub Pages:
5242

53-
# License
43+
```git commit -a -m "Update index.md```
5444

55-
MIT
45+
```git push```
5646

47+
```./deploy.sh```

0 commit comments

Comments
 (0)