Skip to content

Commit

Permalink
This update zh-tw docs and 2023 award added
Browse files Browse the repository at this point in the history
  • Loading branch information
xuri committed Jan 6, 2024
1 parent d01ab51 commit 5e7e7a9
Show file tree
Hide file tree
Showing 47 changed files with 303 additions and 295 deletions.
2 changes: 1 addition & 1 deletion ar/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize هي مكتبة مكتوبة في الذهاب نقية توفير مج
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- التراخيص: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- الإصدار الأخير: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- وقت تحديث المستند: ديسمبر 17, 2023
- وقت تحديث المستند: كانون الثاني 7, 2024

## بعثة المشروع

Expand Down
2 changes: 1 addition & 1 deletion de/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize ist eine Bibliothek, die in reinem Go geschrieben wurde und eine Reihe
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- Lizenzen: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- Letzte Version: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- Dokument Aktualisierungszeit: Dezember 17, 2023
- Dokument Aktualisierungszeit: Januar 7, 2024

## Project mission

Expand Down
2 changes: 1 addition & 1 deletion en/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize is a library written in pure Go providing a set of functions that allow
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- Last version: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- Document update time: December 17, 2023
- Document update time: January 7, 2024

## Project mission

Expand Down
2 changes: 1 addition & 1 deletion es/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize es una biblioteca escrita en Go puro que proporciona un conjunto de fun
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- Licencias: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- Ultima versión: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- Tiempo de actualización del documento: diciembre 17, 2023
- Tiempo de actualización del documento: enero 7, 2024

## Misión del proyecto

Expand Down
2 changes: 1 addition & 1 deletion fr/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize est une bibliothèque écrite en pure Go fournissant un ensemble de fon
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- Dernière version: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- Heure de mise à jour du document: 17 décembre 2023
- Heure de mise à jour du document: 7 janvier 2024

## Mission du projet

Expand Down
Binary file added images/award2023.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion ja/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize は、純粋な Go で記述されたライブラリで、XLAM / XLSM /
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- ライセンス契約: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- 現在のバージョン: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- ドキュメントの更新:2023年12月17日
- ドキュメントの更新:2024年1月7日

## プロジェクトミッション

Expand Down
2 changes: 1 addition & 1 deletion ko/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize 는 순수 Go로 작성된 라이브러리로 XLAM / XLSM / XLSX / XLTM
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- 면허: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- 마지막 버전: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- 문서 업데이트 시간: 20231217
- 문서 업데이트 시간: 202417

## 프로젝트 미션

Expand Down
2 changes: 1 addition & 1 deletion ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ EXCELIZE - это библиотека, написанная на чистом G
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- Лицензии: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- Последняя версия: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- Время обновления документа: 17 Декабрь 2023 г.
- Время обновления документа: 7 Январь 2024 г.

## Миссия проекта

Expand Down
10 changes: 7 additions & 3 deletions zh-hans/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- 许可协议: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- 当前版本: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- 文档更新: 2023年12月17日
- 文档更新: 2024年1月7日

## 项目使命

Expand All @@ -21,17 +21,21 @@ Excelize 的目标是创建并维护一个 Go 语言版本的 Excel 文档 API

## 项目荣誉

