update

Author: jincheng9

readme.md

@@ -121,7 +121,13 @@
 * [Docker入门教程101: 用途，架构，安装和使用](https://github.com/jincheng9/disributed-system-notes/tree/main/docker/01)
 * [Docker入门教程101: 基于Docker部署Go项目](https://github.com/jincheng9/disributed-system-notes/tree/main/docker/02)
 
+### Doc Tools
 
+#### Swagger
+
+* [gin-swagger常见问题](./workspace/swagger)
+
+  
 
 ## 外文翻译
 

workspace/swagger/readme.md

@@ -0,0 +1,36 @@
+# gin-swagger常见问题
+
+### Fetch error *Internal Server Error doc*.*json*
+
+需要在Gin路由设置的源文件导入`swag init`命令生成的docs包
+
+```go
+import _  module_name/docs
+```
+
+
+
+## gin-swagger支持multipart/form-data里带文件参数
+
+Param Type: `formData`
+
+Data Type: `file`
+
+```markdown
+// UpdateProfile godoc
+// @Summary UpdateProfile updates user info
+// @Description check username and token, then update user profile
+// @Accept multipart/form-data
+// @Produce json
+// @param username path string true "username"
+// @param token formData string true "token"
+// @param nickname formData string false "nickname"
+// @param image formData file false "image"
+// @Success 200 {object} map[string]interface{}
+// @Router /update/{username} [POST]
+```
+
+* https://github.com/swaggo/swag/blob/master/README.md
+
+* https://swagger.io/docs/specification/2-0/file-upload/
+