Port from bookdown to quarto (#365)

* use yaml formatted chunk options

* enforce sentence-level markdown wraping locally

* ignore *_cache and *_files folders

* canonicalise facets chapter markdown

* replace _bookdown.yml and _output.yml with _quarto.yml

* canonicalise getting-started

* fixes level 1 headers in chapter files

* spurious newline diffs

* canonicalise references

* remove yaml header and canonicalise index.Rmd

* use quarto on gh actions

* use @ notation for cross-references and sec- prefix for section labels

* restore references.Rmd to document structure

* tweak heading to fix inscrutable quarto bug

* removes columns() function, uses quarto layout-ncols instead

* adds status() function and set.seed() to common.R, and updates chapter headings

* remove refs chapter (each chapter has its own refs)

* fix broken crossrefs

* adds "welcome to part" file for part 1

* removes status note from part headers where it makes no sense to have one

* tentatively assign some chapters to status: polishing

* removes spurious heading

* fixes silly mistakes in the gh actions

Author: djnavarro

.github/workflows/bookdown.yaml renamed to .github/workflows/build_book.yaml

@@ -1,51 +1,54 @@
-# Workflow derived from https://github.com/r-lib/actions/tree/master/examples
-# Need help debugging build failures? Start at https://github.com/r-lib/actions#where-to-find-help
 on:
   push:
-    branches: [main, master]
+    branches: main
   pull_request:
-    branches: [main, master]
+    branches: main
+  # to be able to trigger a manual build
+  workflow_dispatch:
   schedule:
     # run every day at 11 PM
     - cron: '0 23 * * *'
 
-name: bookdown
+name: Render and deploy Book to Netlify
+
+env:
+  isExtPR: ${{ github.event.pull_request.head.repo.fork == true }}
+  RUST_BACKTRACE: 1
 
 jobs:
-  bookdown:
+  build-deploy:
     runs-on: ubuntu-latest
     env:
       GITHUB_PAT: ${{ secrets.GITHUB_TOKEN }}
-      isExtPR: ${{ github.event.pull_request.head.repo.fork == true }}
-
     steps:
       - uses: actions/checkout@v3
 
-      - uses: r-lib/actions/setup-pandoc@v2
+      - name: Install Quarto
+        uses: quarto-dev/quarto-actions/install-quarto@v1
+        with:
+          # To install LaTeX to build PDF book
+          tinytex: true
+          # uncomment below and fill to pin a version
+          # version: 0.9.105
 
       - uses: r-lib/actions/setup-r@v2
         with:
           use-public-rspm: true
 
       - uses: r-lib/actions/setup-r-dependencies@v2
 
-      - name: Cache bookdown results
-        uses: actions/cache@v3
-        with:
-          path: _bookdown_files
-          key: bookdown-${{ hashFiles('**/*Rmd') }}
-          restore-keys: bookdown-
-
-      - name: Build site
-        run: Rscript -e 'bookdown::render_book("index.Rmd", quiet = TRUE)'
+      - name: Render book to all format
+        # Add any command line argument needed
+        run: |
+          quarto render
 
       - name: Deploy to Netlify
         if: contains(env.isExtPR, 'false')
         id: netlify-deploy
         uses: nwtgck/[email protected]
         with:
           publish-dir: './_book'
-          production-branch: master
+          production-branch: main
           github-token: ${{ secrets.GITHUB_TOKEN }}
           deploy-message:
             'Deploy from GHA: ${{ github.event.pull_request.title || github.event.head_commit.message }} (${{ github.sha }})'

.gitignore

@@ -3,7 +3,6 @@
 .Rproj.user
 .Rhistory
 book/ggplot2-book.pdf
-_cache
 temp.Rmd
 rsconnect
 www
@@ -17,3 +16,8 @@ _main.aux
 _main.idx
 _main.out
 _main.toc
+
+/.quarto/
+*_cache
+*_files
+_main.Rmd

_bookdown.yml

@@ -0,0 +1,76 @@
+project:
+  type: book
+  output-dir: _book
+
+book:
+  title: "ggplot2: Elegant Graphics for Data Analysis (3e)"
+  reader-mode: true
+
+  page-footer:
+    left: |
+      ggplot2: Elegant Graphics for Data Analysis (3e) was written by
+      Hadley Wickham, Danielle Navarro, and Thomas Lin Pedersen.
+    right: |
+      This book was built with <a href="https://quarto.org/">Quarto</a>.
+  cover-image: cover.jpg
+  favicon: cover.jpg
+  site-url: https://ggplot2-book.org/
+  repo-url: https://github.com/hadley/ggplot2-book/
+  repo-branch: main
+  repo-actions: [edit, issue]
+  chapters:
+    - index.Rmd
+
+    - preface-3e.Rmd
+    - preface-2e.Rmd
+
+    - part: start.Rmd
+      chapters:
+        - introduction.Rmd
+        - getting-started.Rmd
+
+    - part: toolbox.Rmd
+      chapters:
+        - individual-geoms.Rmd
+        - collective-geoms.Rmd
+        - statistical-summaries.Rmd
+        - maps.Rmd
+        - networks.Rmd
+        - annotations.Rmd
+        - arranging-plots.Rmd
+
+    - part: scales.Rmd
+      chapters:
+        - scales-position.Rmd
+        - scales-colour.Rmd
+        - scales-other.Rmd
+
+    - part: mastery.Rmd
+      chapters:
+        - layers.Rmd
+        - scales-guides.Rmd
+        - coord.Rmd
+        - facet.Rmd
+        - themes.Rmd
+
+    - part: extending.Rmd
+      chapters:
+        - programming.Rmd
+        - internals.Rmd
+        - extensions.Rmd
+        - ext-springs.Rmd
+
+bibliography: references.bib
+
+format:
+  html:
+    theme:
+      - cosmo
+    code-link: true
+
+    author-meta: "Hadley Wickham, Danielle Navarro, and Thomas Lin Pedersen"
+    include-in-header: "ga_script.html"
+    callout-appearance: simple
+
+editor: visual
+