Skip to content

64-shades/64-shades.github.io

Repository files navigation

64 Shades 🀄 🃏 ♟️ 🎲 🕹️

View the project board GitHub Sponsors Discord GitHub Pages Status Read the Docs Documentation Status

CodeQL Dependabot Updates First Interaction Git Clone Matrix Lerna ls-lint pre-commit

Build and Deploy Eleventy site CI - Build Eleventy on PR Pages Build Deployment

About the Site Generator

This website is built using Eleventy (11ty), a modern and flexible static site generator for JavaScript projects. Eleventy takes your content and templates and generates a fast, static website. You do not need to know advanced JavaScript to get started - just follow the steps below!

Technology Stack

  • GitHub Pages is a static site hosting service offered by GitHub, enabling users to host websites directly from their GitHub repositories. It is designed for publishing static content, meaning it primarily handles HTML, CSS, and JavaScript files, and does not support server-side languages like PHP or Python for dynamic content generation.
  • Read the Docs is a Continuous Documentation Deployment platform designed to simplify the process of building, versioning, and hosting technical documentation, particularly for software projects. It operates on the principle of "docs as code," integrating with version control systems like Git (GitHub, GitLab, Bitbucket) to automatically build and update documentation whenever changes are committed to the repository.
  • Lerna is a fast, modern build system for managing and publishing multiple JavaScript/TypeScript packages from the same repository.
  • Vitest is a blazing-fast, next-generation testing framework designed for modern JavaScript and TypeScript projects, built on top of Vite. It's known for its speed and developer experience, offering instant feedback and seamless integration with Vite's features like hot module replacement (HMR). Vitest is inspired by Jest and aims to provide a familiar yet enhanced testing experience.
  • Eleventy (also known as 11ty) is a static site generator. It's a tool that transforms content (like Markdown, HTML, or JavaScript) and templates into static HTML files, making it faster and easier to build websites. Unlike dynamic website builders, 11ty generates all the website's content upfront, which leads to better performance and simpler deployments.
  • Tailwind CSS is a utility-first CSS framework designed for rapidly building custom user interfaces directly within HTML. Unlike traditional CSS frameworks that provide pre-built components (like buttons or navigation bars), Tailwind offers a comprehensive set of low-level utility classes.
  • Nunjucks is a powerful and flexible templating engine for JavaScript, heavily inspired by Jinja2 (a popular templating engine for Python). It allows developers to create dynamic HTML, XML, or other text-based content by embedding logic, variables, and control structures directly within templates.
  • Sphinx is a powerful and widely-used documentation generator written in Python. It is particularly popular within the Python community and is considered the de facto standard for documenting Python projects.
  • reStructuredText (RST) is a lightweight markup language designed for creating easy-to-read and easy-to-write plaintext documents that can be automatically converted to various output formats, such as HTML, LaTeX (and thus PDF), and more. It is a key component of the Docutils project and is widely used in the Python community for writing technical documentation, including Python's official documentation and documentation for many Python libraries.

Read below for instructions about the current static development site hosted on GitHub Pages.


Getting Started / Building the Site

To start a local development server with live reload, run:

npm run start

Build the Documentation

Run the following commands from the repo root to create the Sphinx documentation with Make:

cd doc
make html

The generated HTML site will be in the doc/build/html folder. You can open the HTML files with your web browser.


Contributors

Contributors


© 2025 64 Shades