summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorRi Xu <xuri.me@gmail.com>2016-08-30 11:51:31 +0800
committerRi Xu <xuri.me@gmail.com>2016-08-30 11:51:31 +0800
commita9d3ee28693adfe920b3cd047f52862d8a79a00e (patch)
tree564bde64a5229782c8a3a5e1f0d39e4bfc57cdb4 /README.md
Init commit.
Diffstat (limited to 'README.md')
-rw-r--r--README.md79
1 files changed, 79 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e9fd91b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,79 @@
+* Excelize
+
+![Excelize](./excelize.png "Excelize")
+
+** Introduction
+Excelize is a library written in pure Golang and providing a set of function that allow you to write to and read from XLSX files.
+
+
+
+** Basic Usage
+
+*** Installation
+
+```
+go get github.com/luxurioust/excelize
+```
+
+*** Create XLSX files
+
+Here is a minimal example usage that will create XLSX file.
+
+```
+package main
+
+import (
+ "fmt"
+ "github.com/luxurioust/excelize"
+)
+
+func main() {
+ xlsx := excelize.CreateFile()
+ xlsx = excelize.NewSheet(xlsx, 2, "Sheet2")
+ xlsx = excelize.NewSheet(xlsx, 3, "Sheet3")
+ xlsx = excelize.SetCellInt(xlsx, "Sheet2", "A23", 10)
+ xlsx = excelize.SetCellStr(xlsx, "Sheet3", "B20", "Hello")
+ err := excelize.Save(xlsx, "~/Workbook.xlsx")
+ if err != nil {
+ fmt.Println(err)
+ }
+}
+```
+
+*** Writing XLSX files
+
+The following constitutes the bare minimum required to write an XLSX document.
+
+```
+package main
+
+import (
+ "fmt"
+ "github.com/luxurioust/excelize"
+)
+
+func main() {
+ xlsx, err := excelize.Openxlsx("~/Workbook.xlsx")
+ if err != nil {
+ fmt.Println(err)
+ }
+ xlsx = excelize.SetCellInt(xlsx, "Sheet2", "B2", 100)
+ xlsx = excelize.SetCellStr(xlsx, "Sheet2", "C11", "Hello")
+ xlsx = excelize.NewSheet(xlsx, 3, "TestSheet")
+ xlsx = excelize.SetCellInt(xlsx, "Sheet3", "A23", 10)
+ xlsx = excelize.SetCellStr(xlsx, "Sheet3", "b230", "World")
+ xlsx = excelize.SetActiveSheet(xlsx, 2)
+ if err != nil {
+ fmt.Println(err)
+ }
+ err = excelize.Save(xlsx, "~/Workbook.xlsx")
+}
+```
+
+** Contributing
+
+Contributions are welcome! Open a pull request to fix a bug, or open an issue to discuss a new feature or change.
+
+** Licenses
+
+This program is under the terms of the BSD 3-Clause License. See <https://opensource.org/licenses/BSD-3-Clause>. \ No newline at end of file