al-folio
用户社区
al-folio的活跃用户社区正在不断壮大! 世界各地的学者们使用这个主题来创建他们的个人主页、博客、实验室页面,以及课程、研讨会、会议、聚会等网页。 请查看下方的社区网页列表。 欢迎通过提交PR的方式添加您自己的页面。
学者 | ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ ★ |
实验室 | ★ ★ ★ ★ ★ ★ ★ ★ ★ |
课程 |
CMU PGM (2019春季) CMU DeepRL (2021春季, 2021秋季, 2022春季, 2022秋季, 2023春季, 2023秋季) CMU MMML (2020秋季, 2022秋季) CMU AMMML (2022春季, 2023春季) CMU ASI (2023春季) CMU 分布式系统 (2024春季) |
会议与研讨会 |
ICLR 博客文章专题 (2023, 2024) ML回顾(NeurIPS:2019,2020;ICML:2020) HAMLETS(NeurIPS:2020) ICBINB(NeurIPS:2020,2021) 神经压缩(ICLR:2021) 基于得分的方法(NeurIPS:2022) 图像到符号(CogSci:2022) 医疗机器人青年教师论坛(ISMR:2023) 超越视觉:物理学遇上人工智能(ICIAP:2023) 扩散模型研讨会(NeurIPS:2023) 结构化概率推理与生成建模研讨会(ICML:2023,2024) |
桌面版
自行运行测试:Google Lighthouse PageSpeed Insights
移动版
自行运行测试:Google Lighthouse PageSpeed Insights
目录
入门
想了解更多关于Jekyll的信息?查看这个教程。为什么选择Jekyll?阅读Andrej Karpathy的博客文章!为什么要写博客?阅读Rachel Thomas的博客文章。
安装和部署
有关安装和部署的详细信息,请参阅INSTALL.md。
自定义
有关自定义的详细信息,请参阅CUSTOMIZE.md。
特性
明暗模式
此模板内置明暗模式。它会检测用户首选的配色方案并自动切换。您也可以通过点击页面右上角的太阳/月亮图标手动切换明暗模式。
简历
目前有两种不同的方式生成简历页面内容。第一种是使用位于assets/json/resume.json的json文件。这是一种已知标准,用于以编程方式创建简历。第二种方式,目前作为json文件未找到时的备选方案,是使用位于_data/cv.yml的yml文件。这是创建简历页面内容的原始方式,由于它比json文件更易读,我们决定将其保留为一个选项。
这意味着,如果在_config.yml中没有定义简历数据并通过json文件加载,它将加载_data/cv.yml的内容作为备选。
人员
如果您想展示多人信息,可以创建一个人员页面。每个人都可以有自己的简短介绍、个人照片,您还可以设置每个人是否出现在同一侧或相对侧。
出版物
您的出版物页面是根据BibTex参考文献自动生成的。只需编辑_bibliography/papers.bib即可。您还可以添加新的*.bib
文件,并通过编辑_pages/publications.md来自定义出版物的外观。默认情况下,出版物将按年份排序,最新的显示在最前面。您可以在_config.yml文件的Jekyll Scholar
部分更改这种行为和更多设置。
您可以为出版物添加额外信息,比如在assets/pdf/目录中的PDF文件,并在BibTeX条目中使用pdf
字段添加PDF文件的路径。一些支持的字段包括:abstract
、altmetric
、arxiv
、bibtex_show
、blog
、code
、dimensions
、doi
、eprint
、html
、isbn
、pdf
、pmid
、poster
、slides
、supp
、video
和website
。
集合
这个Jekyll主题实现了"集合"功能,让你可以将工作分类。主题自带两个默认集合:"新闻"和"项目"。"新闻"集合中的项目会自动显示在主页上。"项目"集合中的项目会以响应式网格形式显示在项目页面上。
你可以轻松创建自己的集合,如应用、短篇小说、课程,或任何你的创意作品。要做到这一点,只需编辑_config.yml文件中的集合,创建相应的文件夹,并为你的集合创建一个登陆页面,类似于_pages/projects.md
。
布局
al-folio提供了页面和博客文章的时尚布局。
Distill的标志性风格
该主题允许你创建distill.pub风格的博客文章:
关于如何使用<d-*>
标签创建Distill风格的文章,请参考这个例子。
全面支持数学公式和代码
al-folio通过MathJax支持快速数学排版,并使用GitHub风格进行代码语法高亮。还支持chartjs图表、mermaid图表和TikZ图形。
照片、音频、视频等
照片排版使用Bootstrap的网格系统变得简单。轻松在博客文章和项目页面中创建美观的网格,还支持视频和音频嵌入:
其他功能
GitHub仓库和用户统计
al-folio使用github-readme-stats和github-profile-trophy在/repositories/
页面显示GitHub仓库和用户统计信息。
编辑_data/repositories.yml
并更改github_users
和github_repos
列表,以在/repositories/
页面包含你自己的GitHub个人资料和仓库。
你也可以使用以下代码在任何其他页面显示这些内容。
<!-- GitHub用户代码 -->
{% if site.data.repositories.github_users %}
<div class="repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center">
{% for user in site.data.repositories.github_users %} {% include repository/repo_user.liquid username=user %} {% endfor %}
</div>
{% endif %}
<!-- GitHub奖杯代码 -->
{% if site.repo_trophies.enabled %} {% for user in site.data.repositories.github_users %} {% if site.data.repositories.github_users.size > 1 %}
<h4>{{ user }}</h4>
{% endif %}
<div class="repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center">
{% include repository/repo_trophies.liquid username=user %}
</div>
{% endfor %} {% endif %}
<!-- GitHub仓库代码 -->
{% if site.data.repositories.github_repos %}
<div class="repositories d-flex flex-wrap flex-md-row flex-column justify-content-between align-items-center">
{% for repo in site.data.repositories.github_repos %} {% include repository/repo.liquid repository=repo %} {% endfor %}
</div>
{% endif %}
主题
为你精心挑选了多种美丽的主题颜色供选择。默认为紫色,但你可以通过编辑_sass/_themes.scss
文件中的--global-theme-color
变量快速更改。其他颜色变量也列在那里。可用的库存主题颜色选项可以在_sass/_variables.scss中找到。你还可以在此文件中添加自己的颜色,为每种颜色分配一个名称,以便在整个模板中轻松使用。
社交媒体预览
al-folio支持社交媒体预览图。要启用此功能,你需要在_config.yml中将serve_og_meta
设置为true
。一旦完成,你网站的所有页面都将在HTML头部元素中包含Open Graph数据。
然后,你需要配置在网站的社交媒体预览中显示的图片。这可以通过设置每个页面的og_image
变量来实现。如果某个页面没有设置这个变量,主题将会使用在_config.yml中配置的全站og_image
变量作为后备选项。无论是页面特定还是全站范围的设置,og_image
变量都需要包含你希望在社交媒体预览中显示的图片URL。
Atom(类RSS)订阅
它会生成一个Atom(类RSS)格式的文章订阅源,适用于Atom和RSS阅读器。只需在你的主页地址后添加/feed.xml
即可访问订阅源。例如,假设你的网站根目录是主文件夹,你可以输入yourusername.github.io/feed.xml
来访问。
相关文章
默认情况下,博客文章底部会显示相关文章部分。这些相关文章是通过选择最近的max_related
篇文章中,与当前文章至少共享min_common_tags
个标签的文章生成的。如果你不想在特定文章中显示相关文章,只需在该文章的前置元数据中添加related_posts: false
。如果你想对所有文章禁用此功能,只需在_config.yml的related_blog_posts
部分将enabled
设置为false。
代码质量检查
目前,我们进行一些检查以确保代码质量和生成的网站质量。这些检查通过GitHub Actions和以下工具完成:
我们决定将Axe
的运行保持为手动,因为修复这些问题并不简单,对于没有网页开发知识的人来说可能比较困难。
常见问题
关于常见问题,请参考FAQ.md。
贡献
我们非常欢迎对al-folio的贡献!在开始之前,请先查看贡献指南。
如果你想改进文档或修复一个小的不一致或bug,请随时直接向master
分支发送PR。对于更复杂的问题/bug或功能请求,请使用适当的模板来开启一个issue。
维护者
我们最活跃的贡献者都欢迎加入维护团队。如果你有兴趣,请联系我们!
(维护者列表部分略)
所有贡献者
(贡献者图片部分略)
星标历史
(星标历史图表部分略)
许可证
该主题以MIT许可证的条款作为开源软件提供。
最初,al-folio基于*folio主题(由Lia Bogoev发布并采用MIT许可证)。此后,它经历了样式的全面重写并添加了许多额外的酷炫功能。