如何在GitHub README与pkgdown主页设置不同尺寸的包Logo?
实现R包Logo在GitHub README和pkgdown主页差异化显示的最佳方法
方法1:分离配置(最简洁可靠)
这种方式完全分开GitHub README和pkgdown主页的Logo,无需CSS干预:
- GitHub README端:直接用Markdown图片语法指定小尺寸
GitHub会识别{width=120px}width属性,渲染出小尺寸的Logo。 - pkgdown端:在包根目录的
_pkgdown.yml中单独配置主页Logo的大尺寸
pkgdown主页会优先读取这个配置,显示大尺寸Logo,和README的设置互不干扰。homepage: logo: man/figures/logo.png logo_width: 250px # 按需调整大尺寸数值
方法2:通过CSS覆盖(适用于Logo共用的场景)
如果希望README中的Logo在pkgdown的其他页面保持小尺寸,仅主页放大,可以用CSS实现:
- 给README中的Logo添加自定义类:
{.pkg-logo width=120px} - 添加自定义CSS:在包的
inst/pkgdown/assets/custom.css文件中写入规则
GitHub不识别Markdown中的CSS类,只会应用/* 仅在pkgdown主页放大Logo */ .page-home .pkg-logo { width: 250px !important; /* 覆盖inline的width属性 */ }width=120px显示小Logo;而pkgdown主页因为有.page-home的页面类,会触发CSS规则放大Logo。
注:之前CSS尝试失败大概率是因为没精准匹配pkgdown主页的页面类(
.page-home),或者没加!important覆盖Markdown中指定的inline宽度。
内容的提问来源于stack exchange,提问作者mat
相关产品推荐
相关产品推荐

