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 <cetinkaya.mine@gmail.com>
This commit is contained in:
Mitsuo Shiota 2023-05-27 03:45:52 +09:00 committed by GitHub
parent 9470637463
commit 579f2c2e5f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 4 additions and 2 deletions

View File

@ -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`.