@levino/shipyard-blog

Blog plugin for shipyard, a general-purpose page builder for Astro.

Installation

npm install @levino/shipyard-blog

Peer Dependencies

• astro ^5.15

Basic Usage

Astro Integration

// astro.config.ts
import shipyardBlog from '@levino/shipyard-blog'

export default defineConfig({
  integrations: [
    shipyardBlog({
      blogSidebarCount: 5,
      blogSidebarTitle: 'Recent posts',
      postsPerPage: 10,
      editUrl: 'https://github.com/user/repo/edit/main/blog',
      showLastUpdateTime: true,
      showLastUpdateAuthor: true,
    }),
  ],
})

Content Collection Schema

// src/content.config.ts (Astro 5+)
import { defineCollection } from 'astro:content'
import { blogSchema } from '@levino/shipyard-blog'

const blog = defineCollection({
  schema: blogSchema,
})

export const collections = { blog }

Routes

The integration automatically injects these routes:

• /blog - Blog index
• /blog/page/[page] - Paginated blog index
• /blog/[...slug] - Individual blog posts

With i18n enabled, routes are prefixed with [locale].

Documentation

For complete documentation and examples, visit shipyard.levinkeller.de.

License

MIT