wide/README.md

82 lines
3.1 KiB
Markdown
Raw Normal View History

2014-09-24 07:25:07 +04:00
# Wide [![Build Status](https://drone.io/github.com/b3log/wide/status.png)](https://drone.io/github.com/b3log/wide/latest)
2014-08-18 17:45:43 +04:00
2014-09-08 16:31:31 +04:00
## Intro
2014-09-17 16:37:35 +04:00
2014-09-17 16:42:38 +04:00
A <b>W</b>eb <b>IDE</b> IDE for Team using Golang.
2014-08-18 17:45:43 +04:00
2014-09-08 16:31:31 +04:00
## Motivation
2014-09-10 18:53:18 +04:00
* **Team** IDE:
2014-09-08 16:14:34 +04:00
* Safe and reliable: the project source code stored on the server in real time, the developer's machine crashes without losing any source code
* Unified environment: server unified development environment configuration, the developer machine without any additional configuration
* Out of the box: 5 minutes to setup a server then open browser to develop, debug
* Version Control: each developer has its own source code repository, easy sync with the trunk
2014-09-10 18:54:18 +04:00
* **Web based** IDE:
* Developer needs a browser only
* Cross-platform, even on mobile devices
* For the geeks
2014-09-12 13:41:53 +04:00
* A try for commercial-open source: versions customized for enterprises, close to their development work flows respectively
2014-09-08 16:14:34 +04:00
* Currently more popular Go IDE has some defects or regrets:
* Text editor (vim/emacs/sublime/Atom, etc.): For the Go newbie is too complex
* Plug-in (goclipse, etc.): the need for the original IDE support, not professional
2014-09-10 18:51:00 +04:00
* LiteIDE: no modern user interface :p
2014-09-08 16:14:34 +04:00
* No team development experience
2014-09-10 18:54:18 +04:00
* There are a few of GO IDEs, and no one developed by Go itself, this is a nice try
2014-09-08 16:17:04 +04:00
2014-09-08 16:31:31 +04:00
## Features
2014-09-09 05:33:20 +04:00
* Code Highlight, Folding: Go/HTML/JavaScript/Markdown etc.
* Autocomplete: Go/HTML etc.
* Format: Go/HTML/JSON etc.
* Run & Debug: run/debug multiple processes at the same time
* Multiplayer: a real team development experience
* Navigation, Jump to declaration, Find usages, File search etc.
* Shell: run command on the server
* Git integration: git command on the web
* Web development: Frontend devlopment (HTML/JS/CSS) all in one
2014-09-09 13:05:54 +04:00
* Go tool: go get/install/fmt etc.
2014-08-18 17:45:43 +04:00
2014-09-24 18:14:45 +04:00
## Architecture
### Build & Run
![](https://cloud.githubusercontent.com/assets/873584/4389219/3642bc62-43f3-11e4-8d1f-06d7aaf22784.png)
2014-09-25 07:03:53 +04:00
### Code Assist
2014-09-25 07:25:06 +04:00
![](https://cloud.githubusercontent.com/assets/873584/4399135/3b80c21c-4463-11e4-8e94-7f7e8d12a4df.png)
2014-09-25 07:03:53 +04:00
2014-09-11 09:32:47 +04:00
## Documents
2014-09-20 06:23:45 +04:00
2014-09-18 11:26:35 +04:00
* [用户指南](http://88250.gitbooks.io/wide-user-guide/zh-cn/index.html)
* [开发指南](http://88250.gitbooks.io/wide-dev-guide/zh-cn/index.html)
2014-09-11 09:32:47 +04:00
2014-09-08 16:31:31 +04:00
## Demos
2014-09-10 19:30:41 +04:00
2014-09-13 09:57:47 +04:00
* 20140913, png ![](http://b3log.org/wide/demo/20140913.png)
2014-09-13 09:58:35 +04:00
### Olds
2014-09-13 10:00:00 +04:00
* [20140910, png](http://b3log.org/wide/demo/20140910.png)
2014-09-10 19:30:41 +04:00
* [20140823, swf](http://b3log.org/wide/demo/20140823.html)
2014-08-28 05:29:28 +04:00
2014-09-10 18:42:36 +04:00
## Setup from sources
2014-08-18 17:45:43 +04:00
1. Downloads source
2014-09-15 05:56:38 +04:00
2. Gets dependencies with
* `go get -u`
* `go get -u github.com/88250/ide_stub`
* `go get -u github.com/nsf/gocode`
2014-09-10 18:42:36 +04:00
3. Compiles wide with `go build`
4. Configures `conf/wide.json`
5. Runs the executable `wide` or `wide.exe`
2014-08-18 17:45:43 +04:00
2014-09-08 16:27:54 +04:00
## Known Issues
* [Shell is not available on Windows](https://github.com/b3log/wide/issues/32)
2014-09-08 16:31:31 +04:00
## License
2014-08-18 17:51:03 +04:00
Copyright (c) 2014, B3log Team (http://b3log.org)
2014-08-18 17:45:43 +04:00
2014-08-18 17:51:03 +04:00
Licensed under the [Apache License 2.0](https://github.com/b3log/wide/blob/master/LICENSE).
2014-08-18 17:45:43 +04:00
2014-09-08 16:31:31 +04:00
## Credits
2014-08-18 17:45:43 +04:00
* [golang](http://golang.org)
* [CodeMirror](https://github.com/marijnh/CodeMirror)
* [zTree](https://github.com/zTree/zTree_v3)
2014-09-12 05:14:15 +04:00
* [LiteIDE](https://github.com/visualfc/liteide)
2014-08-18 17:45:43 +04:00
* [gocode](https://github.com/nsf/gocode)
* [Gorilla](https://github.com/gorilla)