Code listing with line numbers and caption

[jpmorr]

When I'm adding example code to a book project, how do I specify the code block to have a caption and to be formatted with line numbers while still having the relevant syntax highlighting? For example how would I create the following listing? Treating it like a table doesn't seem to work. Maybe it's not currently possible to do something like this with quarto?

```{python}
def sum(a, b):
    sum = a + b
    print(f'Sum: {sum}`)
    return sum
``` : Pointless implementation of a sum function {#lst-sumfunc}

[cscheid]

---
code-line-numbers: true
---

::: {#fig-sumfunc}

```python
def sum(a, b):
    sum = a + b
    print(f'Sum: {sum}')
    return sum
sum(1,2)
```

Pointless implementation of a sum function

:::

This is documented under https://quarto.org/docs/authoring/figures.html and https://quarto.org/docs/output-formats/html-code.html#highlighting

[cscheid]

Yeah, that caption location looks like a bug to me too. It should either be above sum.py (when fig-cap-location: top) or below the listing (when fig-cap-location: bottom).

[cscheid]

In addition, it neither respects fig-cap-location, nor do we have a lst-cap-location option. Another bug...

[drriguz]

Still the caption is placed below the filename, any workaround?

[cscheid]

@drriguz This should be fixed on 1.3 prereleases, which you can download here.

[drriguz]

Thanks, I'll try it!

[AmeliaMN]

I posted on the Posit community before being reminded this might be the right place to ask. I can't figure out how to use lst-cap and lst-label. Here's a minimal document that isn't behaving how I expected:

---
title: "Untitled"
format: html
editor: visual
---

```{r}
#| lst-label: lst-code
#| lst-cap: "Some R code"
a <- 1
a+1
```

I'd like to be able to reference the code chunk @lst-code.

[baptiste]

Seems to be tracked at #1580

[AmeliaMN]

Thanks!

[AmeliaMN]

Ah I figured it out-- the inline options are actually just a display code block. Doh!

[AmeliaMN]

I've been able to make it work by using inline chunk options, like so:

---
title: "Untitled"
format: pdf
editor: visual
---

``` {#lst-code .r lst-cap="Some R code"}
a <- 1
a+1
```

I'd like to be able to reference the code chunk @lst-code.

So perhaps the issue is with the in-chunk options?