Șapte sfaturi pentru a crea prezentări Quarto revelajs

URMĂREȘTE-NE
16,065FaniÎmi place
1,142CititoriConectați-vă

(Acest articol a fost publicat pentru prima dată pe R | Dr Tom Palmerși cu amabilitate a contribuit la R-bloggeri). (Puteți raporta problema legată de conținutul acestei pagini aici)


Doriți să vă distribuiți conținutul pe R-bloggeri? dați clic aici dacă aveți un blog, sau aici dacă nu aveți.

Introducere

La fel ca mulți lectori, predau în acest moment. Dacă am de făcut o prezentare, în principal imagini, voi folosi Powerpoint sau Google Slides. Dacă prezentarea include matematică sau cod sau ambele, am folosit LaTeX Beamer. De-a lungul anilor, m-am săturat de Beamer și așa că m-am gândit să încerc să fac niște prezentări revelaj folosind Quarto.

Revealjs a existat de mult mai mult decât Quarto, îmi amintesc că am văzut un coleg prezent folosind revelajs în aproximativ 2012 și poți face cu bucurie o prezentare revelajs fără Quarto. Cu toate acestea, comoditatea de a scrie în formatul Quarto Markdown este fantastică.

Pentru a afla elementele de bază ale realizării diapozitivelor revelajs cu Quarto, vă recomand să citiți ghidul utilizatorului. Și documentația completă este disponibilă aici și aici.

Următoarele sfaturi sunt soluții pentru micile obstacole pe care am descoperit că trebuie să le depășesc atunci când am făcut primele prezentări revelaj folosind Quarto.

1. Dimensiunea diapozitivului și testarea pe o dimensiune mai mică de afișare pe propriul monitor

Lucrul minunat despre realizarea unei prezentări în Powerpoint sau Google Slides este că puteți vedea instantaneu dacă conținutul dvs. se potrivește pe un diapozitiv. Așadar, ajută să înțelegeți cât de mare este un diapozitiv. În mod implicit, un slidejs are 1050px lățime pe 700px înălțime. Acest lucru vă ajută când setați dimensiunea figurilor și a blocurilor de cod.

În plus, este util să puteți previzualiza diapozitivele pe dimensiunea monitorului pe care le veți prezenta. Universitatea mea are monitoare 1080p în majoritatea sălilor de curs, cu toate acestea, monitorul meu este mai mare decât atât. Chrome permite setarea dimensiunii afișajului prin deschiderea Instrumente pentru dezvoltatori (Trei puncte | Mai multe instrumente | Instrumente pentru dezvoltatori). Apoi puteți introduce rezoluția dorită în bara de sus, după cum urmează (un ecran de 1080p are 1080 pixeli înălțime și 1920 pixeli lățime).

Captură de ecran cu utilizarea instrumentelor pentru dezvoltatori Google Chrome pentru a inspecta dimensiunea unui diapozitiv și pentru a previzualiza diapozitivele la rezoluție de 1080p.

Găsesc acest lucru deosebit de util atunci când lucrez pe un Mac, ale cărui laptopuri au adesea rezoluții de ecran neobișnuite.

2. Lățimea tăietură mai mare în bucăți de cod

```{r}
#| tidy: TRUE
#| tidy-opts: !expr list(width.cutoff = I(110))
# ... Wide R code here ...
```

De asemenea, le putem seta global pentru documentul Quarto fie în antetul YAML,

knitr:
  opts_chunk: 
    tidy: TRUE
    tidy-opts: !expr list(width.cutoff = I(110))

sau într-o bucată din partea de sus a documentului dvs. Quarto.

```{r}
#| include: false
knitr::opts_chunk$set(tidy = TRUE, tidy.opts = list(width.cutoff = I(110)))
```

3. Bucăți de cod mai înalte

Bucățile de cod vin în mai multe arome într-o prezentare redată. Există bucăți de introducere a codului, bucăți de ieșire de cod și bucăți pentru orice erori de ieșire a codului. Pentru a face bucățile de cod de intrare mai înalte, există o opțiune convenabilă Quarto code-block-height care este specificat în antetul YAML (valoarea implicită este 500px, deci alegeți o valoare mai mare decât aceasta).

---
format:
  revealjs:
    code-block-height: 650px
---

4. Bucăți mai înalte de ieșire de cod

În prezent, nu pare să existe o opțiune Quarto care să crească bucățile de ieșire a codului. Prin urmare, a trebuit să inspectez codul sursă al slide-urilor html pentru a afla cum să modific acest lucru. În majoritatea browserelor, faceți clic dreapta pe un diapozitiv și în Chrome faceți clic Inspecta – faceți acest lucru peste elementul din pagina despre care doriți să aflați.

Captură de ecran a meniului contextual Google Chrome.Captură de ecran a meniului contextual Google Chrome.

Făcând acest lucru peste o celulă de ieșire a codului, se afișează instrumentele pentru dezvoltatori în partea dreaptă. Apoi putem vedea că elementele și clasele pentru celula de ieșire a codului sunt date chiar deasupra panoului din dreapta jos, adică, div.cell div.cell-output.cell-output-stdout pre code.

