Skip to content

NYIST-CIPS/website

This branch is 83 commits ahead of, 167 commits behind ustclug/website:master.

Folders and files

NameName
Last commit message
Last commit date
Mar 14, 2024
Sep 22, 2024
Mar 2, 2024
Apr 4, 2023
Mar 2, 2024
Apr 4, 2023
Sep 25, 2024
Apr 24, 2024
Mar 2, 2024
May 10, 2022
Nov 28, 2020
Mar 12, 2024
May 28, 2020
Oct 30, 2023
Mar 19, 2024
Oct 30, 2023
Oct 30, 2023
Sep 11, 2023

Repository files navigation

CIPS @ NYIST 主页

本站 fork 自中国科学技术大学 Linux 用户协会主页

本仓库为源代码,所有推送到 master 分支的修改会使用 GitHub Actions 自动编译和部署。

添加与修改页面

本网站采用 Minimal Mistakes 主题,各自定义项目参见主题的文档。

添加新页面(Wiki / News / Planet)请分别在 pages/_wikipages/_newspages/_planet 中参考 _template.md

设置文章作者请在 _data/authors.yml 中添加作者信息(参考已有内容),然后在页面中指定 author: key(只支持一个作者)。

为了避免仓库过度膨胀,请避免将图片上传至本仓库。图片的处理方式有以下几种:

  • 上传至 website-static 仓库,并使用如下格式引用:

    ![图片的 alt 文字]({{ site.static_url }}/path/to/image.jpg)

本地预览与构建

  1. 安装 Ruby 开发环境(略)

  2. 运行 bundle install --path=vendor/bundle 以安装依赖的软件包

  3. 运行 bundle exec jekyll serve,此时即可在 http://localhost:4000/ 预览网站

  4. 编译整个网站的命令为

    bundle exec jekyll build

    在命令行末尾添加 --profile 可以查看编译性能分析(每个源文件耗时),添加 --trace 可以在出错时输出 stack trace

    正式部署时需要添加环境变量 JEKYLL_ENV=production,详情请见 GitHub Actions 的 workflow 配置

Markdown 格式化

请在提交前使用 prettier 进行格式化。

  1. 安装 Node.js 开发环境(略)
  2. 运行 npm install 以安装 prettier
  3. 使用 npm run fix 自动格式化。可以将不希望 prettier 处理的文件加入 .prettierignore,未来可能会加上 YAML 和 SCSS 格式文件的处理
  4. 使用 npm run check 验证格式无问题

许可

本仓库及本网站以 CC BY-NC-SA 4.0 许可协议开源。

About

The next-gen website of CIPS@NYIST.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 52.4%
  • SCSS 35.4%
  • Ruby 11.5%
  • Nix 0.7%