@anja.codes/create-vitakit 0.2.0 → 0.3.0

package/README.md

@@ -34,7 +34,8 @@ pnpm create @anja.codes/vitakit --deployment-help
 - **GitLab Pages:** private source supported on Free; uses GitLab CI/CD.
 - **Codeberg Pages:** uses git-pages and Forgejo Actions. Hosted CI requires public,
   freely licensed source; use your own runner for sensitive CV source.
-- **SSH/rsync:** needs existing web space; the preset uses Forgejo Actions.
+- **SSH/rsync:** needs existing web space; uses GitHub Actions via
+  `.github/workflows/rsync.yml`.
 
 Choosing to decide later adds no workflows and leaves all hosting options open.
 

package/deployments.mjs

@@ -87,17 +87,17 @@ export const DEPLOYMENTS = {
     details: {
       URL: 'Your server’s URL, e.g. https://www.example.edu/~username/.',
       Needs: 'SSH/rsync access and a writable web directory; not SFTP-only hosting.',
-      CI: 'Forgejo Actions, not GitHub Actions.',
+      CI: 'GitHub Actions.',
     },
     setup: [
-      'Open .forgejo/workflows/deploy.yml.',
+      'Open .github/workflows/rsync.yml.',
       'Set the SSH user, host, destination path and NUXT_APP_BASE_URL.',
-      'Add SSH_DEPLOY_KEY as a Forgejo Actions repository secret.',
+      'Add SSH_DEPLOY_KEY as a GitHub Actions repository secret.',
       'Configure SSH host-key verification; the template currently disables it.',
       'Commit pnpm-lock.yaml and push to main.',
     ],
     notes: ['Check the destination: rsync --delete removes files absent from the build.'],
-    files: ['.forgejo/workflows/deploy.yml'],
+    files: ['.github/workflows/rsync.yml'],
   },
   'none': {
     label: 'Decide later / deploy manually',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anja.codes/create-vitakit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Scaffold a vitakit project: an academic website and a LaTeX CV from one set of files.",
   "license": "MIT",
   "keywords": [

package/template/{_forgejo/workflows/deploy.yml → _github/workflows/rsync.yml}

@@ -2,28 +2,33 @@
 #
 # Secret: SSH_DEPLOY_KEY (private key with write access to the target).
 # Adjust NUXT_APP_BASE_URL and the rsync target below.
+name: Deploy (SSH/rsync)
+
 on:
   push:
     branches: [main]
   workflow_dispatch:
 
+permissions:
+  contents: read
+
 jobs:
   deploy:
     runs-on: ubuntu-latest
     env:
       NUXT_APP_BASE_URL: /
     steps:
-      - uses: https://github.com/actions/checkout@v7
-      - run: apt update && apt install -y rsync
-      - uses: https://github.com/pnpm/action-setup@v6
+      - uses: actions/checkout@v7
+      - run: sudo apt-get update && sudo apt-get install -y rsync
+      - uses: pnpm/action-setup@v6
       # The runner image may ship an older Node than Nuxt requires.
-      - uses: https://github.com/actions/setup-node@v7
+      - uses: actions/setup-node@v7
         with:
           node-version: 22
           cache: pnpm
       - run: pnpm install --frozen-lockfile
       - run: pnpm check
-      - uses: https://github.com/webfactory/ssh-agent@v0.9.0
+      - uses: webfactory/ssh-agent@v0.9.0
         with:
           ssh-private-key: ${{ secrets.SSH_DEPLOY_KEY }}
       - run: |

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

@@ -52,9 +52,15 @@ a {
 .vita-publications__group + .vita-publications__group {
   @apply mt-8;
 }
+.vita-publications__title {
+  @apply text-xl font-semibold;
+}
 .vita-publications__heading {
   @apply text-xl font-semibold;
 }
+.vita-publications__title ~ .vita-publications__group .vita-publications__heading {
+  @apply mt-4 text-base;
+}
 .vita-bib {
   @apply mt-3 list-decimal space-y-3 pl-6;
 }

package/template/app/pages/index.vue

@@ -1,13 +1,15 @@
 <script setup lang="ts">
 /**
  * The landing page: who you are, then the prose from
- * `content/pages/index.md`, then a few recent items.
+ * `content/pages/index.md`, then a few recent items: the list `recent` of
+ * `content/publication-lists.yml`, and the newest talks.
  *
  * This file is yours — reorder it, delete parts, add your own markup.
  */
 const profile = useProfile()
 const page = usePage('/')
 const talks = useSection('talks')
+const publications = usePublicationList('recent')
 
 useHead({
   title: profile.name,
@@ -47,6 +49,18 @@ useHead({
 
     <VitaMarkdown v-if="page" class="mt-8" :html="page.bodyHtml" />
 
+    <section v-if="publications.count" class="mt-10">
+      <h2 class="text-xl font-semibold">
+        Recent publications
+      </h2>
+      <VitaPublications list="recent" class="mt-3" />
+      <p class="mt-3 text-sm">
+        <NuxtLink to="/publications/">
+          All publications →
+        </NuxtLink>
+      </p>
+    </section>
+
     <section v-if="talks.length" class="mt-10">
       <h2 class="text-xl font-semibold">
         Recent talks

package/template/app/pages/publications.vue

@@ -22,6 +22,6 @@ useHead({
   <article>
     <h1 class="text-3xl font-semibold" v-html="page.titleHtml" />
     <VitaMarkdown class="mt-6" :html="page.bodyHtml" />
-    <VitaPublications class="mt-8" />
+    <VitaPublications list="all" class="mt-8" />
   </article>
 </template>

package/template/content/publication-lists.yml

@@ -0,0 +1,23 @@
+# Publication lists: which publications of publications.bib a list shows,
+# in what order and in which groups. A page shows one with
+#   <VitaPublications list="recent" title="Recent publications" />
+# and a PDF with
+#   \vitapublications[Recent publications]{recent}
+#
+# Settings, all optional:
+#   where:    { status: preprint }, { keywords: selected }, { year: 2024 } --
+#             fields of the entries in publications.bib; [a, b] means a or b
+#   keys:     [doe2024, roe2023] -- exactly these, in this order
+#   since, until: years
+#   sort:     date (newest first), year, title, source (as in publications.bib),
+#             or a field; order: asc or desc
+#   limit:    at most this many
+#   groupBy:  status, year or a field; otherLabel: the heading for the entries
+#             without it (Other)
+# `vitakit explain publications` shows what each list contains and where.
+
+all:
+  groupBy: status
+
+recent:
+  limit: 3

package/template/content/publications.bib

@@ -1,9 +1,11 @@
 % 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:
+% The non-standard `status` field says what an entry is: published, accepted,
+% preprint, software or other; without it, an entry is published. Which
+% publications are shown where -- grouped by status on /publications/, the
+% newest on the home page -- is decided in content/publication-lists.yml.
+% To change the statuses and their headings:
 %     pnpm vitakit customize publications    # -> schemas/publications.ts
 %
 % `doi`, `arxiv`, `mrnumber` and `zbl` become links; `eprint` with

package/template/cv-tex/cv.tex

@@ -30,8 +30,7 @@
 \vitasection[Education]{education}
 \vitasection[Teaching]{teaching}
 
-\section{Publications}
-\vitainput{publications}
+\vitapublications[Publications]{all}
 
 \vitasection[Supervised theses]{supervision}
 \vitasection[Selected talks]{talks}

package/template/package.json.template

@@ -16,7 +16,7 @@
     "pdf": "vitakit pdf"
   },
   "dependencies": {
-    "@anja.codes/vitakit": "^0.2.0",
+    "@anja.codes/vitakit": "^0.3.0",
     "@nuxt/fonts": "^0.14.0",
     "@tailwindcss/vite": "^4.3.3",
     "nuxt": "^4.5.2",