关于页面

概述

Quarto 使得为个人或组织创建一个简单的关于页面变得容易。当文档提供了 about 选项时，将使用一个特殊的模板来布局当前页面的内容，该布局设计用于展示个人或组织。

例如：

---
title: "Finley Malloc"
about:
  template: jolla
  image: profile.jpg
  links:
    - icon: twitter
      text: twitter
      href: https://twitter.com
    - icon: github
      text: Github
      href: https://github.com
---

Finley Malloc 是 Wengo Analytics 的首席数据科学家。在不创新数据平台时，Finley 喜欢花时间玩独轮车和她的宠物鬣蜥。

## 教育

加州大学圣地亚哥分校 | 圣地亚哥，CA
数学博士 | 2011年9月 - 2015年6月

马卡莱斯特学院 | 圣保罗，MA
经济学学士 | 2007年9月 - 2011年6月

## 经验

Wengo Analytics | 数据科学家主管 | 2018年4月 - 现在

GeoScynce | 首席分析师 | 2012年9月 - 2018年4月

此页面的内容将使用 jolla 模板进行布局，并使用 profile.jpg 图像，并生成 links 中指定的项目链接集。

你可以按照你喜欢的方式编写和格式化页面内容——当页面渲染时，Quarto 将使用 about 选项中提供的内容和选项来创建关于页面，将 about 选项的内容与页面本身的内容进行排列。

模板

Quarto 包含了5个内置模板，灵感来自于 Postcards R 包。内置模板包括：

jolla
trestles
solana
marquee
broadside

每个模板将以不同的布局定位关于页面元素和内容。使用 template 选项选择模板：

about:
  template: trestles

以下是每个模板的预览：

使用 jolla 模板的关于页面的截图。照片是一个位于标题上方的居中圆形，标题是作者的名字。标题下方有一个居中的段落，然后是一条分隔线，底部居中是 twitter 和 github 的按钮。

使用 trestles 模板的关于页面的截图。左侧是一个位于作者名字上方的矩形照片，以及两个按钮（一个用于 twitter，另一个用于 github）。右侧是一个主体文本段落，然后是教育和工作经验的标题部分。

使用 solana 模板的关于页面的截图。左侧是名字作为主标题，下面是 twitter 和 github 的按钮。按钮下方是一个主体文本段落，然后是教育和工作经验的标题部分。右上角有一个矩形图片。

使用 marquee 模板的关于页面的截图。顶部是一个大正方形图片。下面是作者名字的标题，然后是一个主体文本段落，接着是教育和工作经验的标题部分。页面底部居中是带有各自图标的 Twitter 和 GitHub 链接。

使用 broadside 模板的关于页面的截图。左侧是一个矩形图片。右侧是作者名字的标题，然后是一个主体文本段落，接着是教育和工作经验的标题部分。页面底部居中是带有各自图标的 Twitter 和 GitHub 链接。

图片

关于页面的图片将从文档级的 image 选项中读取：

title: Finley Malloc
image: profile.jpg
about:
  template: jolla

此外，你可以通过设置以下选项来定制图片在页面中的显示方式，以更好地满足你的需求。

选项	描述	模板
`image-width`	图片的有效 CSS 宽度。	所有
`image-shape`	关于页面上图片的形状。选择：`rectangle`, `round`, `rounded`	`jolla`, `solana`, `trestles`
`image-alt`	图片的替代文本	所有
`image-title`	图片的标题	所有

例如：

title: 芬利·马洛克
image: 个人资料.png
关于:
  模板: 特雷斯托
  图片宽度: 10em
  图片形状: 圆形

链接

你的关于页面也可能包含一组指向你或你的组织的其他资源的链接。每个模板将以稍微不同的方式呈现这些链接。以下是你可以为每个链接指定的选项：

选项	描述
`href`	链接指向项目中包含的文件或外部URL。
`text`	导航项显示的文本（如果未提供，默认为文档的`title`）。
`icon`	标准Bootstrap 5图标之一的名字（例如”github”、“twitter”、“share”等）。
`aria-label`	导航项的可访问标签。

部分页面内容

默认情况下，关于页面将使用页面的全部内容生成。然而，如果你愿意，你也可以选择仅使用页面内容的一部分来填充关于模板。在这种情况下，你可以在文档的前言中为关于页面指定一个id。在渲染页面时，Quarto将找到具有该id的任何div，并使用该div的内容来填充关于模板。提供内容的div将被格式化的“关于”内容替换。例如，你可以这样写：

---
title: "Finley Malloc"
about:
  id: hero-heading
  template: jolla
  image: profile.jpg
  links:
    - icon: twitter
      text: twitter
      href: https://twitter.com
    - icon: github
      text: Github
      href: https://github.com
---

### 这些内容出现在格式化的关于页面内容上方。

:::{#hero-heading}

Finley Malloc是Wengo Analytics的首席数据科学家。在不为数据平台创新时，Finley喜欢花时间玩单轮车并和她的小宠物鬣蜥玩耍。

## 教育

加州大学圣地亚哥分校 | 圣地亚哥，加利福尼亚州
数学博士 | 2011年9月 - 2015年6月

麦卡莱斯特学院 | 圣保罗，马萨诸塞州
经济学学士 | 2007年9月 - 2011年6月

## 经验

Wengo Analytics | 首席数据科学家 | 2018年4月 - 至今

GeoScynce | 首席分析师 | 2012年9月 - 2018年4月

:::

### 这些内容出现在格式化的关于页面内容下方。