@anja.codes/create-vitakit 0.0.0-stage → 0.2.0

package/template/_github/workflows/cv.yml

@@ -0,0 +1,36 @@
+# Builds the PDF CV and attaches it to the workflow run.
+#
+# The PDF is an artifact, not part of the website: it may contain entries
+# marked `visibility: cv` (address, phone, referees). Download it from the run
+# summary. Runs on demand, and on pushes that touch CV material.
+name: CV
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths: ['content/**', 'cv-tex/**']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      # Generate the .tex files here: the LaTeX action runs in its own container,
+      # without Node. cv-tex/latexmkrc lets it find the generated document class.
+      - run: pnpm pdf --tex-only
+      - uses: xu-cheng/latex-action@v4
+        with:
+          working_directory: cv-tex
+          root_file: cv.tex
+          latexmk_use_lualatex: false
+      - uses: actions/upload-artifact@v5
+        with:
+          name: cv
+          path: cv-tex/*.pdf

package/template/_github/workflows/deploy.yml

@@ -0,0 +1,53 @@
+# Builds the site and publishes it to GitHub Pages.
+#
+# Setup: Settings -> Pages -> Source: "GitHub Actions".
+#
+# NUXT_APP_BASE_URL must match where the site is served from. For a project
+# site at https://<user>.github.io/<repo>/ keep the line below; for a user site
+# or a custom domain, delete it. A wrong value breaks every asset URL.
+name: Deploy
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      NUXT_APP_BASE_URL: /${{ github.event.repository.name }}/
+    steps:
+      - uses: actions/checkout@v7
+      # No `version:` here: the pnpm version comes from `packageManager` in
+      # package.json. Setting both fails with ERR_PNPM_BAD_PM_VERSION.
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22        # keep in sync with engines.node
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      # typecheck + generate + assertions on the generated HTML
+      - run: pnpm check
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: .output/public
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v5

package/template/_github/workflows/workers.yml

@@ -0,0 +1,39 @@
+# Builds the site and deploys static assets to Cloudflare Workers (not Pages).
+# wrangler.json points exclusively to .output/public. No Worker script or SSR.
+# Setup: enable your account's workers.dev subdomain and choose an available
+# Worker name in wrangler.json, or configure a custom domain there.
+# Secrets: CLOUDFLARE_API_TOKEN (Workers Scripts edit permission),
+#          CLOUDFLARE_ACCOUNT_ID. The source repository can stay private.
+name: Deploy (Cloudflare Workers)
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: cloudflare-workers
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    if: ${{ github.ref == 'refs/heads/main' }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 22
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm check
+      - uses: cloudflare/wrangler-action@v4
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          wranglerVersion: '4'
+          command: deploy

package/template/app/app.vue

@@ -0,0 +1,5 @@
+<template>
+  <NuxtLayout>
+    <NuxtPage />
+  </NuxtLayout>
+</template>

package/template/app/assets/css/main.css

@@ -0,0 +1,129 @@
+@import "tailwindcss";
+
+/* Design tokens: the first stop for restyling. Tailwind v4 reads these, so
+   `text-primary` and `font-serif` follow from here. */
+@theme {
+  --font-sans: "Inter", ui-sans-serif, system-ui, sans-serif;
+  --font-serif: "Lora", ui-serif, Georgia, serif;
+  --color-primary: oklch(48% 0.13 250);
+}
+
+body {
+  @apply font-sans text-neutral-900 antialiased;
+}
+
+a {
+  @apply text-primary underline underline-offset-2 hover:no-underline;
+}
+
+/* --- vitakit components ------------------------------------------------ */
+
+.vita-entry {
+  @apply grid gap-1 py-2 sm:grid-cols-[8rem_1fr] sm:gap-4;
+}
+.vita-entry__date {
+  @apply text-sm text-neutral-500 tabular-nums;
+}
+.vita-entry__title {
+  @apply font-medium;
+}
+.vita-entry__meta,
+.vita-entry__note {
+  @apply text-sm text-neutral-600;
+}
+.vita-section {
+  @apply divide-y divide-neutral-100;
+}
+.vita-section-group {
+  @apply mt-10;
+}
+.vita-section-group__title {
+  @apply text-xl font-semibold;
+}
+.vita-section-group > .vita-section {
+  @apply mt-3;
+}
+.vita-section-group__subtitle {
+  @apply mt-6 text-sm font-semibold text-neutral-600;
+}
+.vita-links {
+  @apply flex flex-wrap gap-x-4 gap-y-1;
+}
+.vita-publications__group + .vita-publications__group {
+  @apply mt-8;
+}
+.vita-publications__heading {
+  @apply text-xl font-semibold;
+}
+.vita-bib {
+  @apply mt-3 list-decimal space-y-3 pl-6;
+}
+.vita-badge {
+  @apply ml-1 rounded bg-neutral-100 px-1.5 py-0.5 text-xs no-underline hover:bg-neutral-200;
+}
+.vita-issues {
+  @apply border-b border-red-300 bg-red-50 px-4 py-3 text-sm text-red-900;
+}
+.vita-issues__title {
+  @apply font-semibold;
+}
+.vita-issues pre {
+  @apply whitespace-pre-wrap font-sans;
+}
+
+/* --- Markdown output --------------------------------------------------- */
+
+.vita-prose {
+  @apply leading-relaxed;
+}
+.vita-prose :where(p, ul, ol, blockquote, pre, table) {
+  @apply my-4;
+}
+.vita-prose :where(h2) {
+  @apply mt-8 mb-2 text-xl font-semibold;
+}
+.vita-prose :where(h3) {
+  @apply mt-6 mb-2 text-lg font-semibold;
+}
+.vita-prose :where(ul) {
+  @apply list-disc pl-6;
+}
+.vita-prose :where(ol) {
+  @apply list-decimal pl-6;
+}
+.vita-prose :where(code) {
+  @apply rounded bg-neutral-100 px-1 py-0.5 text-sm;
+}
+.vita-prose :where(pre) {
+  @apply overflow-x-auto rounded bg-neutral-100 p-4 text-sm;
+}
+.vita-prose :where(blockquote) {
+  @apply border-l-4 border-neutral-200 pl-4 text-neutral-600;
+}
+.vita-prose :where(figure) {
+  @apply my-4;
+}
+.vita-prose :where(figcaption) {
+  @apply mt-1 text-xs text-neutral-500;
+}
+/* A figure beside the text on wide screens, above it on narrow ones. */
+.vita-prose :where(figure.figure-right) {
+  @apply sm:float-right sm:ml-6 sm:mt-0 sm:w-56;
+}
+.vita-prose :where(figure.figure-right) img {
+  @apply w-full rounded border border-neutral-200 bg-white p-2;
+}
+.vita-prose :where(table) {
+  @apply w-full border-collapse text-left text-sm;
+}
+.vita-prose :where(th, td) {
+  @apply border-b border-neutral-200 py-2 pr-4 align-top;
+}
+.vita-prose :where(th) {
+  @apply font-semibold;
+}
+
+/* Wide display formulas must not blow up the layout on narrow screens. */
+.katex-display {
+  @apply overflow-x-auto overflow-y-hidden py-1;
+}

