Skip to content

codegamc/codegamc.github.io

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Pages Blog

A clean and simple blog built with Jekyll and GitHub Pages.

Structure

.
├── _config.yml          # Jekyll configuration
├── _posts/              # Blog posts go here
├── _layouts/            # HTML templates
│   ├── default.html     # Default layout
│   └── post.html        # Blog post layout
├── _includes/           # Reusable components
├── assets/              # Static assets
│   ├── css/             # Stylesheets
│   └── images/          # Images
├── index.md             # Home page
├── about.md             # About page
├── Gemfile              # Ruby dependencies
└── README.md            # This file

Local Development

Prerequisites

  • Ruby (version 2.7 or higher)
  • Bundler (gem install bundler)

Setup

  1. Clone this repository

  2. Install dependencies:

    bundle install
  3. Run the local server:

    bundle exec jekyll serve
  4. Open your browser to http://localhost:4000

Creating Blog Posts

  1. Create a new file in _posts/ directory
  2. Name it using the format: YYYY-MM-DD-title-of-post.md
  3. Add front matter at the top:
    ---
    layout: post
    title: "Your Post Title"
    date: YYYY-MM-DD HH:MM:SS -0000
    categories: [category1, category2]
    ---
  4. Write your content in Markdown below the front matter
  5. Commit and push to publish

Configuration

Edit _config.yml to customize:

  • Site title and description
  • Email and social links
  • Theme settings
  • Build options

Deployment

This site is automatically deployed to GitHub Pages when you push to the main branch.

Your site will be available at: https://yourusername.github.io

Resources

License

This project is open source and available under the MIT License.


React Tools Setup

I have successfully added a React-based tools section to your GitHub Pages site.

Architecture

  • tools-src/: This directory contains the source code for your React application. It is a standard Vite + React project.
  • tools/: This directory contains the built static files. Do not edit files here directly. They are generated by the build process.
  • _config.yml: Updated to exclude tools-src from Jekyll processing.

How to Add New Tools

  1. Create the Tool Component:

    • Create a new file in tools-src/src/tools/, e.g., MyNewTool.jsx.
    • Implement your tool as a React component.
  2. Register the Tool:

    • Open tools-src/src/App.jsx.
    • Import your component.
    • Add it to the tools array in the Layout component:
      const tools = [
        { path: '/', name: 'Resizer', icon: ImageIcon },
        { path: '/my-new-tool', name: 'My New Tool', icon: Wrench }, // Add this
      ];
    • Add a <Route> for it in the App component:
      <Routes>
        <Route path="/" element={<Resizer />} />
        <Route path="/my-new-tool" element={<MyNewTool />} /> {/* Add this */}
      </Routes>

How to Deploy

  1. Build the React App:

    • Open a terminal in tools-src/.
    • Run npm run build.
    • This will update the contents of the tools/ directory.
  2. Push to GitHub:

    • Commit all changes (including tools-src and tools).
    • Push to your repository.
    • GitHub Pages will serve the new version at your-site.github.io/tools/.

Current Tools

  • 1024x1024 Resizer: A browser-based image resizer and cropper.

About

My personal bog

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •