Skip to content

Commit

Permalink
This update zh-tw docs
Browse files Browse the repository at this point in the history
  • Loading branch information
xuri committed Jan 11, 2024
1 parent 346e186 commit dfa94c5
Show file tree
Hide file tree
Showing 23 changed files with 109 additions and 83 deletions.
2 changes: 1 addition & 1 deletion zh-tw/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -178,7 +178,7 @@
* [圖樣填滿](style.md#pattern)
* [對齊方式](style.md#align)
* [字型底線](style.md#underline)
* [數字自定義格式](style.md#number_format)
* [數字自訂格式](style.md#number_format)
* [獲取樣式](style.md#GetStyle)
* [設定欄樣式](style.md#SetColStyle)
* [獲取欄樣式](style.md#GetColStyle)
Expand Down
6 changes: 3 additions & 3 deletions zh-tw/cell.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,7 +137,7 @@ err = f.SetCellStyle("Sheet1", "D7", "D7", style)

儲存格 `D7` 的四個外框被設定了不同的樣式和色彩,這與調用 [`NewStyle`](style.md#NewStyle) 函式時的參數有關,需要設定不同的樣式可參考該章節的文檔。

- 例2,為名為 `Sheet1` 的工作表 `D7` 儲存格設定漸變樣式
- 例2,為名為 `Sheet1` 的工作表 `D7` 儲存格設定漸層樣式

```go
style, err := f.NewStyle(&excelize.Style{
Expand All @@ -149,9 +149,9 @@ if err != nil {
err = f.SetCellStyle("Sheet1", "D7", "D7", style)
```

<p align="center"><img width="612" src="./images/SetCellStyle_02.png" alt="為儲存格設定漸變樣式"></p>
<p align="center"><img width="612" src="./images/SetCellStyle_02.png" alt="為儲存格設定漸層樣式"></p>

儲存格 `D7` 被設定了漸變效果的色彩填滿,漸變填滿效果與調用 [`NewStyle`](style.md#NewStyle) 函式時的參數有關,需要設定不同的樣式可參考該章節的文檔。
儲存格 `D7` 被設定了漸層效果的色彩填滿,漸層填滿效果與調用 [`NewStyle`](style.md#NewStyle) 函式時的參數有關,需要設定不同的樣式可參考該章節的文檔。

- 例3,為名為 `Sheet1` 的工作表 `D7` 儲存格設定純色填滿:

Expand Down
4 changes: 2 additions & 2 deletions zh-tw/chart.md
Original file line number Diff line number Diff line change
Expand Up @@ -146,7 +146,7 @@ TickLabelSkip | `int` | `1` | 指定標籤間隔單位
ReverseOrder | `bool` | `false` | 逆序刻度值
Maximum | `*float64` | `0` | 最大值,`0` 代表自動
Minimum | `*float64` | `0` | 最小值,`0` 代表自動
Font | `Font` | N/A | 設定水平坐標軸刻度字體格式
Font | `Font` | N/A | 設定水平坐標軸刻度字型格式
NumFmt | `ChartNumFmt` | N/A | 設定水平坐標軸數字格式和鏈接到源
Title | `[]RichTextRun` | N/A | 設定位於坐標軸下方的主要橫坐標軸標題,並調整圖表大小

Expand All @@ -161,7 +161,7 @@ MajorUnit | `float64` | `0` | 坐標軸主要刻度單位,`Majo
ReverseOrder | `bool` | `false` | 逆序刻度值
Maximum | `*float64` | `0` | 最大值,`0` 代表自動
Minimum | `*float64` | `0` | 最小值,`0` 代表自動
Font | `Font` | N/A | 設定垂直坐標軸刻度字體格式
Font | `Font` | N/A | 設定垂直坐標軸刻度字型格式
LogBase | `float64` | N/A | 設定垂直坐標軸對數刻度的基底
NumFmt | `ChartNumFmt` | N/A | 設定垂直坐標軸數字格式和鏈接到源
Title | `[]RichTextRun` | N/A | 設定旋轉過的主要縱坐標軸標題,並調整圖表大小
Expand Down
4 changes: 2 additions & 2 deletions zh-tw/example/calendar.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ func main() {
14: {31, 1, 2, 3, 4, 5, 6},
18: {"筆記"},
}
// 自定義列高
// 自訂列高
height = map[int]float64{
1: 45, 3: 22, 5: 44, 7: 44, 9: 44, 11: 44, 13: 44, 15: 44,
18: 24, 19: 24, 20: 24, 21: 24, 22: 24, 23: 24, 24: 24,
Expand All @@ -58,7 +58,7 @@ func main() {
return
}
}
// 設定自定義列高
// 設定自訂列高
for r, ht := range height {
if err = f.SetRowHeight(sheet, r, ht); err != nil {
fmt.Println(err)
Expand Down
4 changes: 2 additions & 2 deletions zh-tw/example/dependentDropList.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ func main() {
fmt.Println(err)
return
}
// 設定自定義名稱
// 設定自訂名稱
if err = f.SetDefinedName(&excelize.DefinedName{
Name: "Fruits",
RefersTo: "Sheet1!$A$2:$A$6",
Expand All @@ -73,7 +73,7 @@ func main() {
fmt.Println(err)
return
}
// 自定義欄寬
// 自訂欄寬
for col, width := range map[string]float64{
"A": 12, "B": 12, "C": 6, "D": 12, "E": 12} {
if err = f.SetColWidth("Sheet1", col, col, width); err != nil {
Expand Down
4 changes: 2 additions & 2 deletions zh-tw/example/multiselectDropList.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ func main() {
return
}
}
// 設定自定義名稱
// 設定自訂名稱
for index, value := range selection {
if cell, err = excelize.CoordinatesToCellName(1, index+2, true); err != nil {
fmt.Println(err)
Expand Down Expand Up @@ -73,7 +73,7 @@ func main() {
fmt.Println(err)
return
}
// 自定義欄寬
// 自訂欄寬
for col, width := range map[string]float64{"A": 10, "B": 18, "D": 18} {
if err = f.SetColWidth(sheetName, col, col, width); err != nil {
fmt.Println(err)
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/formControl.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ func (f *File) AddFormControl(sheet string, opts FormControl) error

AddFormControl 透過給定的工作表名稱和表單控制項選項在工作表中添加表單控制項。支援的表單控制項類型為:按鈕、核取方塊、群組方塊、標籤、選項按鈕、捲軸和微調按鈕。若需要為表單控制項指定巨集,保存的活頁簿擴展名應為 `.xlsm` 或者 `.xltm`。滾動值應介於 0 到 30000 之間。

例1,在 `Sheet1!A2` 存儲格添加帶有指定巨集、富文本、自定義尺寸和摘要資訊的按鈕表單控制項
例1,在 `Sheet1!A2` 存儲格添加帶有指定巨集、富文本、自訂尺寸和摘要資訊的按鈕表單控制項

<p align="center"><img width="180" src="./images/form_ctrl_button.gif" alt="使用 Excelize 在工作表中添加按鈕表單控制項"></p>

Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v1.3.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
* 添加表格函式 `AddTable` 支援指定表格名稱,相關 issue [#216](https://github.com/xuri/excelize/issues/216)
* 添加圖片函式 `AddPicture` 新增支援設定圖片位置,相關 issue [#214](https://github.com/xuri/excelize/issues/214)
* 獲取儲存格的值函式 `GetCellValue` 支援讀取 `inlineStr` 內聯型別儲存格的值,相關 issue [#208](https://github.com/xuri/excelize/issues/208)[#209](https://github.com/xuri/excelize/issues/209)
* 添加圖表函式 `AddChart` 支援自定義圖表尺寸
* 添加圖表函式 `AddChart` 支援自訂圖表尺寸
* 支援創建三維、三維百分比、堆積、簇狀、百分比堆積條形圖和柱形圖,相關 issue [#160](https://github.com/xuri/excelize/issues/160)[#190](https://github.com/xuri/excelize/issues/190)
* 新增支援為透過 `AddPicture` 插入的圖片設定超鏈接屬性,相關 issue [#185](https://github.com/xuri/excelize/issues/185)
* 新增支援為儲存格設定保護屬性,相關 issue [#191](https://github.com/xuri/excelize/issues/191)
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.3.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
* `AddChart` 添加圖表 API 支援指定 Y 軸對數刻度,相關 issue [#661](https://github.com/xuri/excelize/issues/661)
* `AddPicture` 添加圖片 API 支援插入圖片自適應儲存格
* 增加對列、欄和活頁簿名稱的長度上限的檢查
* 公式計算引擎支援自定義名稱,相關 issue [#665](https://github.com/xuri/excelize/issues/665)
* 公式計算引擎支援自訂名稱,相關 issue [#665](https://github.com/xuri/excelize/issues/665)
* API `CalcCellValue` 更新:新增 12 項函式, `COUNTA`, `ISBLANK`, `ISERR`, `ISERROR`, `ISEVEN`, `ISNA`, `ISNONTEXT`, `ISODD`, `ISNUMBER`, `MEDIAN`, `NA``SUMIF`

### 相容性提升
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.3.2.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
### 新增功能

* 樞紐分析表 API `AddPivotTable` 支援缺省欄與多重資料源,相關 issue [#710](https://github.com/xuri/excelize/pull/710)
* 使用 `GetCellValue` 獲取儲存格的值支援自定義日期與時間數字格式,相關 issue [#703](https://github.com/xuri/excelize/pull/703)
* 使用 `GetCellValue` 獲取儲存格的值支援自訂日期與時間數字格式,相關 issue [#703](https://github.com/xuri/excelize/pull/703)
* 計算儲存格的值 API `CalcCellValue` 新增公式函式支援 `AND``CLEAN``TRIM``LOWER``PROPER``UPPER``OR`,相關 issue [#701](https://github.com/xuri/excelize/issues/701)[#747](https://github.com/xuri/excelize/pull/747)
* 資料驗證新增支援浮點型小數區間驗證規則,相關 issue [#739](https://github.com/xuri/excelize/issues/739)
* 創建圖表 API `AddChart` 新增支援設定資料系列線型寬度和線端型別,相關 issue [#549](https://github.com/xuri/excelize/issues/549)[#654](https://github.com/xuri/excelize/issues/654)
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.4.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@
* 公式計算鏈增加對工作表的關聯處理,修復部分情況下複製列導致的檔案損壞問題,解決 issue [#774](https://github.com/xuri/excelize/issues/774)
* 刪除工作表時增加對名稱的處理,解決 issue [#775](https://github.com/xuri/excelize/issues/775)
* 修復內部函式 `newFills``parseToken` 圈複雜度過高的問題
* 修復對工作表默認自定義列高的檢查
* 修復對工作表默認自訂列高的檢查
* 修復取消工作表中全部合併存儲格時導致檔案損壞的問題, 解決 issue [#782](https://github.com/xuri/excelize/issues/782)
* 修復部分情況下篩選條件部分丟失的問題
* 修復當活頁簿包含圖表工作表、對話工作表時,[`UpdateLinkedValue`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.0#File.UpdateLinkedValue) 產生錯誤的問題
Expand Down
10 changes: 5 additions & 5 deletions zh-tw/releases/v2.4.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ Go Modules 包引用地址調整為 `github.com/xuri/excelize/v2`
* 新增流式設定工作表欄寬度支援,相關 issue [#625](https://github.com/xuri/excelize/issues/625)
* 新增流式創建合併存儲格支援,相關 issue [#826](https://github.com/xuri/excelize/issues/826)
* 公式計算引擎新增 2 項公式函式支援: BESSELK, BESSELY
* 公式計算引擎支援自定義名稱引用,相關 issue [#856](https://github.com/xuri/excelize/issues/856)
* 公式計算引擎支援自訂名稱引用,相關 issue [#856](https://github.com/xuri/excelize/issues/856)
* 添加圖表時支援設定不顯示主要橫縱坐標軸
* 透過 [`AddPivotTable`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.1#File.AddPivotTable) 創建樞紐分析表支援透過自定義名稱動態引用數據源
* 透過 [`AddPivotTable`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.1#File.AddPivotTable) 創建樞紐分析表支援透過自訂名稱動態引用數據源
* 以下函式新增支援併發安全調用,相關 issue [#861](https://github.com/xuri/excelize/issues/829)
* [`AddPicture`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.1#File.AddPicture)[`GetPicture`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.1#File.GetPicture) 併發插入/獲取圖片
* [`Rows`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.1#File.Rows)[`Cols`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.1#File.Cols) 併發列/欄迭代
Expand Down Expand Up @@ -51,15 +51,15 @@ Go Modules 包引用地址調整為 `github.com/xuri/excelize/v2`
* 修復部分情況下獲取獲取存儲格的值時,未返回帶有公式的空存儲格的問題,解決 issue [#855](https://github.com/xuri/excelize/issues/855)
* 修復部分情況下 IF 公式條件運算錯誤問題,解決 issue [#858](https://github.com/xuri/excelize/issues/858)
* 修復透過 [`GetRowHeight`](https://pkg.go.dev/github.com/xuri/excelize/v2@v2.4.1#File.GetRowHeight) 獲取列高度錯誤的問題
* 修復部分情況下因範圍解析異常導致獲取和刪除自定義名稱錯誤的問題,解決 issue [#879](https://github.com/xuri/excelize/issues/879)
* 修復設定自定義名稱時關聯工作表索引錯誤的問題
* 修復部分情況下因範圍解析異常導致獲取和刪除自訂名稱錯誤的問題,解決 issue [#879](https://github.com/xuri/excelize/issues/879)
* 修復設定自訂名稱時關聯工作表索引錯誤的問題
* 修復設定欄樣式時已有存儲格樣式未被更新的問題,解決 issue [#467](https://github.com/xuri/excelize/issues/467)
* 修復使用非法數據引用範圍創建樞紐分析表時導致的潛在 panic 的問題
* 修復部分情況下讀取數字精度異常的問題,解決 issue [#848](https://github.com/xuri/excelize/issues/848)[#852](https://github.com/xuri/excelize/issues/852)
* 修復設定數據驗證規則時,部分情況下因未進行 XML 字符轉義處理導致生成檔案損壞的問題,解決 issue [#971](https://github.com/xuri/excelize/issues/971)
* 修復設定數據驗證規則長度校驗不準確問題,解決 issue [#972](https://github.com/xuri/excelize/issues/972)
* 修復由時間解析異常導致的,部分情況下讀取帶有時間或日期數字格式存儲格時 CPU 資源佔用率過高問題,解決 issue [#974](https://github.com/xuri/excelize/issues/974)
* 修復部分情況下,當自定義數字格式為日期時,月份解析失敗的問題
* 修復部分情況下,當自訂數字格式為日期時,月份解析失敗的問題

### 性能優化

Expand Down
2 changes: 1 addition & 1 deletion zh-tw/releases/v2.5.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
* 修復部分情況下,由於內部依賴關係計算錯誤導致的 `AddPicture` 重復創建圖片的問題, 相關 issue [#1017](https://github.com/xuri/excelize/issues/1017)
* `AddShape` 支援設定圖形輪廓線條寬度, 相關 issue [#262](https://github.com/xuri/excelize/issues/262)
* 新增文檔開啓選項 `UnzipXMLSizeLimit` 以支援指定開啓每個工作表以及共享字符表時的內存解壓上限
* 創建樣式時,若給定的自定義數字格式無效,將返回錯誤提示,相關 issue [#1028](https://github.com/xuri/excelize/issues/1028)
* 創建樣式時,若給定的自訂數字格式無效,將返回錯誤提示,相關 issue [#1028](https://github.com/xuri/excelize/issues/1028)
* 流式寫入現已支援設定列樣式
* 流式寫入器將為時間型別存儲格創建時間數字格式樣式,相關 issue [#1107](https://github.com/xuri/excelize/issues/1107)
* 支援設定樞紐分析表報表佈局「以壓縮形式顯示」或「以大綱形式顯示」, 相關 issue [#1029](https://github.com/xuri/excelize/issues/1029)
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 @@ -24,7 +24,7 @@
* 新增 71 項公式函式: AVERAGEIFS, BETADIST, BETA.DIST, BETAINV, BETA.INV, BINOMDIST, BINOM.DIST, BINOM.DIST.RANGE, BINOM.INV, CHIINV, CHITEST, CHISQ.DIST, CHISQ.DIST.RT, CHISQ.INV, CHISQ.INV.RT, CHISQ.TEST, CONFIDENCE.T, CORREL, COVAR, COVARIANCE.P, CRITBINOM, ERROR.TYPE, EXPON.DIST, EXPONDIST, F.DIST, F.DIST.RT, FDIST, F.INV, F.INV.RT, FINV, FORMULATEXT, F.TEST, FTEST, GAMMA.DIST, GAMMADIST, GAMMA.INV, GAMMAINV, GAMMALN.PRECISE, GAUSS, HOUR, HYPGEOM.DIST, HYPGEOMDIST, INDIRECT, LOGINV, LOGNORM.DIST, LOGNORMDIST, LOGNORM.INV, MODE, MODE.MULT, MODE.SNGL, NEGBINOM.DIST, NEGBINOMDIST, PHI, SECOND, SERIESSUM, SUMIFS, SUMPRODUCT, SUMX2MY2, SUMX2PY2, SUMXMY2, T.DIST, T.DIST.2T, T.DIST.RT, TDIST, TIMEVALUE, T.INV, T.INV.2T, TINV, T.TEST, TTEST, TYPE
* 保存或另存為活頁簿時增加對文件擴展名進行檢查
* 支援設定活頁簿檢視模式和顯示/隱藏標尺
* 引入依賴庫 NFP (number format parser) 以增加對自定義時間、日期和文本類型數字格式的支援,可對包含 19 種語言(南非荷蘭語、孟加拉語、漢語、英語、法語、德語、奧地利語、愛爾蘭語、意大利語、俄語、西班牙語、泰語、藏語、土耳其語、威爾士語、沃洛夫語、科薩語、彝語和祖魯語)本地月份名稱和 12 小時制格式的數字格式表達式進行解析,相關 issues [#660](https://github.com/xuri/excelize/issues/660), [#764](https://github.com/xuri/excelize/issues/764), [#1093](https://github.com/xuri/excelize/issues/1093), [#1112](https://github.com/xuri/excelize/issues/1112)[#1133](https://github.com/xuri/excelize/issues/1133)
* 引入依賴庫 NFP (number format parser) 以增加對自訂時間、日期和文本類型數字格式的支援,可對包含 19 種語言(南非荷蘭語、孟加拉語、漢語、英語、法語、德語、奧地利語、愛爾蘭語、意大利語、俄語、西班牙語、泰語、藏語、土耳其語、威爾士語、沃洛夫語、科薩語、彝語和祖魯語)本地月份名稱和 12 小時制格式的數字格式表達式進行解析,相關 issues [#660](https://github.com/xuri/excelize/issues/660), [#764](https://github.com/xuri/excelize/issues/764), [#1093](https://github.com/xuri/excelize/issues/1093), [#1112](https://github.com/xuri/excelize/issues/1112)[#1133](https://github.com/xuri/excelize/issues/1133)
* 新增 API: `SetWorkbookPrOptions``GetWorkbookPrOptions` 支援設定和獲取活頁簿中的 `FilterPrivacy``CodeName` 屬性,以解除部分情況下向活頁簿中嵌入 VBA 工程時的限制,相關 issue [#1148](https://github.com/xuri/excelize/issues/1148)
* 公式計算引擎支援中綴運算符後包含無參數公式函式的計算
* 支援以文本形式讀取布爾型存儲格的值
Expand Down
4 changes: 2 additions & 2 deletions zh-tw/releases/v2.7.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,8 +67,8 @@
* 新增 2 項公式函式: AGGREGATE 與 SUBTOTAL
* `Save``Write``WriteTo` 函式支援指定保存選項,相關 issue [#744](https://github.com/xuri/excelize/issues/744)
* 使用 `AddChart` 函式添加圖表時,支援為折線圖設定是否使用平滑折線,相關 issue [#1290](https://github.com/xuri/excelize/issues/1290)
* 使用 `AddChart` 函式添加圖表時,支援設定自定義折線圖線條色彩,相關 issue [#1345](https://github.com/xuri/excelize/issues/1345)
* 使用 `AddChart` 函式添加圖表時,支援設定自定義坐標軸字型樣式,相關 issue [#320](https://github.com/xuri/excelize/issues/320)
* 使用 `AddChart` 函式添加圖表時,支援設定自訂折線圖線條色彩,相關 issue [#1345](https://github.com/xuri/excelize/issues/1345)
* 使用 `AddChart` 函式添加圖表時,支援設定自訂坐標軸字型樣式,相關 issue [#320](https://github.com/xuri/excelize/issues/320)
* 添加圖表函式 `AddChart` 支援創建立體折線圖
* 以下函式新增併發安全支援:`SetColWidth``GetColWidth``SetColVisible``GetColVisible``SetColStyle``GetColStyle`
* 設定樣式時,當給定的樣式 ID 不存在時將返回錯誤,相關 issue [#1323](https://github.com/xuri/excelize/issues/1323)
Expand Down
Loading

0 comments on commit dfa94c5

Please sign in to comment.