Project Overview

This is a Jekyll-based static website for “Meu Tarot Online,” a tarot reading and spirituality website. The site provides interactive tarot readings, a “card of the day” feature, and articles on related topics.

Key Technologies:

  • Jekyll: A static site generator written in Ruby.
  • HTML/CSS/JavaScript: The core technologies for the website’s structure, styling, and interactivity.
  • GitHub Pages: The project is set up for easy deployment using GitHub Pages.

Architecture:

  • The site’s structure is defined by Jekyll’s conventions, with layouts in _layouts, includes in _includes, and posts in _posts.
  • The main pages are index.html, tarot.html, and card-of-day.md.
  • The interactive tarot features are powered by js/tarot-app.js, which contains the card data and all the logic for shuffling, drawing, and displaying the cards and their meanings.
  • The website’s styling is defined in css/style.css.

Building and Running

To run the project locally, you need to have Ruby and Bundler installed.

  1. Install dependencies: 
    bundle install
  2. Start the development server: 
    bundle exec jekyll serve
  3. Access the site: Open http://localhost:4000 in your browser.

Development Conventions

  • Content: New articles should be created as Markdown files in the _posts directory, following the naming convention YYYY-MM-DD-title.md.
  • Styling: All custom styles are in css/style.css. The site uses the minima theme as a base.
  • Interactivity: The tarot reading logic is contained in js/tarot-app.js. Any changes to the tarot features should be made in this file.
  • Configuration: The site’s main configuration is in _config.yml.