quarto-dev / quarto-dev/quarto-cli

keep-ipynb notebook with cell magics and yaml options can't be executed

Open
#2,123 7 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

e.g.

```{python}
#| output: asis
%%javascript

// some JS code
```

This is because cell magics need to be the first line of the cell.

Note that the keep-ipynb feature is really designed for debugging rather than for producing a final notebook for distribution (e.g. markdown constructs like citations and crossrefs are not resolved in this version). We should either resolve this or make it more clear in the documentation that keep-ipynb is for debugging intermediate representations (we could even change the filename to make this more clear).

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the keep-ipynb feature and reproduce the supplied notebook containing YAML cell options and a JavaScript cell magic. Determine whether the generated notebook can execute with the cell magic first, or whether the documentation must clearly describe keep-ipynb as an intermediate debugging representation. Done means the behavior is resolved or the limitation is clearly documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, jupyter-notebook
Domain
documentation, tooling
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.