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
.jmd
files (to be run through pluto) - run
julia make_qmd.jl
to convert to.qmd
files- The files in subdirectories are generated, they should not be edited
- The files in this main directory are quarto specific.
_book
and_freeze
are conveniences
- run
quarto preview
to develop interactively (kinda slow!) - run
quarto render
to render pages (not too bad)
to publish
bump the version number in
_quarto.yml
,Project.toml
run
quarto publish gh-pages
to publishor
quarto publish gh-pages --no-render
to avoid re-rendering, when just doneshould also push project to github
no need to push
_freeze
the repo, as files are locally rendered for now.XXX to get
PlotlyLight
to 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, …