package/template/app/layouts/default.vue

@@ -0,0 +1,39 @@
+<script setup lang="ts">
+const profile = useProfile()
+</script>
+
+<template>
+  <div class="min-h-screen flex flex-col">
+    <!-- Shows content problems while developing; a build fails on them instead. -->
+    <VitaIssues />
+
+    <header class="border-b border-neutral-200">
+      <div class="mx-auto flex max-w-3xl flex-wrap items-baseline gap-x-6 gap-y-2 px-4 py-6">
+        <NuxtLink to="/" class="text-lg font-semibold no-underline">
+          {{ profile.name }}
+        </NuxtLink>
+        <nav class="ml-auto flex gap-4 text-sm">
+          <NuxtLink
+            v-for="item in profile.nav"
+            :key="item.url"
+            :to="item.url"
+            class="no-underline hover:underline"
+          >
+            {{ item.label }}
+          </NuxtLink>
+        </nav>
+      </div>
+    </header>
+
+    <main class="mx-auto w-full max-w-3xl flex-1 px-4 py-10">
+      <slot />
+    </main>
+
+    <footer class="border-t border-neutral-200">
+      <div class="mx-auto flex max-w-3xl flex-wrap items-baseline gap-2 px-4 py-6 text-sm text-neutral-600">
+        <p>&copy; {{ new Date().getFullYear() }} {{ profile.name }}</p>
+        <VitaMarkdown class="ml-auto text-xs text-neutral-400" :html="profile.footerHtml" />
+      </div>
+    </footer>
+  </div>
+</template>

package/template/app/pages/[...slug].vue

