Generate swagger json (#1402)

- Generate swagger.json into public/
- Add swagger-ui auto-installation
- Add footer link to local swagger-ui
- Add /swagger url for using app url.
- Fix Swagger-UI version via git tag

routers/api/v1/misc/markdown.go

@@ -13,8 +13,19 @@ import (
 )
 
 // Markdown render markdown document to HTML
-// see https://github.com/gogits/go-gogs-client/wiki/Miscellaneous#render-an-arbitrary-markdown-document
 func Markdown(ctx *context.APIContext, form api.MarkdownOption) {
+	// swagger:route POST /markdown renderMarkdown
+	//
+	//     Consumes:
+	//     - application/json
+	//
+	//     Produces:
+	//     - text/html
+	//
+	//     Responses:
+	//       200: MarkdownRender
+	//       422: validationError
+
 	if ctx.HasAPIError() {
 		ctx.Error(422, "", ctx.GetErrMsg())
 		return
@@ -40,8 +51,18 @@ func Markdown(ctx *context.APIContext, form api.MarkdownOption) {
 }
 
 // MarkdownRaw render raw markdown HTML
-// see https://github.com/gogits/go-gogs-client/wiki/Miscellaneous#render-a-markdown-document-in-raw-mode
 func MarkdownRaw(ctx *context.APIContext) {
+	// swagger:route POST /markdown/raw renderMarkdownRaw
+	//
+	//     Consumes:
+	//     - text/plain
+	//
+	//     Produces:
+	//     - text/html
+	//
+	//     Responses:
+	//       200: MarkdownRender
+	//       422: validationError
 	body, err := ctx.Req.Body().Bytes()
 	if err != nil {
 		ctx.Error(422, "", err)

routers/api/v1/misc/version.go

@@ -12,5 +12,17 @@ import (
 
 // Version shows the version of the Gitea server
 func Version(ctx *context.APIContext) {
+	// swagger:route GET /version getVersion
+	//
+	// Return Gitea running version.
+	//
+	// This show current running Gitea application version.
+	//
+	//     Produces:
+	//     - application/json
+	//
+	//     Responses:
+	//       200: ServerVersion
+	
 	ctx.JSON(200, &gitea.ServerVersion{Version: setting.AppVer})
 }