gr-apollo/docs/astro.config.mjs
Ryan Malloy 9dc52d1a5b Docs: replace default favicon, add git icon, fix Mermaid direction
- Favicon: MSFN antenna dish with signal arcs (NASA blue/red, dark mode)
- Social icon: generic git-branch replacing GitHub-specific icon
- Mermaid signal chain diagram: flowchart TB for vertical readability
- Add astro-icon (with Lucide icons) and astro-opengraph-images packages
2026-02-21 09:10:07 -07:00

68 lines
2.3 KiB
JavaScript

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
import icon from 'astro-icon';
import rehypeMermaid from 'rehype-mermaid';
// astro-opengraph-images installed but needs font setup:
// import astroOpenGraphImages, { presets } from 'astro-opengraph-images';
export default defineConfig({
integrations: [
icon(),
starlight({
title: 'gr-apollo',
description: 'Apollo Unified S-Band decoder for GNU Radio 3.10+',
sidebar: [
{
label: 'Getting Started',
items: [
{ label: 'Introduction', slug: 'getting-started/introduction' },
{ label: 'Installation', slug: 'getting-started/installation' },
{ label: 'Quick Start', slug: 'getting-started/quick-start' },
],
},
{
label: 'Understanding Apollo USB',
items: [
{ label: 'Signal Architecture', slug: 'explanation/signal-architecture' },
{ label: 'PCM Frame Structure', slug: 'explanation/pcm-frames' },
{ label: 'Virtual AGC Integration', slug: 'explanation/virtual-agc' },
],
},
{
label: 'How-To Guides',
items: [
{ label: 'Tune Demodulator Parameters', slug: 'guides/tuning-parameters' },
{ label: 'Generate Test Signals', slug: 'guides/test-signals' },
{ label: 'Decode Voice Audio', slug: 'guides/voice-audio' },
{ label: 'Connect to Virtual AGC', slug: 'guides/agc-bridge' },
{ label: 'Work with PCM Telemetry', slug: 'guides/pcm-telemetry' },
],
},
{
label: 'Reference',
items: [
{ label: 'Block Reference', slug: 'reference/blocks' },
{ label: 'Constants & Parameters', slug: 'reference/constants' },
{ label: 'Protocol Specification', slug: 'reference/protocol' },
],
},
],
editLink: {
baseUrl: 'https://github.com/rpm/gr-apollo/edit/main/docs/',
},
components: {
Head: './src/components/Head.astro',
SocialIcons: './src/components/SocialIcons.astro',
},
}),
],
markdown: {
rehypePlugins: [
[rehypeMermaid, { strategy: 'pre-mermaid' }],
],
},
devToolbar: { enabled: false },
});