@@ -0,0 +1,30 @@
+<script setup lang="ts">
+/**
+ * Renders every Markdown page in `content/pages/`.
+ *
+ * Adding a page means adding a file. When a page needs more than prose, create
+ * `app/pages/<name>.vue`: a concrete route always wins over this catch-all.
+ */
+const profile = useProfile()
+const route = useRoute()
+const page = usePage(route.path)
+
+if (!page) {
+  throw createError({ statusCode: 404, statusMessage: `No page for ${route.path}`, fatal: true })
+}
+
+useHead({
+  title: page.route === '/' ? profile.name : `${page.title} – ${profile.name}`,
+  meta: [{ name: 'description', content: page.description ?? profile.summary }],
+})
+</script>
+
+<template>
+  <article>
+    <h1 class="text-3xl font-semibold" v-html="page!.titleHtml" />
+    <p v-if="page!.description" class="mt-2 text-neutral-600">
+      {{ page!.description }}
+    </p>
+    <VitaMarkdown class="mt-6" :html="page!.bodyHtml" />
+  </article>
+</template>

package/template/app/pages/cv.vue

@@ -0,0 +1,34 @@
+<script setup lang="ts">
+/**
+ * The CV page: several sections composed in the order you want them.
+ *
+ * Section order, headings and which sections appear are decided here, not in
+ * the data — exactly as `cv-tex/cv.tex` decides them for the PDF. One line per
+ * section: move a line to move a section, delete it to leave the section out.
+ * A section without entries is not shown, heading included.
+ */
+const profile = useProfile()
+const page = usePage('/cv/')
+
+if (!page) {
+  throw createError({ statusCode: 404, statusMessage: 'No page for /cv/ (expected content/pages/cv.md)', fatal: true })
+}
+
+useHead({
+  title: `${page.title} – ${profile.name}`,
+  meta: [{ name: 'description', content: page.description ?? profile.summary }],
+})
+</script>
+
+<template>
+  <article>
+    <h1 class="text-3xl font-semibold" v-html="page.titleHtml" />
+    <VitaMarkdown class="mt-6" :html="page.bodyHtml" />
+
+    <VitaSection id="employment" title="Employment" />
+    <VitaSection id="education" title="Education" />
+    <VitaSection id="teaching" title="Teaching" />
+    <VitaSection id="supervision" title="Supervised theses" />
+    <VitaSection id="talks" title="Talks" />
+  </article>
+</template>

package/template/app/pages/index.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+/**
+ * The landing page: who you are, then the prose from
+ * `content/pages/index.md`, then a few recent items.
+ *
+ * This file is yours — reorder it, delete parts, add your own markup.
+ */
+const profile = useProfile()
+const page = usePage('/')
+const talks = useSection('talks')
+
+useHead({
+  title: profile.name,
+  meta: [{ name: 'description', content: profile.summary }],
+})
+</script>
+
+<template>
+  <div>
+    <header class="flex flex-wrap items-start gap-6 sm:flex-nowrap">
+      <img
+        v-if="profile.avatar"
+        :src="profile.avatar"
+        alt=""
+        width="128"
+        height="128"
+        class="size-32 shrink-0 rounded-full object-cover ring-1 ring-neutral-200"
+      >
+      <div>
+        <h1 class="text-3xl font-semibold">
+          {{ profile.name }}
+        </h1>
+        <p v-if="profile.title || profile.affiliation" class="text-neutral-600">
+          {{ profile.title }}
+          <template v-if="profile.title && profile.affiliation"> · </template>
+          <template v-if="profile.affiliation">
+            <a v-if="profile.affiliation.url" :href="profile.affiliation.url">{{ profile.affiliation.label }}</a>
+            <template v-else>{{ profile.affiliation.label }}</template>
+          </template>
+        </p>
+        <p v-if="profile.email" class="mt-1 text-sm">
+          <a :href="`mailto:${profile.email}`">{{ profile.email }}</a>
+        </p>
+        <VitaLinks :links="profile.links" class="mt-2 text-sm" />
+      </div>
+    </header>
+
+    <VitaMarkdown v-if="page" class="mt-8" :html="page.bodyHtml" />
+
+    <section v-if="talks.length" class="mt-10">
+      <h2 class="text-xl font-semibold">
+        Recent talks
+      </h2>
+      <VitaSection :entries="talks" :limit="3" class="mt-3" />
+      <p class="mt-3 text-sm">
+        <NuxtLink to="/cv/#talks">
+          All talks →
+        </NuxtLink>
+      </p>
+    </section>
+  </div>
+</template>

