First commit

Author: xuri

.github/FUNDING.yml

@@ -0,0 +1,7 @@
+github: xuri
+open_collective: excelize
+patreon: xuri
+ko_fi: xurime
+liberapay: xuri
+issuehunt: xuri
+custom: https://www.paypal.com/paypalme/xuri

.github/ISSUE_TEMPLATE/docs_issue.md

@@ -0,0 +1,37 @@
+---
+name: Docs issues
+about: Create a report to help us improve
+
+---
+
+<!--
+If you are reporting a new issue, make sure that we do not have any duplicates
+already open. You can ensure this by searching the issue list for this
+repository. If there is a duplicate, please close your issue and add a comment
+to the existing issue instead.
+
+Use the commands below to provwide key information.
+-->
+
+**Description**
+
+<!--
+Briefly describe the problem you are having in a few paragraphs. Share your
+experience with us, but please don't include sensitive or personal information.
+-->
+
+**The reason for your feedback**
+
+<!--- What types of feedback? Put an `x` in all the boxes that apply: -->
+
+- [ ] Content is hard to understand
+- [ ] Procedure or code doesn't work
+- [ ] Couldn't find what I need
+- [ ] Out of date/obsolete
+- [ ] Other
+
+**Docs URL:**
+
+```text
+(paste here)
+```

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,18 @@
+# PR Details
+
+<!--- Provide a general summary of your changes in the Title above -->
+
+## Description
+
+<!--- Describe your changes in detail -->
+
+## Related Issue
+
+<!--- This project only accepts pull requests related to open issues -->
+<!--- If suggesting a new feature or change, please discuss it in an issue first -->
+<!--- If fixing a issue, there should be an issue describing it with steps to reproduce -->
+<!--- Please link to the issue here: -->
+
+## Motivation and Context
+
+<!--- Why is this change required? What problem does it solve? -->

.github/SECURITY.md

@@ -0,0 +1,9 @@
+# Security Policy
+
+## Supported Versions
+
+We will dive into any security-related issue as long as your excelize-py-docs version is still supported by us. When reporting an issue, include as much information as possible, but no need to fill fancy forms or answer tedious questions. Just tell us what you found, how to reproduce it, and any concerns you have about it. We will respond as soon as possible and follow up with any missing information.
+
+## Reporting a Vulnerability
+
+Please e-mail us directly at `xuri.me at gmail.com` or use the security issue template on GitHub. In general, public disclosure is made after the issue has been fully identified and a patch is ready to be released. A security issue gets the highest priority assigned and a reply regarding the vulnerability is given within a typical 24 hours. Thank you!

.github/linter-rules.yml

@@ -0,0 +1,5 @@
+default: true
+MD013: false
+MD033: false
+MD036: false
+MD041: false

.github/workflows/markdown.yml

@@ -0,0 +1,15 @@
+on: [push, pull_request]
+name: lint
+jobs:
+  markdown-lint:
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Markdown Linting Action
+        uses: avto-dev/markdown-lint@v1.5.0
+        with:
+          args: './'
+          config: '.github/linter-rules.yml'

.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+_book/
+**/.DS_Store

LANGS.md

@@ -0,0 +1,3 @@
+# Languages
+
+* [English](en)

book.json

@@ -0,0 +1,45 @@
+{
+    "title": "Excelize for Python",
+    "author": "xuri",
+    "language": "en",
+    "plugins": [
+        "-sharing",
+        "-lunr",
+        "-search",
+        "search-plus",
+        "scripts",
+        "sitemap-general",
+        "language-picker",
+        "favicon"
+    ],
+    "pluginsConfig": {
+        "favicon": {
+            "shortcut": "https://xuri.me/excelize-py/images/favicon.ico",
+            "bookmark": "https://xuri.me/excelize-py/images/favicon.ico",
+            "appleTouch": "https://xuri.me/excelize-py/images/logo_trans_300x300.png",
+            "appleTouchMore": {
+                "120x120": "https://xuri.me/excelize-py/images/apple-touch-icon-120x120.png",
+                "180x180": "https://xuri.me/excelize-py/images/apple-touch-icon-180x180.png"
+            }
+        },
+        "sitemap-general": {
+            "prefix": "https://xuri.me/excelize-py/"
+        },
+        "scripts": {
+            "files": []
+        }
+    },
+    "pdf": {
+        "fontSize": 10,
+        "pageNumbers": false,
+        "paperSize": "a4",
+        "margin": {
+            "right": 0,
+            "left": 0,
+            "top": 0,
+            "bottom": 0
+        },
+        "headerTemplate": null,
+        "footerTemplate": null
+    }
+}

en/README.md

