add doc

crawler.go

@@ -4,6 +4,7 @@ import (
 	"fmt"
 )
 
+// 获取置顶文章pid以及作者信息
 func GetPinnedArticlePidAndAuthor(columnName string) (*PinnedArticleAndAuthor, error) {
 	if columnName == "" {
 		return nil, ColumnNameCanNotBeEmpty
@@ -23,6 +24,7 @@ func GetPinnedArticlePidAndAuthor(columnName string) (*PinnedArticleAndAuthor, e
 	return &pinnedArticleAndAuthor, nil
 }
 
+// 获取单个文章
 func GetSingleArticle(pid int) (*Article, error) {
 	if pid == 0 {
 		return nil, PidCanNotBeEmpty
@@ -42,6 +44,7 @@ func GetSingleArticle(pid int) (*Article, error) {
 	return &article, nil
 }
 
+// 获取文章pid列表
 func GetArticlesListPids(columnName string) ([]int, error) {
 	if columnName == "" {
 		return nil, ColumnNameCanNotBeEmpty

model.go

@@ -1,10 +1,12 @@
 package ZhihuZhuanlanCrawler
 
+// 专栏
 type Zhuanlan struct {
 	Slug string `json:"slug"`
 	Name string `json:"name"`
 }
 
+// 作者
 type Author struct {
 	ID          string `json:"id"`
 	Name        string `json:"name"`
@@ -19,6 +21,7 @@ type Author struct {
 	UserType    string `json:"user_type"`
 }
 
+// 置顶文章及作者信息
 type PinnedArticleAndAuthor struct {
 	Type     string `json:"type"`
 	ID       int    `json:"id"`
@@ -31,13 +34,15 @@ type PinnedArticleAndAuthor struct {
 	Author   Author
 }
 
+// 主题
 type Topic struct {
 	Url  string `json:"url"`
 	Type string `json:"type"`
 	Id   string `json:"id"`
 	Name string `json:"name"`
 }
 
+// 文章
 type Article struct {
 	ID       int     `json:"id"`
 	Type     string  `json:"type"`
@@ -51,6 +56,7 @@ type Article struct {
 	Topics   []Topic `json:"topics"`
 }
 
+// 文章列表
 type ArticleList struct {
 	Paging struct {
 		IsEnd   bool `json:"is_end"`