MyST Supports cross-referencing into external content in order to create figures and embeds. External content could be in a different version of the AST and would need special handling.
An External Figure!¶
An External Embed!¶
Local testing¶
On local testing
Get test source content in
folderAmyst start --execute --headlessstarts a content server running onlocalhost:3100.Start
myst-themenpm run theme:bookin the MyST Theme repository, e.g.npm run theme:bookstarts a theme running onlocalhost:3000.Get second set of test content in
folderBAdd
local: http://localhost:3000tomyst.yml#project.references.Add external cross references and embeds in
folderBpointing to the local content infolderA.Start a second content server with
myst start --execute --headless, which runs onlocalhost:3101.
In a second
myst-themefolder, or without fully restarting the theme from step 2.Set
CONTENT_CDN_PORT=3101in your environment, and run another MyST Theme process (see (2))
Test this website 👆.