diff --git a/images/book.png b/images/book.png new file mode 100644 index 00000000..2bbe4482 Binary files /dev/null and b/images/book.png differ diff --git a/zh-hans/README.md b/zh-hans/README.md index 6abc5430..3799c9f9 100644 --- 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 权威指南》 + +

人民邮电出版社《Excelize 权威指南》

+ +本书基于 Excelize 基础库，从 Office 办公文档格式国际标准出发，以源代码为基础，结合大量直观的配图，循序渐进地讲解 Excelize 中的模块实现，详细解读技术标准内容和基础库的设计。主要内容包括 Excelize 开发环境准备、文档格式国际标准解读、文档数据结构建模、工作簿、工作表、单元格和行列的相关操作、复杂样式解析、图表、图片与形状的相关操作、数据验证与筛选、数据透视表、流式读写技术以及一个综合实践应用。阅读本书，具有一定 Go 语言基础，想入门 Excelize 的开发人员能够进一步系统理解 Excelize 基础库的实现细节，不具备 Go 语言开发经验的开发人员也能够快速掌握 Excelize 的设计原理。 + +网上购买方式：异步社区 | 天猫 | 京东 | 当当 | 微店 | 抖音 | 拼多多 + ## 项目荣誉 入选 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 index 3f47b0dc..65dbd9f1 100644 --- 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 index 0d891e34..b8dee761 100644 --- a/zh-hans/book.json +++ b/zh-hans/book.json @@ -37,5 +37,8 @@ }, "headerTemplate": null, "footerTemplate": null + }, + "variables": { + "info": "
《Excelize 权威指南》图书出版，网上购买方式：异步社区 | 天猫 | 京东 | 当当 | 微店 | 抖音 | 拼多多
" } } \ No newline at end of file diff --git a/zh-hans/cell.md b/zh-hans/cell.md index 3b529fb0..8852b5cf 100644 --- 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 index 5469606f..f961f122 100644 --- 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 index 9b33f112..beaa0795 100644 --- 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 index fc22466a..09778d29 100644 --- a/zh-hans/contribution.md +++ b/zh-hans/contribution.md @@ -1,5 +1,7 @@ # 参与贡献 +{{ book.info }} + ## 如何参与贡献 Microsoft Excel™ 2007 版本后支持基于 XML 的文档格式 OOXML (Office Open XML)，是一种基于 XML 和 ZIP 技术的新的文档格式。下面列出了包括文档标准、文档验证对比工具和浏览器插件等在内的开发符合该文档格式的相关参考资料。 diff --git a/zh-hans/data.md b/zh-hans/data.md index c2e2f1cf..b732b386 100644 --- 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 index 3bece91d..7f1c2119 100644 --- a/zh-hans/example/calendar.md +++ b/zh-hans/example/calendar.md @@ -1,5 +1,7 @@ # 日历 +{{ book.info }} + 使用 Go 语言在 Excel 文档中创建日历：

使用 Go 语言在 Excel 文档中创建日历

diff --git a/zh-hans/example/dependentDropList.md b/zh-hans/example/dependentDropList.md index f6721d9a..9aeb72cf 100644 --- a/zh-hans/example/dependentDropList.md +++ b/zh-hans/example/dependentDropList.md @@ -1,5 +1,7 @@ # 级联列表 +{{ book.info }} + 使用 Go 语言在 Excel 文档中创建多级联动菜单列表:

使用 Go 语言在 Excel 文档中创建多级联动菜单列表

diff --git a/zh-hans/example/multiselectDropList.md b/zh-hans/example/multiselectDropList.md index 3866e073..1d2b665f 100644 --- a/zh-hans/example/multiselectDropList.md +++ b/zh-hans/example/multiselectDropList.md @@ -1,5 +1,7 @@ # 多选列表 +{{ book.info }} + 使用 Go 语言在 Excel 文档中无需 VBA 创建可多选菜单列表:

使用 Go 语言在 Excel 文档中无需 VBA 创建可多选菜单列表

diff --git a/zh-hans/formControl.md b/zh-hans/formControl.md index b93df0ec..828235d6 100644 --- 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 index ba79c1e2..7db78fe6 100644 --- 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 index 15277ac2..ec10fc9e 100644 --- a/zh-hans/performance.md +++ b/zh-hans/performance.md @@ -1,5 +1,7 @@ # 性能数据 +{{ book.info }} + Excelize benchmark 性能数据由[此基准测试脚本](https://github.com/xuri/excelize-benchmark)生成。 diff --git a/zh-hans/pivot.md b/zh-hans/pivot.md index f571dc5b..2f1dfe29 100644 --- 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 index 8a1dd84f..2f5b643a 100644 --- 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 index a37c4eed..4c506fbd 100644 --- 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 index d62fa1fb..ede5ce82 100644 --- a/zh-hans/sparklines.md +++ b/zh-hans/sparklines.md @@ -1,5 +1,7 @@ # 迷你图 +{{ book.info }} + 迷你图是 Excel 2010 及以上版本中的功能，是放入单元格中的小型图，每个迷你图代表所选内容中的一行数据。将迷你图放在其数据附近可提供非常好的视觉冲击。

使用 Go 语言通过 Excelize 创建迷你图

diff --git a/zh-hans/stream.md b/zh-hans/stream.md index 9f7ee2b0..3a925576 100644 --- 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 index 87debc08..5e21ec5a 100755 --- 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 index 17e6ac1e..f65a4103 100644 --- 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 index caf6cae3..502d1b99 100644 --- 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 index ed660486..946b52f3 100644 --- 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 index 637a6c87..088955a4 100644 --- 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 權威指南》 + +

