Fixed #21190 -- Added a new ePub theme for documentation.

5 files changed, 71 insertions, 0 deletions

diff --git a/docs/_theme/djangodocs-epub/static/docicons-behindscenes.png b/docs/_theme/djangodocs-epub/static/docicons-behindscenes.png
new file mode 120000
index 0000000000..3f1cd17ce2
--- /dev/null
+++ b/docs/_theme/djangodocs-epub/static/docicons-behindscenes.png
@@ -0,0 +1 @@
+../../djangodocs/static/docicons-behindscenes.png
\ No newline at end of file
diff --git a/docs/_theme/djangodocs-epub/static/docicons-note.png b/docs/_theme/djangodocs-epub/static/docicons-note.png
new file mode 120000
index 0000000000..b8193a35d7
--- /dev/null
+++ b/docs/_theme/djangodocs-epub/static/docicons-note.png
@@ -0,0 +1 @@
+../../djangodocs/static/docicons-note.png
\ No newline at end of file
diff --git a/docs/_theme/djangodocs-epub/static/docicons-philosophy.png b/docs/_theme/djangodocs-epub/static/docicons-philosophy.png
new file mode 120000
index 0000000000..26d9a0c502
--- /dev/null
+++ b/docs/_theme/djangodocs-epub/static/docicons-philosophy.png
@@ -0,0 +1 @@
+../../djangodocs/static/docicons-philosophy.png
\ No newline at end of file
diff --git a/docs/_theme/djangodocs-epub/static/docicons-warning.png b/docs/_theme/djangodocs-epub/static/docicons-warning.png
new file mode 120000
index 0000000000..455195f35f
--- /dev/null
+++ b/docs/_theme/djangodocs-epub/static/docicons-warning.png
@@ -0,0 +1 @@
+../../djangodocs/static/docicons-warning.png
\ No newline at end of file
diff --git a/docs/_theme/djangodocs-epub/static/epub.css b/docs/_theme/djangodocs-epub/static/epub.css
new file mode 100644
index 0000000000..b74af5e9bf
--- /dev/null
+++ b/docs/_theme/djangodocs-epub/static/epub.css
@@ -0,0 +1,67 @@
+h1 { margin-top: 0; }
+
+/* Keep lists a bit narrow to maximize page estate regarding width. */
+ol, ul {
+    margin: 0;
+    padding: 0 0 0 1.3em;
+}
+
+/* Images should never exceed the width of the page. */
+img { max-width: 100%; }
+
+/* Don't display URL after links, this is not print. */
+.link-target { display: none; }
+
+/* This is the front cover page of the book. */
+.epub-cover { text-align: center; }
+.epub-cover h1 { margin: 4em 0 0 0; }
+.epub-cover h2 { margin: 1em 0; }
+.epub-cover h3 { margin: 3em 0 2em 0; }
+
+/* Code examples should never exceed the width of the page, so wrap instead. */
+pre, span.pre { white-space: pre-wrap; }
+
+pre {
+    background-color: #f6f6f6;
+    border: 0;
+    padding: 0.5em;
+    font-size: 90%;
+}
+
+/* Header for some code blocks. */
+.snippet-filename {
+    background-color: #393939;
+    color: white;
+    margin: 0;
+    padding: 0.5em;
+    font: bold 90% monospace;
+}
+.snippet-filename + .highlight > pre,
+.snippet-filename + pre {
+    margin-top: 0;
+}
+
+a:link, a:visited { color: #396623; }
+a:hover { color: #1d3311; }
+
+/* Use special styled note boxes from the default theme, but with the left side
+fitted after the icon, to allow text resizing with breaking. */
+.note, .admonition {
+    background-position: 9px 0.8em;
+    background-repeat: no-repeat;
+    padding: 0.8em 1em 0.8em 65px;
+    margin: 1em 0;
+    border: 0.01em solid black;
+}
+
+.note, .admonition { background-image: url(docicons-note.png); }
+div.admonition-philosophy { background-image: url(docicons-philosophy.png); }
+div.admonition-behind-the-scenes { background-image: url(docicons-behindscenes.png); }
+.admonition.warning { background-image: url(docicons-warning.png); }
+
+.admonition-title {
+    font-weight: bold;
+    margin: 0;
+}
+
+.admonition .last { margin-bottom: 0; }