package/template/app/pages/publications.vue

@@ -0,0 +1,27 @@
+<script setup lang="ts">
+/**
+ * Prose from `content/pages/publications.md`, then the generated list.
+ *
+ * This page shadows the Markdown catch-all for `/publications/` — the general
+ * escape hatch when a page needs prose *and* components.
+ */
+const profile = useProfile()
+const page = usePage('/publications/')
+
+if (!page) {
+  throw createError({ statusCode: 404, statusMessage: 'No page for /publications/ (expected content/pages/publications.md)', fatal: true })
+}
+
+useHead({
+  title: `${page.title} – ${profile.name}`,
+  meta: [{ name: 'description', content: page.description ?? profile.summary }],
+})
+</script>
+
+<template>
+  <article>
+    <h1 class="text-3xl font-semibold" v-html="page.titleHtml" />
+    <VitaMarkdown class="mt-6" :html="page.bodyHtml" />
+    <VitaPublications class="mt-8" />
+  </article>
+</template>

package/template/content/education.yml

@@ -0,0 +1,18 @@
+- date: { from: 2016, to: 2020 }
+  degree: PhD in Mathematics
+  institution: { name: University of Klagenfurt, url: https://www.aau.at }
+  thesis:
+    title: Cutting down random trees
+    type: Doctoral thesis
+    supervisor: { label: A. Supervisor, url: https://example.org/supervisor }
+
+- date: { from: 2014, to: 2016 }
+  degree: MSc in Mathematics (with distinction)
+  institution: University of Klagenfurt
+  thesis:
+    title: Ascent sequences and their asymptotics
+    type: Master's thesis
+
+- date: { from: 2011, to: 2014 }
+  degree: BSc in Technical Mathematics
+  institution: University of Klagenfurt

package/template/content/employment.yml

@@ -0,0 +1,18 @@
+- date: { from: 2023, to: present }
+  position: Postdoctoral Researcher
+  institution: { name: University of Graz, url: https://www.uni-graz.at }
+  project:
+    title: Asymptotics of random discrete structures
+    funder: FWF
+    grant: P 12345
+    url: https://www.fwf.ac.at
+
+- date: { from: 2020, to: 2023 }
+  position: University Assistant
+  institution: University of Klagenfurt
+
+- date: { from: 2019, to: 2019 }
+  position: Visiting Researcher
+  institution: Uppsala University
+  note: Three-month research stay with the combinatorics group.
+  visibility: cv

package/template/content/pages/cv.md

@@ -0,0 +1,9 @@
+---
+title: Curriculum Vitae
+description: The same data that produces the PDF.
+order: 30
+---
+
+Build the PDF version with `pnpm pdf`. The sections below come from the
+YAML files in `content/`; their order is decided in `app/pages/cv.vue`, and the
+order in the PDF in `cv-tex/cv.tex`.

package/template/content/pages/index.md

@@ -0,0 +1,11 @@
+---
+title: __YAML_NAME__
+order: 0
+---
+
+Replace this page with a few sentences about yourself: it lives in
+`content/pages/index.md`, and the heading above comes from its front matter.
+
+Everything on this site comes from the files in `content/`, and the same data
+produces `cv-tex/cv.pdf`. Add a page by adding a Markdown file; add a CV
+section by adding a YAML file — `pnpm vitakit add section outreach` sets one up.

package/template/content/pages/publications.md

@@ -0,0 +1,8 @@
+---
+title: Publications
+description: Grouped by status, generated from a single BibTeX file.
+order: 20
+---
+
+Preprints are on [arXiv](https://arxiv.org/a/doe_j_1). The list below is
+generated from `content/publications.bib` at build time.

package/template/content/pages/research.md

@@ -0,0 +1,32 @@
+---
+title: Research
+description: Analytic combinatorics and random discrete structures.
+order: 10
+---
+
+<figure class="figure-right">
+  <img src="/img/tree.svg" alt="A simulated random tree" width="240" height="140">
+  <figcaption>A random tree on eight nodes.</figcaption>
+</figure>
+
+My work concerns the asymptotic behaviour of large random trees. A simple
+family is described by the equation $T(z) = z\,\phi(T(z))$, whose singular
+expansion determines almost everything about the limit shape:
+
+$$
+T(z) = \tau - \gamma \sqrt{1 - z/\rho} + O(1 - z/\rho).
+$$
+
+From this, the expected height of a random tree with $n$ nodes satisfies
+
+$$
+\mathbb{E}[H_n] \sim c \sqrt{n}, \qquad n \to \infty.
+$$
+
+## Tools
+
+| Technique | Used for |
+| --- | --- |
+| Singularity analysis | asymptotics of coefficients |
+| Analytic combinatorics in several variables | multivariate limit laws |
+| Simulation | checking conjectures before proving them |

package/template/content/profile.yml

@@ -0,0 +1,33 @@
+# You, and the shape of your site. The only file that is not a CV section.
+name: __YAML_NAME__
+title: __YAML_TITLE__
+affiliation:
+  name: __YAML_AFFILIATION__
+email: __YAML_EMAIL__
+
+# Where the site is published. Only the PDF needs it, to link files on the
+# site such as /slides/talk.pdf; delete the # once you know the address.
+# url: https://yourname.github.io/
+
+# Portrait, from public/. Delete the line if you would rather not have one.
+avatar: /img/portrait.svg
+
+links:
+  - { label: ORCID, url: https://orcid.org/0000-0002-1825-0097 }
+  # - { label: GitHub, url: https://github.com/yourname }
+  # - { label: arXiv, url: https://arxiv.org/a/yourname }
+
+# One or two sentences for search engines and link previews. What visitors
+# read is content/pages/index.md, not this.
+summary: __YAML_SUMMARY__
+
+# Navigation, in the order it should appear. Adding a page does not change
+# this list: the wording and the order are yours.
+nav:
+  - { label: About, to: / }
+  - { label: Research, to: /research/ }
+  - { label: Publications, to: /publications/ }
+  - { label: CV, to: /cv/ }
+
+# Inline Markdown, shown quietly at the bottom of every page.
+footer: Built with [vitakit](https://github.com/anja-codes/vitakit).

package/template/content/publications.bib

@@ -0,0 +1,43 @@
+% Your publication list. Export it from Zotero, JabRef or arXiv and replace the
+% examples below.
+%
+% The non-standard `status` field decides the grouping on /publications/ and in
+% the PDF: published, accepted, preprint, software or other; without it, an
+% entry is published. To change the groups:
+%     pnpm vitakit customize publications    # -> schemas/publications.ts
+%
+% `doi`, `arxiv`, `mrnumber` and `zbl` become links; `eprint` with
+% `eprinttype = {arxiv}` (or `archivePrefix`) works as `arxiv` does, so exports
+% from Zotero, JabRef or arXiv need no editing. Mathematics in titles works:
+% write $...$ as usual.
+%
+% The website formats this list with a CSL style. To change it:
+%     pnpm vitakit eject publications.csl    # -> content/publications.csl
+% or save any CSL style under that name.
+
+@article{example-published,
+  author  = {Doe, Jane and Roe, Richard},
+  title   = {The shape of large random $k$-ary trees},
+  journal = {Random Structures \& Algorithms},
+  volume  = {64},
+  pages   = {201--240},
+  year    = {2024},
+  doi     = {10.5555/12345678},
+  status  = {published},
+}
+
+@misc{example-preprint,
+  author = {Doe, Jane},
+  title  = {Sharp bounds for ascent sequences of height $h$},
+  year   = {2025},
+  arxiv  = {2501.01234},
+  status = {preprint},
+}
+
+@software{example-software,
+  author = {Doe, Jane},
+  title  = {treetools: utilities for random tree simulation},
+  url    = {https://github.com/yourname/treetools},
+  year   = {2025},
+  status = {software},
+}

package/template/content/supervision.yml

@@ -0,0 +1,12 @@
+- date: 2025
+  student: A. Student
+  ongoing: true          # still in progress
+  title: Simulating random trees with $n$ nodes
+  degree: Master's thesis
+  institution: University of Graz
+
+- date: 2024
+  student: B. Student
+  title: Ascent sequences in combinatorics
+  degree: Bachelor's thesis
+  institution: University of Graz

package/template/content/talks.yml

@@ -0,0 +1,17 @@
+- date: 2025-06-16
+  title: The shape of large random $k$-ary trees
+  event: AofA 2025
+  location: Bath, UK
+  kind: invited
+
+- date: 2024-09-03
+  title: Cutting down trees, one leaf at a time
+  event: Austrian Mathematical Society Meeting
+  location: Graz, Austria
+  kind: contributed
+
+- date: 2024-03-12
+  title: What is a random tree?
+  event: Mathematics for schools
+  location: Klagenfurt, Austria
+  kind: outreach