| .. | ||
| .devcontainer | ||
| .github | ||
| .vscode | ||
| archetypes | ||
| assets | ||
| exampleSite | ||
| i18n | ||
| images | ||
| layouts | ||
| resources/_gen/assets/scss | ||
| src | ||
| static/lib | ||
| .all-contributorsrc | ||
| .babelrc | ||
| .eslintrc | ||
| .gitignore | ||
| .huskyrc | ||
| .lintstagedrc | ||
| .prettierignore | ||
| .prettierrc | ||
| .stylelintrc | ||
| .versionrc.json | ||
| CHANGELOG.md | ||
| commitlint.config.js | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| renovate.json | ||
| theme.toml | ||
CodeIT Theme | Hugo
CodeIT is a clean, elegant but advanced blog theme for Hugo.
It is based on the original LoveIt Theme, LeaveIt Theme, and KeepIt Theme.
Since the three themes have a similar look, if you have questions about their differences, read Why to choose CodeIT so that you can choose the one that works best for you.
⏳ Brief history
This theme is based on the original LoveIt theme. The original theme was loved by many users, but since May 2020 it has not been maintained.
We tried to contact the theme owner, but without success. The contributors have opened an issue and asked if the theme is still supported, but we also did not receive any response.
So we decided to create and maintain the theme with a new name, keeping the original style, but continuously improving it. Feel free to contribute to this theme 😊.
💻 Demo Site
To see this theme in action, here is a live demo site that is rendered with the CodeIT theme.
❓ Why choose CodeIT
Compared to the original LeaveIt theme and the KeepIt theme, the CodeIT theme has the following modifications.
- Custom Header
- Custom CSS Style
- A new home page, compatible with the latest version of Hugo
- A lot of style detail adjustments, including color, font size, margins, code preview style
- More readable dark mode
- Some beautiful CSS animations
- Easy-to-use and self-expanding table of contents
- More social links, share sites, and comment system
- Search supported by Lunr.js or Algolia
- Copy code to the clipboard with one click
- Extended Markdown syntax for Font Awesome icons
- Extended Markdown syntax for ruby annotation
- Extended Markdown syntax for fractions
- Mathematical formula supported by KaTeX
- Diagram syntax shortcode supported by mermaids
- Interactive data visualization shortcode supported by ECharts
- Mapbox shortcode supported by Mapbox GL JS
- Embedded music player supported by APlayer and MetingJS
- Bilibili player supported
- Kinds of admonitions shortcode supported
- Custom style shortcodes supported
- CDN for all third-party libraries supported
- ...
In short, if you prefer the design language and freedom of the CodeIT theme, if you want to use the extended Font Awesome icons conveniently, if you want to embed mathematical formulas, flowcharts, music, or Bilibili videos in your posts, the CodeIT theme may be more suitable for you.
I hope you will CodeIT 👩💻!
📖 Features
⚡ Performance and SEO
- Optimized for performance: 99/100 on mobile and 100/100 on the desktop in Google PageSpeed Insights
- Optimized SEO performance with a correct SEO SCHEMA based on JSON-LD
- Google Analytics supported
- Fathom Analytics supported
- Plausible Analytics supported
- Search engine verification supported (Google, Bind, Yandex, and Baidu)
- CDN for third-party libraries supported
- Automatically converted images with Lazy Load by lazysizes
🖥️ Appearance and Layout
- Responsive layout
- Light/Dark mode
- Globally consistent design language
- Pagination supported
- Easy-to-use and self-expanding table of contents
- Multilanguage supported and i18n ready
- Beautiful CSS animation
💭 Social and Comment Systems
- Gravatar supported by Gravatar
- Local Avatar supported
- Up to 64 social links supported
- Up to 28 share sites supported
- Disqus comment system supported by Disqus
- Gitalk comment system supported by Gitalk
- Valine comment system supported by Valine
- Facebook comments system supported by Facebook
- Telegram comments system supported by Telegram Comments
- Commento comment system supported by Commento
- Utterances comment system supported by Utterances
- Waline comment system supported by Waline
- Twikoo comment system supported by Twikoo
✨ Extended Features
- Search supported by Lunr.js or algolia
- Twemoji supported
- Automatically highlighting code
- Copy code to the clipboard with one click
- Images gallery supported by lightgallery.js
- Extended Markdown syntax for Font Awesome icons
- Extended Markdown syntax for ruby annotation
- Extended Markdown syntax for fractions
- Mathematical formula supported by KaTeX
- Diagrams shortcode supported by mermaids
- Interactive data visualization shortcode supported by ECharts
- Mapbox shortcode supported by Mapbox GL JS
- Music player shortcode supported by APlayer and MetingJS
- Bilibili player shortcode
- Kinds of admonitions shortcode
- Custom style shortcode
- Custom script shortcode
- Animated typing supported by TypeIt
- Dynamic scroll supported by Smooth Scroll
- Cookie consent banner supported by cookieconsent
- ...
🎯 Add the theme to your blog
First, download the theme from GitHub and add it to your site’s themes directory:
cd your-hugo-blog-directory
git init
git submodule add https://github.com/sunt-programator/CodeIT.git themes/CodeIT
Note for non-git users:
If you do not have git installed, you can download the archive of the latest version of this theme from the release page of this repository.
Extract the .zip file to get a CodeIT-latest directory.
Rename that directory to CodeIT, and move it into the themes/ directory.
Then, add the theme to the site configuration:
echo 'theme = "CodeIT"' >> config.toml
📄 Build documentation instructions
You can build the theme documentation locally by using a devcontainer or by manually install the Hugo.
The main advantage of the devcontainer is that you will have a preconfigured container with all tools required for developing and building the theme documentation.
hugo server --source=exampleSite
🌍 Multilingual and i18n
CodeIT supports the following languages:
- English
- Simplified Chinese
- French
- Polish
- Brazilian Portuguese
- Italian
- Spanish
- German
- Serbian
- Russian
- Romanian
- Vietnamese
- Contribute with a new language
❓ Questions, ideas, bugs, pull requests
All feedback is welcome! Head over to the issue tracker.
📜 License
CodeIT is licensed under the MIT license. Check the LICENSE file for details.
Thanks to the authors of the following resources included in the theme:
- normalize.css
- Font Awesome
- Simple Icons
- Animate.css
- Smooth Scroll
- autocomplete.js
- Lunr.js
- algoliasearch
- lazysizes
- object-fit-images
- Twemoji
- lightgallery.js
- clipboard.js
- Sharer.js
- TypeIt
- KaTeX
- mermaid
- ECharts
- Mapbox GL JS
- APlayer
- MetingJS
- Gitalk
- Valine
- cookieconsent
💰 Sponsor
If you enjoy the theme, please consider buying me a coffee ☕️.
🎉 Contributors
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!