doc: top-level README.md

This commit is contained in:
mappu 2018-12-31 18:33:13 +13:00
parent ea3bb84b7b
commit 0556358529

View File

@ -1,33 +1,28 @@
# nmdc-webfrontend
A web interface to an NMDC/ADC hub. A web interface to an NMDC/ADC hub.
Chat in real-time on your NMDC/ADC hub using a web browser. This project forks and deprecates my earlier `dcwebui2` project since Go seems to use less memory than node. Chat in real-time on your NMDC/ADC hub using a web browser. This project forks and deprecates my earlier `dcwebui2` project since Go seems to use less memory than node.
Written in Golang This project supercedes [dcwebui](https://code.ivysaur.me/dcwebui/), [flexdc](https://code.ivysaur.me/flexdc/), and [dcwebui2](https://code.ivysaur.me/dcwebui2/).
Tags: nmdc ## Upgrading from `dcwebui2`
This project supercedes [entry=dcwebui]dcwebui[/entry], [entry=flexdc]flexdc[/entry], and [entry=dcwebui2]dcwebui2[/entry]. - The configuration file content is identical between `nmdc-webfrontend` 1.0.0 and `dcwebui2` 1.3.0, but please now ensure it's valid JSON instead of arbitrary javascript. This means no assignment, use double-quoted strings, and no comments.
- Future changes to the configuration file since `nmdc-webfrontend` 1.0.0 are backward compatible (see the changelog for more details).
=UPGRADING FROM DCWEBUI2= ## Developing
- The configuration file content is identical between nmdc-webfrontend 1.0.0 and dcwebui2 1.3.0, but please now ensure it's valid JSON instead of arbitrary javascript. This means no assignment, use double-quoted strings, and no comments. 1. Install Go (>= 1.11), Node.js, NPM, and 7-Zip (`p7zip-full` on Debian)
- Future changes to the configuration file since nmdc-webfrontend 1.0.0 are backward compatible (see the changelog for more details). 2. Download the source code
=DEVELOPING=
[go-get]code.ivysaur.me/nmdc-webfrontend git https://git.ivysaur.me/code.ivysaur.me/nmdc-webfrontend.git[/go-get]
1. Install Go, Node.js, NPM, and 7-Zip (`p7zip-full` on Debian)
2. Set up your `$GOPATH`
3. Download the source code
    - `git clone https://git.ivysaur.me/code.ivysaur.me/nmdc-webfrontend.git `; or     - `git clone https://git.ivysaur.me/code.ivysaur.me/nmdc-webfrontend.git `; or
    - `go get code.ivysaur.me/nmdc-webfrontend` ; or     - `go get code.ivysaur.me/nmdc-webfrontend` ; or
    - download and extract a source archive     - download and extract a source archive
4. Install dependencies: `sudo make deps` 3. Install dependencies: `sudo make deps`
5. Build: `make` 4. Build: `make`
6. Optional: Set `web.external_webroot: true` in the config file for unminified development 5. Optional: Set `web.external_webroot: true` in the config file for unminified development
=CHANGELOG= ## Changelog
2017-11-26 1.3.0 2017-11-26 1.3.0
- Update libnmdc to 0.16 (adds ADC hub support) - Update libnmdc to 0.16 (adds ADC hub support)