Jess Temporal's Blog & Portfolio

Personal blog and portfolio website of Jessica Temporal — Sr. Dev Advocate, podcaster, and creator. Built with Jekyll and the Ethereal Ink theme, hosted on GitHub Pages.

🌐 Live site: jtemporal.com

Repository note: This project currently lives at jtemporal/new-blog while the Ethereal Ink migration is in progress. Clone and setup instructions below still use jtemporal/jtemporal.github.io — the repo will be renamed once the migration ships.

About

This site features:

• Technical blog posts about Python, data science, Git, and open source
• Books, talks, videos, series, and social links
• Hacktoberfest project collections (2019–2025)
• Multi-language support (Portuguese and English, with French infrastructure)

Tech Stack

• Static site generator: Jekyll 4.3
• Styling: Tailwind CSS (Ethereal Ink design system) with Typography plugin
• Syntax highlighting: Rouge
• Hosting: GitHub Pages
• Domain: jtemporal.com
• Analytics: Google Analytics & PostHog

Features

• Responsive layout with light/dark mode
• Multi-language content (PT/EN) with scalable architecture
• Reading time estimation
• Post tag banners, series pages, and listing pages for talks, videos, and books
• Blog post pagination
• Language switcher

Multi-Language System

See MULTI_LANGUAGE_SYSTEM.md for architecture, translation management, adding languages, and troubleshooting.

Local Development

Prerequisites

• Ruby 3.4.1 (see .ruby-version)
• Bundler
• Node.js & npm (for Tailwind CSS builds)
• Git

Setup

1. Clone the repository

   git clone https://github.com/jtemporal/jtemporal.github.io.git
   cd jtemporal.github.io

   If you are working from the migration repo before the rename:

   git clone https://github.com/jtemporal/new-blog.git
   cd new-blog

2. Install dependencies

   bundle install
   npm install

3. Run the development server

   Recommended — builds CSS and starts Jekyll with the dev config:

   npm run dev

   Or run the steps separately:

   npm run build:css
   bundle exec jekyll serve --config _dev_config.yml

   CSS auto-rebuilds via _plugins/build_css.rb while Jekyll is running.

4. Open the site

   http://127.0.0.1:4000

Development Commands

Command	Description
npm run dev	Build CSS and serve with _dev_config.yml
npm run build:css	Compile Tailwind → assets/css/main.css
npm run watch:css	Watch and rebuild CSS
bundle exec jekyll build	Production build
bundle exec jekyll serve --drafts	Include draft posts
bundle exec jekyll serve --future	Include future-dated posts
bundle exec jekyll clean	Remove _site and cache

Content Structure

├── _posts/                    # Blog posts
├── _books/                    # Book collection (en/, pt/)
├── _drafts/                   # Draft posts
├── _hacktoberfest_projects_*/ # Hacktoberfest listings by year
├── _includes/                 # Reusable templates
├── _layouts/                  # Page layouts
├── _plugins/                  # Jekyll plugins (CSS build, Rouge tweaks)
├── _data/                     # YAML data (socials, localization, etc.)
├── src/styles/                # Tailwind source (tailwind.css, theme.css, syntax.css)
├── assets/css/                # Compiled CSS
├── images/                    # Image assets
└── slides/                    # Presentation slides

Design mockups from Stitch live in stitch_bilingual_blog_post_page_v1/ locally for reference — that folder is gitignored and not part of the repository.

Writing Posts

Create new posts in _posts/ using:

YYYY-MM-DD-post-title.md

Front Matter Template

---
layout: post
title: "Your Post Title"
date: 2025-08-30
image: /images/covers/tutorial.webp
tags: [tag1, tag2]
lang: en  # or pt
translations:
  - lang: pt
    url: "/caminho-para-traducao-em-portugues"
---

Your post content here...

For translation details, see MULTI_LANGUAGE_SYSTEM.md.

Collections

Books

Book content lives in _books/en/ and _books/pt/.

Hacktoberfest Projects

Organized by year in _hacktoberfest_projects_YYYY/.

Configuration

• Production config: _config.yml
• Development config: _dev_config.yml (local URLs, dev-only excludes)
• Styling: src/styles/tailwind.css, tailwind.config.js, src/styles/theme.css

Contributing

1. Fork jtemporal/jtemporal.github.io
2. Create a feature branch (git checkout -b feature/my-change)
3. Commit your changes
4. Push and open a pull request

License

See LICENCE.md.

Contact

• Website: jtemporal.com
• Email: hello@jtemporal.com
• Twitter: @jesstemporal
• GitHub: @jtemporal

---

Made with ❤️ by Jessica Temporal