Skip to content

Commit

Permalink
Update the zh-tw version docs (#19)
Browse files Browse the repository at this point in the history
  • Loading branch information
taomin597715379 authored Jul 21, 2023
1 parent 9cace30 commit e3ebfda
Show file tree
Hide file tree
Showing 17 changed files with 45 additions and 45 deletions.
2 changes: 1 addition & 1 deletion zh-tw/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Excelize 的目標是創建並維護一個 Go 語言版本的 Excel 檔案 API

## 為什麼要使用 Excelize

在一些情況下我們需要透過程式操作 Excel 檔案,例如:打開讀取已有 Excel 檔案內容、創建新的 Excel 檔案、基於已有檔案(範本)生成新的 Excel 檔案、向 Excel 檔案中插入圖片、圖表和表格等元素,有時還需要跨平台實現這些操作。使用 Excelize 可以方便的滿足上述需求。
在一些情況下我們需要透過程式操作 Excel 檔案,例如:開啓讀取已有 Excel 檔案內容、創建新的 Excel 檔案、基於已有檔案(範本)生成新的 Excel 檔案、向 Excel 檔案中插入圖片、圖表和表格等元素,有時還需要跨平台實現這些操作。使用 Excelize 可以方便的滿足上述需求。

## 專案榮譽

Expand Down
8 changes: 4 additions & 4 deletions zh-tw/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@
* [在 Excel 文檔中創建圖表](base/installation.md#chart)
* [向 Excel 文檔中插入圖片](base/installation.md#image)
* [活頁簿](workbook.md)
* [創建](workbook.md#NewFile)
* [打開](workbook.md#OpenFile)
* [打開數據流](workbook.md#OpenReader)
* [新增](workbook.md#NewFile)
* [開啓](workbook.md#OpenFile)
* [開啓數據流](workbook.md#OpenReader)
* [儲存](workbook.md#Save)
* [另存為](workbook.md#SaveAs)
* [關閉活頁簿](workbook.md#Close)
* [新建工作表](workbook.md#NewSheet)
* [新增工作表](workbook.md#NewSheet)
* [刪除工作表](workbook.md#DeleteSheet)
* [複製工作表](workbook.md#CopySheet)
* [工作表分組](workbook.md#GroupSheets)
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/cell.md
Original file line number Diff line number Diff line change
Expand Up @@ -610,7 +610,7 @@ err := f.DeleteComment("Sheet1", "A30")
func (f *File) SetCellFormula(sheet, cell, formula string, opts ...FormulaOpts) error
```

根據給定的工作表名和儲存格坐標設定該儲存格上的公式。公式的結果會在工作表被 Office Excel 應用程式打開時計算,或透過 [CalcCellValue](cell.md#CalcCellValue) 函式計算存儲格的值。若 Excel 應用程式打開活頁簿後未對設定的存儲格公式進行計算,請在設定公式後調用 [UpdateLinkedValue](utils.md#UpdateLinkedValue) 清除存儲格緩存。
根據給定的工作表名和儲存格坐標設定該儲存格上的公式。公式的結果會在工作表被 Office Excel 應用程式開啓時計算,或透過 [CalcCellValue](cell.md#CalcCellValue) 函式計算存儲格的值。若 Excel 應用程式開啓活頁簿後未對設定的存儲格公式進行計算,請在設定公式後調用 [UpdateLinkedValue](utils.md#UpdateLinkedValue) 清除存儲格緩存。

- 例1,為名為 `Sheet1` 的工作表 `A3` 存儲格設定普通公式 `=SUM(A1,B1)`

Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@
### 問題修復

* 修復部分情況下,在樣式格式中未指定儲存格色彩填滿時,創建了空白填滿的問題
* 修復當工作表資料驗證公式超過 `225` 個字符時,檔案打開失敗的問題,解決了相關 issue [#339](https://github.com/xuri/excelize/issues/339)
* 修復當工作表資料驗證公式超過 `225` 個字符時,檔案開啓失敗的問題,解決了相關 issue [#339](https://github.com/xuri/excelize/issues/339)
* 修復部分情況下,刪除帶有公式的儲存格會導致檔案損壞的問題,解決了相關 issue [#346](https://github.com/xuri/excelize/issues/346)
* 修復透過獲取註解函式 `GetComment`,從包含多個工作表的活頁簿獲取註解時,返回了錯誤的工作表名稱的問題,解決了相關 issue [#345](https://github.com/xuri/excelize/issues/345)
* 修復獲取工作表全部儲存格函式 `GetRows` 返回多餘的欄的問題
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.0.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
* 新增 `SetDocProps``GetDocProps` 方法,支持設定和獲取文檔屬性,相關 issue [#415](https://github.com/xuri/excelize/issues/415)
* 函式 `AddChart` 新增加了 26 種圖表的創建:簇狀圓錐、堆積圓錐、百分比堆積圓錐、三維圓錐圖、簇狀水平圓錐圖、堆積水平圓錐圖、堆積百分比水平圓錐圖、簇狀稜錐圖、堆積稜錐、百分比堆積稜錐、三維稜錐圖、簇狀水平稜錐圖、堆積水平稜錐圖、堆積百分比水平稜錐圖、簇狀柱形圖 、堆積柱形圖、百分比堆積柱形圖、三維柱形圖、簇狀水平圓柱圖、堆積水平圓柱圖、堆積百分比水平圓柱圖、三維曲面圖、俯視框架曲面圖、三維曲面框架圖、泡泡圖與三維泡泡圖,不受支持的圖表型別將返回錯誤提示
* 新增 `SetDefinedName``GetDefinedName` 方法,支持設定和獲取名稱
* 優化並明確了打開加密檔案時的錯誤提示信息
* 優化並明確了開啓加密檔案時的錯誤提示信息
* 函式 `AddPicture` 現在支持添加 TIF 和 TIFF 格式的圖片

### 問題修復
Expand Down
4 changes: 2 additions & 2 deletions zh-tw/releases/v2.2.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,14 +32,14 @@
* 修復透過 `GetComments` 獲取註解部分註解資料無法獲取問題,解決 issue [#345](https://github.com/xuri/excelize/issues/345)
* 修復特定情況下透過 `GetCellValue` 獲取儲存格值錯誤問題,解決 issue [#602](https://github.com/xuri/excelize/issues/602)
* 修復因某些情況下文檔內部列內儲存格缺少 `r` 屬性而導致的 `GetCellValue` 錯誤地返回空值問題
* 兼容儲存格樣式中的空值與默認值,修復部分情況下透過電子錶格軟體打開生成文檔修改樣式失效的問題,解決 issue [#628](https://github.com/xuri/excelize/issues/628)
* 兼容儲存格樣式中的空值與默認值,修復部分情況下透過電子錶格軟體開啓生成文檔修改樣式失效的問題,解決 issue [#628](https://github.com/xuri/excelize/issues/628)

### 性能提升

* 優化內部函式 `getRowHeight`,降低內存佔用

### 其他

* 移除工作表計算屬性使部分電子錶格應用程式(如:金山 WPS™ Office)打開生成的文檔進行重新計算公式
* 移除工作表計算屬性使部分電子錶格應用程式(如:金山 WPS™ Office)開啓生成的文檔進行重新計算公式
* 完善單元測試中的錯誤處理
* 包含簡體中文、英語、法語、俄語、日語和韓語的[多國語言文檔網站](https://xuri.me/excelize)更新
4 changes: 2 additions & 2 deletions zh-tw/releases/v2.3.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,12 +31,12 @@
* 修復因活頁簿內產生了重復的篩選資料庫而導致的文檔損壞問題
* 避免添加樣式時生成重復的樣式定義
* 修復設定富文本中包含的特殊字符丟失問題
* 修復使用 Office 應用程式打開添加註解的文檔,儲存後再次打開註解圖形不為矩形的問題,解決 [#672](https://github.com/xuri/excelize/issues/672)
* 修復使用 Office 應用程式開啓添加註解的文檔,儲存後再次開啓註解圖形不為矩形的問題,解決 [#672](https://github.com/xuri/excelize/issues/672)
* 避免部分情況下開啓編譯內聯優化參數時潛在的運行時 panic 問題,解決 issue [#677](https://github.com/xuri/excelize/issues/677)[#679](https://github.com/xuri/excelize/issues/679)
* 修正獲取百分比儲存格值的數值精度問題

### 其他

* 修復特定情況下打開無效工作表時出現的異常 panic 問題
* 修復特定情況下開啓無效工作表時出現的異常 panic 問題
* 完善單元測試中的錯誤處理
* 包含簡體中文、英語、法語、俄語、日語和韓語的[多國語言文檔網站](https://xuri.me/excelize)更新
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.3.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

### 新增功能

* 支持打開帶有基於 ECMA-376 文檔加密標準密碼保護的電子錶格文檔,相關 issue [#199](https://github.com/xuri/excelize/issues/199)
* 支持開啓帶有基於 ECMA-376 文檔加密標準密碼保護的電子錶格文檔,相關 issue [#199](https://github.com/xuri/excelize/issues/199)
* 增加工作表規範與限制
* 擴展樞紐分析表功能:支持設定樞紐分析表的標題、樣式和透視表選項
* 安全漏洞修復
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.4.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Go Modules 包引用地址調整為 `github.com/xuri/excelize/v2`
### 相容性提升

* 提升內部默認 XML 命名空間相容性,修復部分情況下生成檔案損壞的問題
* 兼容帶有非標準頁面配置屬性數據型別的電子錶格檔案,避免打開失敗的問題
* 兼容帶有非標準頁面配置屬性數據型別的電子錶格檔案,避免開啓失敗的問題
* 增加內部共享字符表計數
* 解除透過給定的時間設定存儲格的值時,需要協調世界時 (UTC) 的限制,相關 issue [#409](https://github.com/xuri/excelize/issues/409)
* 增加對內部 XML 控制字符的兼容
Expand Down
6 changes: 3 additions & 3 deletions zh-tw/releases/v2.5.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@

### 相容性提示

* 打開已有活頁簿或在獲取列迭代器後,需要調用對應的 `Close` 關閉活頁簿和資料流
* 開啓已有活頁簿或在獲取列迭代器後,需要調用對應的 `Close` 關閉活頁簿和資料流
* 修改 `ReadZipReader``File` 的實現, 支持透過選項指定解壓至內存或文件系統
* 移除了不必要的導出變數 `XMLHeader`,可使用 `encoding/xml` 包的 `xml.Header` 代替
* 移除了不再使用的導出變數 `ErrToExcelTime`
Expand All @@ -30,7 +30,7 @@
* `UpdateLinkedValue` 在清除存儲格計算緩存時將跳過 macro sheet, 相關 issue [#1014](https://github.com/xuri/excelize/issues/1014)
* 修復部分情況下,由於內部依賴關係計算錯誤導致的 `AddPicture` 重復創建圖片的問題, 相關 issue [#1017](https://github.com/xuri/excelize/issues/1017)
* `AddShape` 支持設定圖形輪廓線條寬度, 相關 issue [#262](https://github.com/xuri/excelize/issues/262)
* 新增文檔打開選項 `UnzipXMLSizeLimit` 以支持指定打開每個工作表以及共享字符表時的內存解壓上限
* 新增文檔開啓選項 `UnzipXMLSizeLimit` 以支持指定開啓每個工作表以及共享字符表時的內存解壓上限
* 創建樣式時,若給定的自定義數字格式無效,將返回錯誤提示,相關 issue [#1028](https://github.com/xuri/excelize/issues/1028)
* 流式寫入現已支持設定列樣式
* 流式寫入器將為時間型別存儲格創建時間數字格式樣式,相關 issue [#1107](https://github.com/xuri/excelize/issues/1107)
Expand Down Expand Up @@ -61,7 +61,7 @@
* 修復部分情況下浮點型資料讀取異常的問題,解決 issue [#1031](https://github.com/xuri/excelize/issues/1031)
* 修復部分情況下刪除工作表失敗的問題
* 修復內建時間數字格式解析異常問題,解決 issue [#1060](https://github.com/xuri/excelize/issues/1060)
* 修復部分情況下新建樣式時返回樣式 ID 異常的問題
* 修復部分情況下新增樣式時返回樣式 ID 異常的問題
* 修復部分情況下刪除行列後合併存儲格區域異常的問題

### 性能優化
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.6.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@

### 相容性提升

* 提升與 LibreOffice 電子錶格應用程式的相容性,修復在 LibreOffice 中打開的工作表名包含空格時,自動過濾器失效的問題,解決 issue [#1122](https://github.com/xuri/excelize/issues/1122)
* 提升與 LibreOffice 電子錶格應用程式的相容性,修復在 LibreOffice 中開啓的工作表名包含空格時,自動過濾器失效的問題,解決 issue [#1122](https://github.com/xuri/excelize/issues/1122)
* 提升對活頁簿中替代內容的支持,保留活頁簿、工作表以及 drawingML 中的替代內容
* 提升與頁面設定中列印質量 DPI 設定屬性的相容性

Expand Down
6 changes: 3 additions & 3 deletions zh-tw/releases/v2.6.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,15 +24,15 @@
* 新增對 1900 和 1904 日期系統的支持,相關 issue [#1212](https://github.com/xuri/excelize/issues/1212)
* 新增更新超鏈接支持,相關 issue [#1217](https://github.com/xuri/excelize/issues/1217)
* 透過 `AddPicture` 添加圖片時,現已允許插入 EMF、WMF、EMZ 和 WMZ 格式圖片,相關 issue [#1225](https://github.com/xuri/excelize/issues/1225)
* 優化打開活頁簿失敗時的錯誤提示信息,新增導出變數 `ErrWorkbookPassword` 定義了打開活頁簿時密碼驗證失敗的錯誤提示信息,以便開發者可根據不同的錯誤類型進行採取相應處理
* 優化開啓活頁簿失敗時的錯誤提示信息,新增導出變數 `ErrWorkbookPassword` 定義了開啓活頁簿時密碼驗證失敗的錯誤提示信息,以便開發者可根據不同的錯誤類型進行採取相應處理
* 新增導出常量 `MinFontSize``MinColumns``MaxCellStyles` 以定義最小字號和最小欄號
* 公式引擎新增數組公式支持
* 支持根據給定的密碼對活頁簿進行加密保護,相關 issue [#199](https://github.com/xuri/excelize/issues/199)
* 設定儲存格富文本格式時,支持透過指定 `RichTextRun` 中的 vertAlign` 屬性設定上標和下標
* 透過 `DeleteDataValidation` 函式刪除數據驗證時,支持省略第二個引用區域參數以刪除工作表中的全部數據驗證,相關 issue [#1254](https://github.com/xuri/excelize/issues/1254)
* 公式計算引擎支持帶有百分比符號的條件比較表達式
* 公式計算引擎支持依賴依賴公式計算,相關 issue [#1262](https://github.com/xuri/excelize/issues/1262)
* 新增文檔打開選項 `MaxCalcIterations` 以支持指定公式反覆運算的最多迭代次數
* 新增文檔開啓選項 `MaxCalcIterations` 以支持指定公式反覆運算的最多迭代次數
* 新增導出類型 `ColorMappingType` 以定義色彩轉換枚舉類型
* 插入或刪除列列時支持自動調整表格區域
* 支持設定與獲取工作表標籤色彩索引、主題和色調,相關 [#1283](https://github.com/xuri/excelize/issues/1283)
Expand All @@ -57,7 +57,7 @@
* 修復部分情況下存儲格賦值失效的問題,解決 issue [#1264](https://github.com/xuri/excelize/issues/1264)
* 修復設定工作表檢視屬性時可能出現的 panic
* 修復部分情況下因工作表核心屬性中 dcterms 屬性為空,導致生成的活页簿損壞問題
* 修復新建工作表後活頁簿屬性丟失問題,解決 issue [#1298](https://github.com/xuri/excelize/issues/1298)
* 修復新增工作表後活頁簿屬性丟失問題,解決 issue [#1298](https://github.com/xuri/excelize/issues/1298)

### 性能優化

Expand Down
4 changes: 2 additions & 2 deletions zh-tw/releases/v2.7.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@

* 兼容帶有函式組的活頁簿
* 兼容帶有嚴格模式 XML 命名空間地址的活頁簿主題,相關 issue [#1447](https://github.com/xuri/excelize/issues/1447)
* 提高了與檔案內部不含活頁簿關係部件活頁簿的相容性,以修復打開此類活頁簿可能出現的 panic
* 提高了與檔案內部不含活頁簿關係部件活頁簿的相容性,以修復開啓此類活頁簿可能出現的 panic
* 提高了獲取帶有空白字符共享字符串表索引值的相容性,解決 issue [#1508](https://github.com/xuri/excelize/issues/1508)

### 問題修復
Expand All @@ -61,7 +61,7 @@
* 修復了特定情況下當修改原本存儲了日期時間類型的存儲格為文本類型值,修改後存儲格數據類型有誤的問題,解決 issue [#1464](https://github.com/xuri/excelize/issues/1464)
* 修復了部分情況下公式計算結果為空的問題,解決 issue [#1469](https://github.com/xuri/excelize/issues/1469)
* 修復了設定數據條類型條件式格式時,指定自定義最大/最小值無效的問題,解決 issue [#1492](https://github.com/xuri/excelize/issues/1492)
* 修復了打開列高或欄寬為 0 的工作表,保存後列高欄寬設定失效的問題,解決 issue [#1461](https://github.com/xuri/excelize/issues/1461)
* 修復了開啓列高或欄寬為 0 的工作表,保存後列高欄寬設定失效的問題,解決 issue [#1461](https://github.com/xuri/excelize/issues/1461)

### 性能優化

Expand Down
10 changes: 5 additions & 5 deletions zh-tw/sheet.md
Original file line number Diff line number Diff line change
Expand Up @@ -192,7 +192,7 @@ func (f *File) DuplicateRow(sheet string, row int) error
err := f.DuplicateRow("Sheet1", 2)
```

請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式打開它時將可能導致檔案錯誤。excelize 目前僅支持對工作表上部分引用的更新。
請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式開啓它時將可能導致檔案錯誤。excelize 目前僅支持對工作表上部分引用的更新。

## 複製列 {#DuplicateRowTo}

Expand All @@ -206,7 +206,7 @@ func (f *File) DuplicateRowTo(sheet string, row, row2 int) error
err := f.DuplicateRowTo("Sheet1", 2, 7)
```

請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式打開它時將可能導致檔案錯誤。excelize 目前僅支持對工作表上部分引用的更新。
請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式開啓它時將可能導致檔案錯誤。excelize 目前僅支持對工作表上部分引用的更新。

## 創建列的分級顯示 {#SetRowOutlineLevel}

Expand Down Expand Up @@ -377,7 +377,7 @@ func (rows *Rows) GetRowOpts() RowOpts
func (rows *Rows) Close() error
```

關閉數據流並清理打開工作表時可能產生的系統磁盤緩存
關閉數據流並清理開啓工作表時可能產生的系統磁盤緩存

## 在工作表中搜尋 {#SearchSheet}

Expand Down Expand Up @@ -463,7 +463,7 @@ func (f *File) RemoveCol(sheet, col string) error
err := f.RemoveCol("Sheet1", "C")
```

請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式打開它時將可能導致檔案錯誤。excelize 目前僅支持對工作表上部分引用的更新。
請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式開啓它時將可能導致檔案錯誤。excelize 目前僅支持對工作表上部分引用的更新。

## 刪除列 {#RemoveRow}

Expand All @@ -477,7 +477,7 @@ func (f *File) RemoveRow(sheet string, row int) error
err := f.RemoveRow("Sheet1", 3)
```

請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式打開它時將可能導致檔案錯誤。Excelize 目前僅支持對工作表上部分引用的更新。
請謹慎使用此方法,這將影響所有對該工作表中原有公式、圖表等資源引用的更改。如果該工作表包含任何引用值,在使用此方法後使用 Excel 應用程式開啓它時將可能導致檔案錯誤。Excelize 目前僅支持對工作表上部分引用的更新。

## 按欄賦值 {#SetSheetCol}

Expand Down
Loading

0 comments on commit e3ebfda

Please sign in to comment.