Excelize: The Definitive Guide, 1st Edition, Simplified Chinese versi…

…on book info
xuri · Jul 29, 2024 · 022be0a · 022be0a
1 parent e14104c
commit 022be0a
Show file tree

Hide file tree

Showing 47 changed files with 107 additions and 1 deletion.
diff --git a/images/book.png b/images/book.png
diff --git a/zh-hans/README.md b/zh-hans/README.md
@@ -19,6 +19,14 @@ Excelize 的目标是创建并维护一个 Go 语言版本的 Excel 文档 API
 
 在一些情况下我们需要通过程序操作 Excel 文档，例如：打开读取已有 Excel 文档内容、创建新的 Excel 文档、基于已有文档（模版）生成新的 Excel 文档、向 Excel 文档中插入图片、图表和表格等元素，有时还需要跨平台实现这些操作。使用 Excelize 可以方便的满足上述需求。
 
+## 《Excelize 权威指南》
+
+<p align="center"><img width="240" src="../images/book.png" alt="人民邮电出版社《Excelize 权威指南》"></p>
+
+本书基于 Excelize 基础库，从 Office 办公文档格式国际标准出发，以源代码为基础，结合大量直观的配图，循序渐进地讲解 Excelize 中的模块实现，详细解读技术标准内容和基础库的设计。主要内容包括 Excelize 开发环境准备、文档格式国际标准解读、文档数据结构建模、工作簿、工作表、单元格和行列的相关操作、复杂样式解析、图表、图片与形状的相关操作、数据验证与筛选、数据透视表、流式读写技术以及一个综合实践应用。阅读本书，具有一定 Go 语言基础，想入门 Excelize 的开发人员能够进一步系统理解 Excelize 基础库的实现细节，不具备 Go 语言开发经验的开发人员也能够快速掌握 Excelize 的设计原理。
+
+网上购买方式：<a href="https://www.epubit.com/bookDetails?id=UB88d55b2b00d26" title="在异步社区购买《Excelize 权威指南》图书" target="_blank">异步社区</a> | <a href="https://detail.tmall.com/item.htm?id=818853544894" title="在天猫商城购买《Excelize 权威指南》图书" target="_blank">天猫</a> | <a href="https://item.jd.com/14710146.html" title="在京东购买《Excelize 权威指南》图书" target="_blank">京东</a> | <a href="https://product.dangdang.com/11781983074.html" title="在当当网购买《Excelize 权威指南》图书" target="_blank">当当</a> | <a href="https://j.youzan.com/AYJQXF" title="在微店购买《Excelize 权威指南》图书" target="_blank">微店</a> | <a href="https://v.douyin.com/iMmtmks2" title="在抖音商城购买《Excelize 权威指南》图书" target="_blank">抖音</a> | <a href="https://mobile.yangkeduo.com/goods2.html?ps=w8ZH3afuel" title="在拼多多购买《Excelize 权威指南》图书" target="_blank">拼多多</a>
+
 ## 项目荣誉
 
 入选 2023 开源创新榜[优秀开源项目](https://cccst.org.cn/zxyw/tzgg/art/2023/art_748b3428e4184ccc825ea6de1a2d273f.html)

diff --git a/zh-hans/base/installation.md b/zh-hans/base/installation.md
@@ -1,5 +1,7 @@
 # 快速开始
 
+{{ book.info }}
+
 ## 安装 {#install}
 
 下表列出了各版本 Excelize 基础库对 Go 语言版本最低要求的情况：

diff --git a/zh-hans/book.json b/zh-hans/book.json
@@ -37,5 +37,8 @@
         },
         "headerTemplate": null,
         "footerTemplate": null
