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
- Blog
- Responsive
- Disqus
- Google Analytics
- Google web fonts (Merriweather and Lato)
- MathJax
- highlight.js
The main changes I made to the original hugo-lithium-theme are:
-
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
, ...).
-
-
Added Google web fonts (embedded in the theme so that visitors from countries where Google is banned can still see the typefaces).
-
Improved Hugo's built-in Disqus template, so that you can actually the comments even when you are previewing the website locally.
-
Replaced the variable
.Permalink
with.RelPermalink
, and functionabsURL
withrelURL
where necessary. It is a bad idea to use full absolute links (with the protocol and domain) in general. For example,.Permalink
andabsURL
may generate URLs of the formhttp://www.example.com/foo/bar.html
, but/foo/bar.html
is more portable. Used for blog posts.
Run hugo new post/<post-name>.md
to create a post.
Used for site pages.
Run hugo new page/<page-name>.md
to create a page.
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.