Package 'quartostamp'

Title: RStudio Addin to Insert Quarto Helpers
Description: An RStudio Addin to insert ('stamp') pre-written classes and divs into your Quarto documents.
Authors: Matt Dray [aut, cre], Zoë Turner [ctb]
Maintainer: Matt Dray <[email protected]>
License: MIT + file LICENSE
Version: 0.1.1
Built: 2024-10-27 03:48:30 UTC
Source: https://github.com/matt-dray/quartostamp

Help Index


Insert Aside

Description

Insert a div that creates an 'aside' in a Revealjs presentation slide. Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_aside()

Details

The output looks like this if the user hadn't selected any text:

::: aside
Additional commentary.
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert 'Caution' Callout Block

Description

Insert a callout-block div of type 'caution', which has an orange accent and a traffic-cone icon. Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_callout_caution()

Details

The output looks like this if the user hadn't selected any text:

:::{.callout-caution collapse=false appearance='default' icon=true}
## Optional caption (caution)
- Hide callout body with 'collapse=true'
- Remove 'collapse' to prevent expandability
- Set appearance to 'default', 'simple' or 'minimal'
- Remove icon with 'icon=false'
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert 'Important' Callout Block

Description

Insert a callout-block div of type 'important', which has a red accent and an exclamation-point icon. Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_callout_important()

Details

The output looks like this if the user hadn't selected any text:

:::{.callout-important collapse=false appearance='default' icon=true}
## Optional caption (important)
- Hide callout body with 'collapse=true'
- Remove 'collapse' to prevent expandability
- Set appearance to 'default', 'simple' or 'minimal'
- Remove icon with 'icon=false'
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert 'Note' Callout Block

Description

Insert a callout-block div of type 'note', which has a blue accent and a letter 'i' icon. Will embed text selected bythe user, otherwise skeleton help text will be inserted.

Usage

stamp_callout_note()

Details

The output looks like this if the user hadn't selected any text:

:::{.callout-note collapse=false appearance='default' icon=true}
## Optional caption (note)
- Hide callout body with 'collapse=true'
- Remove 'collapse' to prevent expandability
- Set appearance to 'default', 'simple' or 'minimal'
- Remove icon with 'icon=false'
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert 'Tip' Callout Block

Description

Insert a callout-block div of type 'tip', which has an green accent and a lightbulb icon. Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_callout_tip()

Details

The output looks like this if the user hadn't selected any text:

:::{.callout-tip collapse=false appearance='default' icon=true}
## Optional caption (tip)
- Hide callout body with 'collapse=true'
- Remove 'collapse' to prevent expandability
- Set appearance to 'default', 'simple' or 'minimal'
- Remove icon with 'icon=false'
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert 'Warning' Callout Block

Description

Insert a callout-block div of type 'warning', which has a yellow accent and a warning-triangle icon. Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_callout_warning()

Details

The output looks like this if the user hadn't selected any text:

:::{.callout-warning collapse=false appearance='default' icon=true}
## Optional caption (warning)
- Hide callout body with 'collapse=true'
- Remove 'collapse' to prevent expandability
- Set appearance to 'default', 'simple' or 'minimal'
- Remove icon with 'icon=false'
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Column Layout

Description

Insert a div for a horizontal two-column layout with percentage widths in a Revealjs presentation slide. Will embed text selected by the user into the left column and helper text into the right, otherwise skeleton help text will be inserted into both columns.

Usage

stamp_columns()

Details

The output looks like this if the user hadn't selected any text:

:::: {.columns}

::: {.column width='40%'}
Left column
:::

::: {.column width='60%'}
Right column
:::

::::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Slide Divider

Description

Insert a slide divider in a Revealjs presentation (for slides without titles).

Usage

stamp_divider()

Details

The output looks like this:

---

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Footnote

Description

Insert a footnote marker with skeleton text. If the user selects some text before using this function, a modified version of it will be used to fill the footnote label text instead (punctuation will be removed, spaces will be replaced by hyphens and the text will be made lowercase).

Usage

stamp_footnote(clip = TRUE)

Arguments

clip

Logical. Should the footnote string be added to the clipboard so the user can paste it at the bottom of the document? Defaults to TRUE.

Details

The output looks like this if the user hadn't selected any text and just wants to insert a footnote skeleton:

Here is some text you wrote [^footnote].

And the console will print:

ℹ Copy the footnote '[^footnote]: Insert description'.
ℹ Paste it at the bottom of your document and adjust the description.
ℹ Ensure your footnote labels are unique.

The output looks like this if the user selected some text before using the function:

Here is some text[^some-text] you wrote.

And the console will print:

ℹ The footnote '[^some-text]: Insert description.' was added to the clipboard.
ℹ Paste it at the bottom of your document and adjust the description.
ℹ Ensure your footnote labels are unique.

Value

Nothing. Text is updated in the active document and footnote is added to the clipboard if clip = TRUE.

References

The Quarto documentation website.


Insert Incremental List

Description

Insert a list-containing div in a Revealjs presentation slide that is revealed incrementally. Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_incremental()

Details

The output looks like this if the user hadn't selected any text:

::: {.incremental}
- List element A
- List element B
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Non-Incremental List

Description

Insert a list-containing div to a Revealjs presentation slide that is not revealed incrementally (overrides a global incremental reveal). Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_nonincremental()

Details

The output looks like this if the user hadn't selected any text:

::: {.nonincremental}
- List element A
- List element B
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Speaker Notes

Description

Insert a speaker notes div in a Revealjs presentation slide. Will embed text selected by the user, otherwise skeleton help text will be inserted.

Usage

stamp_notes()

Details

The output looks like this if the user hadn't selected any text:

::: {.notes}
Speaker notes (press 's' when presenting to switch to speaker mode).
:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Pause

Description

Insert a pause marker into a Revealjs presentation slide.

Usage

stamp_pause()

Details

The output looks like this:

. . .

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Scrollable Content

Description

Insert a class that allows content to be scrolled if the slide is too small to hold it (place on the same line as the slide title).

Usage

stamp_scrollable()

Details

Output looks like this:

{.scrollable}

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Smaller Font

Description

Insert a class that makes the font smaller in a Revealjs presentation slide (place on the same line as the slide title).

Usage

stamp_smaller()

Details

Output looks like this:

{.smaller}

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.


Insert Tabset

Description

Insert a panel tabset div to a Revealjs presentation slide. Will embed text selected by the user into the first tab and skeleton help text into the second, otherwise skeleton help text will be inserted into both tabs.

Usage

stamp_tabset()

Details

The output looks like this if the user hadn't selected any text:

::: {.panel-tabset}

## Tab A

Content for Tab A

## Tab B

Content for Tab B

:::

Value

Nothing. Text is updated in the active document.

References

The Quarto documentation website.