Dr. Yang Zhao

Dr. Yang Zhao

she/her

Lecturer (Assistant Professor), La Trobe University

Publications Direct-Link Workflow

Publications Direct-Link Workflow

Goal

Plan the next Publications page refinement.

Requested outcome:

  • Keep the current sorting and section numbering.
  • Do not make publication titles open the local generated introduction/detail page.
  • Make each publication title open an external paper page instead, such as DOI, publisher, arXiv, Google Scholar, or project paper page.
  • Keep optional Demo, Code, Dataset, or Project links beside the title when those links are provided.
  • Keep the venue line, for example:
Published in The 35th British Machine Vision Conference (BMVC 2024), Glasgow, UK, 2024
  • Make adding new publications easier by using front matter only, with no required local introduction text.

Current Good Behavior To Keep

The current Publications page already has the correct sorting and section-local numbering:

  • Journal Articles are sorted newest first and numbered within the journal section.
  • Conference Papers are sorted newest first and numbered within the conference section.
  • Only the newest 10 papers per section are shown before older papers fold.

Do not change this part unless the sorting rule changes later.

Implementation Status

This workflow has been implemented in the refine-publications-direct-links branch:

  • _includes/publication-list-item.html now links publication titles to paperurl.
  • Optional demourl, codeurl, dataseturl, and projecturl fields render beside the title.
  • Existing body Links: entries were moved into front matter.
  • The current Publications sorting, numbering, and folding logic was kept unchanged.

Use each _publications/*.md file as a metadata record.

The title should link to:

paperurl: "https://..."

The paperurl can be any preferred external page:

  • DOI page
  • publisher page
  • arXiv page
  • Google Scholar result page
  • project paper page
  • PDF link

Optional extra links should move into front matter:

demourl: "https://..."
codeurl: "https://..."
dataseturl: "https://..."
projecturl: "https://..."

Only include optional fields when there is a real link. If a paper has no demo or code, delete those fields from the copied file.

New Template

A direct-link template has been added here:

_publications/publication-direct-link-template.md

It includes:

published: false

Keep published: false in the template file. When creating a real publication by copying this template, remove published: false from the copied file.

Example Publication Entry

Example for Motion Avatar:

---
title: "Motion Avatar: Generate Human and Animal Avatars with Arbitrary Motion"
collection: publications
category: conferences
date: 2024-01-01
venue: "The 35th British Machine Vision Conference (BMVC 2024), Glasgow, UK"
paperurl: "https://arxiv.org/abs/2405.11286"
demourl: "https://steve-zeyu-zhang.github.io/MotionAvatar/"
citation: "Zeyu Zhang*, Yiran Wang*, Biao Wu*, Shuo Chen, Zhiyuan Zhang, Shiya Huang, Wenbo Zhang, Meng Fang, Ling Chen, Yang Zhao. Motion Avatar: Generate Human and Animal Avatars with Arbitrary Motion. The 35th British Machine Vision Conference (BMVC 2024), Glasgow, UK."
---

The Publications page should render it like:

Motion Avatar: Generate Human and Animal Avatars with Arbitrary Motion, Demo
Published in The 35th British Machine Vision Conference (BMVC 2024), Glasgow, UK, 2024

If both demo and code are provided:

Motion Avatar: Generate Human and Animal Avatars with Arbitrary Motion, Demo, Code
Published in The 35th British Machine Vision Conference (BMVC 2024), Glasgow, UK, 2024

Files To Update During Implementation

Main rendering file:

_includes/publication-list-item.html

Current behavior:

<a href=""></a>

Recommended new behavior:



<a href=""></a>

Keep the existing venue line:

<span class="publication-list__venue">
  Published in <i></i>, 1900
</span>

The fallback to post.url is useful only when a publication has no paperurl. Normal new entries should use paperurl.

Some existing publication files currently store extra links in the body as Markdown:

Links: [Demo](...)
Links: [Code](...)
Links: [Dataset](...)

For the new direct-link list page, move those links into front matter.

Example before:

paperurl: "https://arxiv.org/abs/2405.11286"

Links: [Demo](https://steve-zeyu-zhang.github.io/MotionAvatar/)

Example after:

paperurl: "https://arxiv.org/abs/2405.11286"
demourl: "https://steve-zeyu-zhang.github.io/MotionAvatar/"

Recommended migration targets:

Demo    -> demourl
Code    -> codeurl
Dataset -> dataseturl
Project -> projecturl

The body text can remain for now, but the Publications list should no longer need it.

How To Add A New Publication Online

Use GitHub online editing for simple publication additions.

  1. Open the repository on GitHub.
  2. Switch to the academic branch.
  3. Open:
_publications/publication-direct-link-template.md
  1. Copy the template content.
  2. Create a new file in _publications/.
  3. Use this filename pattern:
YYYY-MM-DD-short-paper-title.md

Example:

_publications/2026-01-01-example-paper-title.md
  1. Paste the template content.
  2. Replace the title, date, venue, paper URL, category, and citation.
  3. Delete optional link fields that are not used.
  4. Remove this line from the copied real publication:
published: false
  1. Commit the file to academic, or open a pull request if you want to review first.

After editing online, pull before doing local work:

git checkout academic
git pull --ff-only origin academic

Category Rules

Journal paper:

category: manuscripts

Conference paper:

category: conferences

The category controls which section the paper appears in.

Venue Rule

Use venue for the publication venue text, not the full citation.

Recommended:

venue: "The 35th British Machine Vision Conference (BMVC 2024), Glasgow, UK"
date: 2024-01-01

This renders as:

Published in The 35th British Machine Vision Conference (BMVC 2024), Glasgow, UK, 2024

Avoid putting a final duplicate year at the end of venue, because the template already adds the year from date.

Implementation Steps

  1. Create a new branch from academic.
git checkout academic
git pull --ff-only origin academic
git checkout -b refine-publications-direct-links
  1. Update _includes/publication-list-item.html so the title links to paperurl.
  2. Render optional Demo, Code, Dataset, and Project links beside the title.
  3. Move existing body links into front matter for papers that already have demo/code/dataset links.
  4. Keep _pages/publications.html sorting, numbering, and folding logic unchanged.
  5. Run a local Jekyll build.
  6. Push the branch and confirm GitHub Actions passes.
  7. Merge into academic only after review.

Validation Checklist

  • Publication title opens paperurl, not the local generated publication page.
  • If demourl exists, Demo appears beside the title.
  • If codeurl exists, Code appears beside the title.
  • If dataseturl exists, Dataset appears beside the title.
  • Venue line still appears under each title.
  • Journal and conference sorting remains correct.
  • Journal and conference numbering remains correct.
  • Folded older papers still work.
  • The direct-link template does not appear as a real publication.