Skip to content

mertssmnoglu/mertssmnoglu.github.io

Repository files navigation

Mert Şişmanoğlu Personal Website

Built with Astro License: MIT

Based on the Astro blog template, this SEO-optimized personal blog website is built with Astro. It serves as the blog for Mert Şişmanoğlu, featuring blog posts written in Markdown and MDX.

Tech Stack

  • Framework: Astro
  • Styling: Tailwind CSS
  • Content: Markdown/MDX
  • Language: TypeScript
  • Package Manager: pnpm
  • Code Quality: Biome
  • Deployment: GitHub Pages

Prerequisites

Before you begin, ensure you have the following installed:

  • Node.js: Version 22 (LTS) or higher
  • pnpm: Package manager (recommended over npm/yarn)

You can check your Node.js version:

node --version

If you need to install Node.js 22, you can use nvm:

nvm install 22
nvm use 22

To install pnpm:

npm install -g pnpm@latest-10

Getting Started

  1. Clone the repository

    git clone https://github.com/mertssmnoglu/mertssmnoglu.github.io.git
    cd mertssmnoglu.github.io
  2. Install dependencies

    pnpm install
  3. Start the development server

    pnpm dev
  4. Open your browser Navigate to http://localhost:4321 to see the website.

Available Scripts

Command Description
pnpm dev Start development server at localhost:4321
pnpm start Start the production server locally
pnpm build Build the production site to ./dist/
pnpm preview Preview your build locally before deploying
pnpm lint Run Biome linter to check code quality
pnpm lint-fix Run Biome linter and fix issues automatically
pnpm format Format code with Biome
pnpm format-check Check code formatting without making changes

Writing Blog Posts

Blog posts are stored in src/content/blog/ and written in Markdown or MDX format.

Creating a New Post

  1. Create a new .md or .mdx file in src/content/blog/
  2. Add frontmatter at the top of the file:
---
title: "Your Post Title"
description: "A brief description of your post"
pubDate: "2025-01-15"
heroImage: "/blog-placeholder-1.jpg"
---

Your content goes here...

Frontmatter Fields

  • title: The title of your blog post
  • description: A brief description for SEO and previews
  • pubDate: Publication date in YYYY-MM-DD format
  • heroImage: Path to hero image (optional)
  • tags: Array of tags for categorization (optional)

Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add some amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.