Renderer: option to show source code

[machow]

Let's add an option to render the source code for an object (inside a collapsed dropdown).

Still thinking about if this should happen by default 🤔

[machow]

Here's an example of source code in a doc.

Let's aim to do something similar:

• add the option show_source to layout.Auto
• lists file name
• click to expand
• test via snapshot

[machow]

There's a bit of a funky issue here. Basically quarto will look for python blocks, even in indented blocks in a qmd. So we need an escaping strategy to place source code inside qmds.

So far using a function like this seems to work:

def sanitize(x):
    return (x
        .replace("{", "{")
        .replace("}", "}")
        .replace("`", "`")
    )

It can take a string of source like this...

def f(x):
    """Some func

    ```{python}
    1 + 1
    ```
    """

And turn it into this (I've added code and pre elements):

<code><pre>
def f(x):
    """Some func

    &grave;&grave;&grave;&lbrace;python&rbrace;
    1 + 1
    &grave;&grave;&grave;
    """
</code></pre>

In this case, quarto doesn't read the source as having a python block to execute.

[isabelizimm]

Another potential option is to not have the source code rendered, but rather have a link to source code that opens on GitHub. Happy to break that out into another issue if that makes more sense!

CC: @ncclementi @gforsyth who are interested in this for ibis docs 👀

[deepyaman]

Another potential option is to not have the source code rendered, but rather have a link to source code that opens on GitHub. Happy to break that out into another issue if that makes more sense!

CC: @ncclementi @gforsyth who are interested in this for ibis docs 👀

I randomly came across this issue just now because I was independently frustrated that it wasn't in the Ibis docs. 😂 I actually prefer links to GitHub source, personally.

[ncclementi]

Opened a separate issue for a feature to link to github source since it's slightly different than the original opened here.
xref: #354