Maupassant IC is a free, minimalistic, light, and responsive Hugo theme designed for bloggers. It offers a clean design focused on readability and simplicity, ensuring your content stands out on desktops, laptops, tablets and phones.
- Responsive design
- Minimalistic and clean layout
- Easy customization
- SEO friendly
- Google Tag Manager integration (Google Analytics, etc.)
- Multilingual support
- Extensive customizations
- Multiple Languages (i18n): Supports English, French, German, Spanish, Japanese, Korean, Chinese (simplified & traditional).
- Google Tag Manager (GTM): Integrates seamlessly with Google Analytics, Ads, Optimize, and many other services without requiring code changes.
- Comments: Compatible with Disqus, Utterances, and Waline comment systems.
- Categories & Tags: Includes dedicated pages and sidebar list widgets.
- Recent Posts: Display the most recent submissions.
- Related Posts: Automatically suggest related posts to readers.
- Multiple Authors: Support for multiple authors via front matter.
- Site Search: Offers both local-native search and Google site search options.
- RSS: Works out-of-the-box for syndicating your content.
- Custom CSS and JS files: Easily configure to point to your own custom files.
- Archives: Dedicated page for listing all your posts.
- Configurable Sidebar: Options for displaying recent posts, ads, categories & tags, third-party links, and social network links.
- CI/CD: Sample continuous integration via GitHub workflows.
- Hugo >= 0.127.0
The theme was developed and tested with v0.127.0. If this version is not available for your default package manager, try one from Snap.
-
Clone the Repository into your Hugo website directory:
git clone https://github.com/bryndin/maupassant-hugo/ themes/maupassant
-
Copy example configuration and modify it for your needs:
cp themes/maupassant/exampleSite/hugo.toml .
-
Copy "about.md", "archives.md" and "search.md" content files. Modify "about" page for your needs.
cp themes/maupassant/exampleSite/content/about.md content/
cp themes/maupassant/exampleSite/content/archives.md content/
cp themes/maupassant/exampleSite/content/search.md content/
To update the theme, navigate to the theme directory and pull the latest changes:
cd themes/maupassant
git pull
Follow the comments in sample hugo.toml
Most of the theme features, e.g. comments, categories, tags, etc. by default only apply to the blog post pages. What page is blog post is configured via required blogType
parameter in the [params]
section of hugo.toml
.
blogType
is a directory name of your blog content (e.g. posts
, for content/posts
directory). To mark any other page a blog post, set e.g. type: posts
in front matter.
Prerequisite: Pick one of the supported comments systems: Disqus, Utterances, or Waline, and configure it in your hugo.toml
.
- (Override) Force comments on a page by setting
comments: true
in the front matter. - Globally enable comments for blog posts by setting
comments = true
in[params]
section ofhugo.toml
.
To automate website deployment from a GitHub repository to GitHub Pages, adjust our workflow of the theme exampleSite
.
Layout Customization
Modify layout files in the layouts
directory to customize the theme's appearance.
Adding Widgets
Add widgets by modifying the sidebar.html
partial in the layouts/partials
directory.
Configuring Menus
Define menus in the config.toml
as shown in the example configuration.
Customizing the Footer
Edit the footer.html
partial to customize the footer content.
Reporting Bugs Report bugs by creating an issue.
Getting Help For help, check the Hugo community forums or Hugo documentation.
Local search is based on RSS (index.html
file). If you don't see the list of results
-
Check RSS is working locally
https://localhost:1313/index.xml
(orhttps://localhost:1313/<path from baseURL>/index.xml
). -
Do the same for the deployed site.
-
Check local search is enabled in
hugo.toml
[params.search] disable = false localSearch = true
-
Verify there is a
content/search.md
file with thetype: "search"
line in the front matter.
- Verify there is a
content/archives.md
file with thetype: "archives"
line in the front matter.
No need to integrate Google Analytics, AdSense, etc. code into your website. The theme has the support for Google Tag Manager (GTM) containerization. Include your GTM key in hugo.toml
and the rest of integrations are done via GTM website.
[params.googletagmanager]
gtmid = "GTM-xxxxxx" # Google Tag Manager ID
Follow Google's instructions, they claim it takes them up to 48h to start showing data.
All translations are in the i18n
directory in theme/maupassant
. If there's an error, please open an issue, indicate the language and suggest the correct translation. Pull requests are always welcome.
Submitting Pull Requests Fork the repository, create a new branch, and submit a pull request with your changes.
The Maupassant theme was originally created by Cho for the Typecho PHP blogging platform. It has been ported to multiple platforms, including Hugo. The initial Hugo port was created by JokerQyou and further improved by Flysnow-org. These versions are primarily targeted at an oriental audience and offer good integrations with Chinese services.
"Maupassant IC" is an enhanced version tailored for an international audience.
SVG Icons from Bootstrap Icons.