Repository navigation
vitakit 0.2.0
The vitakit command
One command answers questions about a project and makes the common changes,
showing every change before it is made:
vitakit status |
every section, where it appears on the website and in the PDF, what is wrong |
vitakit explain <section|document|/route/> |
where it comes from and where it goes; --field prints lines that show a field |
vitakit validate |
everything a build checks, without building or LaTeX |
vitakit add section <name> |
the file, a schema drafted from its entries, one line on a page and in a PDF |
vitakit add field <section> <name> |
one more field a section accepts |
vitakit add page <name> |
a page that can show sections, in the menu |
vitakit customize <section> |
a component, a PDF template or a schema of your own |
vitakit pdf |
build the PDFs (concise output; TeX's own error on failure) |
vitakit verify |
check the generated website |
vitakit eject <file> |
take over a shared component, the citation style or the LaTeX class |
Breaking changes
- Scripts.
build:cvis nowpdf,check:staticis gone. In an existing
project'spackage.json:(npm:"pdf": "vitakit pdf", "check": "pnpm typecheck && pnpm generate && vitakit verify"
npm run typecheck && npm run generate && vitakit verify.) - Binaries.
vitakit-build-cvandvitakit-checkare removed; use
vitakit pdfandvitakit verify.--no-pdfis--tex-only. - Commands.
vitakit add <name>isvitakit add section <name>;
vitakit listisvitakit eject --list; ejecting a schema is
vitakit customize <section> --schema --copy(publications:
vitakit customize publications); ejecting a template is
vitakit customize <section> --pdf. linkedreplacesinstitutionandlink. Every "name that may link"
is{ label, url? }. YAML may still write{ name, url }; code reading
.name(e.g.profile.affiliation.namein a page) must read.label.
Schemas importinginstitutionorlinkimportlinked(and
requiredLinkfor links that need a URL). The context-line part kind is
'linked',INSTITUTION_FIELDSisLINKED_FIELDS.
New
VitaSectiontakeswhere(likewherein a PDF document's.yml) and
title(heading and anchor, hidden without entries). The scaffold's
cv.vueis one<VitaSection id title />line per section, andcv.tex
writes headings inline,\vitasection[Heading]{id}.wherevalues may be numbers; an entry's ownyearfield wins over the
year of its date.- One broken schema no longer hides the other sections during development.
- The LaTeX class uses T1 font encoding under pdfLaTeX, so „, ł, ő and similar
characters typeset. - Shared helper
asLinkedListfor templates.