workspace-course-topics

Orchestrator: Ballpark editing, Jupyter, MyST, and bibliography

OBSOLETE: This monolithic 17-step orchestrator has been replaced by the modular orchestrators (01 through 06). In particular, the MyST conversion steps (10-16) are now handled by the four-notebook MyST assembly approach — see MyST Assembly. Retained for historical reference only.

Unit: ballpark-jupyter-myst-bibliography

Overview

This session takes students from an updated ballpark clone through PaperPile/LitMaps setup, Jupyter editing, MyST conversion, bibliography configuration, and a PR.


External resources (as.180.369)


Workflow sequence

1. Git fetch/pull on ballpark

Make sure everyone has the latest code before we begin.

2. PaperPile setup and sharing

Connect to JHU libraries; create and share folders; verify shared content.

3. Google Drive sync for PaperPile

Get PaperPile files available locally via Google Drive.

4. LitMaps import and visualize

Import bib from PaperPile; create a map showing papers that cite your paper.

5. Launch Cursor in ballpark

Open Cursor with the ballpark repo as your workspace.

6. Install the environment (via Cursor)

Ask Cursor how to install the environment; execute the steps.

7. Open Jupyter notebook in Cursor

Navigate to your ballpark directory and open your notebook in Cursor.

8. Add yourself as coauthor

Add your name to the notebook; save and close.

9. Ask Cursor about a MyST extension

Ask Cursor whether there is an extension for MyST Markdown and how to install it.

10. Install MyST-Markdown extension

Install the MyST-Markdown VS Code extension for syntax highlighting and autocomplete.

11. Install MyST (CLI)

Ask Cursor how to install MyST; follow the instructions.

12. Convert notebook to MyST

Ask Cursor how to convert the notebook to a MyST document.

13. Set up bibliography files for MyST

Copy PaperPile bib; create a bib for the paper itself; configure MyST to use both.

14. Add a citation to the paper

Add a proper citation to the paper in your notebook/MyST document.

15. Add LitMap image and subsequent-literature bib

Download the LitMap image; add it to the MyST document; add the subsequent-literature bib.

16. Add “Subsequent Literature” section (AI-assisted)

Use ChatGPT 5.3 mode to generate a summary of citing papers.

17. Git add, commit, and PR

Stage changes, commit, and create a pull request for your modifications.


Assignment after this session

See AI revision with prompt tracking