Pillow/README.rst

Pillow
======

Python Imaging Library (Fork)
-----------------------------

Pillow is the friendly PIL fork by `Alex Clark and Contributors <https://github.com/python-pillow/Pillow/graphs/contributors>`_. PIL is the Python Imaging Library by Fredrik Lundh and Contributors.

.. start-badges

.. list-table::
    :stub-columns: 1

    * - docs
      - |docs|
    * - tests
      - | |linux| |macos| |windows| |coverage|
    * - package
      - |zenodo| |version|
    * - social
      - |gitter| |twitter|

.. |docs| image:: https://readthedocs.org/projects/pillow/badge/?version=latest
   :target: https://pillow.readthedocs.io/?badge=latest
   :alt: Documentation Status

.. |linux| image:: https://img.shields.io/travis/python-pillow/Pillow/master.svg?label=Linux%20build
   :target: https://travis-ci.org/python-pillow/Pillow
   :alt: Travis CI build status (Linux)

.. |macos| image:: https://img.shields.io/travis/python-pillow/pillow-wheels/latest.svg?label=macOS%20build
   :target: https://travis-ci.org/python-pillow/pillow-wheels
   :alt: Travis CI build status (macOS)

.. |windows| image:: https://img.shields.io/appveyor/ci/python-pillow/Pillow/master.svg?label=Windows%20build
   :target: https://ci.appveyor.com/project/python-pillow/Pillow
   :alt: AppVeyor CI build status (Windows)

.. |coverage| image:: https://coveralls.io/repos/python-pillow/Pillow/badge.svg?branch=master&service=github
   :target: https://coveralls.io/github/python-pillow/Pillow?branch=master
   :alt: Code coverage

.. |zenodo| image:: https://zenodo.org/badge/17549/python-pillow/Pillow.svg
   :target: https://zenodo.org/badge/latestdoi/17549/python-pillow/Pillow

.. |version| image:: https://img.shields.io/pypi/v/pillow.svg
   :target: https://pypi.python.org/pypi/Pillow/
   :alt: Latest PyPI version

.. |gitter| image:: https://badges.gitter.im/python-pillow/Pillow.svg
   :target: https://gitter.im/python-pillow/Pillow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
   :alt: Join the chat at https://gitter.im/python-pillow/Pillow

.. |twitter| image:: https://img.shields.io/badge/tweet-on%20Twitter-00aced.svg
   :target: https://twitter.com/PythonPillow
   :alt: Follow on https://twitter.com/PythonPillow

.. end-badges


More Information
----------------

- `Documentation <https://pillow.readthedocs.io/>`_

  - `Installation <https://pillow.readthedocs.io/en/latest/installation.html>`_
  - `Handbook <https://pillow.readthedocs.io/en/latest/handbook/index.html>`_

- `Contribute <https://github.com/python-pillow/Pillow/blob/master/.github/CONTRIBUTING.md>`_

  - `Issues <https://github.com/python-pillow/Pillow/issues>`_
  - `Pull requests <https://github.com/python-pillow/Pillow/pulls>`_

- `Changelog <https://github.com/python-pillow/Pillow/blob/master/CHANGES.rst>`_

  - `Pre-fork <https://github.com/python-pillow/Pillow/blob/master/CHANGES.rst#pre-fork>`_
Removed feline quality typing 2013-06-14 08:20:46 +04:00			`Pillow`
Forking PIL 2010-07-31 06:52:47 +04:00			`======`

Jazz up README [ci skip] I've not liked the "plain" readme for the last few releases, so I've adjusted things hopefully for the better: - Rename/add section headers - Divide content into two sections - Provide bulleted list with most important links e.g. "install" 2015-03-25 01:23:55 +03:00			`Python Imaging Library (Fork)`
			`-----------------------------`
Wording [ci skip] 2013-10-02 15:06:12 +04:00
README fixes - Add Makefile target ``make readme`` to run ``viewdoc`` - Reorg "More Info" sections - Docs to the top - Less doc links (folks can find more than installation & guides from documentation link) - Add link to PRs - Reorg link to pre-fork changes 2015-09-29 13:35:07 +03:00			Pillow is the friendly PIL fork by `Alex Clark and Contributors <https://github.com/python-pillow/Pillow/graphs/contributors>`_. PIL is the Python Imaging Library by Fredrik Lundh and Contributors.
Wording 2013-06-30 03:30:52 +04:00
Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00			`.. start-badges`

			`.. list-table::`
			`:stub-columns: 1`