+    },
+    "variables": {
+        "info": "<pre style=\"font-family: inherit; padding: 10px 2%;\"><span style=\"display: table-cell; padding: 12px; width: 24px; height: 24px; line-height: 0;\"><svg xmlns=\"http://www.w3.org/2000/svg\" x=\"0px\" y=\"0px\" viewBox=\"0 0 44 44\" width=\"24px\" height=\"24px\" fill=\"none\" stroke=\"currentColor\"><circle cx=\"22\" cy=\"22\" r=\"20\" stroke-width=\"2\"></circle><line x1=\"22\" x2=\"22\" y1=\"18\" y2=\"33\" stroke-width=\"3\"></line><line x1=\"22\" x2=\"22\" y1=\"12\" y2=\"15\" stroke-width=\"3\"></line></svg></span><p style=\"display: table-cell; vertical-align: middle; padding: 0; line-height: 16px;\">《Excelize 权威指南》图书出版，网上购买方式：<a href=\"https://www.epubit.com/bookDetails?id=UB88d55b2b00d26\" title=\"在异步社区购买《Excelize 权威指南》图书\" target=\"_blank\">异步社区</a> | <a href=\"https://detail.tmall.com/item.htm?id=818853544894\" title=\"在天猫商城购买《Excelize 权威指南》图书\" target=\"_blank\">天猫</a> | <a href=\"https://item.jd.com/14710146.html\" title=\"在京东购买《Excelize 权威指南》图书\" target=\"_blank\">京东</a> | <a href=\"https://product.dangdang.com/11781983074.html\" title=\"在当当网购买《Excelize 权威指南》图书\" target=\"_blank\">当当</a> | <a href=\"https://j.youzan.com/AYJQXF\" title=\"在微店购买《Excelize 权威指南》图书\" target=\"_blank\">微店</a> | <a href=\"https://v.douyin.com/iMmtmks2\" title=\"在抖音商城购买《Excelize 权威指南》图书\" target=\"_blank\">抖音</a> | <a href=\"https://mobile.yangkeduo.com/goods2.html?ps=w8ZH3afuel\" title=\"在拼多多购买《Excelize 权威指南》图书\" target=\"_blank\">拼多多</a></p></pre>"
     }
 }
diff --git a/zh-hans/cell.md b/zh-hans/cell.md
@@ -1,5 +1,7 @@
 # 单元格
 
+{{ book.info }}
+
 `RichTextRun` 定义了富文本的属性。
 
 ```go

diff --git a/zh-hans/chart.md b/zh-hans/chart.md
@@ -1,5 +1,7 @@
 # 图表
 
+{{ book.info }}
+
 ## 添加图表 {#AddChart}
 
 ```go

diff --git a/zh-hans/constants.md b/zh-hans/constants.md
@@ -1,5 +1,7 @@
 # 常量
 
+{{ book.info }}
+
 CultureName 是受支持的区域格式类型定义。
 
 ```go

diff --git a/zh-hans/contribution.md b/zh-hans/contribution.md
@@ -1,5 +1,7 @@
 # 参与贡献
 
+{{ book.info }}
+
 ## 如何参与贡献
 
 Microsoft Excel&trade; 2007 版本后支持基于 XML 的文档格式 OOXML (Office Open XML)，是一种基于 XML 和 ZIP 技术的新的文档格式。下面列出了包括文档标准、文档验证对比工具和浏览器插件等在内的开发符合该文档格式的相关参考资料。

diff --git a/zh-hans/data.md b/zh-hans/data.md
@@ -1,5 +1,7 @@
 # 数据
 
+{{ book.info }}
+
 ## 添加数据验证 {#AddDataValidation}
 
 ```go

diff --git a/zh-hans/example/calendar.md b/zh-hans/example/calendar.md
@@ -1,5 +1,7 @@
 # 日历
 
+{{ book.info }}
+
 使用 Go 语言在 Excel 文档中创建日历：
 
 <p align="center"><img width="933" src="../images/example_calendar.png" alt="使用 Go 语言在 Excel 文档中创建日历"></p>

diff --git a/zh-hans/example/dependentDropList.md b/zh-hans/example/dependentDropList.md
@@ -1,5 +1,7 @@
 # 级联列表
 
+{{ book.info }}
+
 使用 Go 语言在 Excel 文档中创建多级联动菜单列表:
 
 <p align="center"><img width="379" src="../images/dependent_drop_list.gif" alt="使用 Go 语言在 Excel 文档中创建多级联动菜单列表"></p>

diff --git a/zh-hans/example/multiselectDropList.md b/zh-hans/example/multiselectDropList.md
@@ -1,5 +1,7 @@
 # 多选列表
 
+{{ book.info }}
+
 使用 Go 语言在 Excel 文档中无需 VBA 创建可多选菜单列表:
 
 <p align="center"><img width="426" src="../images/multiselect_drop_list.gif" alt="使用 Go 语言在 Excel 文档中无需 VBA 创建可多选菜单列表"></p>