@@ -0,0 +1,60 @@
+# Introduction
+
+<p align="center"><img width="650" src="../images/excelize-py.svg" alt="Excelize for Python logo"></p>
+
+Excelize for Python is a Python port of Go [Excelize](https://github.com/xuri/excelize) library, providing a set of functions that allow you to write and read from XLAM / XLSM / XLSX / XLTM / XLTX files. Supports reading and writing spreadsheet documents generated by Microsoft Excel&trade; 2007 and later. Supports complex components by high compatibility, and provided streaming API for generating or reading data from a worksheet with huge amounts of data. This library needs Python version 3.9 or later. The full API docs can be found at [docs reference](https://xuri.me/excelize/).
+
+- Source Code: [github.com/xuri/excelize-py](https://github.com/xuri/excelize-py)
+- Issue: [github.com/xuri/excelize-py/issues](https://github.com/xuri/excelize-py/issues)
+- PyPI: [pypi.org/project/excelize](https://pypi.org/project/excelize)
+- Licenses: [BSD 3-Clause](https://opensource.org/licenses/BSD-3-Clause)
+- Last version: [v0.0.4](https://github.com/xuri/excelize-py/releases/latest)
+- Document update time: June 29, 2025
+
+## Project mission
+
+The goal of Excelize is to create and maintain a Python language version of the Excel Document API to handle xlsx files that conform to the Office Open XML (OOXML) standard. With Excelize you can use Python to read and write MS Excel files.
+
+## Why use Excelize
+
+In some cases, we need to manipulate Excel documents through programs, such as: open to read existing Excel document content, create new Excel documents, generate new Excel documents based on existing documents (templates), insert images into Excel documents, charts Elements such as tables and sometimes need to implement these operations across platforms. Excelize can easily meet these needs.
+
+If your company or product is using Excelize, welcome <a href="mailto: xuri.me@gmail.com?Subject=Please add our company in Excelize Introduction page&amp;Body=Hello%2C%20this%20is%20%3Cyour%20name%3E%20from%20%3Cyour%20company%20name%3E.%0AWe%20are%20using%20Excelize%20and%20will%20be%20proud%20to%20add%20our%20company%20name%20to%20Excelize%20Introduction%20page.%0APlease%20see%20attachment%20for%20our%20logo.%20%3CBe%20sure%20to%20include%20logo%20in%20attachment%3E%0A" title="send Logo via E-mail">send Logo</a> to us.
+
+## Community
+
+- [Facebook Group](https://www.facebook.com/groups/excelize)
+- [Google Group](https://groups.google.com/g/excelize)
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/excelize)
+- [Slack Channel](https://join.slack.com/t/xuri/shared_invite/zt-eriqdkeo-wV04zcCdBiiZveFgY86Wzw)
+- [Gitter](https://gitter.im/excelize/community)
+- [Community on Telegram](https://t.me/excelize)
+- [Community on Discord](https://discord.gg/MWV8MBQGtv)
+- [Excelize Community on Microsoft Teams](https://teams.live.com/l/invite/FBA8aHkflqEj5SNzQM)
+- [Skype Community](https://join.skype.com/YW3OFS5QjYcV?source=qr-ios): <a href="../images/skype_group@2x.png" alt="Excelize Skype Community" target="_blank" target="_blank">join via QR Code</a>
+- [Line Community](http://line.me/ti/g/NFIjhfbP_g): <a href="../images/line_group@2x.png" alt="Excelize Line Community" target="_blank" target="_blank">join via QR Code</a>
+- [DingTalk Group ID](https://qr.dingtalk.com/action/joingroup?code=v1,k1,6tmzbBbJuQkGezVdHJjsHz29CZI9F49xeW+cvOaECtk=&_dt_no_comment=1&origin=11): `30047129` | <a href="../images/dingtalk_group@2x.png" alt="Excelize DingTalk Group" target="_blank" target="_blank">join via QR Code</a>
+- QQ Group ID: `1302058237` (Verification info: Excelize) | <a href="../images/qq_group@2x.png" alt="Excelize QQ Group ID" target="_blank" target="_blank">join via QR Code</a>
+- Excelize WeChat ID: `hixuri` (Verification info: Excelize) | <a href="../images/wechat_group@2x.png" alt="Excelize WeChat Community" target="_blank" target="_blank">join via QR Code</a>
+- WeCom Group (Verification info: Excelize): <a href="../images/wecom_group@2x.png" title="Excelize WeCom Group" target="_blank">join via QR Code</a>
+- Inflow Group ID: `4375928` | <a href="../images/inflow_group@2x.png" alt="Excelize Inflow Group" target="_blank" target="_blank">join via QR Code</a>
+
+## Sponsor Excelize Development
+
+If you are an individual user and have enjoyed the productivity of using Excelize, consider donating as a sign of appreciation - like buying me coffee once in a while, or support this project by becoming a sponsor.
+
+<a href="https://github.com/sponsors/xuri" title="GitHub Sponsor" target="_blank"><img width="170" src="https://xuri.me/excelize/images/github_sponsor@2x.png" alt="GitHub Sponsor"></a> <a href="https://www.paypal.com/paypalme/xuri" title="Donate with Paypal" target="_blank"><img width="170" src="https://xuri.me/excelize/images/donate@2x.png" alt="Donate with Paypal"></a> <a href="https://opencollective.com/excelize" title="Become a Sponsor" target="_blank"><img height="61" src="https://xuri.me/excelize/images/opencollective.com@2x.png" alt="Become a Sponsor"></a> <a href="https://www.patreon.com/xuri" title="Support Excelize on Patreon" target="_blank"><img height="61" src="https://xuri.me/excelize/images/patreon.com@2x.png" alt="Support Excelize on Patreon"></a>
+
+## Commercial Support
+
+Let us help you reach the maximum potential of your app, to make working with Excel fun. Besides offering a completely free and open source package, we can also offer support on a commercial basis：
+
+- Prioritize your issue
+
+Having a bug ticket, a question or a feature request on our Github issue tracker that needs urgent attention? We are happy to give your ticket priority based on commercial support, contact us to get more details.
+
+- Technical advisory services
+
+Need help implementing Excelize in your application and you are on a shortage of technology or resources? We are happy to supercharge your imports and exports and can step in your team on an hourly-basis contract.
+
+Please contact us by <a href="mailto: xuri.me@gmail.com">E-mail</a>.