Add two package vignettes, coord_*() and theme_*() wrappers by Copilot · Pull Request #7 · yihui/gglite

Copilot · 2026-03-31T02:10:15Z

Two vignettes using the litedown::vignette engine: a grammar-of-graphics overview and a ggplot2 migration guide. Also adds convenience wrapper functions for coordinates and themes.

Vignettes

vignettes/gglite.Rmd — Walks through each grammar layer (data → marks → encodings → scales → coordinates → transforms → facets → themes → components → interactions) with runnable examples
vignettes/ggplot2.Rmd — Concept mapping tables (geom→mark, scale functions, coords, themes), side-by-side ggplot2/gglite code comparisons (using flex-col layout, non-evaluated gglite blocks), and a quick-reference cheat sheet

New API functions

coord_*() wrappers: coord_polar(), coord_theta(), coord_radial(), coord_radar(), coord_helix(), coord_parallel() — shortcuts for coordinate(chart, type, ...)
theme_*() wrappers: theme_classic(), theme_classicDark(), theme_light(), theme_dark(), theme_academy() — shortcuts for theme_of(chart, type, ...)

Package metadata

DESCRIPTION: added VignetteBuilder: litedown, version bump 0.0.2 → 0.0.3

Agent-Logs-Url: https://github.com/yihui/gglite/sessions/92c20ecc-c37e-42fc-89d7-355c87807724 Co-authored-by: yihui-bot <264330240+yihui-bot@users.noreply.github.com>

yihui-bot · 2026-03-31T04:09:13Z

+```{r, include = FALSE}
+library(gglite)
+```


don't hide this chunk but move it down to the code chunk where gglite is used for the first time, otherwise it can be confusing that you used gglite functions without loading the package

Moved library(gglite) from the hidden chunk to the first code chunk where gglite is used (the "Data and encodings" section). Commit 0183556.

yihui-bot · 2026-03-31T04:14:05Z

+| `geom_point()` | `mark_point()` | "geom" → "mark" |
+| `scale_x_log10()` | `scale_of('x', type = 'log')` | One function for all scales |
+| `coord_flip()` | `coord_transpose()` | |
+| `coord_polar()` | `coordinate('polar')` | |


we should provide wrapper functions coord_*() in gglite, too; coordinate('polar') is not easy to type and can't autocomplete

Added coord_polar(), coord_theta(), coord_radial(), coord_radar(), coord_helix(), and coord_parallel() as wrappers around coordinate(). Updated both vignettes and the comparison table to use them. Commit 0183556.

yihui-bot · 2026-03-31T04:14:38Z

+| `coord_flip()` | `coord_transpose()` | |
+| `coord_polar()` | `coordinate('polar')` | |
+| `facet_wrap()` / `facet_grid()` | `facet_rect()` / `facet_circle()` | |
+| `theme_minimal()` | `theme_of('light')` | |


we should provide wrapper functions theme_*() in gglite

Added theme_classic(), theme_classicDark(), theme_light(), theme_dark(), and theme_academy() as wrappers around theme_of(). Updated both vignettes and the comparison table to use them. Commit 0183556.

yihui-bot · 2026-03-31T04:16:56Z

+
+## Building blocks: geom → mark
+
+Every ggplot2 `geom_*()` has a corresponding `mark_*()` in gglite. Here are the


