Content Guide

This file is the shortest path to the content you are likely to edit.

Edit Map

Home / About: _pages/about.md
CV: _pages/cv.md
Publications index: _pages/publications.md
Projects index: _pages/projects.md
Footprints index: _pages/footprints.md
Publication entries: _publications/
Project entries: _projects/
Footprints / essays: _plogs/
Top navigation: _data/navigation.yml
Site identity, avatar list, social links: _config.yml
Main page layout: _layouts/page-content.html
Footprints entry layout: _layouts/travel-log-entry.html
Shared content embeds: _includes/content-media.html, _includes/content-figure.html
Main styles: _sass/_theme.scss
Frontend interactions: assets/js/

What You Usually Need

Add a publication

Create a file in _publications/:

---
title: "Paper Title"
title_zh: "论文标题"
permalink: /publication/2026-01-01-paper
excerpt: "One-sentence summary."
excerpt_zh: "一句中文简介。"
date: 2026-01-01
venue: "Journal / Conference"
venue_zh: "期刊 / 会议"
paperurl: "https://..."
citation: "Author, A. ..."
---

Optional media:

<figure class="publication-figure">
  <img src="../files/example-figure.jpg" alt="Example figure" decoding="async">
  
    <figcaption>
      
<span class="i18n-switch i18n-switch--inline">
  <span class="lang-en"><strong>Figure.</strong> English caption.</span>
  <span class="lang-zh"><strong>图示。</strong> 中文说明。</span>
</span>

    </figcaption>
  
</figure>

  <p class="publication-kicker">

<span class="i18n-switch i18n-switch--inline">
  <span class="lang-en">Demo video.</span>
  <span class="lang-zh">演示视频。</span>
</span>
</p>

<div class="document-viewer-shell document-viewer-shell--video">
  
    <video class="publication-embed publication-embed--video" controls preload="metadata" playsinline>
      <source src="../files/example-video.mp4" type="video/mp4">
      
<span class="i18n-switch i18n-switch--inline">
  <span class="lang-en">Your browser does not support embedded video playback.</span>
  <span class="lang-zh">当前浏览器不支持内嵌视频播放。</span>
</span>

    </video>
  
</div>

<div class="document-viewer-shell">
  
    <iframe class="publication-embed publication-embed--pdf" src="../files/example-paper.pdf" title="Paper PDF preview" data-i18n-title-en="Paper PDF preview" data-i18n-title-zh="论文 PDF 预览"></iframe>
  
</div>

  <div class="content-link-row">
    
      <a class="btn btn--inverse" href="../files/example-paper.pdf" target="_blank" rel="noopener">

<span class="i18n-switch i18n-switch--inline">
  <span class="lang-en">Open PDF</span>
  <span class="lang-zh">打开 PDF</span>
</span>
</a>
    
      <a class="btn btn--primary" href="https://drive.google.com/..." target="_blank" rel="noopener">

<span class="i18n-switch i18n-switch--inline">
  <span class="lang-en">Google Drive</span>
  <span class="lang-zh">Google Drive</span>
</span>
</a>
    
  </div>

If the paper is not public yet, this is enough:

---
title: "Paper Title"
title_zh: "论文标题"
permalink: /publication/2026-01-01-paper
excerpt: "This paper is under review."
excerpt_zh: "该论文正在审稿中。"
date: 2026-01-01
status: "Under review"
status_zh: "审稿中"
---

Add a project

Create a file in _projects/:

---
title: "Project Title"
title_zh: "项目标题"
permalink: /projects/2026-project-name
type: "Project Type"
type_zh: "项目类型"
venue: "Institution"
venue_zh: "机构"
date: 2026-01-01
location: "City, Country"
location_zh: "城市，国家"
excerpt: "One-sentence summary."
excerpt_zh: "一句中文简介。"
---

Optional embeds:

<div class="document-viewer-shell document-viewer-shell--video">
  
    <video class="document-embed document-embed--video" controls preload="metadata" playsinline>
      <source src="../files/project-demo.mp4" type="video/mp4">
      
<span class="i18n-switch i18n-switch--inline">
  <span class="lang-en">Your browser does not support embedded video playback.</span>
  <span class="lang-zh">当前浏览器不支持内嵌视频播放。</span>
</span>

    </video>
  
</div>

<div class="document-viewer-shell">
  
    <iframe class="document-embed document-embed--pdf" src="../files/project-slides.pdf" title="Project PDF preview" data-i18n-title-en="Project PDF preview" data-i18n-title-zh="项目 PDF 预览"></iframe>
  
</div>

  <div class="content-link-row">
    
      <a class="btn btn--inverse" href="../files/project-slides.pdf" target="_blank" rel="noopener">

<span class="i18n-switch i18n-switch--inline">
  <span class="lang-en">Open PDF</span>
  <span class="lang-zh">打开 PDF</span>
</span>
</a>
    
  </div>

Add a footprint / essay

Create a file in _plogs/ with a date-based filename:

2026-03-29-city-name.md

Minimal footprint:

---
title: "Bangkok"
title_zh: "曼谷"
type: "Trip ✈️"
type_zh: "旅行 ✈️"
venue: "Dragon Boat Festival"
venue_zh: "端午假期"
location: "Bangkok, Thailand"
location_zh: "泰国曼谷"
excerpt_zh: "端午期间一次短暂的曼谷出走。"
---

<span class="plog-note plog-note--trip">A short Bangkok getaway during the Dragon Boat Festival.</span>

Simplified Rules

Do not add collection: in files under _projects/ or _publications/; Jekyll already knows the collection from the folder.
Put PDFs, videos, and figures in files/, then use the shared include instead of writing raw <iframe> / <video> blocks each time.
Keep long citations and external links on the detail page, not the listing page.
Use excerpt / excerpt_zh for one-line summaries only.
Use status / status_zh for placeholder publication pages that are still under review.

Files You Usually Should Not Touch

_site/: generated output
vendor/: Ruby dependencies
tmp/: storage for old upstream examples and temporary files
node_modules/: local tooling dependencies

Yiheng XUE (Billy) 薛毅恒

Content Guide Content Guide