Project Manual Guide

Introduction

This guide provides a comprehensive overview of the project, its structure, and how to contribute.

Project Structure

The project follows a standard Hugo blog structure. Key directories include:

• content/posts/: Contains all blog posts written in Markdown.
• layouts/: Contains custom HTML layouts for the blog.
• assets/css/: Contains custom CSS files for styling.
• hugo.yaml: Main configuration file for the Hugo site.

How to Create a New Blog Post

1. Navigate to the content/posts/ directory.
2. Create a new Markdown file (e.g., my-new-post.md).
3. Add the following front matter to the top of the file:

   ---
   title: "Your Post Title"
   date: 2025-10-28T20:00:00-04:00
   draft: false
   ---
   

   • title: The title of your blog post.
   • date: The publication date and time.
   • draft: Set to true to keep the post as a draft, false to publish.
4. Write your content below the front matter using Markdown syntax.

How to Run the Project Locally

1. Ensure you have Hugo installed.
2. Open your terminal in the project’s root directory.
3. Run the command: hugo server -D
4. Open your browser and navigate to http://localhost:1313/ to view the site.

Contributing

Contributions are welcome! Please follow these guidelines:

• Fork the repository.
• Create a new branch for your features or bug fixes.
• Submit a pull request with a clear description of your changes.