An open source project for official documentation website of beego app framework.
Beego Web is a go get
able project:
$ go get github.com/beego/beeweb
Switch to project root path:
$ cd $GOPATH/src/github.com/beego/beeweb
Build and run with Go tools:
$ go build
$ ./beeweb
Or build with bee tool:
$ bee run beeweb
Open your browser and visit http://localhost:8090.
This project can be easily transferred as your own documentation site, there are some tips that you may want to know:
-
In the file
conf/app.ini
:-
lang -> types
: languages that you want to support -
lang -> names
: user-friendly name of languages. -
app -> navs
: sections' name of documentation list. -
app -> samples
: samples' name of sample page. -
Use Github app keys as following format:
[github] client_id=1862bcb2******f36c client_secret=308d71ab53ccd858416cfceaed52******53c5f
-
-
In the file
conf/docTree.json
:- This file saves the file tree(with file name and commit) of your project that is hosted in Github. About how to use documentation project please see beedoc. Note that if you added new section to documentation list and you do not want to wait auto-refresh, simple delete this file and restart.
- To change the documentation project URL, you need to change it in function
checkDocUpdates
in filemodels/models.go
.
-
When you added new section to documentation list in
conf/app.ini
, you also need to update list in template files(views/docs_<lang>.html
,<lang>
depends on the language you use).