🌓 Moonrise is a fresh take on the classic Moon theme, with a modern design, improved responsiveness, and more customization options.
- Minimal, you can focus on your content
- Responsive
- Syntax highlighting
- Optional post image
- Social icons
- Page for sharing projects
- Optional background image
- Simple navigation menu
- MathJax support
See a live version of Moon hosted on GitHub.
To learn how to install and use this theme check out the Setup Guide for more information.
- Fork the Moonrise repo
- Edit
_config.ymlfile. - Remove sample posts from
_postsfolder and add yours. - Edit
index.mdfile inaboutfolder. - Change repo name to
YourUserName.github.io
That's all.
A quick checklist of the files you’ll want to edit to get up and running.
_config.yml is your friend. Open it up and personalize it. Most variables are self explanatory but here's an explanation of each if needed:
The title of your site... shocker!
Example title: My Awesome Site
The description to show on your homepage.
The description to use for meta tags and navigation menu.
Used to generate absolute urls in sitemap.xml, feed.xml, and for generating canonical URLs in <head>. When developing locally either comment this out or use something like http://localhost:4000 so all assets load properly. Don't include a trailing /.
Examples:
{% highlight yaml %} url: http://tolgatatli.me/Moonrise url: http://localhost:4000 url: //cooldude.github.io url {%endhighlight%}
Set true to show reading time for posts. And set words_per_minute, default is 200.
Your site's logo. It will show on homepage and navigation menu. Also used for twitter meta tags.
Image for background. If you don't set it, color will be used as a background.
To set what links appear in the top navigation edit _data/navigation.yml. Use the following format to set the URL and title for as many links as you'd like. External links will open in a new window.
{% highlight yaml %}
-
title: Home url: /
-
title: Blog url: /blog/
-
title: Projects url: /projects/
-
title: About url: /about/
-
title: Moon url: http://tolgatatli.me/Moon {% endhighlight %}
Moon Theme use Jekyll Compress to compress html output. But it can cause errors if you use "linenos" (line numbers). I suggest don't use line numbers for codes, because it won't look good with this theme, also i didn't give a proper style for them. If you insist to use line numbers, just remove layout: compress string from layouts. It will disable compressing.
You can set feature image per post. Just add feature: some link to your post's front matter.
feature: /assets/img/some-image.png
or
feaure: http://example.com/some-image.png