A clean and simple blog built with Jekyll and GitHub Pages.
.
├── _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
- Ruby (version 2.7 or higher)
- Bundler (
gem install bundler)
-
Clone this repository
-
Install dependencies:
bundle install
-
Run the local server:
bundle exec jekyll serve -
Open your browser to
http://localhost:4000
- Create a new file in
_posts/directory - Name it using the format:
YYYY-MM-DD-title-of-post.md - Add front matter at the top:
--- layout: post title: "Your Post Title" date: YYYY-MM-DD HH:MM:SS -0000 categories: [category1, category2] ---
- Write your content in Markdown below the front matter
- Commit and push to publish
Edit _config.yml to customize:
- Site title and description
- Email and social links
- Theme settings
- Build options
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
This project is open source and available under the MIT License.
I have successfully added a React-based tools section to your GitHub Pages site.
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 excludetools-srcfrom Jekyll processing.
-
Create the Tool Component:
- Create a new file in
tools-src/src/tools/, e.g.,MyNewTool.jsx. - Implement your tool as a React component.
- Create a new file in
-
Register the Tool:
- Open
tools-src/src/App.jsx. - Import your component.
- Add it to the
toolsarray in theLayoutcomponent: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 theAppcomponent:<Routes> <Route path="/" element={<Resizer />} /> <Route path="/my-new-tool" element={<MyNewTool />} /> {/* Add this */} </Routes>
- Open
-
Build the React App:
- Open a terminal in
tools-src/. - Run
npm run build. - This will update the contents of the
tools/directory.
- Open a terminal in
-
Push to GitHub:
- Commit all changes (including
tools-srcandtools). - Push to your repository.
- GitHub Pages will serve the new version at
your-site.github.io/tools/.
- Commit all changes (including
- 1024x1024 Resizer: A browser-based image resizer and cropper.