5da77a35cc
- Convert 20+ markdown guides to Starlight documentation site - Implement organized navigation with 4 main sections: * 3 Tutorials (learning-oriented) * 13 How-To Guides (task-oriented) * 4 Explanations (understanding-oriented) * Quick Reference (information-oriented) - Add custom CSS for enhanced conversational feel - Preserve original voice and tone while improving structure - Create responsive design with proper mobile support - Include organized sidebar with logical groupings and badges - Ready for deployment at localhost:4321 Content migrated from '/home/user/claude/how-to-ai/' with proper frontmatter conversion and Starlight formatting.
99 lines
3.1 KiB
JavaScript
99 lines
3.1 KiB
JavaScript
// @ts-check
|
|
import { defineConfig } from 'astro/config';
|
|
import starlight from '@astrojs/starlight';
|
|
|
|
// https://astro.build/config
|
|
export default defineConfig({
|
|
integrations: [
|
|
starlight({
|
|
title: 'How to Talk to Claude',
|
|
description: 'A comprehensive guide to AI collaboration skills - for humans',
|
|
social: [
|
|
{ icon: 'github', label: 'GitHub', href: 'https://github.com/your-username/how-to-talk-to-claude' }
|
|
],
|
|
sidebar: [
|
|
{
|
|
label: 'Start Here',
|
|
items: [
|
|
{ label: 'Introduction', link: '/start/introduction/' },
|
|
],
|
|
},
|
|
{
|
|
label: 'Tutorials',
|
|
badge: '3 guides',
|
|
collapsed: false,
|
|
items: [
|
|
{ label: 'First Conversation', link: '/tutorials/first-conversation/', badge: 'New to AI?' },
|
|
{ label: 'Messy Ideas to Results', link: '/tutorials/messy-ideas/' },
|
|
{ label: 'Creative Collaboration', link: '/tutorials/creative-project/' },
|
|
],
|
|
},
|
|
{
|
|
label: 'How-To Guides',
|
|
badge: '13 guides',
|
|
collapsed: true,
|
|
items: [
|
|
{
|
|
label: 'Communication & Style',
|
|
collapsed: true,
|
|
items: [
|
|
{ label: 'Ask When Uncertain', link: '/how-to/ask-when-uncertain/' },
|
|
{ label: 'Match Your Tone', link: '/how-to/match-tone-style/' },
|
|
{ label: 'Fix Misunderstandings', link: '/how-to/fix-misunderstandings/' },
|
|
],
|
|
},
|
|
{
|
|
label: 'Information & Research',
|
|
collapsed: true,
|
|
items: [
|
|
{ label: 'Fact-Check Answers', link: '/how-to/fact-check/' },
|
|
{ label: 'Avoid Walls of Text', link: '/how-to/avoid-walls-of-text/' },
|
|
{ label: 'Get Useful Sources', link: '/how-to/get-useful-sources/' },
|
|
{ label: 'Research Unfamiliar Topics', link: '/how-to/research-unfamiliar-topics/' },
|
|
{ label: 'Organize Information', link: '/how-to/organize-information/' },
|
|
],
|
|
},
|
|
{
|
|
label: 'Creative & Personal Work',
|
|
collapsed: true,
|
|
items: [
|
|
{ label: 'Brainstorm Comfortably', link: '/how-to/brainstorm-comfortably/' },
|
|
{ label: 'Get Helpful Feedback', link: '/how-to/get-helpful-feedback/' },
|
|
{ label: 'Personal Decisions', link: '/how-to/personal-decisions/' },
|
|
{ label: 'Maintain Your Voice', link: '/how-to/maintain-voice-writing/' },
|
|
],
|
|
},
|
|
{
|
|
label: 'Advanced Techniques',
|
|
collapsed: true,
|
|
items: [
|
|
{ label: 'Persona Prompts', link: '/how-to/persona-prompts/' },
|
|
],
|
|
},
|
|
],
|
|
},
|
|
{
|
|
label: 'Explanations',
|
|
badge: '4 guides',
|
|
collapsed: true,
|
|
items: [
|
|
{ label: 'Conversations vs Commands', link: '/explanations/conversations-vs-commands/' },
|
|
{ label: 'Psychology of Collaboration', link: '/explanations/psychology-collaboration/' },
|
|
{ label: 'How Claude Thinks', link: '/explanations/how-claude-thinks/' },
|
|
{ label: 'Making AI Work for Life', link: '/explanations/making-ai-work-for-life/' },
|
|
],
|
|
},
|
|
{
|
|
label: 'Quick Reference',
|
|
items: [
|
|
{ label: 'Conversation Starters', link: '/reference/' },
|
|
],
|
|
},
|
|
],
|
|
customCss: [
|
|
'./src/styles/custom.css',
|
|
],
|
|
}),
|
|
],
|
|
});
|