Theme Information

  • Name: Joseph is a super minimal content focus theme for Jekyll.
  • Joseph is a super minimal content focus theme for Jekyll. This theme was created with a focus on typography and a reading experience and has a light and dark mode for easy reading. This theme is perfect for the personal blog of a programmer, designer, blogger, or any creative person.
  • Current Version: 1.2
  • Released: 08/01/2021
  • Creator: Artem Sheludko

Table of Contents

Configurations

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

config

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.

Important: For security reasons, Github does not allow plugins like jekyll-tagging when deploying with Github Pages. To use all the features of the plugin, use the Netlify service for deployment. All you need to do is create a new private repository on GitHub or GitLab. Upload the theme to the repository and link your repo to Netlify. Please check this link with the step by step guidelines.

Posts

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

post

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

Add post images to /images/ directory.

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.

page

Things you can change are: title and image name.

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

gallery

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

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

Disqus Comments

Joseph Theme comes with Disqus comments enabled.

Open _config.yml file, and change the anvodstudio-demo value on line 56 with your Disqus account shortname.

disqus

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.

analytics

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.

Support

If you have any questions that are not answered here, please feel free to contact me by mail.

Contact Artem

Go To Table of Contents