{"id":25869534,"url":"https://github.com/tobylai-toby/hexo-theme-mdsuper","last_synced_at":"2025-03-02T05:18:09.464Z","repository":{"id":219073646,"uuid":"748084145","full_name":"tobylai-toby/hexo-theme-mdsuper","owner":"tobylai-toby","description":"A hexo blog theme using mdui-v2 with Material You (Material Design 3). Supports comment systems (twikoo, gitalk).","archived":false,"fork":false,"pushed_at":"2024-02-05T07:22:58.000Z","size":1177,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-02-05T08:34:35.389Z","etag":null,"topics":["gitalk","hexo","hexo-theme","javascript","local-search","material-design","material-design-3","material-you","mdui","responsive","theme","twikoo"],"latest_commit_sha":null,"homepage":"https://tobylai.fun","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tobylai-toby.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-01-25T08:38:42.000Z","updated_at":"2024-02-05T05:19:57.000Z","dependencies_parsed_at":"2024-01-28T16:24:10.002Z","dependency_job_id":"5d3951a0-f9b1-46dc-aee4-31127e603102","html_url":"https://github.com/tobylai-toby/hexo-theme-mdsuper","commit_stats":null,"previous_names":["tobylai-toby/hexo-theme-mdsuper"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobylai-toby%2Fhexo-theme-mdsuper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobylai-toby%2Fhexo-theme-mdsuper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobylai-toby%2Fhexo-theme-mdsuper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobylai-toby%2Fhexo-theme-mdsuper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tobylai-toby","download_url":"https://codeload.github.com/tobylai-toby/hexo-theme-mdsuper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241460397,"owners_count":19966559,"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":["gitalk","hexo","hexo-theme","javascript","local-search","material-design","material-design-3","material-you","mdui","responsive","theme","twikoo"],"created_at":"2025-03-02T05:18:08.849Z","updated_at":"2025-03-02T05:18:09.456Z","avatar_url":"https://github.com/tobylai-toby.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hexo-theme-mdsuper\n![1706268121039](README/1706268121039.png)\n\n[简体中文](https://github.com/tobylai-toby/hexo-theme-mdsuper/blob/main/README.zh-CN.md)\n\nA [hexo](https://hexo.io) blog theme using [mdui-v2](https://mdui.org) with Material You (Material Design 3). \nSupports some comment system and [Prismjs](https://prismjs.com/) highlight.\n\n## Feature\n- front-matter `photos` gallery (using fancybox \u0026 carousel)\n- prismjs highlight\n- comment systems support\n  - [twikoo](https://twikoo.js.org)\n  - [gitalk](https://github.com/gitalk/gitalk)\n  - [waline](https://waline.js.org)\n\n- mdui v2\n- fancybox for images\n- local search for posts (requires [wzpan/hexo-generator-search](https://github.com/wzpan/hexo-generator-search))\n\n## Install\n```bash\ncd your-hexo-site/\ngit clone https://github.com/tobylai-toby/hexo-theme-mdsuper.git themes/mdsuper\n```\n### Activation\ngo to `your-hexo-site/_config.yml` and change theme to mdsuper.\n```yaml\ntheme: mdsuper\nlanguage: zh-CN # default is en\n# set language to zh-CN if you are using Chinese\n```\n## Prismjs\nmdsuper uses [prismjs](https://prismjs.com/) to highlight code.\n\n`prism.js` and `prism.css` are included in the theme, but it's recommended to use a customized version because you can choose what languages and plugins to include.\n\nGo to [prismjs download](https://prismjs.com/download.html) to download a customized download.\n- Move `prism.js` to `your-hexo-site/themes/mdsuper/source/js/prism.js`.\n- Move `prism.css` to `your-hexo-site/themes/mdsuper/source/css/prism.css`.\n\n## Cover\n```markdown\n---\ntitle: \ndate: \ntags: \ncategories: \ncover: cover image url\n---\n```\n\n## Builtin Layouts\n- `post`: post layout\n- `onlycontent`: only content layout (comments are still enabled, disable it by using frontmatter `comments: false`)\n\n## Configuration\ngo to `your-hexo-site/themes/mdsuper/_config.yml` and configure it.\n```yaml\ntheme:\n  colorScheme: \"#4fd8eb\" # change color theme\n  layout: dark # dark | light | auto\n\nfavicon: \"\" # path( or url) of avatar such as /favicon.png\n\ndrawer:\n  always_open: false\n  menu: \n    Home: \n      icon: home \n      url: /\n    ...\n\ncopyright: \"\" # text appear at the bottom of the page\n\ncomment:\n  system: none # none | twikoo | gitalk\n  twikoo:  # see: https://twikoo.js.org/frontend.html\n    cdn: \n      js: /js/twikoo.all.min.js # or use cdn such as https://cdn.bootcdn.net/ajax/libs/twikoo/1.6.31/twikoo.all.min.js\n    \n    # twikoo settings:\n    envId: \"\"\n    region: '' # region, see twikoo documentation\n    path: location.pathname # will eval this, be careful\n    lang: 'zh-CN' \n  gitalk: # see https://github.com/gitalk/gitalk\n    cdn:\n      css: /css/gitalk.css\n      js: /js/gitalk.min.js\n\n    # gitalk settings:\n    clientID: '' # GitHub Application Client ID\n    clientSecret: '' # GitHub Application Client Secret\n    repo: '' # GitHub repo\n    owner: '' # GitHub repo owner\n    admin: [] # GitHub repo owner and collaborators, only these guys can initialize github issues\n    id: decodeURIComponent(location.pathname)# will eval this, be careful\n    # this is like /2024/01/24/xxxxxxxxxx ,make sure the length \u003c 50\n    # Ensure uniqueness and length less than 50\n    distractionFreeMode: false  # Facebook-like distraction free mode\n    #proxy: \n    # you may need a reverse proxy to support cors, default url may not work in some places(such as cn)\n  waline:\n    #...\n\n# supports twikoo comment system\n# this way only supports v0.2.0-beta, move to \"comment\" instead\n# see: https://twikoo.js.org/frontend.html\n# twikoo: \n#   enable: false\n#   cdn: js/twikoo.all.min.js \n#   # twikoo settings:\n#   envId: \"\"\n#   region: '' \n#   path: location.pathname # will eval this, be careful\n#   lang: 'zh-CN' \n\n# display in the card at the top of the page under the subtitle\ndisplay_index_top:\n  text: \"dev-mdsuper\"\n  avatar: \"\" # path( or url) of avatar such as /avatar.png\n\n# assets\nmdui:\n  css: https://unpkg.com/mdui@2.0.3/mdui.css\n  js: https://unpkg.com/mdui@2.0.3/mdui.global.js\n\n# install https://github.com/wzpan/hexo-generator-search and configure it following the readme\nsearch:\n  enable: true\n  xml: /search.xml # only supports xml\n```\n\n## Preview Site\n[Tobylai.fun](https://tobylai.fun)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobylai-toby%2Fhexo-theme-mdsuper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftobylai-toby%2Fhexo-theme-mdsuper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobylai-toby%2Fhexo-theme-mdsuper/lists"}