Vucius.github.io

This repository contains the source code for the personal website and Jekyll blog of Peter Vucius (lucius3451@gmail.com), hosted via GitHub Pages at Vucius.github.io.

The site is built with a custom Jekyll setup (without the standard Minima theme), utilizing a clean custom layout system and Tailwind CSS styling. In addition to standard blog posts, it hosts a premium, interactive Gomoku (Five in a Row) AI Play Page powered by a deep learning backend.

---

Key Features

1. Custom Jekyll Layouts: Fully customized default, home, and post layouts styled using Tailwind CSS utility classes.
2. Dark Mode Support: Seamless light/dark mode theme toggling, with preferences persisted in localStorage.
3. Interactive Gomoku AI Game:
   • Playable at /gomoku/ (from gomoku.html).
   • Supports two aesthetic board themes: Classic Wood and Cyber Neon.
   • Includes real-time AI confidence tracking, board coordinates, game logs, move indicators, interactive hover previews, and synthesized audio cues.
   • Integrates with a local backend server (Vuk_Services) to request next-move predictions generated by a deep residual neural network.
4. Archive & Blog Posts: Dynamic blog posts organized under _posts/ with tag/category lists.

---

Directory Structure

Vucius.github.io/
├── _includes/               # Reusable HTML layouts & components
│   ├── footer.html          # Page footer
│   ├── header.html          # Navigation header (Home, Blog, About, Gomoku)
│   └── theme-toggle.html    # Light/Dark mode switcher logic & UI
├── _layouts/                # Page templates
│   ├── default.html         # Base HTML shell with theme initialization
│   ├── home.html            # Main landing page listing posts
│   └── post.html            # Individual blog post layout
├── _posts/                  # Markdown blog posts
│   ├── 2024-xx-xx-...       # Archive posts
│   └── 2025-11-21-...       # "Welcome to Jekyll!" post
├── assets/                  # Static assets
│   ├── css/
│   │   ├── tailwind.css     # Main compiled Tailwind stylesheets
│   │   └── remix.css        # Remix Icon font definitions
│   ├── images/              # Custom image resources
│   └── js/                  # Frontend scripts
├── about.markdown           # Profile/About page for Peter Vucius
├── gomoku.html              # Gomoku human-vs-AI playing board page (permalink: /gomoku/)
├── index.markdown           # Homepage entry (inherits home layout)
├── _config.yml              # Jekyll site configuration settings
├── Gemfile / Gemfile.lock   # Ruby dependencies (Jekyll & plugins)
└── .gitignore               # Ignored files (e.g. .jekyll-cache, _site)

---

Local Development

To run the Jekyll website locally, make sure you have Ruby and Bundler installed on your system.

1. Install Dependencies

Initialize the Ruby environment and download required Jekyll gems:

bundle install

2. Start the Jekyll Server

Run the local development server with live-reloads:

bundle exec jekyll serve --livereload

By default, the site will be accessible at: http://localhost:4000/

---

Gomoku AI Integration

The Gomoku board UI in gomoku.html requires an active backend server to run the AI engine.

1. Run the Backend API

Start Vuk_Services from the root workspace folder:

cd Colosseum/Vuk_Services
npm install
npm run dev

This runs the local API endpoint at http://localhost:3000.

2. Connect the Frontend

• By default, the frontend page attempts to communicate with http://localhost:3000.
• If you run Vuk_Services on a different port or domain, you can configure it via the Model Service settings cog in the Gomoku control panel.
• Ensure you click Test Connection to verify API responsiveness.

---

Author & Contact

• Owner: Peter Vucius
• Email: lucius3451@gmail.com
• Alt Ego: Don Quijote, Edward Joseph Snowden, Julian Paul Assange