manual_teachbooks/book/basic-features/figures.md
Tom van Woudenberg 0421f78d8e Update figures.md
2024-05-30 15:22:53 +02:00

2.9 KiB

Figures

To add a figure, just copy the figure to the correct directory. Then, in your markdown file, include the figure as follows:

    ```{figure} <figurename>.png/.jpg
    ---
    height/width: <height or width in pixels>
    name: <name of the figure>
    align: left / center / right
    figclass: left blank or "margin"
    ---
    <Figure caption>
    ```

For example:

    ```{figure} ../images/TUDelft_logo_rgb.png
    ---
    width: 70%
    name: demoexample1
    align: center
    ---
    example 1: width (70%) as percentage, align center
    ```

provides this output, which looks nice.

---
width: 70%
name: demoexample1
align: center
---
example 1: width (70%) as percentage, align center

Using the name label, you can refer to the figure as done with {numref}Figure {number} <demoexample1>.

You can find more documentation on including figures here.

There are many settings, for instance aligning right:

    ```{figure} ../images/TUDelft_logo_rgb.png
    ---
    width: 50%
    name: demoexample2
    align: right
    ---
    example 2: width (50%) as percentage, align right
    ```

with the result:

---
width: 50%
name: demoexample2
align: right
---
example 2: width (50%) as percentage, align right

Aligning right can come with the potential downside (not always wanted) that text is wrapped around the figure. To avoid this one can use <div> elements, both before and after the text (make sure to leave an empty line after the <div>!):

    <div style="clear: both;">
    and the output
    </div>
    <div style="clear: both;">

    ```{figure} ../images/TUDelft_logo_rgb.png
    ---
    width: 50%
    name: demoexample3
    align: right
    ---
    example 3: width (50%) as percentage, align right with additional div style
    ```

    </div>
with the result:
---
width: 50%
name: demoexample3
align: right
---
example 3: width (50%) as percentage, align right with additional div style

including figclass: margin sets the figure to the column at the right.

    ```{figure} demo97/demo97_figure1.jpg
    ---
    figclass: margin
    width: 50%
    name: demoexample2
   
    ---
    example 2:including figclass: margin
    ```

---
figclass: margin
width: 50%
name: demoexample4
---
example 4:including figclass: margin

Figure syntax maker

One might quickely forget the code for making figures, here is a useful tool to make your figures, just specify all information and the code is produced for you: