• Posts
Features
Quickstart
Getting Started
• Prepare Site
• Deploy in Github Pages
• Deploy in Netlify
• Automate Theme Update
Configuration
• Site Parameters
• Sections
  • About Section
  • Skills Section
  • Experiences Section
  • Education Section
  • Projects Section
  • Featured Posts Section
  • Recent Posts Section
  • Achievements Section
Writing Posts
• Organizing Posts
  • Creating Category
  • Sub-Category
    • Creating Sub-Category
• Front Matter
• Markdown Guide
• Math Guide
• Rich Content
• Mermaid
• Using Emoji
Customizing
• Enable Dark Theme
• CSS Customization
• Layout Customization
• Adding New Section
Translation
• Adding new language
• Translating Homepage
• Translating Posts
Analytics
Comments
Support Links
Shortcodes
External Link Example
Contributing
V3 to V4 Migration

Prepare Your Site

In this post, we are going to create a hugo site from scratch. Then, we will configure it with Toha theme, make it multilingual, add some example posts. At the end of this post, you should be able to run a fully functional hugo site with Toha theme locally. If you want a head start, you can just fork hugo-toha/hugo-toha.github.io repo, rename it and update with your own data. This repo has already been configured to deploy in Github Pages and Netlify.

Monday, June 8, 2020 | 8 minutes Read

Deploy site in Github Pages

In this post, we are going to deploy the site we have created in previous post in Github Pages. At first, make sure that your repository name is <your username>.github.io. Then, commit any local uncommitted changes and push into Github. Create gh-pages Branch At first, create a new branch named gh-pages. Github will automatically set respective configurations for Github Pages when it see a branch with this name. # create the gh-pages branch $ git checkout -b gh-pages # push the source branch into Github $ git push gh-pages gh-pages Enable Github Action We are going to automate the deploying process using Github Actions. At first, make sure that Github Action is enabled in your repository. Go to Settings > Actions of your repository and make sure Action permissions is set to Allow all actions. Here, is a screenshot of the respective setting:

Monday, June 8, 2020 | 3 minutes Read

Deploy site in Netlify

Netlify offers an excellent and easy process for deploying hugo static site. You can deploy your site in matter of few clicks. Unlike Github Pages, you can name your repository whatever you want. You can also customize the site URL. In this post, we will show the step-by-step process of deploying a hugo site with netlify. Add Netlify Configuration At first, create a netlify.toml file at the root of your repository and add the following configuration there:

Monday, June 8, 2020 | 3 minutes Read

Automate Theme Update

To ensure your site benefits from the most recent features and corrections, it’s crucial to keep it updated with the latest theme version. This article will guide you through the process of establishing a GitHub workflow that will automatically update the theme version. This action will perform daily checks for any updates to the theme. If an update is detected, it will generate a PR to update your site to the most recent theme version.

Monday, June 8, 2020 | 2 minutes Read