/blog

My personal blog posts! πŸ“‹

Primary LanguageVue

πŸ“ Blog

Welcome to my personal blog! This project is a reflection of my thoughts, ideas, and experiences. Please note that this is a personal project, and each post is written and published by me aloneβ€”without review by any team. Some of the content may extend beyond my formal studies, but driven by a passion for learning and a lifelong learner mindset, I write about what interests or fascinates me.

🌟 Features

  • Responsive Design: Optimized for all devices to ensure a great user experience.
  • Markdown Support: Write blog posts effortlessly using Markdown.
  • Tagging & Categories: Organize posts with tags and categories for easy navigation.
  • Search Functionality: Quickly find posts with a powerful search feature.
  • Commenting System: Engage with readers through a built-in commenting feature.
  • SEO Optimized: Posts are optimized for better visibility on search engines.

πŸš€ Getting Started

Prerequisites

Ensure you have the following installed before starting:

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/your-blog-repo.git
  2. Navigate to the project directory:

    cd your-blog-repo
  3. Install PHP dependencies:

    composer install
  4. Install Node.js dependencies:

    npm install

    or

    yarn install
  5. Create a copy of the .env file:

    cp .env.example .env
  6. Generate the application key:

    php artisan key:generate
  7. Set up your database in the .env file, then run migrations:

    php artisan migrate
  8. Install and build front-end assets:

    npm run build

    or

    yarn build

Running the Blog

To start the local development server:

php artisan serve

Visit http://localhost:8000 to view your blog in the browser.

πŸ“‚ Project Structure

Here’s an overview of the project structure:

β”œβ”€β”€ app/                # Application code
β”œβ”€β”€ config/             # Configuration files
β”œβ”€β”€ database/           # Migrations and seeders
β”œβ”€β”€ public/             # Public assets (images, JS, CSS)
β”œβ”€β”€ resources/          # Views, Blade templates, and assets
β”‚   β”œβ”€β”€ css/            # CSS stylesheets
β”‚   β”œβ”€β”€ js/             # JavaScript files
β”‚   β”œβ”€β”€ views/          # Blade templates
β”œβ”€β”€ routes/             # Application routes
β”œβ”€β”€ storage/            # File storage
β”œβ”€β”€ tests/              # Unit and feature tests
β”œβ”€β”€ .env                # Environment configuration
β”œβ”€β”€ .gitignore          # Git ignore file
β”œβ”€β”€ composer.json       # PHP dependencies and project metadata
β”œβ”€β”€ package.json        # Node.js dependencies and scripts
└── README.md           # Project documentation

🎨 Customization

Feel free to customize the blog’s appearance and functionality. Modify the Blade templates, CSS, and JavaScript files in the resources directory to match your style.

🀝 Contributing

Contributions are welcome! If you have suggestions or improvements, please open an issue or submit a pull request.

πŸ›‘οΈ License

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

πŸ“§ Contact

If you have any questions or suggestions, feel free to reach out:

Email: vireakrothpun@gmail.com

LinkedIn: VireakRoth Pun

Facebook: virak.roth.545