sagemathgh-36714: Deploy live doc preview with pdf docs
    
Currently live doc preview lacks pdf docs though links to them are
visible, as seen

https://deploy-livedoc--sagemath-tobias.netlify.app/

We fix the problem. The live doc preview built with this PR is here:

https://deploy-livedoc--sagemath.netlify.app/

<!-- ^^^^^
Please provide a concise, informative and self-explanatory title.
Don't put issue numbers in there, do this in the PR body below.
For example, instead of "Fixes sagemath#1234" use "Introduce new method to
calculate 1+1"
-->
<!-- Describe your changes here in detail -->

<!-- Why is this change required? What problem does it solve? -->
<!-- If this PR resolves an open issue, please link to it here. For
example "Fixes sagemath#12345". -->
<!-- If your change requires a documentation PR, please link it
appropriately. -->

### 📝 Checklist

<!-- Put an `x` in all the boxes that apply. -->
<!-- If your change requires a documentation PR, please link it
appropriately -->
<!-- If you're unsure about any of these, don't hesitate to ask. We're
here to help! -->
<!-- Feel free to remove irrelevant items. -->

- [x] The title is concise, informative, and self-explanatory.
- [x] The description explains in detail what this PR is about.
- [x] I have linked a relevant issue or discussion.
- [ ] I have created tests covering the changes.
- [ ] I have updated the documentation accordingly.

### ⌛ Dependencies

<!-- List all open PRs that this PR logically depends on
- sagemath#12345: short description why this is a dependency
- sagemath#34567: ...
-->

- sagemath#36692

<!-- If you're unsure about any of these, don't hesitate to ask. We're
here to help! -->
    
URL: sagemath#36714
Reported by: Kwankyu Lee
Reviewer(s): Matthias Köppe

Author: Release Manager

.github/workflows/doc-build-pdf.yml

@@ -59,7 +59,6 @@ jobs:
           eval $(sage-print-system-package-command auto --yes --no-install-recommends install zip)
           eval $(sage-print-system-package-command auto --spkg --yes --no-install-recommends install git texlive)
 
-
       - name: Add prebuilt tree as a worktree
         id: worktree
         run: |

.github/workflows/doc-build.yml

@@ -203,11 +203,15 @@ jobs:
         if: (success() || failure()) && steps.copy.outcome == 'success' && github.repository == 'sagemath/sage' && github.ref == 'refs/heads/develop'
         run: |
           set -ex
+          export PATH="build/bin:$PATH"
+          eval $(sage-print-system-package-command auto update)
+          eval $(sage-print-system-package-command auto --yes --no-install-recommends install zip)
+          eval $(sage-print-system-package-command auto --spkg --yes --no-install-recommends install git texlive)
           export SAGE_USE_CDNS=yes
           export SAGE_LIVE_DOC=yes
           export SAGE_JUPYTER_SERVER=binder:sagemath/sage-binder-env/dev
           make doc-clean doc-uninstall
-          ./config.status && make sagemath_doc_html-no-deps
+          ./config.status && make sagemath_doc_html-no-deps sagemath_doc_pdf-no-deps
         working-directory: ./worktree-image
         env:
           MAKE: make -j2 --output-sync=recurse
@@ -220,6 +224,7 @@ jobs:
           set -ex
           mkdir -p ./livedoc
           cp -r -L /sage/local/share/doc/sage/html ./livedoc
+          cp -r -L /sage/local/share/doc/sage/pdf ./livedoc
           cp  /sage/local/share/doc/sage/index.html ./livedoc
           zip -r livedoc.zip livedoc
 

src/doc/common/static/custom-furo.css

@@ -11,3 +11,13 @@ body[data-theme="dark"] div.highlight {
   background: #383838;
 }
 
+/* Copied the style for a.pdf from website/templates/index_furo.html */
+
+a.pdf {
+  margin-right: 0.5em;
+}
+
+a.pdf:hover {
+  text-decoration: none;
+}
+

src/doc/en/website/templates/index_furo.html

@@ -10,10 +10,13 @@
     border: none;
   }
   a.pdf {
-    margin-left: 0.5em;
-  {%- if hide_pdf_links %}
+    margin-right: 0.3em;
+    {%- if hide_pdf_links %}
     display: none;
-  {%- endif %}
+    {%- endif %}
+  }
+  a.pdf:hover {
+    text-decoration: none;
   }
   table.contentstable {
     align: center;
@@ -41,7 +44,7 @@ <h2>
    <tr valign="top">
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/a_tour_of_sage/a_tour_of_sage.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/a_tour_of_sage/a_tour_of_sage.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="a_tour_of_sage/index.html">
@@ -55,7 +58,7 @@ <h2>
     </td>
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/prep/prep_tutorials.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/prep/prep_tutorials.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="prep/index.html">
@@ -75,7 +78,7 @@ <h2>
   <tr valign="top">
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/tutorial/sage_tutorial.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/tutorial/sage_tutorial.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="tutorial/index.html">
@@ -90,7 +93,7 @@ <h2>
     </td>
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/constructions/constructions.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/constructions/constructions.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="constructions/index.html">
@@ -108,7 +111,7 @@ <h2>
   <tr valign="top">
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/thematic_tutorials/thematic_tutorials.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/thematic_tutorials/thematic_tutorials.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="thematic_tutorials/index.html">
@@ -128,7 +131,7 @@ <h2>
     </td>
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/faq/faq.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/faq/faq.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="faq/index.html">
@@ -153,7 +156,7 @@ <h2>
   <tr valign="top">
     <td width="50%">
       <p class="biglink">
-        <a title="Link to PDF" class="pdf" href="reference/index-pdf.html">
+        <a title="PDF" class="pdf" href="reference/index-pdf.html">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="reference/index.html">
@@ -184,7 +187,7 @@ <h2>
   <tr valign="top">
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/installation/installation.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/installation/installation.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="installation/index.html">
@@ -201,7 +204,7 @@ <h2>
     </td>
     <td width="50%">
       <p class="biglink">
-        <a title="Download PDF" class="pdf" href="../../pdf/en/developer/developer.pdf">
+        <a title="PDF" class="pdf" href="../../pdf/en/developer/developer.pdf">
           <img class="icon" src="_static/pdf.png"></img>
         </a>
         <a class="biglink" href="developer/index.html">

src/sage_docbuild/builders.py

@@ -720,14 +720,14 @@ def pdf(self):
         #
         # Change the third form to
         #
-        #   <a href="module/module.pdf">blah <img src="_static/pdf.png" /></a>
+        #   <a href="module/module.pdf"><img src="_static/pdf.png">blah</a>
         #
         rst = re.sub(r'`([^`\n]*)`__.*\n\n__ (.*)',
                      r'<a href="\2">\1</a>.', rst)
         rst = re.sub(r'`([^<\n]*)\s+<(.*)>`_',
                      r'<a href="\2">\1</a>', rst)
         rst = re.sub(r':doc:`([^<]*?)\s+<(.*)/index>`',
-                     r'<a href="../../../pdf/en/reference/\2/\2.pdf"><img src="_static/pdf.png"/></a>&nbsp;<a href="\2/index.html">\1</a> ', rst)
+                     r'<a title="PDF" class="pdf" href="../../../pdf/en/reference/\2/\2.pdf"><img src="_static/pdf.png"></a><a href="\2/index.html">\1</a> ', rst)
         # Body: add paragraph <p> markup.
         start = rst.rfind('*\n') + 1
         end = rst.find('\nUser Interfaces')