fix: Replace use of raw directive in README.rst

.github/workflows/publish-package.yml

@@ -19,12 +19,15 @@ jobs:
       uses: actions/setup-python@v1
       with:
         python-version: 3.7
-    - name: Install pep517
+    - name: Install pep517 and twine
       run: |
         python -m pip install pep517 --user
+        python -m pip install twine
     - name: Build a binary wheel and a source tarball
       run: |
         python -m pep517.build --source --binary --out-dir dist/ .
+    - name: Verify the distribution
+      run: twine check dist/*
     - name: Publish distribution 📦 to Test PyPI
       # every PR will trigger a push event on master, so check the push event is actually coming from master
       if: github.event_name == 'push' && github.ref == 'refs/heads/master' && github.repository == 'scikit-hep/pyhf'

README.rst

@@ -1,8 +1,7 @@
-.. raw:: html
-
-  <p align="center">
-  <img src="https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/pyhf-logo.png" alt="pyhf logo" width="320"/>
-  </p>
+.. image:: https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/pyhf-logo-small.png
+   :alt: pyhf logo
+   :width: 320
+   :align: center
 
 pure-python fitting/limit-setting/interval estimation HistFactory-style
 =======================================================================
@@ -48,21 +47,21 @@ What does it support
 --------------------
 
 Implemented variations:
-  - |check| HistoSys
-  - |check| OverallSys
-  - |check| ShapeSys
-  - |check| NormFactor
-  - |check| Multiple Channels
-  - |check| Import from XML + ROOT via `uproot <https://github.com/scikit-hep/uproot>`__
-  - |check| ShapeFactor
-  - |check| StatError
-  - |check| Lumi Uncertainty
+  - ☑ HistoSys
+  - ☑ OverallSys
+  - ☑ ShapeSys
+  - ☑ NormFactor
+  - ☑ Multiple Channels
+  - ☑ Import from XML + ROOT via `uproot <https://github.com/scikit-hep/uproot>`__
+  - ☑ ShapeFactor
+  - ☑ StatError
+  - ☑ Lumi Uncertainty
 
 Computational Backends:
-  - |check| NumPy
-  - |check| PyTorch
-  - |check| TensorFlow
-  - |check| JAX
+  - ☑ NumPy
+  - ☑ PyTorch
+  - ☑ TensorFlow
+  - ☑ JAX
 
 Available Optimizers
 
@@ -80,8 +79,8 @@ Available Optimizers
 Todo
 ----
 
--  |uncheck| StatConfig
--  |uncheck| Non-asymptotic calculators
+-  ☐ StatConfig
+-  ☐ Non-asymptotic calculators
 
 results obtained from this package are validated against output computed
 from HistFactory workspaces
@@ -93,12 +92,15 @@ A one bin example
 
    nobs = 55, b = 50, db = 7, nom_sig = 10.
 
-.. raw:: html
+.. image:: https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/manual_1bin_55_50_7.png
+   :alt: manual
+   :width: 500
+   :align: center
 
-  <p align="center">
-  <img src="https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/manual_1bin_55_50_7.png" alt="manual" width="500"/>
-  <img src="https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/hfh_1bin_55_50_7.png" alt="manual" width="500"/>
-  </p>
+.. image:: https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/hfh_1bin_55_50_7.png
+   :alt: manual
+   :width: 500
+   :align: center
 
 A two bin example
 -----------------
@@ -108,12 +110,16 @@ A two bin example
    bin 1: nobs = 100, b = 100, db = 15., nom_sig = 30.
    bin 2: nobs = 145, b = 150, db = 20., nom_sig = 45.
 
-.. raw:: html
 
-  <p align="center">
-  <img src="https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/manual_2_bin_100.0_145.0_100.0_150.0_15.0_20.0_30.0_45.0.png" alt="manual" width="500"/>
-  <img src="https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/hfh_2_bin_100.0_145.0_100.0_150.0_15.0_20.0_30.0_45.0.png" alt="manual" width="500"/>
-  </p>
+.. image:: https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/manual_2_bin_100.0_145.0_100.0_150.0_15.0_20.0_30.0_45.0.png
+   :alt: manual
+   :width: 500
+   :align: center
+
+.. image:: https://raw.githubusercontent.com/scikit-hep/pyhf/master/docs/_static/img/hfh_2_bin_100.0_145.0_100.0_150.0_15.0_20.0_30.0_45.0.png
+   :alt: manual
+   :width: 500
+   :align: center
 
 Installation
 ------------
@@ -147,13 +153,11 @@ on `Stack Overflow <https://stackoverflow.com/questions/tagged/pyhf>`__
 with the ``[pyhf]`` tag, which the ``pyhf`` dev team
 `watches <https://stackoverflow.com/questions/tagged/pyhf?sort=Newest&filters=NoAcceptedAnswer&edited=true>`__.
 
-.. raw:: html
-
-  <p align="center">
-  <a href="https://stackoverflow.com/questions/tagged/pyhf">
-  <img src="https://cdn.sstatic.net/Sites/stackoverflow/company/img/logos/so/so-logo.png" alt="Stack Overflow pyhf tag" width="50%"/>
-  </a>
-  </p>
+.. image:: https://cdn.sstatic.net/Sites/stackoverflow/company/img/logos/so/so-logo.png
+   :alt: Stack Overflow pyhf tag
+   :width: 50 %
+   :target: https://stackoverflow.com/questions/tagged/pyhf
+   :align: center
 
 If you believe you have found a bug in ``pyhf``, please report it in the
 `GitHub
@@ -214,11 +218,3 @@ contributors <https://github.com/scikit-hep/pyhf/graphs/contributors>`__
    :target: https://hub.docker.com/r/pyhf/pyhf/
 .. |Docker Pulls| image:: https://img.shields.io/docker/pulls/pyhf/pyhf.svg
    :target: https://hub.docker.com/r/pyhf/pyhf/
-
-.. |check| raw:: html
-
-    <input checked=""  type="checkbox" disabled="true">
-
-.. |uncheck| raw:: html
-
-    <input type="checkbox" disabled="true">