ydata-profiling-multilingual 1.0.0__tar.gz

ydata_profiling_multilingual-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,102 @@
+## How to contribute to YData-Profiling
+
+YData-profiling aims to ease exploratory data analysis for structured datasets, including time-series. 
+Our focus is to provide users with useful and robust statistics for such datasets encountered in industry, academia and elsewhere.
+YData-profiling is open-source and stimulates contributions from passionate community users.
+
+
+#### Themes to contribute
+In line with our aim, we identify the following themes:
+
+- **Exploratory data analysis**: 
+  The core of the package is a dataset summarization by its main characteristics, which is complemented with warnings on data issues and visualisations.
+
+  _Suggestions for contribution_: 
+  Extend the support of more data types (think of paths, location or GPS coordinates and ordinal data types),
+  text data (e.g. encoding, vocabulary size, spelling errors, language detection), 
+  time series analysis, 
+  or even images (e.g. dimensions, EXIF).
+  
+  _Related_: [#7][i7], [#129][i129], [#190][i190], [#204][i204] or [create one](https://github.com/ydataai/ydata-profiling/issues/new/choose).
+
+- **Stability, Performance and Restricted environment compatibility:** 
+  Data exploration takes place in all kinds of conditions, on the latest machine learning platforms with enormous dataset to managed environments in large corporations.
+  `ydata-profiling` helps analysts, researchers and engineers alike in these cases.
+  We do this by fixing bugs, improving performance on big datasets and adding environment compatibility.
+  
+  _Suggestions for contribution (Performance)_: 
+  Perform concurrency analysis or profile execution times and leverage the gained insights for improved performance (e.g. multiprocessing, cython, numba) or test the performance of `ydata-profiling` with [big data sets](https://www.stats.govt.nz/large-datasets/csv-files-for-download/) and corresponding commonly used data formats (such as parquet). 
+  
+  _Suggestions for contribution (Stability)_: 
+  Either review the code and add tests or watch the [issues page](https://github.com/ydataai/ydata-profiling/issues) and [Stackoverflow tag](https://stackoverflow.com/questions/tagged/ydata-profiling) to find current issues.
+     
+  _Related_: [#98][i98], [#122][i122] or [create one](https://github.com/ydataai/ydata-profiling/issues/new/choose).
+
+- **Interaction, presentation and user experience**: 
+  As `ydata-profiling` eases exploratory data analysis, working with the package should reflect that.
+  Interaction and user experience plays a central role in working with the package.
+  Working on interactive and static features is possible through the modular nature of the package: the user can configure which features to use.
+
+  _Suggestions for contribution (interactivity)_:
+  Interactivity allows for more user friendly applications, including but not limited to on demand analysis (don't compute what you don't want to see) and interactive histograms and correlations. 
+  This is ideal for smaller datasets, where we can compute this on-the-fly. 
+  `ipywidgets` would be a great place to start (e.g. [widget based view](https://ipywidgets.readthedocs.io/en/stable/examples/Widget%20List.html)).
+
+  _Suggestions for contribution (presentation)_:
+  Other forms of distribution than HTML (for example PDF or packaged as an GUI application via [PyQt](https://riverbankcomputing.com/software/pyqt/intro))
+  Users should be able to share reports (improve size of labels in graph, add explanations to correlation matrices and allow for styling/branding).
+
+  _Related_: [#161][i161], [#175][i175], [#191][i191] or [create one](https://github.com/ydataai/ydata-profiling/issues/new/choose).
+
+- **Community**: 
+  The success of this package demonstrates the power of sharing and working together.
+  You are welcome as part of this community.
+  
+  _Suggestions for contribution_:
+  Share with us if this package is of value to you, let us know [in our community](https://discord.com/invite/mw7xjJ7b7s).
+  We are interested in how you use `ydata-profiling` in your work.
+  
+  _Related_: [#87][i87] or [create one](https://github.com/ydataai/ydata-profiling/issues/new/choose).
+
+- **Machine learning:** 
+  `ydata-profiling` is not a machine learning package, even though many of our users use EDA as a step prior to developing their models.
+  Our focus lies in the exploratory data analysis.
+  Any functionality that enables machine learning applications by more effective data profiling, is welcome.
+
+  _Related_: [#124][i124], [#173][i173], [#198][i198] or [create one](https://github.com/ydataai/ydata-profiling/issues/new/choose).
+
+#### **Did you find a bug?**
+
+* **Ensure the bug was not already reported** by searching on Github under [Issues](https://github.com/ydataai/ydata-profiling/issues).
+
+* If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/ydataai/ydata-profiling/issues/new/choose). 
+If possible, use the relevant bug report templates to create the issue. 
+
+#### **Did you write a patch that fixes a bug?**
+
+* Open a new Github pull request with the patch.
+
+* Ensure the PR description clearly describes the problem and solution. 
+Include the relevant issue number if applicable.
+
+
+#### Acknowledgements
+
+We would like to thank everyone who has helped getting us to where we are now.
+
+See the [Contributor Graph](https://github.com/ydataai/ydata-profiling/graphs/contributors)
+
+[i7]: https://github.com/ydataai/ydata-profiling/issues/7
+[i129]: https://github.com/ydataai/ydata-profiling/issues/129
+[i190]: https://github.com/ydataai/ydata-profiling/issues/190
+[i204]: https://github.com/ydataai/ydata-profiling/issues/204
+[i98]: https://github.com/ydataai/ydata-profiling/issues/98
+[i122]: https://github.com/ydataai/ydata-profiling/issues/122
+[i124]: https://github.com/ydataai/ydata-profiling/issues/24
+[i173]: https://github.com/ydataai/ydata-profiling/issues/173
+[i198]: https://github.com/ydataai/ydata-profiling/issues/198
+[i87]: https://github.com/ydataai/ydata-profiling/issues/87
+[i161]: https://github.com/ydataai/ydata-profiling/issues/161
+[i175]: https://github.com/ydataai/ydata-profiling/issues/175
+[i191]: https://github.com/ydataai/ydata-profiling/issues/191
+

ydata_profiling_multilingual-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Jos Polfliet, 2019-2021 Simon Brugman, 2022-Present YData Labs Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ydata_profiling_multilingual-1.0.0/MANIFEST.in

@@ -0,0 +1,31 @@
+# Requirements
+include README.md
+include LICENSE
+include VERSION
+include requirements*.txt
+
+# Include license, Readme, etc.
+include LICENSE
+include *.md
+
+# Templates and static resources
+recursive-include src/ydata_profiling/i18n/locales *.json
+recursive-include src/ydata_profiling/report/presentation/flavours/html/templates *.html *.js *.css
+
+# Configuration
+include src/ydata_profiling/*.yaml
+
+# Spark Dev venv
+recursive-include venv *.yml
+
+# Exclude development, docs, testing and example code
+exclude .pre-commit-config.yaml
+exclude commitlint.config.js
+exclude .releaserc.json
+exclude Makefile make.bat
+exclude docs examples tests docsrc .devcontainer
+recursive-exclude docs *
+recursive-exclude docsrc *
+recursive-exclude examples *
+recursive-exclude tests *
+recursive-exclude .devcontainer *

ydata_profiling_multilingual-1.0.0/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: ydata-profiling-multilingual
+Version: 1.0.0
+Summary: forked from ydataai/ydata-profiling and modify the code to support international multilingual functionality
+Home-page: https://github.com/landonzeng/ydata-profiling-multilingual
+Author: Landon Zeng
+Author-email: YData Labs Inc <opensource@ydata.ai>, landonzeng <landonzeng@qq.com>
+License: The MIT License (MIT)
+        
+        Copyright (c) 2016 Jos Polfliet, 2019-2021 Simon Brugman, 2022-Present YData Labs Inc
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/landonzeng/ydata-profiling-multilingual
+Project-URL: Repository, https://github.com/landonzeng/ydata-profiling-multilingual
+Project-URL: Original Repository, https://github.com/ydataai/ydata-profiling
+Keywords: pandas,data-science,data-analysis,python,jupyter,ipython,i18n,multilingual,ydata-profiling-fork
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Intended Audience :: Healthcare Industry
+Classifier: Topic :: Scientific/Engineering
+Classifier: Framework :: IPython
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: scipy<1.16,>=1.4.1
+Requires-Dist: pandas!=1.4.0,<3.0,>1.1
+Requires-Dist: matplotlib<=3.10,>=3.5
+Requires-Dist: pydantic>=2
+Requires-Dist: PyYAML<6.1,>=5.0.0
+Requires-Dist: jinja2<3.2,>=2.11.1
+Requires-Dist: visions[type_image_path]<0.8.2,>=0.7.5
+Requires-Dist: numpy<2.2,>=1.16.0
+Requires-Dist: htmlmin==0.1.12
+Requires-Dist: phik<0.13,>=0.11.1
+Requires-Dist: requests<3,>=2.24.0
+Requires-Dist: tqdm<5,>=4.48.2
+Requires-Dist: seaborn<0.14,>=0.10.1
+Requires-Dist: multimethod<2,>=1.4
+Requires-Dist: statsmodels<1,>=0.13.2
+Requires-Dist: typeguard<5,>=3
+Requires-Dist: imagehash==4.3.1
+Requires-Dist: wordcloud>=1.9.3
+Requires-Dist: dacite>=1.8
+Requires-Dist: numba<=0.61,>=0.56.0
+Requires-Dist: click>=7.0
+Provides-Extra: dev
+Requires-Dist: black>=20.8b1; extra == "dev"
+Requires-Dist: isort>=5.0.7; extra == "dev"
+Requires-Dist: pre-commit>=2.8.2; extra == "dev"
+Requires-Dist: virtualenv>=20.0.33; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: myst-parser>=0.18.1; extra == "dev"
+Requires-Dist: sphinx_rtd_theme>=0.4.3; extra == "dev"
+Requires-Dist: sphinx-autodoc-typehints>=1.10.3; extra == "dev"
+Requires-Dist: sphinx-multiversion>=0.2.3; extra == "dev"
+Requires-Dist: autodoc_pydantic; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs<1.7.0,>=1.6.0; extra == "docs"
+Requires-Dist: mkdocs-material<10.0.0,>=9.0.12; extra == "docs"
+Requires-Dist: mkdocs-material-extensions<2.0.0,>=1.1.1; extra == "docs"
+Requires-Dist: mkdocs-table-reader-plugin<=2.2.0; extra == "docs"
+Requires-Dist: mike<2.2.0,>=2.1.1; extra == "docs"
+Requires-Dist: mkdocstrings[python]<1.0.0,>=0.20.0; extra == "docs"
+Requires-Dist: mkdocs-badges; extra == "docs"
+Provides-Extra: notebook
+Requires-Dist: jupyter>=1.0.0; extra == "notebook"
+Requires-Dist: ipywidgets>=7.5.1; extra == "notebook"
+Provides-Extra: spark
+Requires-Dist: pyspark>=3.0; extra == "spark"
+Requires-Dist: pyarrow>=4.0.0; extra == "spark"
+Requires-Dist: pandas>1.1; extra == "spark"
+Requires-Dist: numpy>=1.16.0; extra == "spark"
+Requires-Dist: visions[type_image_path]<0.7.7,>=0.7.5; extra == "spark"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: coverage<8,>=6.5; extra == "test"
+Requires-Dist: codecov; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: nbval; extra == "test"
+Requires-Dist: pyarrow; extra == "test"
+Requires-Dist: twine>=3.1.1; extra == "test"
+Requires-Dist: kaggle; extra == "test"
+Provides-Extra: unicode
+Requires-Dist: tangled-up-in-unicode==0.2.0; extra == "unicode"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# YData Profiling Multilingual
+ 
+> **Note**: This is a fork of [ydataai/ydata-profiling](https://github.com/ydataai/ydata-profiling) with added international multilingual functionality. I only implemented multilingual language support - all core profiling features remain unchanged from the original project.
+
+[![Build Status](https://github.com/ydataai/pandas-profiling/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/ydataai/pandas-profiling/actions/workflows/tests.yml)
+[![PyPI download month](https://img.shields.io/pypi/dm/ydata-profiling.svg)](https://pypi.python.org/pypi/ydata-profiling/)
+[![](https://pepy.tech/badge/pandas-profiling)](https://pypi.org/project/ydata-profiling/)
+[![Code Coverage](https://codecov.io/gh/ydataai/pandas-profiling/branch/master/graph/badge.svg?token=gMptB4YUnF)](https://codecov.io/gh/ydataai/pandas-profiling)
+[![Release Version](https://img.shields.io/github/release/ydataai/pandas-profiling.svg)](https://github.com/ydataai/pandas-profiling/releases)
+[![Python Version](https://img.shields.io/pypi/pyversions/ydata-profiling)](https://pypi.org/project/ydata-profiling/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)
+ 
+## 🌍 What I Added
+ 
+This fork adds comprehensive internationalization (i18n) support to the original ydata-profiling:
+ 
+- **🔤 Multi-language Support**: Built-in English, Chinese, and framework for custom languages
+- **🛠️ Custom Translations**: Users can create and load their own translation files
+- **📊 Localized Reports**: All UI elements, labels, and messages are translatable
+- **⚙️ Translation Tools**: Command-line utilities for creating and validating translations
+- **🔄 100% Backward Compatibility**: Works exactly like original ydata-profiling
+ 
+## 🙏 Credits
+ 
+- **Original Project**: [ydata-profiling](https://github.com/ydataai/ydata-profiling) by YData team
+- **Multilingual Enhancement**: Added by [Landon Zeng](https://github.com/landonzeng)
+- **What I Did**: Only implemented i18n functionality - all core features are from the original project
+ 
+## 🚀 Quick Start
+ 
+### Installation
+ 
+```bash
+pip install ydata-profiling-multilingual
+```
+
+### Basic Usage (Same as Original + Language Support)
+
+```python
+import pandas as pd
+from ydata_profiling import ProfileReport
+ 
+# Create sample data
+df = pd.DataFrame({
+    'numeric': [1, 2, 3, 4, 5],
+    'categorical': ['A', 'B', 'A', 'C', 'B'],
+})
+ 
+# Generate report in Chinese (NEW FEATURE)
+profile = ProfileReport(df, title="数据分析报告", locale='zh')
+profile.to_file("chinese_report.html")
+ 
+# Generate report in English (same as original)
+profile = ProfileReport(df, title="Data Analysis Report")
+profile.to_file("english_report.html")
+```
+## 🌐 Supported Languages
+- English (en) - Default
+- Chinese Simplified (zh) - 简体中文
+- Custom Languages - Add your own!
+
+## 🔧 New Multilingual Features
+### Export Translation Template
+
+```bash
+# Use new command line tool
+ydata-profiling-translate create-template -l en -o ./my_template.json
+```
+### Create Custom Translation
+```python
+from ydata_profiling.i18n import load_translation_file, set_locale
+ 
+# Load your custom translation file
+load_translation_file('my_french.json', 'fr')
+ 
+# Generate French report
+profile = ProfileReport(df, title="Rapport d'Analyse", locale='fr')
+```
+
+### Load Translation Directory
+```python
+from ydata_profiling.i18n import add_translation_directory
+ 
+# Load all translations from a directory
+add_translation_directory('./my_translations/')
+```
+
+## 📚 Examples
+Check the examples/ folder for complete workflows:
+```python
+# Run the complete example
+python examples/translation_workflow_example.py
+```
+
+## 🔄 Migration from Original
+If you're using the original ydata-profiling, migration is seamless:
+```python
+# Your existing code works unchanged
+from ydata_profiling import ProfileReport
+profile = ProfileReport(df)  # Still works!
+ 
+# Just add locale for multilingual support
+profile = ProfileReport(df, locale='zh')  # Now with Chinese!
+```
+
+## 🤝 Contributing
+This project focuses only on multilingual functionality. For core profiling features:
+- Core Issues: Please report to original ydata-profiling
+- Translation Issues: Report here at ydata-profiling-multilingual
+
+### Adding New Languages
+1. Export English template: ydata-profiling-translate create-template
+2. Translate the JSON file
+3. Submit PR with your translation
+
+## 📄 License
+Same as original project: MIT License
+
+## 🔗 Links
+- Original Project: [ydata-profiling](https://github.com/ydataai/ydata-profiling)
+- This Fork: [ydata-profiling-multilingual](https://github.com/landonzeng/ydata-profiling-multilingual)
+- My GitHub: [landonzeng](https://github.com/landonzeng)
+
+## ⚠️ Disclaimer
+I am not affiliated with YData. This is an independent fork that adds multilingual support. All core profiling algorithms and features are from the original ydata-profiling project. I only implemented the internationalization layer.
+
+## 🌟 If this multilingual version helps you, please star both repositories:
+- ⭐ Original ydata-profiling
+- ⭐ This multilingual fork

ydata_profiling_multilingual-1.0.0/README.md

@@ -0,0 +1,129 @@
+# YData Profiling Multilingual
+ 
+> **Note**: This is a fork of [ydataai/ydata-profiling](https://github.com/ydataai/ydata-profiling) with added international multilingual functionality. I only implemented multilingual language support - all core profiling features remain unchanged from the original project.
+
+[![Build Status](https://github.com/ydataai/pandas-profiling/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/ydataai/pandas-profiling/actions/workflows/tests.yml)
+[![PyPI download month](https://img.shields.io/pypi/dm/ydata-profiling.svg)](https://pypi.python.org/pypi/ydata-profiling/)
+[![](https://pepy.tech/badge/pandas-profiling)](https://pypi.org/project/ydata-profiling/)
+[![Code Coverage](https://codecov.io/gh/ydataai/pandas-profiling/branch/master/graph/badge.svg?token=gMptB4YUnF)](https://codecov.io/gh/ydataai/pandas-profiling)
+[![Release Version](https://img.shields.io/github/release/ydataai/pandas-profiling.svg)](https://github.com/ydataai/pandas-profiling/releases)
+[![Python Version](https://img.shields.io/pypi/pyversions/ydata-profiling)](https://pypi.org/project/ydata-profiling/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)
+ 
+## 🌍 What I Added
+ 
+This fork adds comprehensive internationalization (i18n) support to the original ydata-profiling:
+ 
+- **🔤 Multi-language Support**: Built-in English, Chinese, and framework for custom languages
+- **🛠️ Custom Translations**: Users can create and load their own translation files
+- **📊 Localized Reports**: All UI elements, labels, and messages are translatable
+- **⚙️ Translation Tools**: Command-line utilities for creating and validating translations
+- **🔄 100% Backward Compatibility**: Works exactly like original ydata-profiling
+ 
+## 🙏 Credits
+ 
+- **Original Project**: [ydata-profiling](https://github.com/ydataai/ydata-profiling) by YData team
+- **Multilingual Enhancement**: Added by [Landon Zeng](https://github.com/landonzeng)
+- **What I Did**: Only implemented i18n functionality - all core features are from the original project
+ 
+## 🚀 Quick Start
+ 
+### Installation
+ 
+```bash
+pip install ydata-profiling-multilingual
+```
+
+### Basic Usage (Same as Original + Language Support)
+
+```python
+import pandas as pd
+from ydata_profiling import ProfileReport
+ 
+# Create sample data
+df = pd.DataFrame({
+    'numeric': [1, 2, 3, 4, 5],
+    'categorical': ['A', 'B', 'A', 'C', 'B'],
+})
+ 
+# Generate report in Chinese (NEW FEATURE)
+profile = ProfileReport(df, title="数据分析报告", locale='zh')
+profile.to_file("chinese_report.html")
+ 
+# Generate report in English (same as original)
+profile = ProfileReport(df, title="Data Analysis Report")
+profile.to_file("english_report.html")
+```
+## 🌐 Supported Languages
+- English (en) - Default
+- Chinese Simplified (zh) - 简体中文
+- Custom Languages - Add your own!
+
+## 🔧 New Multilingual Features
+### Export Translation Template
+
+```bash
+# Use new command line tool
+ydata-profiling-translate create-template -l en -o ./my_template.json
+```
+### Create Custom Translation
+```python
+from ydata_profiling.i18n import load_translation_file, set_locale
+ 
+# Load your custom translation file
+load_translation_file('my_french.json', 'fr')
+ 
+# Generate French report
+profile = ProfileReport(df, title="Rapport d'Analyse", locale='fr')
+```
+
+### Load Translation Directory
+```python
+from ydata_profiling.i18n import add_translation_directory
+ 
+# Load all translations from a directory
+add_translation_directory('./my_translations/')
+```
+
+## 📚 Examples
+Check the examples/ folder for complete workflows:
+```python
+# Run the complete example
+python examples/translation_workflow_example.py
+```
+
+## 🔄 Migration from Original
+If you're using the original ydata-profiling, migration is seamless:
+```python
+# Your existing code works unchanged
+from ydata_profiling import ProfileReport
+profile = ProfileReport(df)  # Still works!
+ 
+# Just add locale for multilingual support
+profile = ProfileReport(df, locale='zh')  # Now with Chinese!
+```
+
+## 🤝 Contributing
+This project focuses only on multilingual functionality. For core profiling features:
+- Core Issues: Please report to original ydata-profiling
+- Translation Issues: Report here at ydata-profiling-multilingual
+
+### Adding New Languages
+1. Export English template: ydata-profiling-translate create-template
+2. Translate the JSON file
+3. Submit PR with your translation
+
+## 📄 License
+Same as original project: MIT License
+
+## 🔗 Links
+- Original Project: [ydata-profiling](https://github.com/ydataai/ydata-profiling)
+- This Fork: [ydata-profiling-multilingual](https://github.com/landonzeng/ydata-profiling-multilingual)
+- My GitHub: [landonzeng](https://github.com/landonzeng)
+
+## ⚠️ Disclaimer
+I am not affiliated with YData. This is an independent fork that adds multilingual support. All core profiling algorithms and features are from the original ydata-profiling project. I only implemented the internationalization layer.
+
+## 🌟 If this multilingual version helps you, please star both repositories:
+- ⭐ Original ydata-profiling
+- ⭐ This multilingual fork

ydata_profiling_multilingual-1.0.0/VERSION

@@ -0,0 +1 @@
+1.0.0