Add Zenodo badge for #1322 [ci skip] Looks like I had to "draft a release" in the GitHub UI to make this work. 2015-10-06 21:37:27 +03:00
Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00			`* - docs`
			`- \|docs\|`
			`* - tests`
Removed reference to Landscape badge [ci skip] 2017-06-25 06:16:42 +03:00			`- \| \|linux\| \|macos\| \|windows\| \|coverage\|`
Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00			`* - package`
Comment out broken PyPI downloads badge [CI skip] 2017-03-01 12:28:53 +03:00			`- \|zenodo\| \|version\|`
Add Twitter badge 2018-01-04 13:09:01 +03:00			`* - social`
			`- \|gitter\| \|twitter\|`
Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00
			`.. \|docs\| image:: https://readthedocs.org/projects/pillow/badge/?version=latest`
Update RTD links https://blog.readthedocs.com/securing-subdomains/ 2016-04-28 09:35:03 +03:00			`:target: https://pillow.readthedocs.io/?badge=latest`
Add docs badge [ci skip] Because more badges! 2015-10-02 03:10:15 +03:00			`:alt: Documentation Status`

Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00			`.. \|linux\| image:: https://img.shields.io/travis/python-pillow/Pillow/master.svg?label=Linux%20build`
Fix Travis CI badge for new python-pillow name 2014-06-03 12:06:27 +04:00			`:target: https://travis-ci.org/python-pillow/Pillow`
Add OS X build badge [CI skip] We have OS X builds in another repo. Show the badge here too, to help spot OS X build breaks sooner (for example, if might pass on Linux). 2015-03-06 11:52:10 +03:00			`:alt: Travis CI build status (Linux)`
Move image 2013-03-07 02:55:43 +04:00
Renamed reference to OS X to macOS 2016-09-26 12:04:11 +03:00			`.. \|macos\| image:: https://img.shields.io/travis/python-pillow/pillow-wheels/latest.svg?label=macOS%20build`
Reinstate OS X badge [CI skip] 2015-06-08 16:12:28 +03:00			`:target: https://travis-ci.org/python-pillow/pillow-wheels`
Renamed references to OS X to macOS 2016-09-23 14:12:03 +03:00			`:alt: Travis CI build status (macOS)`
Reinstate OS X badge [CI skip] 2015-06-08 16:12:28 +03:00
Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00			`.. \|windows\| image:: https://img.shields.io/appveyor/ci/python-pillow/Pillow/master.svg?label=Windows%20build`
Update AppVeyor URL accordingly [ci skip] c.f. #1468 2015-10-04 22:41:14 +03:00			`:target: https://ci.appveyor.com/project/python-pillow/Pillow`
Fix alt text [CI skip] 2015-06-18 22:05:15 +03:00			`:alt: AppVeyor CI build status (Windows)`
Add AppVeyor badge [CI skip] Docs: http://www.appveyor.com/docs/status-badges TODO Change to master branch when available. 2015-06-18 22:02:22 +03:00
Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00			`.. \|coverage\| image:: https://coveralls.io/repos/python-pillow/Pillow/badge.svg?branch=master&service=github`
			`:target: https://coveralls.io/github/python-pillow/Pillow?branch=master`
			`:alt: Code coverage`

			`.. \|zenodo\| image:: https://zenodo.org/badge/17549/python-pillow/Pillow.svg`
			`:target: https://zenodo.org/badge/latestdoi/17549/python-pillow/Pillow`

			`.. \|version\| image:: https://img.shields.io/pypi/v/pillow.svg`
Shields.io badges instead of broken pypip.in. PNG->SVG for consistency [CI skip] 2015-06-08 15:02:28 +03:00			`:target: https://pypi.python.org/pypi/Pillow/`
			`:alt: Latest PyPI version`
