Skip to content

yihui/hugo-lithium

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code
This branch is 87 commits ahead, 20 commits behind jrutheiser:master.

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Hugo Lithium

A simple responsive blog theme for Hugo forked from https://github.com/jrutheiser/hugo-lithium-theme with modifications to make it work better with blogdown.

The easiest way to get started is to create a new (empty) RStudio project, then

devtools::install_github('rstudio/blogdown')  # install blogdown
blogdown::new_site(theme = 'yihui/hugo-lithium')

Then you should be able to see an example website launched in the RStudio Viewer.

For the full documentation, please see this section in the blogdown book: https://bookdown.org/yihui/blogdown/themes.html

Features

  • Blog
  • Responsive
  • Disqus
  • Google Analytics
  • Google web fonts (Merriweather and Lato)
  • MathJax
  • highlight.js

Changes

The main changes I made to the original hugo-lithium-theme are:

  1. Added support for MathJax (for rendering LaTeX math expressions) and highlight.js (for syntax highlighting).

    • For both libraries, you can specify the CDN host (e.g., CloudFlare, BootCDN, ...).

    • For highlight.js, you can specify additional languages (e.g., r, yaml, tex, ...).

  2. Added Google web fonts (embedded in the theme so that visitors from countries where Google is banned can still see the typefaces).

  3. Improved Hugo's built-in Disqus template, so that you can actually view the comments even when you are previewing the website locally.

  4. Replaced the variable .Permalink with .RelPermalink, and function absURL with relURL where necessary. It is a bad idea to use full absolute links (with the protocol and domain) in general. For example, .Permalink and absURL may generate URLs of the form http://www.example.com/foo/bar.html, but /foo/bar.html is more portable.

License

The original hugo-lithium-theme was released by Jonathan Rutheiser under the MIT License. The modified version in this repository is also released under MIT.

About

Lithium - A simple responsive Hugo theme

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 52.4%
  • CSS 41.7%
  • JavaScript 5.9%