Tegami

Overview

@fumapress/tegami connects Tegami releases to a Fumapress changelog page.

When you apply a Tegami draft, fumapressPlugin writes MDX release notes into your content directory. changelogPlugin renders those entries on a single index page (/changelog by default) with package filters, date range, search, and load-more pagination.

Installation

npm i @fumapress/tegami tegami

Import the CSS preset:

src/app.css

@import "tailwindcss";
@import "fumadocs-ui/css/neutral.css";
@import "fumadocs-ui/css/preset.css";
@import "fumapress/css/preset.css";
@import "@fumapress/tegami/css/preset.css";

Add fumapressPlugin() into your Tegami config:

tegami.config.ts

import { tegami } from "tegami";
import { fumapressPlugin } from "@fumapress/tegami/tegami";

export default tegami({
  plugins: [
    fumapressPlugin({
      dir: "content/changelog",
    }),
  ],
});

Fumadocs MDX

Create a changelog collection with the Tegami schemas:

source.config.ts

import { defineDocs } from "fumadocs-mdx/config";
import { changelogMetaSchema, changelogPageSchema } from "@fumapress/tegami/schema";

export const changelog = defineDocs({
  dir: "content/changelog",
  docs: {
    async: true,
    schema: changelogPageSchema,
    postprocess: {
      includeProcessedMarkdown: true,
    },
  },
  meta: {
    schema: changelogMetaSchema,
  },
});

press.config.tsx

import { defineConfig } from "fumapress";
import { changelog, docs } from "./.source/server";
import { changelogPlugin } from "@fumapress/tegami";

export default defineConfig({
  content: {
    docs: docs.toFumadocsSource(),
    changelog: changelog.toFumadocsSource({
      baseDir: "changelog",
    }),
  },
})
  .plugins(changelogPlugin());

By default, pages from the changelog content source are included. Override with isChangelog() if needed:

press.config.tsx

import { defineConfig } from "fumapress";
import { changelogPlugin } from "@fumapress/tegami";

export default defineConfig({
  // ...
}).plugins(
  changelogPlugin({
    isChangelog: (page) => page.type === "changelog",
  }),
);

Options

`paths`

Override the index pathname (default /changelog). Set to false to skip creating the index route.

press.config.tsx

import { defineConfig } from "fumapress";
import { changelogPlugin } from "@fumapress/tegami";

export default defineConfig({
  // ...
}).plugins(
  changelogPlugin({
    paths: {
      index: "/releases",
    },
  }),
);

`layouts`

Override the shared layout or index page renderer:

press.config.tsx

import { defineConfig } from "fumapress";
import {
  changelogPlugin,
  createChangelogIndexPage,
  createChangelogLayout,
} from "@fumapress/tegami";
import { createHomeLayout } from "fumapress/layouts/home";

export default defineConfig({
  // ...
}).plugins(
  changelogPlugin({
    layouts: {
      layout: createHomeLayout(),
      index: createChangelogIndexPage({
        heading: "Releases",
        description: "What shipped recently.",
        pageSize: 10,
      }),
    },
  }),
);

Tegami

Overview

Installation

Fumadocs MDX

Other Content Sources

Options

`paths`

`layouts`

On this page