CLAUDE.md — tyrealq.github.io

Owner & Site Identity

• Q = Dr. Yizhou (Tyreal) Qian 钱亦舟, Associate Professor at Louisiana State University
• Site title: “Dr. Q”
• Author display: “Yizhou (Tyreal) Qian” with Chinese name 钱亦舟
• Email: yqian@lsu.edu
• Research focus: sport management, esports, NLP/AI, computer vision, datasets, agent skills
• Academic profiles: Google Scholar, ORCID, GitHub, YouTube, LinkedIn
• Avatar: images/Ty.png

Build & Serve

# Local development (requires Ruby + Bundler)
bundle install
bundle exec jekyll serve -l -H localhost

# Docker alternative
docker build -t academic-pages .
docker run -p 4000:4000 -v $(pwd):/usr/src/app academic-pages

# Rebuild JS assets (requires Node.js)
npm install
npm run build:js        # one-time bundle
npm run watch:js        # watch mode

Site serves at http://localhost:4000. Changes to _config.yml require a server restart.

Architecture

Collections (defined in _config.yml)

Key Directories

• _pages/ — Static pages (about, cv, archive pages); explicitly included via _config.yml
• _includes/ — Reusable HTML partials (author profile, header, footer)
• _layouts/ — Page templates (single, talk, etc.)
• _sass/ — SCSS stylesheets (compressed output)
• _data/navigation.yml — Header navigation links and order
• _drafts/ — Unpublished content
• images/ — Site images
• files/ — Downloadable files (PDFs, etc.)
• assets/js/ — JavaScript; main.min.js is the bundled output

Content Generation Pipeline

markdown_generator/ contains Python scripts and Jupyter notebooks that convert TSV data into Markdown collection files:

• publications.tsv → publications.py / publications.ipynb → _publications/*.md
• talks.tsv → talks.py / talks.ipynb → _talks/*.md
• PubsFromBib.ipynb / OrcidToBib.ipynb — Import from BibTeX/ORCID

Site Navigation

Header links (defined in _data/navigation.yml):

Homepage: _pages/about.md (permalink: /)

Content Inventory

Publications (_publications/) — 10 files, ALL ACTIVE

Publication categories in _config.yml: Books, Journal Articles (manuscripts), Conference Papers (conferences).

Talks (_talks/) — 14 files, ALL ACTIVE

Podcast episodes (7) — YouTube video discussions of Q’s research:

Teaching demos (7) — QLearning tutorials and conference presentations:

Portfolio (_portfolio/) — 7 files, ALL ACTIVE

AI-generated art and creative projects:

Teaching (_teaching/) — 2 files, PLACEHOLDER (theme template)

Blog Posts (_posts/) — 5 files, PLACEHOLDER (theme template)

Pages (_pages/) — 18 files

Active pages:

Archive generators:

Template / unused:

Images Directory

All images live in images/. Grouped by purpose:

Research infographics (used in publications):

• B50.png, B50_INFO.jpeg — Break 50 / Trump golf
• WG_INFO.jpeg — Winter Olympics / Games
• ESPORTS_INFO.jpg — Esports spectator motivation
• ESPORTS_GAMIFICATION_INFO.jpg — Gamification in esports
• EXP_INFO.jpeg — Stadium experience / LLM
• TS_INFO.png — Taylor Swift & NFL
• TWITCH_SPORTS_INFO.jpg — Twitch co-streaming

Teaching demo thumbnails:

• LLM101.png — LLM 101 tutorial
• NLP4ALL.png — NLP4ALL workshop
• QLearning101.png — QLearning series

Portfolio / portraits:

• Q.png — Tyreal football portrait
• Tracy_cute1.png — Tracy portrait
• XL.png — Xiaoli portrait
• SP8.png — Siping portrait
• Ty_Q_EN.jpeg, Ty_Q_CN.jpeg — Stickers (English/Chinese)

Brand logos:

• Logo_Q.png, Logo_Q_B.png, Logo_Q_Horizontal.png, Logo_Q_OB.png, Logo_Q_SB.png, Logo_Q_W.png

City weather visualizations:

• SM_FJ.jpeg (Sanming), XM_FJ.jpeg (Xiamen), SH.jpeg (Shanghai), Athens_GA.jpeg, BR_LA.jpeg (Baton Rouge), Bloomington_IN.jpeg

Site assets (theme defaults):

• Ty.png — Author avatar (sidebar)
• bio-photo.jpg, bio-photo-2.jpg, profile.jpg — Stock/theme bios
• site-logo.png, homepage.png — Site branding
• favicon.ico, safari-pinned-tab.svg, browserconfig.xml, manifest.json, mstile-*.png — Favicon/PWA
• 500x300.png — Default teaser
• Other theme stock images: foo-bar-identity*.jpg, editing-talk.png, paragraph-*.png, image-alignment-*.jpg, 3953273590_704e3899d5_m.jpg

Configuration Files

Content Workflow

Add a new publication:

1. Create _publications/<slug>.md with YAML front matter: title, collection: publications, category (manuscripts/conferences/books), permalink, excerpt, date, venue, optionally paperurl
2. Add an infographic image to images/ if needed, reference with <img src='/images/...'>
3. Or: add a row to markdown_generator/publications.tsv and run publications.py

Add a new talk (podcast or teaching demo):

1. Create _talks/<Podcast_or_Teaching>_<slug>.md with front matter: title, collection: talks, excerpt, type: "Talk", permalink, date
2. Embed YouTube iframe or Canva slides in the body

Add a portfolio item:

1. Create _portfolio/<slug>.md with front matter: title, excerpt (include thumbnail img tag), collection: portfolio, permalink
2. Add images to images/, reference in body

Deployment

Push to master branch. GitHub Pages builds and deploys automatically.