Added course's notes
This commit is contained in:
1 parent
e07993262c
commit
dcd2c072ae
191 files changed
+42866
-12
No files matched your search
@@ -0,0 +1,272 @@
|
||||
--[[
|
||||
si-mathjax.lua
|
||||
----------------------------------------------------------------------
|
||||
Quarto/Pandoc filter: translates a practical subset of siunitx syntax
|
||||
(\SI, \si, \num, \ang) into plain LaTeX that MathJax can render natively.
|
||||
|
||||
- HTML output : \SI{9.8}{\metre\per\square\second} -> 9.8\,\mathrm{m}\,\mathrm{s}^{-2}
|
||||
- PDF/LaTeX : left completely untouched (real siunitx package handles it)
|
||||
|
||||
Supports:
|
||||
* macro-based units : \kilo\gram\per\cubic\metre , \newton\per\square\metre
|
||||
* compact-string units: kg.m.s^{-1} , N/m^2 , kg/m^3
|
||||
* \num{1.5e-3} / \num{6.022e23} -> scientific notation
|
||||
* \ang{45} / \ang{45;30;15} -> degrees / DMS
|
||||
* optional [options] blocks after \SI / \si (ignored, just skipped)
|
||||
* works both inside math ($...$, $$...$$) and inside raw LaTeX text
|
||||
|
||||
Add more units/prefixes to the tables below as your notes need them.
|
||||
|
||||
Turn it off when MathJax itself loads a siunitx extension (e.g. siunitx-pcc
|
||||
in include-in-header), so that extension sees the original commands:
|
||||
|
||||
siunitx-html: mathjax # default: filter
|
||||
]]
|
||||
|
||||
-- ============ unit tables (extend as needed) ============
|
||||
local prefixes = {
|
||||
yotta="Y", zetta="Z", exa="E", peta="P", tera="T", giga="G", mega="M", kilo="k",
|
||||
hecto="h", deca="da", deka="da", deci="d", centi="c", milli="m", micro="\\mu ",
|
||||
nano="n", pico="p", femto="f", atto="a", zepto="z", yocto="y",
|
||||
}
|
||||
|
||||
local baseunits = {
|
||||
metre="m", meter="m", gram="g", second="s", ampere="A", kelvin="K", mole="mol", candela="cd",
|
||||
hertz="Hz", newton="N", pascal="Pa", joule="J", watt="W", coulomb="C", volt="V", farad="F",
|
||||
ohm="\\Omega ", siemens="S", weber="Wb", tesla="T", henry="H",
|
||||
degreeCelsius="{}^{\\circ}C", lumen="lm", lux="lx", becquerel="Bq", gray="Gy", sievert="Sv",
|
||||
katal="kat", radian="rad", steradian="sr", percent="\\%", degree="{}^{\\circ}",
|
||||
litre="L", liter="L", minute="min", hour="h", day="d", year="yr",
|
||||
electronvolt="eV", dalton="u", astronomicalunit="au", bar="bar", bel="B", decibel="dB",
|
||||
angstrom="\\AA ", are="a", hectare="ha", tonne="t", knot="kn",
|
||||
}
|
||||
|
||||
-- ============ small helpers ============
|
||||
local function extract_braces(s, i)
|
||||
local depth = 0
|
||||
for j = i, #s do
|
||||
local c = s:sub(j, j)
|
||||
if c == "{" then depth = depth + 1
|
||||
elseif c == "}" then
|
||||
depth = depth - 1
|
||||
if depth == 0 then return s:sub(i + 1, j - 1), j end
|
||||
end
|
||||
end
|
||||
return nil, i
|
||||
end
|
||||
|
||||
local function skip_optional_brackets(s, i)
|
||||
-- skips a siunitx-style [options] block if present, returns new index
|
||||
if s:sub(i, i) == "[" then
|
||||
local j = s:find("]", i, true)
|
||||
if j then return j + 1 end
|
||||
end
|
||||
return i
|
||||
end
|
||||
|
||||
local function split(s, sep)
|
||||
local out = {}
|
||||
for piece in (s .. sep):gmatch("([^" .. sep .. "]*)" .. sep) do
|
||||
table.insert(out, piece)
|
||||
end
|
||||
return out
|
||||
end
|
||||
|
||||
local function trim(s) return s:match("^%s*(.-)%s*$") end
|
||||
|
||||
-- ============ \num{} ============
|
||||
local function format_num(val)
|
||||
local mantissa, exp = val:match("^([%-%+]?[%d%.]+)[eE]([%-%+]?%d+)$")
|
||||
if mantissa then
|
||||
if mantissa == "1" then return "10^{" .. exp .. "}" end
|
||||
return mantissa .. " \\times 10^{" .. exp .. "}"
|
||||
end
|
||||
return val
|
||||
end
|
||||
|
||||
-- ============ \ang{} ============
|
||||
local function format_ang(val)
|
||||
local parts = split(val, ";")
|
||||
if #parts == 1 then
|
||||
return parts[1] .. "^{\\circ}"
|
||||
elseif #parts == 2 then
|
||||
return parts[1] .. "^{\\circ}" .. parts[2] .. "'"
|
||||
else
|
||||
return parts[1] .. "^{\\circ}" .. parts[2] .. "'" .. parts[3] .. "''"
|
||||
end
|
||||
end
|
||||
|
||||
-- ============ macro-based unit parsing: \kilo\gram\per\cubic\metre ============
|
||||
local function parse_unit_macros(s)
|
||||
local tokens = {}
|
||||
local sign = 1
|
||||
local pendingPrefix = ""
|
||||
local pendingPower = 1
|
||||
local i = 1
|
||||
while i <= #s do
|
||||
if s:sub(i, i) == "\\" then
|
||||
local name = s:sub(i + 1):match("^(%a+)")
|
||||
if not name then
|
||||
i = i + 1
|
||||
else
|
||||
local afterpos = i + 1 + #name
|
||||
if name == "per" then
|
||||
sign = -sign
|
||||
elseif name == "square" then
|
||||
pendingPower = 2
|
||||
elseif name == "cubic" then
|
||||
pendingPower = 3
|
||||
elseif name == "raiseto" or name == "tothe" then
|
||||
if s:sub(afterpos, afterpos) == "{" then
|
||||
local n, endpos = extract_braces(s, afterpos)
|
||||
pendingPower = tonumber(n) or 1
|
||||
afterpos = endpos + 1
|
||||
end
|
||||
elseif prefixes[name] then
|
||||
pendingPrefix = pendingPrefix .. prefixes[name]
|
||||
elseif baseunits[name] then
|
||||
table.insert(tokens, { sym = pendingPrefix .. baseunits[name], exp = pendingPower * sign })
|
||||
pendingPrefix = ""
|
||||
pendingPower = 1
|
||||
else
|
||||
table.insert(tokens, { sym = pendingPrefix .. name, exp = pendingPower * sign })
|
||||
pendingPrefix = ""
|
||||
pendingPower = 1
|
||||
end
|
||||
i = afterpos
|
||||
end
|
||||
else
|
||||
i = i + 1
|
||||
end
|
||||
end
|
||||
return tokens
|
||||
end
|
||||
|
||||
-- ============ compact-string unit parsing: kg.m.s^{-1} | m/s^2 | N.m^-2 ============
|
||||
local function parse_unit_compact(s)
|
||||
s = trim(s)
|
||||
local num, den = s, nil
|
||||
local slashpos = s:find("/")
|
||||
if slashpos then
|
||||
num = s:sub(1, slashpos - 1)
|
||||
den = s:sub(slashpos + 1)
|
||||
end
|
||||
|
||||
local function tokenize_group(group, signMul)
|
||||
local out = {}
|
||||
if not group or trim(group) == "" then return out end
|
||||
group = group:gsub("%s+", ".")
|
||||
for tok in (group .. "."):gmatch("([^%.]*)%.") do
|
||||
if trim(tok) ~= "" then
|
||||
local sym, exp = tok:match("^([%a%%°]+)%^?%{?(%-?%d*)%}?$")
|
||||
if not sym then sym = tok exp = "" end
|
||||
exp = (exp ~= "" and tonumber(exp)) or 1
|
||||
table.insert(out, { sym = sym, exp = exp * signMul })
|
||||
end
|
||||
end
|
||||
return out
|
||||
end
|
||||
|
||||
local tokens = tokenize_group(num, 1)
|
||||
for _, t in ipairs(tokenize_group(den, -1)) do table.insert(tokens, t) end
|
||||
return tokens
|
||||
end
|
||||
|
||||
local function format_unit(unit)
|
||||
unit = trim(unit)
|
||||
local tokens = unit:find("\\") and parse_unit_macros(unit) or parse_unit_compact(unit)
|
||||
local parts = {}
|
||||
for _, t in ipairs(tokens) do
|
||||
local piece = "\\mathrm{" .. t.sym .. "}"
|
||||
if t.exp ~= 1 then piece = piece .. "^{" .. t.exp .. "}" end
|
||||
table.insert(parts, piece)
|
||||
end
|
||||
return table.concat(parts, "\\,")
|
||||
end
|
||||
|
||||
-- ============ top-level scanner: replaces \SI \si \num \ang in a string ============
|
||||
local COMMANDS = { "SI", "si", "numlist", "num", "ang" }
|
||||
|
||||
local function process(s)
|
||||
local out = {}
|
||||
local i = 1
|
||||
while i <= #s do
|
||||
local matched = false
|
||||
for _, cmd in ipairs(COMMANDS) do
|
||||
local pat = "\\" .. cmd
|
||||
if s:sub(i, i + #pat - 1) == pat then
|
||||
local nextc = s:sub(i + #pat, i + #pat)
|
||||
if not nextc:match("%a") then
|
||||
local pos = skip_optional_brackets(s, i + #pat)
|
||||
if s:sub(pos, pos) == "{" then
|
||||
local arg1, end1 = extract_braces(s, pos)
|
||||
if arg1 then
|
||||
if cmd == "SI" and s:sub(end1 + 1, end1 + 1) == "{" then
|
||||
local arg2, end2 = extract_braces(s, end1 + 1)
|
||||
table.insert(out, format_num(arg1) .. "\\," .. format_unit(arg2))
|
||||
i = end2 + 1
|
||||
matched = true
|
||||
elseif cmd == "si" then
|
||||
table.insert(out, format_unit(arg1))
|
||||
i = end1 + 1
|
||||
matched = true
|
||||
elseif cmd == "num" or cmd == "numlist" then
|
||||
table.insert(out, format_num(arg1))
|
||||
i = end1 + 1
|
||||
matched = true
|
||||
elseif cmd == "ang" then
|
||||
table.insert(out, format_ang(arg1))
|
||||
i = end1 + 1
|
||||
matched = true
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
if matched then break end
|
||||
end
|
||||
if not matched then
|
||||
table.insert(out, s:sub(i, i))
|
||||
i = i + 1
|
||||
end
|
||||
end
|
||||
return table.concat(out)
|
||||
end
|
||||
|
||||
-- ============ Pandoc hooks (HTML output only) ============
|
||||
local is_html = FORMAT and FORMAT:match("html")
|
||||
|
||||
if not is_html then
|
||||
-- PDF/LaTeX: real siunitx handles this, don't touch anything.
|
||||
return {}
|
||||
end
|
||||
|
||||
local enabled = true
|
||||
|
||||
return {
|
||||
{
|
||||
Meta = function(meta)
|
||||
local mode = meta["siunitx-html"]
|
||||
enabled = mode == nil or pandoc.utils.stringify(mode) ~= "mathjax"
|
||||
end,
|
||||
},
|
||||
{
|
||||
Math = function(el)
|
||||
if not enabled then return nil end
|
||||
el.text = process(el.text)
|
||||
return el
|
||||
end,
|
||||
RawInline = function(el)
|
||||
if enabled and (el.format == "tex" or el.format == "latex") then
|
||||
el.text = process(el.text)
|
||||
return el
|
||||
end
|
||||
end,
|
||||
RawBlock = function(el)
|
||||
if enabled and (el.format == "tex" or el.format == "latex") then
|
||||
el.text = process(el.text)
|
||||
return el
|
||||
end
|
||||
end,
|
||||
},
|
||||
}
|
||||
Reference in new issue
Block a user