Captură de ecran cu utilizarea instrumentelor pentru dezvoltatori Google Chrome pentru a inspecta clasa CSS a unui element dintr-o celulă de ieșire a codului.Captură de ecran cu utilizarea instrumentelor pentru dezvoltatori Google Chrome pentru a inspecta clasa CSS a unui element dintr-o celulă de ieșire a codului.

Prin urmare, putem face ca celula de ieșire a codului să aibă o înălțime maximă mai înaltă prin specificarea max-height după cum urmează, într-un fișier CSS la care facem referire în antetul YAML. Rețineți că valoarea implicită este 400px, așa că alegeți o valoare mai mare decât aceasta.

---
format:
  revealjs:
    css: custom.css
---

Conținutul de custom.css utilizați elementele și clasele fragmentului de cod pe care l-am descoperit după cum urmează.

.cell .cell-output-stdout pre code {
  max-height: 650px; // Adjust this value as needed
  overflow-y: auto; // Add this to handle overflow
}

5. Încorporarea prezentărilor interactive Mentimeter

Mentimeter oferă codul html necesar pentru a încorpora o prezentare într-un document html. Pentru a obține acest lucru, accesați o prezentare și faceți clic pe Distribuie butonul, apoi selectați Diapozitive filă, apoi faceți clic Copiați codul sub Încorporați diapozitive.

Captură de ecran a meniului pentru a copia codul html pentru a încorpora o prezentare Mentimeter.Captură de ecran a meniului pentru a copia codul html pentru a încorpora o prezentare Mentimeter.

Acest lucru are ca rezultat un div care conține un iframe, pe care pur și simplu îl putem lipi ca conținutul diapozitivului nostru (am adăugat rupturile de linie și am înlocuit o parte a adresei URL la prezentarea mea cu hash-uri).

## My slide with an embedded Menti

Dar când am redat pentru prima dată o prezentare folosind acest cod, nu am văzut prezentarea mea Mentimeter în diapozitivul relevant, ci mai degrabă următoarele puncte rotative.

GIF animat al punctelor care se rotesc atunci când o prezentare Mentimeter este încorporată incorect într-un document HTML.GIF animat al punctelor care se rotesc atunci când o prezentare Mentimeter este încorporată incorect într-un document HTML.

Datorită acestei postări, se dovedește că acest lucru se datorează faptului că am specificat embed-resources: true în opțiunile mele revelajs din antetul YAML. Când faceți acest lucru, trebuie să adăugați data-external="1" atribuiți iframe-ului așa cum este detaliat în documentația Quarto, după cum urmează.

6. Dezactivați procesarea tabelelor HTML pentru unele tabele

Acum există atât de multe pachete R fantastice pentru generarea tabelelor html. Cele două preferate ale mele sunt rezumat şi sjPlot. Cu toate acestea, observ că pentru unii sjPlot tabele Quarto emite următorul avertisment la randarea diapozitivelor.

WARNING (/Applications/quarto/share/filters/main.lua:9319) Unable to parse table from raw html block: skipping.

Pentru a evita acest lucru, este posibil să dezactivați procesarea tabelelor html de la Quarto folosind html-table-processing argument fie la nivel de document, fie la nivel de bucată. Iată un exemplu de diapozitiv care face acest lucru la nivel de bucată.

## Slide presenting a multilevel model

```{r}
#| html-table-processing: none
library(sjPlot)
library(lme4)
fm1 <- lmer(Reaction ~ Days + (Days | Subject), sleepstudy)
tab_model(fm1)
```

7. Redare programatică și export pdf pentru imprimare

Pentru a reda un document Quarto putem face clic pe Face butonul din RStudio, dar mi se pare mai ușor să fac un redă.R script cu un apel la quarto pachetelor quarto_render() funcţie.

Este util să le oferi elevilor o copie pdf a diapozitivelor pentru tipărire. Puteți face acest lucru într-un browser prin meniul de imprimare sau prin programare folosind pagina joslui chrome_print() funcţie. Când am apelat această funcție fără opțiuni, dimensiunea paginii pdf-ului era neobișnuită, producând pagini fără dimensiunea hârtiei A4 sau SUA, așa că o numesc astfel pentru a asigura o dimensiune de pagină A4.

Prin urmare, al meu redă.R scriptul arată adesea ceva ca următorul.

quarto::quarto_render(input = "my-great-slides.qmd")

pagedown::chrome_print("my-great-slides.html", 
  options = 
    list(
      printBackground = FALSE,
      preferCSSPageSize = FALSE, 
      paperWidth = 8.3, paperHeight = 11.7, 
      marginTop = 0.1, marginBottom = 0.1, 
      marginLeft = 0.1, marginRight = 0.1))

De obicei, constat că câteva diapozitive au conținut puțin prea mult pentru o pagină A4, așa că acele diapozitive vor ocupa 2 pagini în pdf. Și, prin urmare, pdf-ul are de obicei câteva pagini mai multe decât numărul de diapozitive.

Rezumat

Am arătat șapte sfaturi pe care trebuia să le antrenez atunci când fac prezentări revelaj cu Quarto.

Dominic Botezariu
Dominic Botezariuhttps://www.noobz.ro/
Creator de site și redactor-șef.

Cele mai noi știri

Pe același subiect

LĂSAȚI UN MESAJ

Vă rugăm să introduceți comentariul dvs.!
Introduceți aici numele dvs.