diff --git a/zh-hans/formControl.md b/zh-hans/formControl.md
@@ -1,5 +1,7 @@
 # 表单控件
 
+{{ book.info }}
+
 FormControl 定义了表单控件的属性。
 
 ```go

diff --git a/zh-hans/image.md b/zh-hans/image.md
@@ -1,5 +1,7 @@
 # 图片
 
+{{ book.info }}
+
 ## 插入图片 {#AddPicture}
 
 ```go

diff --git a/zh-hans/performance.md b/zh-hans/performance.md
@@ -1,5 +1,7 @@
 # 性能数据
 
+{{ book.info }}
+
 <a href="https://xuri.me/wp-content/uploads/2016/08/excelize-performance.svg"><img src="https://xuri.me/wp-content/uploads/2016/08/excelize-performance.svg" alt="Excelize benchmark" width="1506"></a>
 
 性能数据由[此基准测试脚本](https://github.com/xuri/excelize-benchmark)生成。

diff --git a/zh-hans/pivot.md b/zh-hans/pivot.md
@@ -1,5 +1,7 @@
 # 数据透视表 {#PivotTable}
 
+{{ book.info }}
+
 数据透视表是一种交互式的表，是计算、汇总和分析数据的强大工具，可助你了解数据中的对比情况、模式和趋势。
 
 `PivotTableOptions` 定义了数据透视表的属性。

diff --git a/zh-hans/shape.md b/zh-hans/shape.md
@@ -1,5 +1,7 @@
 # 形状
 
+{{ book.info }}
+
 ## 添加形状
 
 ```go

diff --git a/zh-hans/sheet.md b/zh-hans/sheet.md
@@ -1,5 +1,7 @@
 # 工作表
 
+{{ book.info }}
+
 ## 设置列可见性 {#SetColVisible}
 
 ```go

diff --git a/zh-hans/sparklines.md b/zh-hans/sparklines.md
@@ -1,5 +1,7 @@
 # 迷你图
 
+{{ book.info }}
+
 迷你图是 Excel 2010 及以上版本中的功能，是放入单元格中的小型图，每个迷你图代表所选内容中的一行数据。将迷你图放在其数据附近可提供非常好的视觉冲击。
 
 <p align="center"><img width="612" src="./images/sparkline_01.png" alt="使用 Go 语言通过 Excelize 创建迷你图"></p>

diff --git a/zh-hans/stream.md b/zh-hans/stream.md
@@ -1,5 +1,7 @@
 # 流式写入
 
+{{ book.info }}
+
 `StreamWriter` 用于定义流式写入器的数据类型。
 
 ```go

diff --git a/zh-hans/style.md b/zh-hans/style.md
@@ -1,5 +1,7 @@
 # 样式
 
+{{ book.info }}
+
 Alignment 映射单元格对齐样式设置。
 
 ```go

diff --git a/zh-hans/utils.md b/zh-hans/utils.md
@@ -1,5 +1,7 @@
 # 工具函数
 
+{{ book.info }}
+
 ## 创建表格 {#AddTable}
 
 ```go

diff --git a/zh-hans/variables.md b/zh-hans/variables.md
@@ -1,5 +1,7 @@
 # 变量
 
+{{ book.info }}
+
 ```go
 var (
     // ErrAddVBAProject 定义了向工作簿嵌入 VBA 项目发生异常时的错误提示信息

diff --git a/zh-hans/workbook.md b/zh-hans/workbook.md
@@ -1,5 +1,7 @@
 # 工作簿
 
+{{ book.info }}
+
 `Options` 定义了读写电子表格时的选项。
 
 ```go

diff --git a/zh-tw/README.md b/zh-tw/README.md
@@ -19,6 +19,14 @@ Excelize 的目標是創建並維護一個 Go 語言版本的 Excel 檔案 API
 
 在一些情況下我們需要透過程式操作 Excel 檔案，例如：開啓讀取已有 Excel 檔案內容、創建新的 Excel 檔案、基於已有檔案（範本）生成新的 Excel 檔案、向 Excel 檔案中插入圖片、圖表和表格等元素，有時還需要跨平台實現這些操作。使用 Excelize 可以方便的滿足上述需求。
 
+## 《Excelize 權威指南》
+
+<p align="center"><img width="240" src="../images/book.png" alt="人民郵電出版社《Excelize 權威指南》"></p>
+
+本書基於 Excelize 基礎庫，從 Office 辦公檔案格式國際標準出發，以源代碼為基礎，結合大量直觀的配圖，循序漸進地講解 Excelize 中的模塊實現，詳細解讀技術標準內容和基礎庫的設計。主要內容包括 Excelize 開發環境準備、檔案格式國際標準解讀、檔案數據結構建模、活頁簿、工作表、儲存格和列欄的相關操作、複雜樣式解析、圖表、圖片與圖形的相關操作、資料驗證與篩選、樞紐分析表、流式讀寫技術以及一個綜合實踐應用。閱讀本書，具有一定 Go 語言基礎，想入門 Excelize 的開發人員能夠進一步系統理解 Excelize 基礎庫的實現細節，不具備 Go 語言開發經驗的開發人員也能夠快速掌握 Excelize 的設計原理。
+
+網上購買方式：<a href="https://www.epubit.com/bookDetails?id=UB88d55b2b00d26" title="在異步社區購買《Excelize 權威指南》圖書" target="_blank">異步社區</a> | <a href="https://detail.tmall.com/item.htm?id=818853544894" title="在天貓商城購買《Excelize 權威指南》圖書" target="_blank">天貓</a> | <a href="https://item.jd.com/14710146.html" title="在京東購買《Excelize 權威指南》圖書" target="_blank">京東</a> | <a href="https://product.dangdang.com/11781983074.html" title="在當當網購買《Excelize 權威指南》圖書" target="_blank">當當</a> | <a href="https://j.youzan.com/AYJQXF" title="在微店購買《Excelize 權威指南》圖書" target="_blank">微店</a> | <a href="https://v.douyin.com/iMmtmks2" title="在抖音商城購買《Excelize 權威指南》圖書" target="_blank">抖音</a> | <a href="https://mobile.yangkeduo.com/goods2.html?ps=w8ZH3afuel" title="在拼多多購買《Excelize 權威指南》圖書" target="_blank">拼多多</a>
+
 ## 專案榮譽
 
 入選 2023 開源創新榜[優秀開源專案](https://cccst.org.cn/zxyw/tzgg/art/2023/art_748b3428e4184ccc825ea6de1a2d273f.html)

diff --git a/zh-tw/base/installation.md b/zh-tw/base/installation.md
@@ -1,5 +1,7 @@
 # 快速開始
 
+{{ book.info }}
+
 ## 安裝 {#install}
 
 下表列出了各版本 Excelize 基礎庫對 Go 語言版本最低要求的情況：

diff --git a/zh-tw/book.json b/zh-tw/book.json
@@ -34,5 +34,8 @@
             "top": 0,
             "bottom": 0
         }
+    },
+    "variables": {
+        "info": "<pre style=\"font-family: inherit; 10px 2%;\"><span style=\"display: table-cell; padding: 12px; width: 24px; height: 24px; line-height: 0;\"><svg xmlns=\"http://www.w3.org/2000/svg\" x=\"0px\" y=\"0px\" viewBox=\"0 0 44 44\" width=\"24px\" height=\"24px\" fill=\"none\" stroke=\"currentColor\"><circle cx=\"22\" cy=\"22\" r=\"20\" stroke-width=\"2\"></circle><line x1=\"22\" x2=\"22\" y1=\"18\" y2=\"33\" stroke-width=\"3\"></line><line x1=\"22\" x2=\"22\" y1=\"12\" y2=\"15\" stroke-width=\"3\"></line></svg></span><p style=\"display: table-cell; vertical-align: middle; padding: 0; line-height: 16px;\">《Excelize 權威指南》圖書出版，網上購買方式：<a href=\"https://www.epubit.com/bookDetails?id=UB88d55b2b00d26\" title=\"在異步社區購買《Excelize 權威指南》圖書\" target=\"_blank\">異步社區</a> | <a href=\"https://detail.tmall.com/item.htm?id=818853544894\" title=\"在天貓商城購買《Excelize 權威指南》圖書\" target=\"_blank\">天貓</a> | <a href=\"https://item.jd.com/14710146.html\" title=\"在京東購買《Excelize 權威指南》圖書\" target=\"_blank\">京東</a> | <a href=\"https://product.dangdang.com/11781983074.html\" title=\"在當當網購買《Excelize 權威指南》圖書\" target=\"_blank\">當當</a> | <a href=\"https://j.youzan.com/AYJQXF\" title=\"在微店購買《Excelize 權威指南》圖書\" target=\"_blank\">微店</a> | <a href=\"https://v.douyin.com/iMmtmks2\" title=\"在抖音商城購買《Excelize 權威指南》圖書\" target=\"_blank\">抖音</a> | <a href=\"https://mobile.yangkeduo.com/goods2.html?ps=w8ZH3afuel\" title=\"在拼多多購買《Excelize 權威指南》圖書\" target=\"_blank\">拼多多</a></p></pre>"
     }
 }
diff --git a/zh-tw/cell.md b/zh-tw/cell.md
@@ -1,5 +1,7 @@
 # 儲存格
 
+{{ book.info }}
+
 `RichTextRun` 定義了富文本的屬性。
 
 ```go

diff --git a/zh-tw/chart.md b/zh-tw/chart.md
@@ -1,5 +1,7 @@
 # 圖表
 
+{{ book.info }}
+
 ## 添加圖表 {#AddChart}
 
 ```go

diff --git a/zh-tw/constants.md b/zh-tw/constants.md
@@ -1,5 +1,7 @@
 # 常量
 
+{{ book.info }}
+
 CultureName 是受支援的區域格式類別定義。
 
 ```go

diff --git a/zh-tw/contribution.md b/zh-tw/contribution.md
@@ -1,5 +1,7 @@
 # 參與貢獻
 
+{{ book.info }}
+
 ## 如何參與貢獻
 
 Microsoft Excel&trade; 2007 版本後支援基於 XML 的文檔格式 OOXML (Office Open XML)，是一種基於 XML 和 ZIP 技術的新的文檔格式。下面列出了包括文檔標準、文檔驗證對比工具和瀏覽器插件等在內的開發符合該文檔格式的相關參考資料。

diff --git a/zh-tw/data.md b/zh-tw/data.md
@@ -1,5 +1,7 @@
 # 資料
 
+{{ book.info }}
+
 ## 添加資料驗證 {#AddDataValidation}
 
 ```go

diff --git a/zh-tw/example/calendar.md b/zh-tw/example/calendar.md
@@ -1,5 +1,7 @@
 # 日曆
 
+{{ book.info }}
+
 使用 Go 語言在 Excel 文檔中創建日曆：
 
 <p align="center"><img width="934" src="../images/example_calendar.png" alt="使用 Go 語言在 Excel 文檔中創建日曆"></p>

diff --git a/zh-tw/example/dependentDropList.md b/zh-tw/example/dependentDropList.md
@@ -1,5 +1,7 @@
 # 級聯列表
 
+{{ book.info }}
+
 使用 Go 語言在 Excel 檔案中創建多級聯動菜單列表:
 
 <p align="center"><img width="375" src="../images/dependent_drop_list.gif" alt="使用 Go 語言在 Excel 檔案中創建多級聯動菜單列表"></p>

diff --git a/zh-tw/example/multiselectDropList.md b/zh-tw/example/multiselectDropList.md
@@ -1,5 +1,7 @@
 # 多選列表
 
+{{ book.info }}
+
 使用 Go 語言在 Excel 檔案中無需 VBA 創建可多選菜單列表:
 
 <p align="center"><img width="426" src="../images/multiselect_drop_list.gif" alt="使用 Go 語言在 Excel 檔案中無需 VBA 創建可多選菜單列表"></p>

diff --git a/zh-tw/formControl.md b/zh-tw/formControl.md
@@ -1,5 +1,7 @@
 # 表單控制項
 
+{{ book.info }}
+
 FormControl 定義了表單控制項的屬性。
 
 ```go

diff --git a/zh-tw/image.md b/zh-tw/image.md
@@ -1,5 +1,7 @@
 # 圖片
 
+{{ book.info }}
+
 ## 插入圖片 {#AddPicture}
 
 ```go

diff --git a/zh-tw/performance.md b/zh-tw/performance.md
@@ -1,5 +1,7 @@
 # 性能資料
 
+{{ book.info }}
+
 <a href="https://xuri.me/wp-content/uploads/2016/08/excelize-performance.svg"><img src="https://xuri.me/wp-content/uploads/2016/08/excelize-performance.svg" alt="Excelize benchmark" width="1506"></a>
 
 性能數據由[此基準測試腳本](https://github.com/xuri/excelize-benchmark)生成。

diff --git a/zh-tw/pivot.md b/zh-tw/pivot.md
@@ -1,5 +1,7 @@
 # 樞紐分析表 {#PivotTable}
 
+{{ book.info }}
+
 樞紐分析表是一種交互式的表，是計算、匯總和分析資料的強大工具，可助你瞭解資料中的對比情況、模式和趨勢。
 
 `PivotTableOptions` 定義了樞紐分析表的屬性。

diff --git a/zh-tw/shape.md b/zh-tw/shape.md
@@ -1,5 +1,7 @@
 # 圖形
 
+{{ book.info }}
+
 ## 添加圖形
 
 ```go

diff --git a/zh-tw/sheet.md b/zh-tw/sheet.md
@@ -1,5 +1,7 @@
 # 工作表
 
+{{ book.info }}
+
 ## 設定欄可見性 {#SetColVisible}
 
 ```go

diff --git a/zh-tw/sparklines.md b/zh-tw/sparklines.md
@@ -1,5 +1,7 @@
 # 走勢圖
 
+{{ book.info }}
+
 走勢圖是 Excel 2010 及以上版本中的功能，是放入儲存格中的小型圖，每個走勢圖代表所選內容中的一行資料。將走勢圖放在其資料附近可提供非常好的視覺衝擊。
 
 <p align="center"><img width="612" src="./images/sparkline_01.png" alt="使用 Go 語言透過 Excelize 創建走勢圖"></p>

diff --git a/zh-tw/stream.md b/zh-tw/stream.md
@@ -1,5 +1,7 @@
 # 流式寫入
 
+{{ book.info }}
+
 `StreamWriter` 用於定義流式寫入器的資料類別。
 
 ```go

diff --git a/zh-tw/style.md b/zh-tw/style.md
@@ -1,5 +1,7 @@
 # 樣式
 
+{{ book.info }}
+
 Alignment 映射儲存格對齊樣式設定。
 
 ```go

diff --git a/zh-tw/utils.md b/zh-tw/utils.md
@@ -1,5 +1,7 @@
 # 工具函式
 
+{{ book.info }}
+
 ## 創建表格 {#AddTable}
 
 ```go
@@ -1021,7 +1023,7 @@ func ThemeColor(baseColor string, tint float64) string
 
 透過給定的十六進制色彩代碼與色調參數，計算出最終色彩。
 
-電子錶格文檔中的文本有 3 種色彩：十六進制色彩、索引色彩和主題色彩。這些色彩的優先級為：十六進制色彩優先於主題色彩、主題色彩優先於索引色彩。另外，色彩還支持基於十六進制色彩應用色調值，因此可使用 ThemeColor 函數為首選色彩應用色調，以獲取計算出的實際十六進制色彩值。例如，獲取名為 `Sheet1` 的工作表 `A1` 儲存格的富文本中的文字色彩：
+電子錶格文檔中的文本有 3 種色彩：十六進制色彩、索引色彩和主題色彩。這些色彩的優先級為：十六進制色彩優先於主題色彩、主題色彩優先於索引色彩。另外，色彩還支援基於十六進制色彩應用色調值，因此可使用 ThemeColor 函數為首選色彩應用色調，以獲取計算出的實際十六進制色彩值。例如，獲取名為 `Sheet1` 的工作表 `A1` 儲存格的富文本中的文字色彩：
 
 ```go
 package main

diff --git a/zh-tw/variables.md b/zh-tw/variables.md
@@ -1,5 +1,7 @@
 # 變數
 
+{{ book.info }}
+
 ```go
 var (
     // ErrAddVBAProject 定義了向活頁簿嵌入 VBA 專案發生異常時的錯誤提示信息

diff --git a/zh-tw/workbook.md b/zh-tw/workbook.md
@@ -1,5 +1,7 @@
 # 活頁簿
 
+{{ book.info }}
+
 `Options` 定義了讀寫電子表格檔案時的選項。
 
 ```go