Keep documentation in a single place and link to it
Fixes #191 Closes #192
This commit is contained in:
parent
54c8e063d2
commit
ce1e83428b
|
@ -0,0 +1,10 @@
|
||||||
|
# Want to contribute?
|
||||||
|
|
||||||
|
If you would like to contribute, here are some notes and guidelines:
|
||||||
|
|
||||||
|
- All new development happens on feature/fix branches referenced with the GitHub issue number, and are then merged to the develop branch; so the develop branch is always the most up-to-date, working code
|
||||||
|
- The master branch only contains tagged releases
|
||||||
|
- If you are going to be submitting a pull request, please fork from develop, and submit your pull request back as a fix/feature branch referencing the GitHub issue number
|
||||||
|
- Code changes must be validated by PHP-CS-Fixer and PHP_CodeSniffer (via `./vendor/bin/php-cs-fixer fix --verbose && ./vendor/bin/phpcs samples/ src/ tests/ --standard=PSR2 -n`)
|
||||||
|
- [Helpful article about forking](https://help.github.com/articles/fork-a-repo/ "Forking a GitHub repository")
|
||||||
|
- [Helpful article about pull requests](https://help.github.com/articles/using-pull-requests/ "Pull Requests")
|
35
README.md
35
README.md
|
@ -16,41 +16,14 @@ Develop:
|
||||||
|
|
||||||
PhpSpreadsheet is a library written in pure PHP and providing a set of classes that allow you to read from and to write to different spreadsheet file formats, like Excel and LibreOffice Calc.
|
PhpSpreadsheet is a library written in pure PHP and providing a set of classes that allow you to read from and to write to different spreadsheet file formats, like Excel and LibreOffice Calc.
|
||||||
|
|
||||||
## File formats supported
|
## Documentation
|
||||||
|
|
||||||
|Format |Reading|Writing|
|
Read more about it, including install instructions, in the official documentation, either at the online version:
|
||||||
|--------------------------------------------|:-----:|:-----:|
|
|
||||||
|Open Document Format/OASIS (.ods) | ✓ | ✓ |
|
|
||||||
|Office Open XML (.xlsx) Excel 2007 and above| ✓ | ✓ |
|
|
||||||
|BIFF 8 (.xls) Excel 97 and above | ✓ | ✓ |
|
|
||||||
|BIFF 5 (.xls) Excel 95 | ✓ | |
|
|
||||||
|SpreadsheetML (.xml) Excel 2003 | ✓ | |
|
|
||||||
|Gnumeric | ✓ | |
|
|
||||||
|HTML | ✓ | ✓ |
|
|
||||||
|SYLK | ✓ | |
|
|
||||||
|CSV | ✓ | ✓ |
|
|
||||||
|PDF (using either the tcPDF, DomPDF or mPDF libraries, which need to be installed separately)| | ✓ |
|
|
||||||
|
|
||||||
## Requirements
|
https://phpspreadsheet.readthedocs.io
|
||||||
|
|
||||||
* PHP version 5.6 or higher
|
Or directly in this repository in the folder `docs/`.
|
||||||
* PHP extension php_zip enabled
|
|
||||||
* PHP extension php_xml enabled
|
|
||||||
* PHP extension php_gd2 enabled (optional, but required for exact column width autocalculation)
|
|
||||||
|
|
||||||
## PHP version support
|
|
||||||
|
|
||||||
Support for PHP versions will only be maintained for a period of six months beyond the end-of-life of that PHP version
|
|
||||||
|
|
||||||
## Want to contribute?
|
|
||||||
|
|
||||||
If you would like to contribute, here are some notes and guidelines:
|
|
||||||
- All new development happens on feature/fix branches referenced with the GitHub issue number, and are then merged to the develop branch; so the develop branch is always the most up-to-date, working code
|
|
||||||
- The master branch only contains tagged releases
|
|
||||||
- If you are going to be submitting a pull request, please fork from develop, and submit your pull request back as a fix/feature branch referencing the GitHub issue number
|
|
||||||
- Code changes must be validated by PHP-CS-Fixer and PHP_CodeSniffer (via `./vendor/bin/php-cs-fixer fix --verbose && ./vendor/bin/phpcs samples/ src/ tests/ --standard=PSR2 -n`)
|
|
||||||
- [Helpful article about forking](https://help.github.com/articles/fork-a-repo/ "Forking a GitHub repository")
|
|
||||||
- [Helpful article about pull requests](https://help.github.com/articles/using-pull-requests/ "Pull Requests")
|
|
||||||
|
|
||||||
## PHPExcel vs PhpSpreadsheet ?
|
## PHPExcel vs PhpSpreadsheet ?
|
||||||
|
|
||||||
|
|
|
@ -6,6 +6,21 @@ PhpSpreadsheet is a library written in pure PHP and providing a set of
|
||||||
classes that allow you to read from and to write to different
|
classes that allow you to read from and to write to different
|
||||||
spreadsheet file formats, like Excel and LibreOffice Calc.
|
spreadsheet file formats, like Excel and LibreOffice Calc.
|
||||||
|
|
||||||
|
## File formats supported
|
||||||
|
|
||||||
|
|Format |Reading|Writing|
|
||||||
|
|--------------------------------------------|:-----:|:-----:|
|
||||||
|
|Open Document Format/OASIS (.ods) | ✓ | ✓ |
|
||||||
|
|Office Open XML (.xlsx) Excel 2007 and above| ✓ | ✓ |
|
||||||
|
|BIFF 8 (.xls) Excel 97 and above | ✓ | ✓ |
|
||||||
|
|BIFF 5 (.xls) Excel 95 | ✓ | |
|
||||||
|
|SpreadsheetML (.xml) Excel 2003 | ✓ | |
|
||||||
|
|Gnumeric | ✓ | |
|
||||||
|
|HTML | ✓ | ✓ |
|
||||||
|
|SYLK | ✓ | |
|
||||||
|
|CSV | ✓ | ✓ |
|
||||||
|
|PDF (using either the tcPDF, DomPDF or mPDF libraries, which need to be installed separately)| | ✓ |
|
||||||
|
|
||||||
# Getting started
|
# Getting started
|
||||||
|
|
||||||
## Software requirements
|
## Software requirements
|
||||||
|
@ -17,6 +32,10 @@ The following software is required to develop using PhpSpreadsheet:
|
||||||
- PHP extension php\_xml enabled
|
- PHP extension php\_xml enabled
|
||||||
- PHP extension php\_gd2 enabled (if not compiled in)
|
- PHP extension php\_gd2 enabled (if not compiled in)
|
||||||
|
|
||||||
|
### PHP version support
|
||||||
|
|
||||||
|
Support for PHP versions will only be maintained for a period of six months beyond the end-of-life of that PHP version
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
Use [composer](https://getcomposer.org/) to install PhpSpreadsheet into your project:
|
Use [composer](https://getcomposer.org/) to install PhpSpreadsheet into your project:
|
||||||
|
|
|
@ -54,7 +54,7 @@ if ($helper->isCli()) {
|
||||||
</ul>
|
</ul>
|
||||||
<ul class="nav navbar-nav navbar-right">
|
<ul class="nav navbar-nav navbar-right">
|
||||||
<li><a href="https://github.com/PHPOffice/PHPSpreadsheet"><i class="fa fa-github fa-lg" title="GitHub"></i> </a></li>
|
<li><a href="https://github.com/PHPOffice/PHPSpreadsheet"><i class="fa fa-github fa-lg" title="GitHub"></i> </a></li>
|
||||||
<li><a href="http://phpspreadsheet.readthedocs.org/en/develop/"><i class="fa fa-book fa-lg" title="Docs"></i> </a></li>
|
<li><a href="https://phpspreadsheet.readthedocs.io"><i class="fa fa-book fa-lg" title="Docs"></i> </a></li>
|
||||||
<li><a href="http://twitter.com/PHPOffice"><i class="fa fa-twitter fa-lg" title="Twitter"></i> </a></li>
|
<li><a href="http://twitter.com/PHPOffice"><i class="fa fa-twitter fa-lg" title="Twitter"></i> </a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
@ -19,7 +19,7 @@ if (!$helper->isCli()) {
|
||||||
<p> </p>
|
<p> </p>
|
||||||
<p>
|
<p>
|
||||||
<a class="btn btn-lg btn-primary" href="https://github.com/PHPOffice/PHPSpreadsheet" role="button"><i class="fa fa-github fa-lg" title="GitHub"></i> Fork us on Github!</a>
|
<a class="btn btn-lg btn-primary" href="https://github.com/PHPOffice/PHPSpreadsheet" role="button"><i class="fa fa-github fa-lg" title="GitHub"></i> Fork us on Github!</a>
|
||||||
<a class="btn btn-lg btn-primary" href="http://phpspreadsheet.readthedocs.org/en/develop/" role="button"><i class="fa fa-book fa-lg" title="Docs"></i> Read the Docs</a>
|
<a class="btn btn-lg btn-primary" href="https://phpspreadsheet.readthedocs.io" role="button"><i class="fa fa-book fa-lg" title="Docs"></i> Read the Docs</a>
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
<?php
|
<?php
|
||||||
|
|
Loading…
Reference in New Issue