/admans.github.io

Primary LanguageClassic ASPMIT LicenseMIT

介绍

Language license GitHub stars

一款 jekyll 主题(GitHub 地址),简洁纯净(主题资源请求<20KB),未引入任何框架,秒开页面,支持自适应,支持全文检索,支持夜间模式

你可以到 TMaize Blog 查看主题效果,欢迎添加友链

感谢

JetBrains 免费提供的开发工具 JetBrains

夜间模式代码高亮配色

本地运行

一般提交到 github 过个几十秒就可以看到效果,如果你需要对在本地查看效果需要安装 ruby 环境和依赖

windows 下推荐在 wsl 下装 ruby,直接一句apt install build-essential ruby ruby-dev就行了

# linux 下需要 gcc

# gem sources --add https://gems.ruby-china.com/
# gem sources --remove https://rubygems.org/
# gem sources --remove https://mirrors.aliyun.com/rubygems/
# gem sources -l
gem install bundler
# bundle config mirror.https://rubygems.org https://gems.ruby-china.com
bundle install

通过下面命令启动/编译项目

bundle exec jekyll serve --watch --host=127.0.0.1 --port=8080
bundle exec jekyll build --destination=dist

如果需要替换代码高亮的样式可以通过下面的命令生成 css

rougify help style
rougify style github > highlighting.css

项目配置

  1. 如果使用自己的域名,CNAME文件里的内容请换成你自己的域名,然后 CNAME 解析到用户名.github.com

  2. 如果使用 GitHub 的的域名,请删除CNAME文件,然后把你的项目修改为用户名.github.io

  3. 修改pages/about.md中关于我的内容

  4. 修改_config.yml文件,具体作用请参考注释

  5. 清空posts_posts目录下所有文件,注意是清空,不是删除这两个目录

  6. 网站的 logo 和 favicon 放在了static/img/下,替换即可,大小无所谓,图片比例最好是 1:1

  7. 如果你是把项目 fork 过去的,想要删除我的提交记录可以使用下面的命令

    git checkout --orphan temp
    git add . && git commit -m init
    git branch -D master
    git branch -m temp master
    git push --force
    

使用

文章放在_posts目录下,命名为yyyy-MM-dd-xxxx-xxxx.md,内容格式如下

---
layout: mypost
title: 标题
categories: [分类1, 分类2]
---
文章内容,Markdown 格式

文章资源放在posts目录,如文章文件名是2019-05-01-theme-usage.md,则该篇文章的资源需要放在posts/2019/05/01下,在文章使用时直接引用即可。当然了,写作的时候会提示资源不存在忽略即可

![这是图片](xxx.png)

[xxx.zip 下载](xxx.zip)