Icon updates and documentation references to them

This commit ensures that the new PyMuPDF logo is used
for both the README and the documentation.
The old logo has been deleted/replaced where appropriate.
Additionally the sphinx docs have been updated to
include a custom stylesheet and some colors & layout
have been adjusted for better accessibility.

Author: julian-smith-artifex-com

.gitignore

@@ -4,3 +4,4 @@
 *.swp
 build/
 demo/README.rst
+docs/build

README.md

@@ -1,6 +1,6 @@
 # PyMuPDF 1.20.0
 
-![logo](https://github.com/pymupdf/PyMuPDF/blob/master/demo/pymupdf.jpg)
+![logo](https://artifex.com/images/logos/py-mupdf-github-icon.png?raw=True)
 
 Release date: June 6, 2022
 

demo/pymupdf.jpg

@@ -0,0 +1,24 @@
+div.sidebar, .sphinxsidebar {
+    background-color: #333;
+}
+
+div.document {
+    background-color: #333;
+}
+
+.sphinxsidebarwrapper .logo {
+    margin-top: 0;
+}
+
+.sphinxsidebarwrapper .logo img {
+    width: 72px;
+    height: auto;
+}
+
+.sphinxsidebarwrapper ul li {
+    margin-bottom: 5px;
+}
+
+.bodywrapper .body {
+    min-height: 100vh;
+}

docs/PyMuPDF.ico

@@ -105,7 +105,7 @@
 html_theme_options = {
     # "root_name": "",
     # "root_url": "",
-    # "root_icon": "pymupdf.ico",
+    # "root_icon": "_static/PyMuPDF.ico",
     "body_max_width": "none",
     "sidebarbgcolor": "gray",
 }
@@ -123,18 +123,23 @@
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-# html_logo = "images/img-pymupdf.jpg"
+html_logo = "images/pymupdf-sidebar-logo.png"
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-html_favicon = "PyMuPDF.ico"
+html_favicon = "_static/PyMuPDF.ico"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["_static"]
 
+# A list of CSS files. The entry must be a filename string or a tuple containing
+# the filename string and the attributes dictionary. The filename must be
+# relative to the html_static_path, or a full URI
+html_css_files = ['custom.css']
+
 # Add any extra paths that contain custom files (such as robots.txt or
 # .htaccess) here, relative to this directory. These files are copied
 # directly to the root of the documentation.
@@ -197,7 +202,7 @@
 ]
 # The name of an image file (relative to this directory) to place at the top of
 # the title page.
-latex_logo = "images/img-pymupdf.jpg"
+latex_logo = "images/pymupdf-logo.png"
 
 # For "manual" documents, if this is true, then toplevel headings are parts,
 # not chapters.
@@ -219,7 +224,7 @@
 # Grouping the document tree into PDF files. List of tuples
 # (source start file, target name, title, author).
 
-pdf_documents = [("index", "PyMuPDF", "PyMuPDF Manual", "Jorj McKie")]
+pdf_documents = [("index", "PyMuPDF", "PyMuPDF Manual", "Artifex")]
 
 # A comma-separated list of custom stylesheets. Example:
 pdf_stylesheets = ["sphinx", "bahnschrift", "a4"]