Add PyPI badges! http://codeinthehole.com/writing/pypi-readme-badges/ 2013-10-06 19:22:41 +04:00
Fixed typos [ci skip] 2017-12-15 11:52:42 +03:00			`.. \|gitter\| image:: https://badges.gitter.im/python-pillow/Pillow.svg`
moved glitter badge 2017-12-13 14:53:38 +03:00			`:target: https://gitter.im/python-pillow/Pillow?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge`
			`:alt: Join the chat at https://gitter.im/python-pillow/Pillow`

Add Twitter badge 2018-01-04 13:09:01 +03:00			`.. \|twitter\| image:: https://img.shields.io/badge/tweet-on%20Twitter-00aced.svg`
			`:target: https://twitter.com/PythonPillow`
			`:alt: Follow on https://twitter.com/PythonPillow`

Tabulate badges Inspired by https://github.com/pytest-dev/pytest-cov/blob/master/README.rst [CI skip] 2016-04-04 18:25:31 +03:00			`.. end-badges`
Add Landscape config and badge 2014-10-01 15:46:32 +04:00
Jazz up README [ci skip] I've not liked the "plain" readme for the last few releases, so I've adjusted things hopefully for the better: - Rename/add section headers - Divide content into two sections - Provide bulleted list with most important links e.g. "install" 2015-03-25 01:23:55 +03:00
Add docs badge [ci skip] Because more badges! 2015-10-02 03:10:15 +03:00
Jazz up README [ci skip] I've not liked the "plain" readme for the last few releases, so I've adjusted things hopefully for the better: - Rename/add section headers - Divide content into two sections - Provide bulleted list with most important links e.g. "install" 2015-03-25 01:23:55 +03:00			`More Information`
			`----------------`

Update RTD links https://blog.readthedocs.com/securing-subdomains/ 2016-04-28 09:35:03 +03:00			- `Documentation <https://pillow.readthedocs.io/>`_
Include link to pre-fork changelog [ci skip] 2015-04-01 17:33:11 +03:00
Update RTD links https://blog.readthedocs.com/securing-subdomains/ 2016-04-28 09:35:03 +03:00			- `Installation <https://pillow.readthedocs.io/en/latest/installation.html>`_
			- `Handbook <https://pillow.readthedocs.io/en/latest/handbook/index.html>`_
Include link to pre-fork changelog [ci skip] 2015-04-01 17:33:11 +03:00
README.rst fix contribution link 2016-04-06 14:36:12 +03:00			- `Contribute <https://github.com/python-pillow/Pillow/blob/master/.github/CONTRIBUTING.md>`_
Add header to orig readme [ci skip] So we can link to it from README 2015-04-01 17:29:01 +03:00
			- `Issues <https://github.com/python-pillow/Pillow/issues>`_
README fixes - Add Makefile target ``make readme`` to run ``viewdoc`` - Reorg "More Info" sections - Docs to the top - Less doc links (folks can find more than installation & guides from documentation link) - Add link to PRs - Reorg link to pre-fork changes 2015-09-29 13:35:07 +03:00			- `Pull requests <https://github.com/python-pillow/Pillow/pulls>`_
Add header to orig readme [ci skip] So we can link to it from README 2015-04-01 17:29:01 +03:00
README fixes - Add Makefile target ``make readme`` to run ``viewdoc`` - Reorg "More Info" sections - Docs to the top - Less doc links (folks can find more than installation & guides from documentation link) - Add link to PRs - Reorg link to pre-fork changes 2015-09-29 13:35:07 +03:00			- `Changelog <https://github.com/python-pillow/Pillow/blob/master/CHANGES.rst>`_
Jazz up README [ci skip] I've not liked the "plain" readme for the last few releases, so I've adjusted things hopefully for the better: - Rename/add section headers - Divide content into two sections - Provide bulleted list with most important links e.g. "install" 2015-03-25 01:23:55 +03:00
README fixes - Add Makefile target ``make readme`` to run ``viewdoc`` - Reorg "More Info" sections - Docs to the top - Less doc links (folks can find more than installation & guides from documentation link) - Add link to PRs - Reorg link to pre-fork changes 2015-09-29 13:35:07 +03:00			- `Pre-fork <https://github.com/python-pillow/Pillow/blob/master/CHANGES.rst#pre-fork>`_