| title | permalink | layout |
|---|---|---|
About | /about/ | page |
Just fork this repository to your_username.github.io and adjust the _config.yml to use with Github Pages and your page is done.
- dark mode
- KaTeX included
- no external ressources
- optional sidebar
- archive page
- syntax highlighting
- supports comments via disqus or isso
To run locally install Ruby and then run:
git clone https://github.com/niklasbuschmann/contrast.git cd contrast gem install bundler jekyll jekyll-feed bundle exec jekyll serve Your _config.yml could for example look like this:
title: "Blog Title" author: "Blog Author" description: "My blog" permalink: /:title/ lang: "en" excerpt_separator: "\n\n\n" date_format: "%B %d, %Y" # Layout show_excerpts: true # show article excerpts instead of archive list on the home page show_frame: true # display a grey frame on large screens show_sidebar: false # show a sidebar instead of the usual header show_minimal: false # remove all clutter # Menu # for available icons see https://fontawesome.com/v5/icons/ navigation: # accepts {file, title, url, icon, sidebaricon} - {file: "archive.html", sidebaricon: home} - {file: "README.md", sidebaricon: address-card} external: # accepts {file, title, url, icon, sidebaricon} - {title: Mail, icon: envelope, url: "mailto:author@example.com"} - {title: Github, icon: github, url: "https://github.com/"} - {title: Subscribe, icon: rss, url: "/feed.xml"} comments: # disqus_shortname: "" # see https://disqus.com # isso_domain: "" # see https://isso-comments.de plugins: - jekyll-feedContrast comes preinstalled with a leightweight alternative to MathJax called KaTeX. To display equations in a post simply set mathjax: true in the article's front matter. Jektex can be used to pre-render math on the server side.
