A few short notes for helping remember how to recompile when I need to update this after a year or so.
Packages depend on racket version. If the racket version has updated than you need to migrate your packages to the new version.
You can do it in the terminal with the command raco pkg migrate <old-version-no>
raco scribble --htmls /home/britt/gitRepos/compNeuroIntro420/rb/main.scrbl
- Look for an error mentioning
refs.rkt. Sometimes minor formatting problems there can cause the whole thing to halt. Right now (<2023-03-06 Mon>) I am having trouble with a non-standard page for one of the references. - Running from local server can give different behavior than running off of github.io as a github pages. Some of the paths are slightly different. Probably better to prioritize the latter mechanism.
This is a tricky bit to get write.
You need to add the references to a file, in my case refs.rkt. Then you need to make sure that you add the scribble/autobib and ref file to the require section of the file. Then you need to define the ~cite part, e.g. something like:
@(define-cite ~cite citet-id generate-bibliography #:style author+date-style)And then you need to add a bibliography section where you want it to appear:
@generate-bibliography[#:sec-title "Preamble Bibliography"
#:tag "ref:preamble"]