Logo和图片
3 分钟阅读
Logos and Images - Logo和图片
https://www.docsy.dev/docs/adding-content/iconsimages/
在您的项目中添加和自定义logo、icon和图片。
添加您的logo
默认情况下，Docsy在导航栏的开头即极左处显示一个站点logo。将您的项目的SVG logo放在assets/icons/logo.svg中。这将覆盖主题中默认的Docsy logo。
如果您不希望在导航栏中出现logo，则在您的项目配置中将navbar_logo设置为false：
Configuration file:
=== “hugo.yaml”
```yaml
navbar_logo: false
```
=== “hugo.toml”
```toml
navbar_logo = false
```
=== “hugo.json”
```json
{
"navbar_logo": false
}
```
有关样式化您的logo的信息，请参见样式化您的项目logo和名称。
使用 icons
Docsy 默认包含了免费的 FontAwesome 图标，其中包括 GitHub 和 Stack Overflow 等网站的logo。您可以在 FontAwesome 文档 中查看所有可用的图标，包括 FontAwesome 版本以及该图标是否可供免费使用。检查 Docsy 的 package.json 和发行说明，了解 Docsy 当前包含的 FontAwesome 版本。
您可以在 顶级菜单、章节菜单 或文本的任何位置添加 FontAwesome 图标。
添加您的favicon
最简单的方法是通过 http://cthedot.de/icongen（允许您从单个图像创建各种图标大小和选项）和/或 https://favicon.io 来创建一组网站图标，然后将它们放在站点项目的 static/favicons 目录中。这将覆盖本主题的默认图标。
请注意，https://favicon.io 并不像 Icongen 那样创建范围广泛的尺寸，但它可以让您快速从文本创建 favicon：如果您想创建文本 favicon，则可以使用该站点生成它们，然后使用 Icongen 从生成的 .png 文件中创建更多尺寸（如果需要）。
如果您有特殊的网站图标要求，可以创建自己的 layouts/partials/favicons.html 文件并添加相应的链接。
添加图像
着陆页面
Docsy 的 blocks/cover 简码 可以方便地向你的 着陆 pages 中添加大型封面图片。这个 简码 在 landing page 的 Page Bundle 中查找一个名字中带有"background"的图片——例如，如果你复制了本示例站点，则 content/en/_index.html 中的 landing page 图片是 content/en/featured-background.jpg。
你可以使用块的 height 参数指定 cover 块容器（及其图片）的首选显示高度。对于全视口高度，请使用 full：
| |
对于较短的图片，例如本示例站点的 About 页面，请使用 min、med、max 或 auto（实际图片的高度）之一：
| |
其他页面
要向其他页面添加内联图片，请使用 imgproc 简码。或者，如果你喜欢，只需使用常规的 Markdown 或 HTML 图像，并将你的图像文件添加到你的项目的 static 目录中。你可以在添加静态内容中了解更多关于使用此目录的信息。
在本站点中使用的图片
本站点中用作背景图片的图像属于公共领域，可以自由使用。示例网站中的粥图像由iha31提供，来自Pixabay。