DOC: Move logo and badges out of long description into README

* Create top-level header in index.rst
* Remove duplicate definition of MIT License URL

Author: effigies

README.rst

@@ -1,38 +1,10 @@
 .. -*- rest -*-
 .. vim:syntax=rst
 
-.. Following contents should be copied from LONG_DESCRIPTION in nibabel/info.py
-
 .. image:: doc/pics/logo.png
    :target: https://nipy.org/nibabel
    :alt: NiBabel logo
 
-Read and write access to common neuroimaging file formats, including: ANALYZE_ (plain, SPM99, SPM2 and later),
-GIFTI_, NIfTI1_, NIfTI2_, `CIFTI-2`_, MINC1_, MINC2_, `AFNI BRIK/HEAD`_, ECAT_ and Philips PAR/REC.
-In addition, NiBabel also supports FreeSurfer_'s MGH_, geometry, annotation and morphometry files,
-and provides some limited support for DICOM_.
-
-NiBabel's API gives full or selective access to header information (metadata), and image
-data is made available via NumPy arrays. For more information, see NiBabel's `documentation site`_
-and `API reference`_.
-
-.. _API reference: https://nipy.org/nibabel/api.html
-.. _AFNI BRIK/HEAD: https://afni.nimh.nih.gov/pub/dist/src/README.attributes
-.. _ANALYZE: http://www.grahamwideman.com/gw/brain/analyze/formatdoc.htm
-.. _CIFTI-2: https://www.nitrc.org/projects/cifti/
-.. _DICOM: http://medical.nema.org/
-.. _documentation site: http://nipy.org/nibabel
-.. _ECAT: http://xmedcon.sourceforge.net/Docs/Ecat
-.. _Freesurfer: https://surfer.nmr.mgh.harvard.edu
-.. _GIFTI: https://www.nitrc.org/projects/gifti
-.. _MGH: https://surfer.nmr.mgh.harvard.edu/fswiki/FsTutorial/MghFormat
-.. _MINC1:
-    https://en.wikibooks.org/wiki/MINC/Reference/MINC1_File_Format_Reference
-.. _MINC2:
-    https://en.wikibooks.org/wiki/MINC/Reference/MINC2.0_File_Format_Reference
-.. _NIfTI1: http://nifti.nimh.nih.gov/nifti-1/
-.. _NIfTI2: http://nifti.nimh.nih.gov/nifti-2/
-
 .. list-table::
    :widths: 20 80
    :header-rows: 0
@@ -97,6 +69,35 @@ and `API reference`_.
          :target: https://doi.org/10.5281/zenodo.591597
          :alt: Zenodo DOI
 
+.. Following contents should be copied from LONG_DESCRIPTION in nibabel/info.py
+
+
+Read and write access to common neuroimaging file formats, including: ANALYZE_ (plain, SPM99, SPM2 and later),
+GIFTI_, NIfTI1_, NIfTI2_, `CIFTI-2`_, MINC1_, MINC2_, `AFNI BRIK/HEAD`_, ECAT_ and Philips PAR/REC.
+In addition, NiBabel also supports FreeSurfer_'s MGH_, geometry, annotation and morphometry files,
+and provides some limited support for DICOM_.
+
+NiBabel's API gives full or selective access to header information (metadata), and image
+data is made available via NumPy arrays. For more information, see NiBabel's `documentation site`_
+and `API reference`_.
+
+.. _API reference: https://nipy.org/nibabel/api.html
+.. _AFNI BRIK/HEAD: https://afni.nimh.nih.gov/pub/dist/src/README.attributes
+.. _ANALYZE: http://www.grahamwideman.com/gw/brain/analyze/formatdoc.htm
+.. _CIFTI-2: https://www.nitrc.org/projects/cifti/
+.. _DICOM: http://medical.nema.org/
+.. _documentation site: http://nipy.org/nibabel
+.. _ECAT: http://xmedcon.sourceforge.net/Docs/Ecat
+.. _Freesurfer: https://surfer.nmr.mgh.harvard.edu
+.. _GIFTI: https://www.nitrc.org/projects/gifti
+.. _MGH: https://surfer.nmr.mgh.harvard.edu/fswiki/FsTutorial/MghFormat
+.. _MINC1:
+    https://en.wikibooks.org/wiki/MINC/Reference/MINC1_File_Format_Reference
+.. _MINC2:
+    https://en.wikibooks.org/wiki/MINC/Reference/MINC2.0_File_Format_Reference
+.. _NIfTI1: http://nifti.nimh.nih.gov/nifti-1/
+.. _NIfTI2: http://nifti.nimh.nih.gov/nifti-2/
+
 Installation
 ============
 
@@ -128,13 +129,13 @@ Please send any questions or suggestions to the `neuroimaging mailing list
 License
 =======
 
-NiBabel is licensed under the terms of the `MIT license`_. Some code included
-with NiBabel is licensed under the `BSD license`_. For more information,
-please see the COPYING_ file.
+NiBabel is licensed under the terms of the `MIT license
+<https://github.com/nipy/nibabel/blob/master/COPYING#nibabel>`__.
+Some code included with NiBabel is licensed under the `BSD license`_.
+For more information, please see the COPYING_ file.
 
 .. _BSD license: https://opensource.org/licenses/BSD-3-Clause
 .. _COPYING: https://github.com/nipy/nibabel/blob/master/COPYING
