Theme Information

• Name: Menca – Modern personal blogging theme for Jekyll.
• Menca is a super fast and clean blogging theme for Jekyll. One of the main features of this theme is video post support. You can easily add your favorite video from services like Youtube or Vimeo. This theme is fully compatible with Github Pages and has a light and dark mode for easy reading. If you want to start a creative personal blog and you create video content this theme is perfect for you.
• Current Version: 1.0
• Released: 28/05/2021
• Creator: Artem Sheludko

Table of Contents

• Configurations
• Installing Ruby & Jekyll
• Deployment
• Posts
• Pages
• Gallery
• Navigation
• Disqus Comments
• Google Analytics
• Update favicon
• Credits
• Support

Configurations

Menca theme comes with different customizations in the _config.yml file:

Installing Ruby & Jekyll

If this is your first time using Jekyll, please follow the Jekyll docs and make sure your local environment (including Ruby) is setup correctly.

Deployment

To run the theme locally, navigate to the theme directory and run bundle install to install the dependencies, then run bundle exec jekyll serve to start the Jekyll server.

I would recommend checking the Deployment Methods page on Jekyll website.

Posts

To create a new post, you can create a new markdown file inside the _posts directory by following the recommended file structure.

You can set the title, tags, and the post image.

Add post images to /images/ directory.

Full Width Image

To have wide images in posts or pages simply add #wide word with the hashtag at the end of image path like in the example below:

![River]({{site.baseurl}}/images/15-1.jpg#wide)

Video Post

To create a video post, specify the url/link to the video in the video_embed: field like in the example below:

video_embed: https://www.youtube.com/embed/gghgYaYeG_M

For tags, try to not add space between two words, for example, Ruby on Rails, could be something like (ruby-on-rails, Ruby_on_Rails, or Ruby-on-Rails).

Pages

To create a new page, just create a new markdown file inside the _pages directory.

The following is the about.md file that you can find as an example included in the theme with the configurations you can set.

Things you can change are: title, permalink, and image name.

Gallery

Use HTML markup to use gallery on pages. For example:

Don't forget to provide the correct path for your images.

Navigation

The navigation on the header will automatically include all the links to the pages you have created.

Disqus Comments

Menca Theme comes with Disqus comments enabled.

Open config.yml file, and change the demo-menca value on line 83 with your Disqus account shortname.

That’s all you need to setup Disqus from the theme side. If you get any issue regarding that comments are unable to load. First, make sure you have registered your website with Disqus (Step 1).

And also check Disqus troubleshooting guide if you still have issues.

Google Analytics

To integrate Google Analytics, open config.yml, and add your Google Analytics identifier.

Update favicon

You can find the current favicon (favicon.ico) inside the theme root directory, just replace it with your new favicon.

Credits

I have used the following scripts, fonts or other files as listed.

• Google Fonts (Jost).
• Vanilla Lazyload
• Ionicons
• Lightense Images
• Reframe.js
• Simple Jekyll Search
• Smooth Scroll Polyfill
• Preview Images form unsplash.com, pexels.com

Support