更新至 v5.2.1

favicon 和 logo 固定为 SVG 格式，Firefox 支持 SVG 图片作为 favicon，
而 chrome 将在 80 版本支持 SVG，safari 也支持使用 mask-icon 作为图片。

修正 static.Pack 可能的错误，不再允许打包目标文件夹中的二进制文件，
将 favicon 允许的格式改为 SVG，也将唯一的进制文件 icon.png 去掉了。

Author: caixw

.gitignore

@@ -19,10 +19,11 @@ dist
 # project
 .apidoc.yaml
 .apidoc.yml
-/.vscode
 apidoc.json
 apidoc.yaml
 apidoc.xml
 
 .vscode
 .idea
+
+.testdata

CHANGELOG.md

@@ -1,6 +1,14 @@
 # CHANGELOG
 
-## [Unreleased]
+## [v5.2.1]
+
+### Changed
+
+- favicon 现在只支持 SVG 格式的图片；
+
+### Fixed
+
+- 修正 Pack 可能将二进制等文件进行打包的错误；
 
 ## [v5.2.0]
 

apidoc.go

@@ -106,7 +106,7 @@ func Pack(h *message.Handler, url string, contentType, pkgName, varName, path st
 		contentType = http.DetectContentType(data)
 	}
 
-	return static.Pack("./docs", pkgName, varName, path, t, nil, &static.FileInfo{
+	return static.Pack("./docs", pkgName, varName, path, t, &static.FileInfo{
 		Name:        url,
 		Content:     data,
 		ContentType: contentType,

config.go

@@ -48,7 +48,7 @@ type Config struct {
 
 // LoadConfig 加载指定目录下的配置文件
 //
-// 所有的错误信息会输出到 h
+// 所有的错误信息会输出到 h，在出错时，会返回 nil
 func LoadConfig(h *message.Handler, wd string) *Config {
 	for _, filename := range vars.AllowConfigFilenames {
 		p := filepath.Join(wd, filename)

config_test.go

@@ -5,7 +5,6 @@ package apidoc
 import (
 	"bytes"
 	"path/filepath"
-	"strconv"
 	"testing"
 	"time"
 
@@ -14,15 +13,40 @@ import (
 	"github.com/caixw/apidoc/v5/input"
 	"github.com/caixw/apidoc/v5/internal/vars"
 	"github.com/caixw/apidoc/v5/message"
+	"github.com/caixw/apidoc/v5/static"
 )
 
-func buildMessageHandle() (*bytes.Buffer, message.HandlerFunc) {
-	buf := new(bytes.Buffer)
-
-	return buf, func(msg *message.Message) {
-		buf.WriteString(strconv.Itoa(int(msg.Type)))
-		buf.WriteString(msg.Message)
+func buildMessageHandle() (erro, succ *bytes.Buffer, h *message.Handler) {
+	erro = new(bytes.Buffer)
+	succ = new(bytes.Buffer)
+
+	f := func(msg *message.Message) {
+		switch msg.Type {
+		case message.Erro:
+			erro.WriteString(msg.Message)
+		default:
+			succ.WriteString(msg.Message)
+		}
 	}
+
+	return erro, succ, message.NewHandler(f)
+}
+
+func TestLoadConfig(t *testing.T) {
+	a := assert.New(t)
+
+	erro, succ, h := buildMessageHandle()
+	cfg := LoadConfig(h, "./")
+	a.NotNil(cfg).
+		Empty(erro.String())
+
+	erro, succ, h = buildMessageHandle()
+	cfg = LoadConfig(h, "./docs") // 不存在 apidoc 的配置文件
+
+	h.Stop()
+	a.Nil(cfg).
+		NotEmpty(erro.String()).
+		Empty(succ.String())
 }
 
 func TestLoadFile(t *testing.T) {
@@ -42,9 +66,9 @@ func TestDetect_Load(t *testing.T) {
 	a.NotError(err).NotEmpty(wd)
 	a.NotError(Detect(wd, true))
 
-	out, f := buildMessageHandle()
-	cfg := LoadConfig(message.NewHandler(f), wd)
-	a.Empty(out.String()).NotNil(cfg)
+	erro, _, h := buildMessageHandle()
+	cfg := LoadConfig(h, wd)
+	a.Empty(erro.String()).NotNil(cfg)
 
 	a.Equal(cfg.Version, vars.Version()).
 		Equal(cfg.Inputs[0].Lang, "go")
@@ -78,21 +102,55 @@ func TestConfig_sanitize(t *testing.T) {
 		Equal(err.Field, "output")
 }
 
+func TestConfig_Test(t *testing.T) {
+	a := assert.New(t)
+
+	erro, succ, h := buildMessageHandle()
+	cfg := LoadConfig(h, "./docs/example")
+	a.NotNil(cfg)
+	cfg.Test()
+
+	h.Stop()
+	a.Empty(erro.String()).
+		NotEmpty(succ.String()) // 有成功提示
+}
+
+func TestConfig_Pack(t *testing.T) {
+	a := assert.New(t)
+
+	erro, succ, h := buildMessageHandle()
+	cfg := LoadConfig(h, "./docs/example")
+	a.NotNil(cfg)
+	cfg.Pack("testdata", "Data", "./.testdata", "apidoc.xml", "application/xml", static.TypeAll)
+
+	h.Stop()
+	a.Empty(erro.String()).
+		Empty(succ.String())
+}
+
 func TestConfig_Do(t *testing.T) {
 	a := assert.New(t)
 
-	out, f := buildMessageHandle()
-	h := message.NewHandler(f)
-	LoadConfig(h, "./docs/example").Do(time.Now())
-	a.Empty(out.String())
+	erro, succ, h := buildMessageHandle()
+	cfg := LoadConfig(h, "./docs/example")
+	a.NotNil(cfg)
+	cfg.Do(time.Now())
+
+	h.Stop()
+	a.NotEmpty(succ.String()). // 有成功提示
+					Empty(erro.String())
 }
 
 func TestConfig_Buffer(t *testing.T) {
 	a := assert.New(t)
 
-	out, f := buildMessageHandle()
-	h := message.NewHandler(f)
-	buf := LoadConfig(h, "./docs/example").Buffer()
-	a.Empty(out.String()).
+	erro, succ, h := buildMessageHandle()
+	cfg := LoadConfig(h, "./docs/example")
+	a.NotNil(cfg)
+
+	buf := cfg.Buffer()
+	h.Stop()
+	a.Empty(erro.String()).
+		Empty(succ.String()).
 		True(buf.Len() > 0)
 }

docs/example/.apidoc.yaml

@@ -1,4 +1,4 @@
-version: 5.0.0
+version: 5.2.0
 inputs:
 - lang: c++
   dir: .

docs/example/index.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 
 <?xml-stylesheet type="text/xsl" href="../v5/apidoc.xsl"?>
-<apidoc apidoc="5.2.0" created="2019-12-17T21:57:24+08:00" version="1.1.1">
+<apidoc apidoc="5.2.1" created="2019-12-18T00:16:56+08:00" version="1.1.1">
 	<title>示例文档</title>
 	<description type="html"><![CDATA[
 

docs/icon.png

@@ -121,7 +121,7 @@
             <description><p>用于描述整个文档的相关内容，只能出现一次。</p></description>
             <item name="@version">文档的版本</item>
             <item name="@lang">内容的本地化 ID，比如 <samp><var>zh-hans</var></samp> 等。</item>
-            <item name="@logo">图标</item>
+            <item name="@logo">图标，默认采用官网的 <var>https://apidoc.tools/icon.svg</var>，同时作用于 favicon 和 logo，只支持 SVG 格式。</item>
             <item name="@created">文档的生成时间</item>
             <item name="title">文档的标题</item>
             <item name="description">文档的整体介绍，可以是使用 HTML 内容。</item>

docs/index.xml

@@ -32,7 +32,8 @@
             <meta charset="UTF-8" />
             <meta name="viewport" content="width=device-width,initial-scale=1,maximum-scale=1"/>
             <meta name="keywords" content="{$keywords}RESTful API,document,apidoc" />
-            <link rel="icon" type="image/png" href="./icon.png" />
+            <link rel="icon" type="image/svg+xml" href="./icon.svg" />
+            <link rel="mask-icon" type="image/svg+xml" href="./icon.svg" color="black" />
             <link rel="canonical" href="{document('config.xml')/config/url}" />
             <link rel="stylesheet" type="text/css" href="./index.css" />
             <link rel="license" href="{/docs/liense/@url}" />