Red Ackee Software

Red Ackee Software

Project Setup and Troubleshooting Summary

Actions Taken

  1. Configured GitHub Pages Remote Theme

    • Verified _config.yml includes remote_theme: "redackee/beautiful-jekyll".
    • Confirmed correct usage for GitHub Pages and Jekyll.

  2. Created Gemfile for Local Development

    • Added a Gemfile with: 
      gem 'github-pages', group: :jekyll_plugins
    • Noted that jekyll-remote-theme is already included via github-pages.

  3. Attempted Local Gem Installation

    • Ran bundle install --path vendor/bundle to install gems locally.
    • Encountered permission errors and native extension build errors (e.g., commonmarker).

  4. Troubleshooting Steps

    • Advised to remove and retry vendor/bundle if permissions are an issue.
    • Recommended installing Xcode Command Line Tools with xcode-select --install for native gem builds.
    • Provided instructions for installing Ruby locally using Homebrew, rbenv, or rvm to avoid system Ruby permission issues.

  5. Documentation Provided

  6. Ruby Version Management

    • Installed rbenv locally using Homebrew.
    • Set up Ruby version 3.4.5 for local development.

  7. Previewing the Website Locally

    • To preview your site locally with the correct plugins and theme, run: 
      bundle exec jekyll serve
    • Then open http://localhost:4000 in your browser.

Major Customizations and UI Changes (since last update)

  • Site Title Branding:

    • Multi-color “Red Ackee Software” branding applied everywhere the site title appears (navbar, header, page title, and optionally footer).
    • Custom CSS for .red-word (red), .ackee-word (black), and .software-word (gold with black text stroke).
    • Overrode theme includes and layouts to inject custom HTML for the site title.

  • Banner Image:

    • Homepage banner image updated from old_sugar_factory.jpg to banner-redackee-1536x1024.png.

  • Navigation:

    • Added links to ChatGPT, Google Gemini, and Microsoft Copilot under the Resources menu in the navbar.

  • Favicon:

    • Switched favicon from PNG to ICO format in _config.yml.

  • Header and Page Title:

    • Removed text shadow from all major headings for a cleaner look.
    • Ensured only the custom multi-color title is shown in the banner/header area.
    • CSS rules added to hide default page headings if a custom title is present.

  • Footer:

    • Footer reverted to show only copyright and author.

  • General:

    • Various troubleshooting and improvements for local development, LiveReload, and browser cache issues.

For further troubleshooting, ensure you are using a user-managed Ruby and have the necessary build tools installed. All configuration and setup steps are now documented in this summary.