is that claim true? you should do more thorough research (at least listing all ggplot2's geom_*) to confirm

if eventually you are not 100% sure, please revise the wording

Revised the wording from "Every ggplot2 geom_*() has a corresponding mark_*()" to "Many ggplot2 geom_*() functions have corresponding mark_*() equivalents" and changed "Here are the most common mappings" to "Here are some common mappings". Also added a note about marks that don't have ggplot2 equivalents (sankey, chord, word_cloud, etc.). Commit 0183556.

yihui-bot · 2026-03-31T04:19:35Z

+  Graphics with support for 35+ geometry types (marks), scales, coordinates,
+  themes, transforms, facets, animations, and chart components (axes, legends,
+  titles, tooltips, labels, sliders, and scrollbars). Renders in R Markdown,
+  litedown, Shiny, and standalone HTML previews.


don't touch news for v0.1

Reverted NEWS.md to its original state. Commit 0183556.

yihui-bot · 2026-03-31T04:42:00Z

+::: {.col2}
+
+**ggplot2**
+```r
+ggplot(iris, aes(Sepal.Width, Sepal.Length,
+                 color = Species)) +
+  geom_point()
+```
+
+**gglite**
+```{r}
+g2(iris, x = 'Sepal.Width', y = 'Sepal.Length',
+   color = 'Species') |>
+  mark_point()
+```
+
+:::


use the div class flex-col; move package names into code blocks; don't run gglite code blocks r instead of {r}

Suggested change

::: {.col2}

**ggplot2**

```r

ggplot(iris, aes(Sepal.Width, Sepal.Length,

color = Species)) +

geom_point()

```

**gglite**

```{r}

g2(iris, x = 'Sepal.Width', y = 'Sepal.Length',

color = 'Species') |>

mark_point()

```

:::

::: flex-col

```r

# ggplot2

ggplot(iris, aes(Sepal.Width, Sepal.Length,

color = Species)) +

geom_point()

```

```r

# gglite

g2(iris, x = 'Sepal.Width', y = 'Sepal.Length',

color = 'Species') |>

mark_point()

```

:::

apply the same change to all following sections when we make side-by-side comparisons

Applied to all side-by-side comparisons: changed col2 → flex-col, moved package names into code block comments (# ggplot2 / # gglite), and changed all gglite code blocks from {r} to r so they aren't executed. Commit 0183556.

yihui-bot · 2026-03-31T04:43:06Z

+```{r, include = FALSE}
+library(gglite)
+```
+


we don't really run gglite in this vignette

Suggested change

```{r, include = FALSE}

library(gglite)

```

Removed the hidden library(gglite) chunk entirely since no code is evaluated in this vignette. Commit 0183556.

…t NEWS.md Agent-Logs-Url: https://github.com/yihui/gglite/sessions/c77ab966-61cd-4c36-862b-3a1d245844a6 Co-authored-by: yihui-bot <264330240+yihui-bot@users.noreply.github.com>

Add two package vignettes using litedown::vignette engine

87a868f

Agent-Logs-Url: https://github.com/yihui/gglite/sessions/92c20ecc-c37e-42fc-89d7-355c87807724 Co-authored-by: yihui-bot <264330240+yihui-bot@users.noreply.github.com>

Copilot AI assigned Copilot and yihui-bot Mar 31, 2026

Copilot created this pull request from a session on behalf of yihui-bot March 31, 2026 02:10 View session

Merge branch 'main' into copilot/add-vignettes-for-gglite

53669a5

yihui-bot requested changes Mar 31, 2026

View reviewed changes

Copilot started work on behalf of yihui-bot March 31, 2026 04:45 View session

Address PR review: add coord_*/theme_* wrappers, fix vignettes, rever…

0183556

…t NEWS.md Agent-Logs-Url: https://github.com/yihui/gglite/sessions/c77ab966-61cd-4c36-862b-3a1d245844a6 Co-authored-by: yihui-bot <264330240+yihui-bot@users.noreply.github.com>

Copilot AI changed the title ~~Add two package vignettes (overview and ggplot2 comparison)~~ Add two package vignettes, coord_*() and theme_*() wrappers Mar 31, 2026

Copilot finished work on behalf of yihui-bot March 31, 2026 04:53

Copilot AI requested a review from yihui-bot March 31, 2026 04:53

yihui-bot approved these changes Mar 31, 2026

View reviewed changes

yihui-bot marked this pull request as ready for review March 31, 2026 05:02

yihui-bot merged commit 6b9090f into main Mar 31, 2026
5 checks passed

yihui-bot deleted the copilot/add-vignettes-for-gglite branch March 31, 2026 05:03


		## Building blocks: geom → mark

		Every ggplot2 `geom_()` has a corresponding `mark_()` in gglite. Here are the

Conversation

Copilot AI commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Vignettes

New API functions

Package metadata

Uh oh!

yihui-bot Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

yihui-bot Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

yihui-bot Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

yihui-bot Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

yihui-bot Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

yihui-bot Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

yihui-bot Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 31, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Mar 31, 2026 •

edited

Loading