/qubit.guide

The online book for the Introduction to Quantum Information Science course, by Artur Ekert and Tim Hosgood.

Primary LanguageTeX

qubit.guide

The source for qubit.guide.

Build using the ./build_book script.

To-do

General

  • make github actions FAIL if PDF build(s) are unsuccessful
  • only one footnote per paragraph
  • check that you use Chapter vs. Section consistently in any \@ref
  • consistent use of \longrightarrow vs \to in display maths
  • search for TO-DO and .todo

Web

  • check that all videos appear at the top of the page
  • general web styling
    • favicon
      • favicon: "favicon.ico" in the index.Rmd YAML
    • banner image below homepage title?
      • would have to work in both light and dark modes! (or alternatively have a separate image for each)
  • separator in nav bar doesn't change in dark mode
  • pretty urls
    • note that these already sort of work (i.e. you can happily delete the trailing .html from any page's url), but the TOC is all ugly links
    • this is gonna have to be a hack: see bookdown/issues/1298
  • make embedded videos slide in/out rather than just appear/disappear
  • improve sidenote y-positioning using jquery
    • find the previous .footnote-ref in the DOM and align with that
  • extra output (added to downloads) that uses the single page html bookdown format with mathjax
    • (I can't remember why I specifically wanted mathjax...)

PDF

  • _pdf-instructions.Rmd to mirror _web-instructions.Rmd
    • talk about technical divs
    • explain that web version exists
  • figure numbering should (ideally) agree with the web version
  • general PDF styling
    • FONT (in headings)
    • "Part X" pages --- less empty space (maybe centred text?)
    • make the tables (e.g. in "phase gates galore" and "Pauli matrices, algebraically") in the pdf version look good
    • make title page nice
    • remove the dashes from page numbers
    • TOC spacing (e.g. the §11.10 number overlaps with the subsection title)
      • also just make it smaller overall width?
    • make physical page numbers agree with printed page numbers
    • icon for .technical divs?
      • use the title of the div too
    • some figures are just TOO BIG (e.g. that relative phase/probability graph for decoherence)
    • external link icon?
  • "last updated" date on title page
  • .idea and .technical envs have problems:
    • they start with a single space
    • they don't have paragraph line breaks
    • they sometimes have more space at the bottom than at the top?
    • they can't break midway (e.g. Segre embedding)
  • check footnotes don't spill over into subsequent pages
  • make a smaller format pdf version ("book-sized", with footnotes at the bottom)
    • also a large print pdf version