入选 2023 开源创新榜[优秀开源项目](https://cccst.org.cn/zxyw/tzgg/art/2023/art_748b3428e4184ccc825ea6de1a2d273f.html)

<p align="center"><img width="330" src="../images/award2023.jpg" alt="Excelize 入选 2023 开源创新榜优秀开源项目"></p>

荣获 2022 年中国开源创新大赛[一等奖](http://www.ce.cn/cysc/tech/gd2012/202306/05/t20230605_38576356.shtml)

<p align="center"><img width="330" src="../images/award2022.jpg" alt="Excelize 荣获 2022 年中国开源创新大赛一等奖"></p>

入选 2020 Gopher China - Go 领域明星开源项目 ([GSP](https://mp.weixin.qq.com/s/XyLAaqpN-3urYcNmM_vPeg))

<p align="center"><img width="100" src="../images/gsp2020.png" alt="2020 Gopher China Go 领域明星开源项目"></p>
<p align="center"><img width="100" src="../images/gsp2020.png" alt="Excelize 入选 2020 Gopher China Go 领域明星开源项目"></p>

入选 2018 年开源中国码云最有价值开源项目 ([Gitee Most Valuable Project](https://gitee.com/xurime/excelize))

<p align="center"><img width="330" src="../images/gvp2018.jpg" alt="2018 年开源中国码云最有价值开源项目"></p>
<p align="center"><img width="330" src="../images/gvp2018.jpg" alt="Excelize 入选 2018 年开源中国码云最有价值开源项目"></p>

## 知名企业用户

Expand Down
12 changes: 8 additions & 4 deletions zh-tw/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@

<p align="center"><img width="650" src="../images/excelize.svg" alt="Excelize logo"></p>

Excelize 是 Go 語言編寫的用於操作 Office Excel 檔案基礎庫,基於 ECMA-376,ISO/IEC 29500 國際標準。可以使用它來讀取、寫入由 Microsoft Excel&trade; 2007 及以上版本創建的電子錶格檔案。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種檔案格式,高度兼容帶有樣式、圖片(表)、樞紐分析表、切片器等複雜組件的檔案,並提供流式讀寫 API,用於處理包含大規模數據的活頁簿。可應用於各類報表平台、雲計算、邊緣計算等系統。使用本類庫要求使用的 Go 語言為 1.16 或更高版本。
Excelize 是 Go 語言編寫的用於操作 Office Excel 檔案基礎庫,基於 ECMA-376,ISO/IEC 29500 國際標準。可以使用它來讀取、寫入由 Microsoft Excel&trade; 2007 及以上版本創建的電子錶格檔案。支援 XLAM / XLSM / XLSX / XLTM / XLTX 等多種檔案格式,高度兼容帶有樣式、圖片(表)、樞紐分析表、切片器等複雜組件的檔案,並提供流式讀寫 API,用於處理包含大規模數據的活頁簿。可應用於各類報表平台、雲計算、邊緣計算等系統。使用本類庫要求使用的 Go 語言為 1.16 或更高版本。

- Source Code: [github.com/xuri/excelize](https://github.com/xuri/excelize)
- Issue: [github.com/xuri/excelize/issues](https://github.com/xuri/excelize/issues)
- go.dev: [pkg.go.dev/github.com/xuri/excelize/v2](https://pkg.go.dev/github.com/xuri/excelize/v2)
- 許可協議: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
- 當前版本: [v2.8.0](https://github.com/xuri/excelize/releases/latest)
- 檔案更新: 2023年12月17日
- 檔案更新: 2024年1月7日

## 專案使命

Expand All @@ -21,17 +21,21 @@ Excelize 的目標是創建並維護一個 Go 語言版本的 Excel 檔案 API

## 專案榮譽

入選 2023 開源創新榜[優秀開源專案](https://cccst.org.cn/zxyw/tzgg/art/2023/art_748b3428e4184ccc825ea6de1a2d273f.html)

<p align="center"><img width="330" src="../images/award2023.jpg" alt="Excelize 入選 2023 開源創新榜優秀開源專案"></p>

榮獲 2022 年中國開源創新大賽[一等獎](http://www.ce.cn/cysc/tech/gd2012/202306/05/t20230605_38576356.shtml)

<p align="center"><img width="330" src="../images/award2022.jpg" alt="Excelize 榮獲 2022 年中國開源創新大賽一等獎"></p>

入選 2020 Gopher China - Go 領域明星開源專案 ([GSP](https://mp.weixin.qq.com/s/XyLAaqpN-3urYcNmM_vPeg))

<p align="center"><img width="100" src="../images/gsp2020.png" alt="2020 Gopher China Go 領域明星開源專案"></p>
<p align="center"><img width="100" src="../images/gsp2020.png" alt="Excelize 入選 2020 Gopher China Go 領域明星開源專案"></p>

入選 2018 年開源中國碼雲最有價值開源專案 ([Gitee Most Valuable Project](https://gitee.com/xurime/excelize))

<p align="center"><img width="330" src="../images/gvp2018.jpg" alt="2018 年開源中國碼雲最有價值開源專案"></p>
<p align="center"><img width="330" src="../images/gvp2018.jpg" alt="Excelize 入選 2018 年開源中國碼雲最有價值開源專案"></p>

## 知名企業用戶

Expand Down
6 changes: 3 additions & 3 deletions zh-tw/cell.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ func (f *File) SetCellValue(sheet, cell string, value interface{}) error

根據給定的工作表名和儲存格坐標設定儲存格的值。此功能是併發安全的。指定的坐標不應在表格的第一列範圍,使用字符文本設定複數。

|支持的資料類別|
|支援的資料類別|
|---|
|int|
|int8|
Expand Down Expand Up @@ -729,9 +729,9 @@ func (f *File) GetCellFormula(sheet, cell string) (string, error)
func (f *File) CalcCellValue(sheet, cell string, opts ...Options) (string, error)
```

根據給定的工作表名和存儲格坐標計算包含公式存儲格的值。該方法目前正在開發中,尚未支持反覆運算、隱式交集、顯式交集、數組函式、數組函式、表格函式和其他部分函式。
根據給定的工作表名和存儲格坐標計算包含公式存儲格的值。該方法目前正在開發中,尚未支援反覆運算、隱式交集、顯式交集、數組函式、數組函式、表格函式和其他部分函式。

支持的公式函式列表如下
支援的公式函式列表如下

函式名稱 | 描述
---|---
Expand Down
6 changes: 3 additions & 3 deletions zh-tw/chart.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ func (f *File) AddChart(sheet, cell string, chart *ChartOptions, combo ...*Chart

根據給定的工作表名稱、儲存格坐標和圖表樣式屬性插入圖表。

下面是 Excelize 支持創建的圖表類別 `Type`:
下面是 Excelize 支援創建的圖表類別 `Type`:

ID|列舉|圖表類別
---|---|---
Expand Down Expand Up @@ -74,7 +74,7 @@ ID|列舉|圖表類別

參數|含義
---|---
Name | 圖例項(系列),在圖表圖例和公式欄中顯示。`Name` 參數是可選的,如果不指定該值默認將會使用 `Series 1 .. n` 表示。`Name` 支持使用公式表示,例如:`Sheet1!$A$1`。
Name | 圖例項(系列),在圖表圖例和公式欄中顯示。`Name` 參數是可選的,如果不指定該值默認將會使用 `Series 1 .. n` 表示。`Name` 支援使用公式表示,例如:`Sheet1!$A$1`。
Categories | 水平(類別)軸標籤。在大多數圖表類別中,`Categories` 屬性是可選的,默認為形如 `1..n` 的連續序列。
Values | 圖表資料區域,是 `Series` 中最重要的參數,也是創建圖表時唯一的必選參數。該選項將圖表與其顯示的工作表資料鏈接起來。
Fill | 設定圖表中每個資料數列的填滿格式。
Expand Down Expand Up @@ -102,7 +102,7 @@ top_right|右上

其中參數 `ShowLegendKey` 默認值為 `false`。

透過可選 `Title` 對象的 `Name` 參數設定圖表標題,標題將會在圖表上方顯示。參數 `Name` 支持使用公式表示,例如 `Sheet1!$A$1`,圖表標題的默認值為空。
透過可選 `Title` 對象的 `Name` 參數設定圖表標題,標題將會在圖表上方顯示。參數 `Name` 支援使用公式表示,例如 `Sheet1!$A$1`,圖表標題的默認值為空。

參數 `ShowBlanksAs` 提供「隱藏和清空儲存格」設定,默認值為:`gap` 即「空儲存格顯示為」:「空距」。下面是該參數的可選值:

Expand Down
12 changes: 6 additions & 6 deletions zh-tw/constants.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# 常量

CultureName 是受支持的區域格式類別定義
CultureName 是受支援的區域格式類別定義

```go
type CultureName byte
```

部分存儲格數字格式受到作業系統特定的區域日期和時間設定的影響,以下這些常量定義了當前支持的區域格式類別列舉
部分存儲格數字格式受到作業系統特定的區域日期和時間設定的影響,以下這些常量定義了當前支援的區域格式類別列舉

```go
const (
Expand All @@ -16,13 +16,13 @@ const (
)
```

ChartType 是受支持的圖表類別定義
ChartType 是受支援的圖表類別定義

```go
type ChartType byte
```

以下這些常量定義了當前支持的圖表類別列舉
以下這些常量定義了當前支援的圖表類別列舉

```go
const (
Expand Down Expand Up @@ -209,7 +209,7 @@ const (
)
```

以下這些常量定義了當前支持的資料驗證類別
以下這些常量定義了當前支援的資料驗證類別

```go
const (
Expand All @@ -222,7 +222,7 @@ const (
)
```

以下這些常量定義了當前支持的資料驗證條件
以下這些常量定義了當前支援的資料驗證條件

```go
const (
Expand Down
6 changes: 3 additions & 3 deletions zh-tw/contribution.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## 如何參與貢獻

Microsoft Excel&trade; 2007 版本後支持基於 XML 的文檔格式 OOXML (Office Open XML),是一種基於 XML 和 ZIP 技術的新的文檔格式。下面列出了包括文檔標準、文檔驗證對比工具和瀏覽器插件等在內的開發符合該文檔格式的相關參考資料。
Microsoft Excel&trade; 2007 版本後支援基於 XML 的文檔格式 OOXML (Office Open XML),是一種基於 XML 和 ZIP 技術的新的文檔格式。下面列出了包括文檔標準、文檔驗證對比工具和瀏覽器插件等在內的開發符合該文檔格式的相關參考資料。

### 參考資料

Expand Down Expand Up @@ -60,8 +60,8 @@ Microsoft Excel&trade; 2007 版本後支持基於 XML 的文檔格式 OOXML (Off

### 贊助 Excelize 開發

專案的發展離不開你的支持,請作者喝杯咖啡吧!Excelize 透過以下方式接受贊助:
專案的發展離不開你的支援,請作者喝杯咖啡吧!Excelize 透過以下方式接受贊助:

<a href="https://www.paypal.com/paypalme/xuri" title="贊助 Excelize 開發" target="_blank"><img width="710" src="./images/[email protected]" alt="贊助 Excelize 開發"></a>

<a href="https://opencollective.com/excelize" title="成為 Excelize 贊助商" target="_blank"><img height="61" src="../images/[email protected]" alt="成為 Excelize 贊助商"></a> <a href="https://www.patreon.com/xuri" title="在 Patreon 上支持 Excelize" target="_blank"><img height="61" src="../images/[email protected]" alt="在 Patreon 上支持 Excelize"></a>
<a href="https://opencollective.com/excelize" title="成為 Excelize 贊助商" target="_blank"><img height="61" src="../images/[email protected]" alt="成為 Excelize 贊助商"></a> <a href="https://www.patreon.com/xuri" title="在 Patreon 上支援 Excelize" target="_blank"><img height="61" src="../images/[email protected]" alt="在 Patreon 上支援 Excelize"></a>
4 changes: 2 additions & 2 deletions zh-tw/formControl.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ type FormControl struct {
func (f *File) AddFormControl(sheet string, opts FormControl) error
```

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

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

Expand Down Expand Up @@ -129,7 +129,7 @@ err := f.AddFormControl("Sheet1", excelize.FormControl{
func (f *File) GetFormControls(sheet string) ([]FormControl, error)
```

根據給定的工作表名稱獲取工作表中的全部表單控制項。注意,該函數目前尚未支持獲取表單控制項的寬高
根據給定的工作表名稱獲取工作表中的全部表單控制項。注意,該函數目前尚未支援獲取表單控制項的寬高

## 刪除表單控制項 {#DeleteFormControl}

Expand Down
4 changes: 2 additions & 2 deletions zh-tw/image.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ func main() {

可選參數 `Hyperlink` 用以設定圖形對象的超鏈接。

可選參數 `HyperlinkType` 設定圖形對象超鏈接的類型,支持外部鏈接 `External` 和內部鏈接 `Location` 兩種類型,當使用 `Location` 連接到存儲格位置時,坐標需要以 `#` 開始。
可選參數 `HyperlinkType` 設定圖形對象超鏈接的類型,支援外部鏈接 `External` 和內部鏈接 `Location` 兩種類型,當使用 `Location` 連接到存儲格位置時,坐標需要以 `#` 開始。

可選參數 `Positioning` 定義了電子錶格中圖形對象位置屬性的 3 種類型:`oneCell`(大小固定,位置隨存儲格改變)、`twoCell`(大小和位置隨存儲格改變)和 `absolute` (大小、位置均固定)兩種類型,當不設置此參數時,默認屬性為大小、位置隨存儲格改變。

Expand Down Expand Up @@ -144,7 +144,7 @@ func main() {
func (f *File) GetPictures(sheet, cell string) ([]Picture, error)
```

根據給定的工作表名稱和儲存格坐標獲取活頁簿上的圖片,將以 `[]byte` 類別傳回嵌入在 Excel 文檔中的圖片。此功能是併發安全的。該函式暫不支持獲取透過 Kingsoft WPS&trade; 應用程式添加的存儲格圖片。例如,獲取名為 `Sheet1` 的工作表上 `A2` 儲存格上的圖片:
根據給定的工作表名稱和儲存格坐標獲取活頁簿上的圖片,將以 `[]byte` 類別傳回嵌入在 Excel 文檔中的圖片。此功能是併發安全的。該函式暫不支援獲取透過 Kingsoft WPS&trade; 應用程式添加的存儲格圖片。例如,獲取名為 `Sheet1` 的工作表上 `A2` 儲存格上的圖片:

```go
f, err := excelize.OpenFile("Book1.xlsx")
Expand Down
2 changes: 1 addition & 1 deletion zh-tw/pivot.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ type PivotTableOptions struct {
}
```

`PivotTableStyleName`: 支持的樞紐分析表樣式:
`PivotTableStyleName`: 支援的樞紐分析表樣式:

```text
PivotStyleLight1 - PivotStyleLight28
Expand Down
6 changes: 3 additions & 3 deletions zh-tw/releases/v1.2.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@

* 性能優化
* 提升與 Go 1.9 的相容性
* 支持創建堆積條形圖
* 支持 24 小時格式時間
* 支援創建堆積條形圖
* 支援 24 小時格式時間
* API 更改, 使用動態工作表名稱代替 "sheet" + index 格式的工作表名稱
* 代碼庫地址變更為 `github.com/360EntSecGroup-Skylar/excelize`
* 新增函式 `SetSheetViewOptions``GetSheetViewOptions` 支持設定和獲取工作表的檢視屬性
* 新增函式 `SetSheetViewOptions``GetSheetViewOptions` 支援設定和獲取工作表的檢視屬性
Loading

0 comments on commit 5e7e7a9

Please sign in to comment.