Getting Started with Your New Blog

Welcome to your new blog powered by merox-erudite! This guide will help you get started with setting up and customizing your blog.

Initial Setup

1. Configure Your Site

Edit src/consts.ts to customize your site information:

1
export const SITE: Site = {
2
  title: 'Your Blog Name',
3
  description: 'Your blog description',
4
  href: 'https://yourdomain.com',
5
  author: 'your-author-id',
6
  // ...
7
}

Customize your navigation links in src/consts.ts:

1
export const NAV_LINKS: SocialLink[] = [
2
  { href: '/blog', label: 'Blog' },
3
  { href: '/about', label: 'About' },
4
  // Add more links as needed
5
]

Update your social media links:

1
export const SOCIAL_LINKS: SocialLink[] = [
2
  { href: 'https://github.com/username', label: 'GitHub' },
3
  { href: 'https://twitter.com/username', label: 'Twitter' },
4
  { href: 'mailto:your@email.com', label: 'Email' },
5
]

Creating Content

Blog Posts

Create new blog posts in src/content/blog/:

Create a folder for your post: src/content/blog/my-post/
Add an index.mdx file with frontmatter:

1
---
2
title: "My First Post"
3
description: "A brief description"
4
date: 2025-01-16
5
tags: ["tag1", "tag2"]
6
draft: false
7
---

Write your content using Markdown or MDX

Tip

Pro Tip: You can use MDX components like Callout, Code blocks, and more in your posts!

Author Profiles

Create author profiles in src/content/authors/:

1
---
2
name: 'Your Name'
3
avatar: 'https://gravatar.com/avatar/...'
4
bio: 'Your bio'
5
github: 'https://github.com/username'
6
---

Customization

Colors

Edit src/styles/global.css to customize your color scheme:

1
:root {
2
  --primary: hsl(214 95% 52%);
3
  /* Customize other colors */
4
}

Homepage Experience

Edit src/pages/index.astro to customize your experience timeline:

1
const experience: ExperienceItem[] = [
2
  {
3
    role: 'Your Role',
4
    company: 'Company Name',
5
    period: '2020 - Present',
6
    current: true,
7
    icon: 'lucide:briefcase',
8
    key: 'Your achievements and responsibilities'
9
  },
10
]

Optional Features

Sign up for Brevo
Get your API key

Add to .env:

1
BREVO_API_KEY=your-api-key
2
BREVO_LIST_ID=your-list-id

Disqus Comments

Create a Disqus account
Add to .env:
```
1
PUBLIC_DISQUS_SHORTNAME=your-shortname
```

Analytics

Add Google Analytics or Umami:

1
PUBLIC_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX
2
PUBLIC_UMAMI_WEBSITE_ID=your-umami-id

Next Steps

Delete example content - Remove hello-world and getting-started posts
Update About page - Customize src/pages/about.astro
Update Privacy & Terms - Review and customize legal pages
Add your content - Start writing your blog posts!

Resources

Happy blogging! 🎉