update pdf instructions

tomjoht · tomjoht · commit 985fad8b5e2f · 2021-12-29T11:38:52.000-08:00
diff --git a/META-INF/container.xml b/META-INF/container.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0"?>
+<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
+   <rootfiles>
+      <rootfile full-path="docapis.opf" media-type="application/oebps-package+xml"/>
+
+   </rootfiles>
+</container>
diff --git a/_config_kindle.yml b/_config_kindle.yml
@@ -1,5 +1,5 @@
 language: english
-media: /Users/tomjoht/projects/learnapidoc/images
+media: images
 format: kindle
 sidebar: docapis
 
diff --git a/_docs/introduction_to_rest_apis/docapis_formats.md b/_docs/introduction_to_rest_apis/docapis_formats.md
@@ -23,8 +23,6 @@ To read the content as PDF, I recommended that you either read the PDF in [Adobe
 
 ## Kindle
 
-You can use either MOBI or EPUB formats on Kindle. Although Kindle switched to primarily preferring EPUB, it still supports MOBI, and the MOBI file has a better table of contents from the "Go to" button, so I recommend using MOBI for Kindle.
-
 To read the content on Kindle device:
 
 1.  Click the **Kindle (MOBI)** file above. When you do, the MOBI file downloads to your computer.
diff --git a/_includes/course_image.html b/_includes/course_image.html
@@ -1 +1 @@
-{% if site.format == "kindle" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon noCrossRef" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="/Users/tomjoht/projects/learnapidoc/images/{{include.filename}}.{{include.ext_print}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "pdf" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="/Users/tomjoht/projects/learnapidoc/images/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "web" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/api/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% endif %}
+{% if site.format == "kindle" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon noCrossRef" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="images/{{include.filename}}.{{include.ext_print}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "pdf" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="/Users/tomjoht/projects/learnapidoc/images/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "web" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/api/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% endif %}
diff --git a/assets/css/pdf/printstyles.css b/assets/css/pdf/printstyles.css
@@ -56,10 +56,10 @@ a[href^="http:"]::after, a[href^="https:"]::after {
     content: " (" attr(href) ") ";
 }
 
-/* cut this i think*/
+/* cut this i think
 chapter {
 prince-pdf-destination: attr(identifier,string)
-}
+} */
 /* print href link urls after links
 a::after{
     content: " (" attr(href) ") ";
diff --git a/docapis.opf b/docapis.opf
@@ -92,7 +92,7 @@ layout: null
 <manifest>
 <!-- HTML content files [mandatory] -->
 <item id="item_tocstart" media-type="application/xhtml+xml" href="tocstart.html"></item>
-
+<item id="titlepage" href="titlepage.xhtml" media-type="application/xhtml+xml"/>
 {% for folder in sidebar %}
     <item id="item_{{folder.jurl | remove: "/" | remove: ".html" }}" media-type="application/xhtml+xml" href="{{folder.jurl | remove: "/" }}"></item>
 {% for folderitem in folder.folderitems %}
@@ -133,13 +133,15 @@ layout: null
 {% endunless %}
 {% endfor %}
 {% endcomment %}
-
+<!-- stylesheets -->
+    <item id="css" href="assets/css/kindle.css" media-type="text/css"/>
+    <item id="css_syntax" href="assets/css/syntax.css" media-type="text/css"/>
 
   <!-- table of contents [mandatory] -->
 	<item id="My_Table_of_Contents" media-type="application/x-dtbncx+xml" href="docapis.ncx"/>
 
   <!-- cover image [mandatory] -->
-  <item id="My_Cover" media-type="image/gif" href="images/restapi_kindletitle.png"/>
+  <item id="My_Cover" media-type="image/png" href="images/restapi_kindletitle.png"/>
 </manifest>
 
 <!--
diff --git a/mimetype b/mimetype
@@ -0,0 +1 @@
+application/epub+zip
diff --git a/titlepage.xhtml b/titlepage.xhtml
@@ -0,0 +1,19 @@
+<?xml version='1.0' encoding='utf-8'?>
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+    <head>
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+        <meta name="calibre:cover" content="true"/>
+        <title>Cover</title>
+        <style type="text/css" title="override_css">
+            @page {padding: 0pt; margin:0pt}
+            body { text-align: center; padding:0pt; margin: 0pt; }
+        </style>
+    </head>
+    <body>
+        <div>
+            <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="100%" height="100%" viewBox="0 0 960 1186" preserveAspectRatio="none">
+                <image width="960" height="1186" xlink:href="images/restapi_kindletitle.png"/>
+            </svg>
+        </div>
+    </body>
+</html>

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		-{% if site.format == "kindle" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon noCrossRef" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="/Users/tomjoht/projects/learnapidoc/images/{{include.filename}}.{{include.ext_print}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "pdf" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="/Users/tomjoht/projects/learnapidoc/images/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "web" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/api/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% endif %}
	`1`	+{% if site.format == "kindle" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon noCrossRef" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="images/{{include.filename}}.{{include.ext_print}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "pdf" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="/Users/tomjoht/projects/learnapidoc/images/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% elsif site.format == "web" %}<figure>{% if {{include.url}} %}<a target="_blank" class="noExtIcon" href="{{include.url}}">{% endif %}<img class="docimage {% if {{include.size}} %}{{include.size}}{% endif %} {% if {{include.border}} == "true" %}border{% endif %}" src="https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/api/{{include.filename}}.{{include.ext_web}}" alt="{{include.alt}}" />{% if {{include.url}} %}</a>{% endif %}{% if {{include.caption}}%}<figcaption>{{include.caption}}</figcaption>{% endif %}</figure>{% endif %}