{"id":15321035,"url":"https://github.com/qingwave/doit","last_synced_at":"2025-10-09T08:30:31.769Z","repository":{"id":49402214,"uuid":"430107288","full_name":"qingwave/DoIt","owner":"qingwave","description":"A clean, elegant and advanced blog theme for Hugo.","archived":false,"fork":true,"pushed_at":"2023-04-24T09:20:14.000Z","size":50540,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"qinng","last_synced_at":"2024-10-02T09:09:41.504Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hugodoit.pages.dev","language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"HEIGE-PCloud/DoIt","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qingwave.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null},"funding":{"github":"HEIGE-PCloud"}},"created_at":"2021-11-20T13:14:17.000Z","updated_at":"2024-02-01T06:38:56.000Z","dependencies_parsed_at":"2023-01-23T10:48:37.544Z","dependency_job_id":null,"html_url":"https://github.com/qingwave/DoIt","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qingwave%2FDoIt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qingwave%2FDoIt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qingwave%2FDoIt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qingwave%2FDoIt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qingwave","download_url":"https://codeload.github.com/qingwave/DoIt/tar.gz/refs/heads/qinng","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235807660,"owners_count":19047985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-01T09:09:39.945Z","updated_at":"2025-10-09T08:30:25.382Z","avatar_url":"https://github.com/qingwave.png","language":"HTML","funding_links":["https://github.com/sponsors/HEIGE-PCloud"],"categories":[],"sub_categories":[],"readme":"# DoIt Theme | Hugo\r\n\r\nEnglish README | [简体中文说明](https://github.com/HEIGE-PCloud/DoIt/blob/main/README.zh-cn.md)\r\n\r\n\u003e **DoIt** is a **clean**, **elegant** and **advanced** blog theme for [Hugo](https://gohugo.io/).\r\n\r\nIt is based on the [LoveIt Theme](https://github.com/dillonzq/LoveIt), [LeaveIt Theme](https://github.com/liuzc/LeaveIt) and [KeepIt Theme](https://github.com/Fastbyte01/KeepIt).\r\n\r\nThe DoIt theme inherits the excellent functions of these themes, and adds new functions and optimizations on this basis. Please read [Why Choose DoIt](#why-choose-doit) to learn more.\r\n\r\nThe goal of DoIt theme is to create a powerful and easy-to-use Hugo theme, so you can go straight into your blog content creation and just **do it** without worrying about the complex technical details.\r\n\r\n## Getting started\r\n\r\nHead to this [documentation page](https://hugodoit.pages.dev/theme-documentation-basics/) for a complete guidence to get started with the DoIt theme.\r\n\r\n## Migrate from LoveIt\r\n\r\nIf you are currently using the LoveIt theme, it is very easy to migrate to DoIt.\r\n\r\nYou can add this repo as a submodule of your site directory.\r\n\r\n```bash\r\ngit submodule add https://github.com/HEIGE-PCloud/DoIt.git themes/DoIt\r\n```\r\n\r\nAnd later you can update the submodule in your site directory to the latest commit using this command:\r\n\r\n```bash\r\ngit submodule update --remote --merge\r\n```\r\n\r\nAlternatively, you can download the [latest release .zip file](https://github.com/HEIGE-PCloud/DoIt/releases) of the theme and extract it in the themes directory. (Not recommended, the repo is being updated frequently so the releases may out of date.)\r\n\r\nNext, go to the `config.toml` and change the default theme to `DoIt`.\r\n\r\n```diff\r\n- theme = \"LoveIt\"\r\n+ theme = \"DoIt\"\r\n```\r\n\r\nNow the migration is finished and everything is ready 🎉\r\n\r\nMany new features and configurations have been added to the DoIt theme, check the [changelog](https://github.com/HEIGE-PCloud/DoIt/blob/main/CHANGELOG.md) and [documentation](https://hugodoit.pages.dev/) for more information.\r\n\r\n## [Demo Site](https://hugodoit.pages.dev/)\r\n\r\nTo see this theme in action, here is a live [demo site](https://hugodoit.pages.dev/) which is rendered with **DoIt** theme.\r\n\r\n## Why choose DoIt\r\n\r\n* Custom **Header**\r\n* Custom **CSS Style**\r\n* A new **home page**, compatible with the latest version of Hugo\r\n* A lot of **style detail adjustments,** including color, font size, margins, code preview style\r\n* More readable **dark mode**\r\n* Some beautiful **CSS animations**\r\n* Easy-to-use and self-expanding **table of contents**\r\n* More **social links**, **share sites** and **comment system**\r\n* **Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/) or [Fuse.js](https://fusejs.io/)\r\n* **Copy code** to clipboard with one click\r\n* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**\r\n* Extended Markdown syntax for **ruby annotation**\r\n* Extended Markdown syntax for **fraction**\r\n* **Mathematical formula** supported by [KaTeX](https://katex.org/)\r\n* **Diagram syntax** shortcode supported by [mermaid](https://github.com/knsv/mermaid)\r\n* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)\r\n* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)\r\n* Embedded **music player** supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)\r\n* **Bilibili** player supported\r\n* Kinds of **admonitions** shortcode supported\r\n* Custom style shortcodes supported\r\n* **CDN** for all third-party libraries supported\r\n* **Mulitple Authors** supported\r\n* **PJAX** supported\r\n* ...\r\n\r\nIn short,\r\nif you prefer the design language and freedom of the DoIt theme,\r\nif you want to use the extended Font Awesome icons conveniently,\r\nif you want to embed mathematical formulas, flowcharts, music or Bilibili videos in your posts,\r\nthe DoIt theme may be more suitable for you.\r\n\r\n## Features\r\n\r\n### Performance and SEO\r\n\r\n* Optimized for **performance**: 99/100 on mobile and 100/100 on desktop in [Google PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights)\r\n* Optimized SEO performance with a correct **SEO SCHEMA** based on JSON-LD\r\n* **[Google Analytics](https://analytics.google.com/analytics)** supported\r\n* **[Fathom Analytics](https://usefathom.com/)** supported\r\n* **[Baidu Analytics](https://tongji.baidu.com/)** supported\r\n* **[Umami Analytics](https://umami.is/)** supported\r\n* **[Plausible Analytics](https://plausible.io/)** supported\r\n* Search engine **verification** supported (Google, Bind, Yandex and Baidu)\r\n* **CDN** for third-party libraries supported\r\n* Automatically converted images with **Lazy Load** by [lazysizes](https://github.com/aFarkas/lazysizes)\r\n\r\n### Appearance and Layout\r\n\r\n* **Responsive** layout\r\n* **Light/Dark/Black** mode\r\n* Globally consistent **design language**\r\n* **Pagination** supported\r\n* Easy-to-use and self-expanding **table of contents**\r\n* **Multilanguage** supported and i18n ready\r\n* Beautiful **CSS animation**\r\n* Brand new **Page Layout** optimized for wide screens\r\n* Compatibility for **PWA**\r\n\r\n### Social and Comment Systems\r\n\r\n* **Gravatar** supported by [Gravatar](https://gravatar.com)\r\n* Local **Avatar** supported\r\n* Up to **64** social links supported\r\n* Up to **28** share sites supported\r\n* **Disqus** comment system supported by [Disqus](https://disqus.com)\r\n* **Gitalk** comment system supported by [Gitalk](https://github.com/gitalk/gitalk)\r\n* **Valine** comment system supported by [Valine](https://valine.js.org/)\r\n* **Waline** comment system supported by [Waline](https://waline.js.org/)\r\n* **Facebook comments** system supported by [Facebook](https://developers.facebook.com/docs/plugins/comments/)\r\n* **Telegram comments** system supported by [Telegram Comments](https://comments.app/)\r\n* **Commento** comment system supported by [Commento](https://commento.io/)\r\n* **Utterances** comment system supported by [Utterances](https://utteranc.es/)\r\n* **Twikoo** comment system supported by [Twikoo](https://twikoo.js.org/)\r\n* **Vssue** comment system supported by [Vssue](https://vssue.js.org/)\r\n* **Remark42** comment system supported by[Remark42](https://remark42.com/)\r\n* **giscus** comment system supported by [giscus](https://giscus.app/)\r\n\r\n### Extended Features\r\n\r\n* **Search** supported by [Lunr.js](https://lunrjs.com/) or [algolia](https://www.algolia.com/) or [Fuse.js](https://fusejs.io/)\r\n* **Twemoji** supported\r\n* Automatically **highlighting** code\r\n* **Copy code** to clipboard with one click\r\n* **Images gallery** supported by [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)\r\n* Extended Markdown syntax for **[Font Awesome](https://fontawesome.com/) icons**\r\n* Extended Markdown syntax for **ruby annotation**\r\n* Extended Markdown syntax for **fraction**\r\n* **Mathematical formula** supported by [KaTeX](https://katex.org/)\r\n* **Diagrams** shortcode supported by [mermaid](https://github.com/knsv/mermaid)\r\n* **Interactive data visualization** shortcode supported by [ECharts](https://echarts.apache.org/)\r\n* **Mapbox** shortcode supported by [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)\r\n* **Music player** shortcode supported by [APlayer](https://github.com/MoePlayer/APlayer) and [MetingJS](https://github.com/metowolf/MetingJS)\r\n* **Bilibili player** shortcode\r\n* Kinds of **admonitions** shortcode\r\n* **Custom style** shortcode\r\n* **Custom script** shortcode\r\n* **Custom friend** shortcode\r\n* **Animated typing** supported by [TypeIt](https://typeitjs.com/)\r\n* **Dynamic scroll** supported by native CSS\r\n* **Cookie consent banner** supported by [cookieconsent](https://github.com/osano/cookieconsent)\r\n* ...\r\n\r\n## [Documentation](https://hugodoit.pages.dev/categories/documentation/)\r\n\r\nBuild Documentation Locally:\r\n\r\n```bash\r\nhugo server --source=exampleSite\r\n```\r\n\r\n## Multilingual and i18n\r\n\r\nDoIt supports the following languages:\r\n\r\n* English\r\n* Simplified Chinese\r\n* French\r\n* Polish\r\n* Brazilian Portuguese\r\n* Italian\r\n* Spanish\r\n* German\r\n* Serbian\r\n* Russian\r\n* Romanian\r\n* Vietnamese\r\n* [Contribute with a new language](https://github.com/HEIGE-PCloud/DoIt/pulls)\r\n\r\n[Languages Compatibility](https://hugodoit.pages.dev/theme-documentation-basics/#language-compatibility)\r\n\r\n## [Roadmap](https://github.com/HEIGE-PCloud/DoIt/projects/1)\r\n\r\n## [Changelog](https://github.com/HEIGE-PCloud/DoIt/blob/main/CHANGELOG.md)\r\n\r\n## Questions, ideas, bugs, pull requests\r\n\r\nAll feedback is welcome! Head over to the [issue tracker](https://github.com/HEIGE-PCloud/DoIt/issues).\r\n\r\n## License\r\n\r\nDoIt is licensed under the **MIT** license. Check the [LICENSE file](https://github.com/HEIGE-PCloud/DoIt/blob/master/LICENSE) for details.\r\n\r\nThanks to the authors of following resources included in the theme:\r\n\r\n* [normalize.css](https://github.com/necolas/normalize.css)\r\n* [Font Awesome](https://fontawesome.com/)\r\n* [Simple Icons](https://github.com/simple-icons/simple-icons)\r\n* [Animate.css](https://daneden.github.io/animate.css/)\r\n* [autocomplete.js](https://github.com/algolia/autocomplete.js)\r\n* [Lunr.js](https://lunrjs.com/)\r\n* [algoliasearch](https://github.com/algolia/algoliasearch-client-javascript)\r\n* [Fuse.js](https://fusejs.io/)\r\n* [lazysizes](https://github.com/aFarkas/lazysizes)\r\n* [object-fit-images](https://github.com/fregante/object-fit-images)\r\n* [Twemoji](https://github.com/twitter/twemoji)\r\n* [lightgallery.js](https://github.com/sachinchoolur/lightgallery.js)\r\n* [clipboard.js](https://github.com/zenorocha/clipboard.js)\r\n* [Sharer.js](https://github.com/ellisonleao/sharer.js)\r\n* [TypeIt](https://typeitjs.com/)\r\n* [KaTeX](https://katex.org/)\r\n* [mermaid](https://github.com/knsv/mermaid)\r\n* [ECharts](https://echarts.apache.org/)\r\n* [Mapbox GL JS](https://docs.mapbox.com/mapbox-gl-js)\r\n* [APlayer](https://github.com/MoePlayer/APlayer)\r\n* [MetingJS](https://github.com/metowolf/MetingJS)\r\n* [Gitalk](https://github.com/gitalk/gitalk)\r\n* [Valine](https://valine.js.org/)\r\n* [Waline](https://waline.js.org/)\r\n* [Twikoo](https://twikoo.js.org/)\r\n* [Vssue](https://vssue.js.org/)\r\n* [Remark42](https://remark42.com/)\r\n* [cookieconsent](https://github.com/osano/cookieconsent)\r\n* [Pjax](https://github.com/PaperStrike/Pjax)\r\n* [Topbar](https://github.com/buunguyen/topbar)\r\n\r\n## Author\r\n\r\n[PCloud](https://github.com/HEIGE-PCloud)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqingwave%2Fdoit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqingwave%2Fdoit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqingwave%2Fdoit/lists"}