这个项目能做什么
Academic Pages 是一个基于 Jekyll 的 GitHub Pages 模板,旨在用于个人和专业作品集网站。用户可以从模板创建仓库,使用其 GitHub 用户名命名,在 `_config.yml` 中配置站点,并以 Markdown 或 HTML 添加内容。放置在 `files/` 目录中的上传文件会从相应的站点路径提供访问。
该模板包含一个 `markdown_generator` 文件夹,其中包含 Jupyter notebooks 或 Python 脚本,可以从 TSV 数据生成出版物和演讲的 Markdown 页面。它源自 Minimal Mistakes Jekyll 主题,并根据 MIT 许可证提供。
对于本地开发,文档化的设置使用 Ruby、Bundler 和 Node.js。使用 `bundle install` 安装依赖后,可以通过 Jekyll 的本地服务器预览站点,通常在 `localhost:4000`;Markdown 和 HTML 的更改会自动重新构建,而配置更改可能需要重启。该仓库还提供了 Dockerfile 和 Docker Compose 工作流,用于在无需手动安装完整本地工具链的情况下运行站点,此外还提供了 VS Code Dev Container 配置。
维护指南涵盖 GitHub issues、discussions、pull requests、fork 以及针对自定义站点的同步注意事项。由于它被设计为起始模板而非独立托管服务,用户需通过 GitHub Pages 自行管理内容、配置、GitHub 仓库和部署。
评论
0 评分人数达到10人后显示
登录后参与讨论。