2.2 KiB
TODO
- download links to Pluto .jl files (if we have .jmd, but we might deprecate…)
- PlotlyLight
- mermaid, ojs?
DONE * clean up edit link DONE * remove pinned header DONE * clean up directory DONE (?) * JSXGraph files
CalculusWithJulia via quarto
To compile the pages through quarto
- author in
.jmdfiles (to be run through pluto) - run
julia make_qmd.jlto convert to.qmdfiles- The files in subdirectories are generated, they should not be edited
- The files in this main directory are quarto specific.
_bookand_freezeare conveniences
- run
quarto previewto develop interactively (kinda slow!) - run
quarto renderto render pages (not too bad)
to publish
bump the version number in
_quarto.yml,Project.tomlrun
quarto publish gh-pagesto publishor
quarto publish gh-pages --no-renderto avoid re-rendering, when just doneshould also push project to github
no need to push
_freezethe repo, as files are locally rendered for now.XXX to get
PlotlyLightto work the plotly library needs loading before require.min.js. This is accomplished by editing the .html file and moving up this line:
This can be done with this commandline call: julia adjust_plotly.jl
- This error > fatal: ‘gh-pages’ is already checked out at ‘/Users/verzani/julia/CalculusWithJuliaNotes/quarto/f5611730’
was solved with (https://waylonwalker.com/til/git-checkout-worktree/) > git worktree remove f5611730
——
In summary, there are two steps
quarto render
Preview output in _book/index.html. If okay to
publish:
julia adjust_plotly.jl
quarto publish gh-pages --no-render
Then one should:
- push changes to origin
- merge into main
- branch to new version
- pull origin to merge
Eventually, if this workflow seems to be settled:
- deprecate .jmd files
- deprecate need to make “pluto friendly” DONE? * do something with JSXGraph DONE * figure out why PlotlyLight doesn’t work XXX hacky!
- move to not use CalculusWithJulia.WeaveSupport DONE * use an include file not the “hack” in jmd2qmd
- modify sympy’s show method
- take advantage of mermaid, ojs, bibliography, …