-.. _MIT license: https://github.com/nipy/nibabel/blob/master/COPYING#nibabel
 
 Citation
 ========

doc/source/index.rst

@@ -7,6 +7,10 @@
   #
   ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ### ###
 
+=======
+NiBabel
+=======
+
 .. include:: _long_description.inc
 
 Documentation

nibabel/info.py

@@ -12,10 +12,6 @@
 # We also include this text in the docs by ``..include::`` in
 # ``docs/source/index.rst``.
 long_description = """
-.. image:: doc/pics/logo.png
-   :target: https://nipy.org/nibabel
-   :alt: NiBabel logo
-
 Read and write access to common neuroimaging file formats, including: ANALYZE_ (plain, SPM99, SPM2 and later),
 GIFTI_, NIfTI1_, NIfTI2_, `CIFTI-2`_, MINC1_, MINC2_, `AFNI BRIK/HEAD`_, ECAT_ and Philips PAR/REC.
 In addition, NiBabel also supports FreeSurfer_'s MGH_, geometry, annotation and morphometry files,
@@ -42,70 +38,6 @@
 .. _NIfTI1: http://nifti.nimh.nih.gov/nifti-1/
 .. _NIfTI2: http://nifti.nimh.nih.gov/nifti-2/
 
-.. list-table::
-   :widths: 20 80
-   :header-rows: 0
-
-   * - Code
-     -
-      .. image:: https://img.shields.io/pypi/pyversions/nibabel.svg
-         :target: https://pypi.python.org/pypi/nibabel/
-         :alt: PyPI - Python Version
-      .. image:: https://img.shields.io/badge/code%20style-blue-blue.svg
-         :target: https://blue.readthedocs.io/en/latest/
-         :alt: code style: blue
-      .. image:: https://img.shields.io/badge/imports-isort-1674b1
-         :target: https://pycqa.github.io/isort/
-         :alt: imports: isort
-      .. image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
-         :target: https://github.com/pre-commit/pre-commit
-         :alt: pre-commit
-
-   * - Tests
-     -
-      .. image:: https://github.com/nipy/NiBabel/actions/workflows/stable.yml/badge.svg
-         :target: https://github.com/nipy/NiBabel/actions/workflows/stable.yml
-         :alt: stable tests
-      .. image:: https://codecov.io/gh/nipy/NiBabel/branch/master/graph/badge.svg
-         :target: https://codecov.io/gh/nipy/NiBabel
-         :alt: codecov badge
-
-   * - PyPI
-     -
-      .. image:: https://img.shields.io/pypi/v/nibabel.svg
-         :target: https://pypi.python.org/pypi/nibabel/
-         :alt: PyPI version
-      .. image:: https://img.shields.io/pypi/dm/nibabel.svg
-         :target: https://pypistats.org/packages/nibabel
-         :alt: PyPI - Downloads
-
-   * - Packages
-     -
-      .. image:: https://img.shields.io/conda/vn/conda-forge/nibabel
-         :target: https://anaconda.org/conda-forge/nibabel
-         :alt: Conda package
-      .. image:: https://repology.org/badge/version-for-repo/debian_unstable/nibabel.svg?header=Debian%20Unstable
-         :target: https://repology.org/project/nibabel/versions
-         :alt: Debian Unstable package
-      .. image:: https://repology.org/badge/version-for-repo/aur/python:nibabel.svg?header=Arch%20%28%41%55%52%29
-         :target: https://repology.org/project/python:nibabel/versions
-         :alt: Arch (AUR)
-      .. image:: https://repology.org/badge/version-for-repo/gentoo_ovl_science/nibabel.svg?header=Gentoo%20%28%3A%3Ascience%29
-         :target: https://repology.org/project/nibabel/versions
-         :alt: Gentoo (::science)
-      .. image:: https://repology.org/badge/version-for-repo/nix_unstable/python:nibabel.svg?header=nixpkgs%20unstable
-         :target: https://repology.org/project/python:nibabel/versions
-         :alt: nixpkgs unstable
-
-   * - License & DOI
-     -
-      .. image:: https://img.shields.io/pypi/l/nibabel.svg
-         :target: https://github.com/nipy/nibabel/blob/master/COPYING
-         :alt: License
-      .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.591597.svg
-         :target: https://doi.org/10.5281/zenodo.591597
-         :alt: Zenodo DOI
-
 Installation
 ============
 
@@ -137,13 +69,13 @@
 License
 =======
 
-NiBabel is licensed under the terms of the `MIT license`_. Some code included
-with NiBabel is licensed under the `BSD license`_. For more information,
-please see the COPYING_ file.
+NiBabel is licensed under the terms of the `MIT license
+<https://github.com/nipy/nibabel/blob/master/COPYING#nibabel>`__.
+Some code included with NiBabel is licensed under the `BSD license`_.
+For more information, please see the COPYING_ file.
 
 .. _BSD license: https://opensource.org/licenses/BSD-3-Clause
 .. _COPYING: https://github.com/nipy/nibabel/blob/master/COPYING
-.. _MIT license: https://github.com/nipy/nibabel/blob/master/COPYING#nibabel
 
 Citation
 ========