|
| 1 | +# Boyle Lab news-post layout |
| 2 | + |
| 3 | +The `_layouts/post.html` template provides the editorial layout for every item in `_posts`. Existing posts require no changes. The template continues to use the current `title`, `date`, `categories`, `teaser`, `external-url`, and Markdown body fields. |
| 4 | + |
| 5 | +## Standard front matter |
| 6 | + |
| 7 | +```yaml |
| 8 | +--- |
| 9 | +layout: post |
| 10 | +published: true |
| 11 | +title: Boyle Lab receives NINDS R01 award! |
| 12 | +date: 2026-06-12 |
| 13 | +external-url: https://reporter.nih.gov/project-details/11363610 |
| 14 | +teaser: 2026/NINDS_R01_NUMT.png |
| 15 | +categories: |
| 16 | + - Grants |
| 17 | +--- |
| 18 | +``` |
| 19 | + |
| 20 | +The teaser is displayed as the lead image. `Papers`, `Grants`, and `Awards` default to `contain`; other categories default to `cover`. |
| 21 | + |
| 22 | +## Optional editorial fields |
| 23 | + |
| 24 | +```yaml |
| 25 | +summary: >- |
| 26 | + A one- or two-sentence standfirst that appears below the title. |
| 27 | +
|
| 28 | +hero-image: /assets/news_graphics/2026/high-resolution-image.png |
| 29 | +hero-fit: contain # contain or cover |
| 30 | +hero-alt: Description of the lead image |
| 31 | +hero-caption: Optional image credit or caption |
| 32 | +hide-hero: false |
| 33 | + |
| 34 | +cta-label: View project in NIH RePORTER |
| 35 | +``` |
| 36 | +
|
| 37 | +`hero-image` can point to a higher-resolution file while `teaser` remains the smaller News-index image. A relative `hero-image` or gallery path is resolved under `/assets/news_graphics/`. |
| 38 | + |
| 39 | +## Related publication |
| 40 | + |
| 41 | +Use the permanent BibTeX key from `_papers`: |
| 42 | + |
| 43 | +```yaml |
| 44 | +related-publication: McDonald2021Cas9MobileElements |
| 45 | +``` |
| 46 | + |
| 47 | +The post will display the structured publication citation and its Article, DOI, PDF, PubMed, Code, Data, and BibTeX links when available. The separate external call-to-action is omitted because the publication card supplies the article link. |
| 48 | + |
| 49 | +## Related lab members |
| 50 | + |
| 51 | +Use Michigan `umid` values from `_people`: |
| 52 | + |
| 53 | +```yaml |
| 54 | +people: |
| 55 | + - apboyle |
| 56 | + - bmcbean |
| 57 | +``` |
| 58 | + |
| 59 | +Each person is shown in a compact profile card linked to the member page. |
| 60 | + |
| 61 | +## Grant or award information |
| 62 | + |
| 63 | +```yaml |
| 64 | +award: |
| 65 | + agency: National Institute of Neurological Disorders and Stroke |
| 66 | + mechanism: R01 |
| 67 | + project: Characterization and functional impact of somatic numtogenesis in the human cortex |
| 68 | + collaborators: |
| 69 | + - Ryan Mills |
| 70 | +``` |
| 71 | + |
| 72 | +When `external-url` is also present, its action appears inside this information panel. |
| 73 | + |
| 74 | +## Curated image gallery |
| 75 | + |
| 76 | +```yaml |
| 77 | +gallery: |
| 78 | + - src: 2026/event/photo-01.jpg |
| 79 | + alt: Lab members at the event |
| 80 | + caption: Optional caption |
| 81 | + - src: 2026/event/photo-02.jpg |
| 82 | + alt: Poster presentation |
| 83 | +``` |
| 84 | + |
| 85 | +Older posts that generate image galleries in their Markdown remain supported. Their direct child `<div>` image collections receive the same responsive two-column treatment. |
| 86 | + |
| 87 | +## Automatic elements |
| 88 | + |
| 89 | +Every post receives: |
| 90 | + |
| 91 | +- A breadcrumb and category/date header. |
| 92 | +- An optional lead image based on `hero-image` or `teaser`. |
| 93 | +- Previous-story, All News, and next-story navigation. |
| 94 | +- Up to three recent stories from the same primary category. |
| 95 | +- Responsive typography, image treatment, and mobile layouts. |
0 commit comments