人民郵電出版社《Excelize 權威指南》

+ +本書基於 Excelize 基礎庫，從 Office 辦公檔案格式國際標準出發，以源代碼為基礎，結合大量直觀的配圖，循序漸進地講解 Excelize 中的模塊實現，詳細解讀技術標準內容和基礎庫的設計。主要內容包括 Excelize 開發環境準備、檔案格式國際標準解讀、檔案數據結構建模、活頁簿、工作表、儲存格和列欄的相關操作、複雜樣式解析、圖表、圖片與圖形的相關操作、資料驗證與篩選、樞紐分析表、流式讀寫技術以及一個綜合實踐應用。閱讀本書，具有一定 Go 語言基礎，想入門 Excelize 的開發人員能夠進一步系統理解 Excelize 基礎庫的實現細節，不具備 Go 語言開發經驗的開發人員也能夠快速掌握 Excelize 的設計原理。 + +網上購買方式：異步社區 | 天貓 | 京東 | 當當 | 微店 | 抖音 | 拼多多 + ## 專案榮譽 入選 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 index 1a0234c2..c9794d8c 100644 --- 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 index cfb8d414..059f0537 100644 --- a/zh-tw/book.json +++ b/zh-tw/book.json @@ -34,5 +34,8 @@ "top": 0, "bottom": 0 } + }, + "variables": { + "info": "
《Excelize 權威指南》圖書出版，網上購買方式：異步社區 | 天貓 | 京東 | 當當 | 微店 | 抖音 | 拼多多
" } } \ No newline at end of file diff --git a/zh-tw/cell.md b/zh-tw/cell.md index 3075e05f..2f9f8662 100644 --- 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 index b65989e2..cb242d1f 100644 --- 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 index 8e07fbd2..9bcadd8c 100644 --- 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 index 4501faa3..8c8230a1 100644 --- a/zh-tw/contribution.md +++ b/zh-tw/contribution.md @@ -1,5 +1,7 @@ # 參與貢獻 +{{ book.info }} + ## 如何參與貢獻 Microsoft Excel™ 2007 版本後支援基於 XML 的文檔格式 OOXML (Office Open XML)，是一種基於 XML 和 ZIP 技術的新的文檔格式。下面列出了包括文檔標準、文檔驗證對比工具和瀏覽器插件等在內的開發符合該文檔格式的相關參考資料。 diff --git a/zh-tw/data.md b/zh-tw/data.md index 62b56a38..b2186be6 100644 --- 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 index adcc9764..ed27dbef 100644 --- a/zh-tw/example/calendar.md +++ b/zh-tw/example/calendar.md @@ -1,5 +1,7 @@ # 日曆 +{{ book.info }} + 使用 Go 語言在 Excel 文檔中創建日曆：

使用 Go 語言在 Excel 文檔中創建日曆

diff --git a/zh-tw/example/dependentDropList.md b/zh-tw/example/dependentDropList.md index 8248b4ef..34e56d55 100644 --- a/zh-tw/example/dependentDropList.md +++ b/zh-tw/example/dependentDropList.md @@ -1,5 +1,7 @@ # 級聯列表 +{{ book.info }} + 使用 Go 語言在 Excel 檔案中創建多級聯動菜單列表:

使用 Go 語言在 Excel 檔案中創建多級聯動菜單列表

diff --git a/zh-tw/example/multiselectDropList.md b/zh-tw/example/multiselectDropList.md index 721389e9..3eff92ce 100644 --- a/zh-tw/example/multiselectDropList.md +++ b/zh-tw/example/multiselectDropList.md @@ -1,5 +1,7 @@ # 多選列表 +{{ book.info }} + 使用 Go 語言在 Excel 檔案中無需 VBA 創建可多選菜單列表:

使用 Go 語言在 Excel 檔案中無需 VBA 創建可多選菜單列表

diff --git a/zh-tw/formControl.md b/zh-tw/formControl.md index 3214842c..d408f644 100644 --- 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 index 94533aff..1928f7c0 100644 --- 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 index 8451abda..ce778320 100644 --- a/zh-tw/performance.md +++ b/zh-tw/performance.md @@ -1,5 +1,7 @@ # 性能資料 +{{ book.info }} + Excelize benchmark 性能數據由[此基準測試腳本](https://github.com/xuri/excelize-benchmark)生成。 diff --git a/zh-tw/pivot.md b/zh-tw/pivot.md index 78b853d0..0f4f864b 100644 --- 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 index 1ac10b1b..e58ea6d2 100644 --- 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 index ab8df98a..63a007e9 100644 --- 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 index e795f76a..4c84c71f 100644 --- a/zh-tw/sparklines.md +++ b/zh-tw/sparklines.md @@ -1,5 +1,7 @@ # 走勢圖 +{{ book.info }} + 走勢圖是 Excel 2010 及以上版本中的功能，是放入儲存格中的小型圖，每個走勢圖代表所選內容中的一行資料。將走勢圖放在其資料附近可提供非常好的視覺衝擊。

使用 Go 語言透過 Excelize 創建走勢圖

diff --git a/zh-tw/stream.md b/zh-tw/stream.md index f31cf017..33ce62df 100644 --- 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 index 9b4f0ee3..1de4246d 100755 --- 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 index 3192bd3c..9a102e87 100644 --- 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 index c0339031..85d2ded4 100644 --- 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 index 84ca5377..a7900f25 100755 --- a/zh-tw/workbook.md +++ b/zh-tw/workbook.md @@ -1,5 +1,7 @@ # 活頁簿 +{{ book.info }} + `Options` 定義了讀寫電子表格檔案時的選項。 ```go