From 579f2c2e5f7c55e80d774d1a1ee64d41b406032e Mon Sep 17 00:00:00 2001 From: Mitsuo Shiota <48662507+mitsuoxv@users.noreply.github.com> Date: Sat, 27 May 2023 03:45:52 +0900 Subject: [PATCH] Suggest/quarto; image sizing (#1502) * Add yaml example * clarify why not out-width but out.width * Update quarto.qmd * Update quarto.qmd --------- Co-authored-by: Mine Cetinkaya-Rundel --- quarto.qmd | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/quarto.qmd b/quarto.qmd index 07718fc..eab1851 100644 --- a/quarto.qmd +++ b/quarto.qmd @@ -447,11 +447,13 @@ We recommend three of the five options: To enforce this, set `fig-width: 6` (6") and `fig-asp: 0.618` (the golden ratio) in the defaults. Then in individual chunks, only adjust `fig-asp`. -- Control the output size with `out-width` and set it to a percentage of the line width. - We suggest `out-width: "70%"` and `fig-align: center`. +- Control the output size with `out-width` and set it to a percentage of the body width of the output document. + We suggest to `out-width: "70%"` and `fig-align: center`. + That gives plots room to breathe, without taking up too much space. - To put multiple plots in a single row, set the `layout-ncol` to 2 for two plots, 3 for three plots, etc. + This effectively sets `out-width` to "50%" for each of your plots if `layout-ncol` is 2, "33%" if `layout-ncol` is 3, etc. Depending on what you're trying to illustrate (e.g., show data or show plot variations), you might also tweak `fig-width`, as discussed below. If you find that you're having to squint to read the text in your plot, you need to tweak `fig-width`.