{"id":13430740,"url":"https://github.com/Siricee/hexo-theme-Chic","last_synced_at":"2025-03-16T06:31:06.045Z","repository":{"id":37396790,"uuid":"191508938","full_name":"Siricee/hexo-theme-Chic","owner":"Siricee","description":"An elegant, powerful, easy-to-read Hexo theme.","archived":false,"fork":false,"pushed_at":"2023-12-20T14:17:35.000Z","size":7085,"stargazers_count":864,"open_issues_count":19,"forks_count":174,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-05-20T09:17:11.791Z","etag":null,"topics":["chic-theme","dark-theme","demo","elegant","hexo","hexo-blog","hexo-theme","mathjax","read-hexo-theme"],"latest_commit_sha":null,"homepage":"https://siricee.github.io/hexo-theme-Chic/","language":"Stylus","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Siricee.png","metadata":{"files":{"readme":"README-CN.md","changelog":"ChangeLogs.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-12T06:13:00.000Z","updated_at":"2024-07-11T01:27:40.552Z","dependencies_parsed_at":"2024-07-11T01:38:57.869Z","dependency_job_id":null,"html_url":"https://github.com/Siricee/hexo-theme-Chic","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siricee%2Fhexo-theme-Chic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siricee%2Fhexo-theme-Chic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siricee%2Fhexo-theme-Chic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Siricee%2Fhexo-theme-Chic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Siricee","download_url":"https://codeload.github.com/Siricee/hexo-theme-Chic/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221656359,"owners_count":16858753,"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":["chic-theme","dark-theme","demo","elegant","hexo","hexo-blog","hexo-theme","mathjax","read-hexo-theme"],"created_at":"2024-07-31T02:00:57.279Z","updated_at":"2025-03-16T06:31:06.040Z","avatar_url":"https://github.com/Siricee.png","language":"Stylus","funding_links":[],"categories":["Content","Stylus"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\u003ca href=\"https://github.com/Siricee/hexo-theme-Chic\" target=\"_blank\"\u003eChic Theme\u003c/a\u003e\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://i.loli.net/2019/06/12/5d006bd289aa325037.png\" alt=\"Chic theme\"\u003e\n\u003c/p\u003e\n\n\u003e Chic,法语词意同'Elegant'\n\n\u003cp align=\"center\"\u003e\n\u003cimg alt=\"Author\" src=\"https://img.shields.io/badge/Author-Sirice-lightgray.svg\"/\u003e\n\u003cimg alt=\"Node\" src=\"https://img.shields.io/badge/Node-6.0%2B-43853d.svg\"/\u003e\n\u003cimg alt=\"Hexo\" src=\"https://img.shields.io/badge/Hexo-3.0+-0e83cd.svg\"/\u003e\n\u003cimg alt=\"Device\" src=\"https://img.shields.io/badge/Device-responsive-orange.svg\"/\u003e\n\u003cimg alt=\"Build Status\" src=\"https://img.shields.io/badge/build-passing-brightgreen\"/\u003e\n\u003c/p\u003e\n\n## 文档语言\n\n- [中文文档](README-CN.md)\n- [English](README.md)\n\n## Contents 目录\n- [Introduction 介绍](#introduction-介绍)\n- [Demo 演示](#demo-演示)\n- [Features 特点](#features-特点)\n- [Installation 安装](#installation-安装)\n- [Configuration 配置](#configuration-配置)\n- [Customize 自定义](#customize-自定义)\n- [FAQ 提问](#faq-提问)\n- [Gallary 图片展示](#gallary-图片展示)\n- [License 开源许可](#license-开源许可)\n\n\n## Introduction 介绍\n\n优雅、功能全面、阅读友好的hexo主题。\n\n## Demo 演示\n- [Demo site](https://siricee.github.io/hexo-theme-Chic)\n- \u003cdel\u003e[作者的博客](https://siricee.github.io/)\u003c/del\u003e (*不再使用 hexo 驱动*)\n\n## Features 特点\n- 恰到好处的留白，优雅却不简陋。\n- 夜间模式主题一键切换。\n- 多种代码高亮方案。\n- 精心挑选的字体，最好的阅读体验。\\* *特别推荐 微软正黑*\n- 响应式适配移动端/桌面端。\n- 支持MathJax，支持LaTeX语法的数学公式\n\n## Installation 安装\n\n```bash\ncd your-blog/themes\ngit clone https://github.com/Siricee/hexo-theme-Chic.git Chic\n// Modify theme setting in _config.yml to Chic.\n```\n\n## Configuration 配置\n\u003cdetails\u003e\n\u003csummary\u003e\u003cmark\u003e点击展开配置文件\u003c/mark\u003e\u003c/summary\u003e\n\n```yaml\n# Header\nnavname: Bentham's Blog\n\n# navigatior items\nnav:\n  Posts: /archives\n  Categories: /category\n  Tags: /tag\n  About: /about\n\n# favicon\nfavicon: /favicon.ico\n\n# Profile\nnickname: Jeremy Bentham\n\n### this variable is MarkDown form.\ndescription: Lorem ipsum dolor sit amet, **consectetur adipiscing elit.** \u003cbr\u003eFusce eget urna vitae velit *eleifend interdum at ac* nisi.\navatar: /image/avatar.jpeg\n\n# main menu navigation\n## links key words should not be changed.\n## Complete url after key words.\n## Unused key can be commented out.\nlinks:\n  Blog: /archives\n#  Category:\n#  Tags:\n#  Link:\n#  Resume:\n#  Publish:\n#  Trophy:\n#  Gallary:\n#  RSS:\n#  AliPay:\n  ZhiHu: https://www.zhihu.com/people/sirice\n#  LinkedIn:\n#  FaceBook:\n#  Twitter:\n#  Skype:\n#  CodeSandBox:\n#  CodePen:\n#  Sketch:\n#  Gitlab:\n#  Dribble:\n  Instagram:\n  Reddit:\n#  YouTube:\n#  QQ:\n#  Weibo:\n#  WeChat:\n  Github: https://github.com/Siricee\n\n# how links show: you have 2 choice--text or icon.\nlinks_text_enable: false\nlinks_icon_enable: true\n\n# Post page\n## Post_meta\npost_meta_enable: true\n\npost_author_enable: true\npost_date_enable: true\npost_category_enable: true\n## Post copyright\npost_copyright_enable: true\n\npost_copyright_author_enable: true\npost_copyright_permalink_enable: true\npost_copyright_license_enable: true\npost_copyright_license_text: Copyright (c) 2019 \u003ca href=\"http://creativecommons.org/licenses/by-nc/4.0/\"\u003eCC-BY-NC-4.0\u003c/a\u003e LICENSE\npost_copyright_slogan_enable: true\npost_copyright_slogan_text: Do you believe in \u003cstrong\u003eDESTINY\u003cstrong\u003e?\n## toc\npost_toc_enable: true\n\n# Page\npage_title_enable: true\n\n# Date / Time format\n## Hexo uses Moment.js to parse and display date\n## You can customize the date format as defined in\n## http://momentjs.com/docs/#/displaying/format/\ndate_format: MMMM D, YYYY\ntime_format: H:mm:ss\n\n# stylesheets loaded in the \u003chead\u003e\nstylesheets:\n  - /css/style.css\n\n# scripts loaded in the end of the body\nscripts:\n  - /js/script.js\n  - /js/tocbot.min.js\n    # tscanlin/tocbot: Build a table of contents from headings in an HTML document.\n    # https://github.com/tscanlin/tocbot\n\n\n# plugin functions\n## Mathjax: Math Formula Support\n## https://www.mathjax.org\nmathjax:\n  enable: true\n  import: demand # global or demand\n  ## global: all pages will load mathjax,this will degrade performance and some grammers may be parsed wrong.\n  ## demand: Recommend option,if your post need fomula, you can declare 'mathjax: true' in Front-matter\n```\n\u003c/details\u003e\n\u003cbr\u003e\n\n### 添加Tag、Category页面\nHexo初始化没有tag、category页面，需要自行添加，本主题请按以下步骤进行:\u003cbr\u003e\n\n1. 执行命令\n```bash\nhexo new page tag\nhexo new page category\n```\n2. 进入页面目录\n```bash\ncd source/tag\n```\n3. 增加layout字段\n```yaml\n// source\\tag\\index.md\n---\ntitle: Tag\nlayout: tag\n---\n```\n4. category页面同理，layout字段键值为category。 \u003cbr\u003e\n\n### 开启MathJax支持（数学公式）\n\n相关配置文件内容（`Chic/_config.yml`）：\n```yaml\n# plugin functions\n## Mathjax: Math Formula Support\n## https://www.mathjax.org\nmathjax:\n  enable: true\n  import: global # global or demand\n  ## global: all pages will load mathjax,this will degrade performance and some grammers may be parsed wrong.\n  ## demand: if your post need fomula, you can declare 'mathjax: true' in Front-matter\n```\n`mathjax`有如下字段：\n- `enable`:值为true为开启该功能（默认开启）；false为关闭\n- `import`:该字段为mathjax的加载方式，可选值为`global`和`demand`。\n  - `global`：全局引入，所有页面均加载。好处是便利，缺点是可能会导致部分markdown语法被错误解析，比如连续`$$`会被解析为公式；而且全局引入会在没有公式的页面明显浪费页面性能。\n  - `demand`【推荐方式】：按需引入。使用方法为在config中设置该字段后，文章中如果需要使用mathjax，在Front-matter中声明即可\n    ```yaml\n    ---\n    title: MathJax Test\n    date: 2019-07-05 21:27:59\n    tags:\n    mathjax: true # 加入这个声明，这篇文章就会开启mathjax渲染\n    ---\n    ```\nLaTeX语法这里不做解释，本主题中，单dollar符号包围的为行内公式，例：`$f(x)=ax+b$`，双dollar符号包围的为块公式，例`$$f(x)=ax+b$$`更多写法请参考LaTeX和[Demo site中的公式测试页面](https://siricee.github.io/hexo-theme-Chic/2019/07/05/MathJax_test/)。\n\n### 图片标题\n\n在Hexo中，你有两种方式引入图片：\n\n  - GFM 语法直接引入（不显示图片标题）\n    ```\n    ![pic](picUrl)\n    ```\n  - Hexo 内置标签系统-图片标签（显示图片标题）\n    ```\n    {% img [class names] /path/to/image [width] [height] '\"alt text\" \"title text\"' %}\n    ```\n所以如果你仅仅想方便快捷引入图片，那你应该使用 GFM 语法，这种方式也是兼容性最好的方案。\n\n但如果你需要显示**图片标题**，你就应该使用第二种方案，**图片标签方式**。\n- `\"alt text\"`用来显示当图片加载失败时垫底的提示文字。\n- `\"title text\"`将会被显示到图片下方作为图片标题。\n\n你可以在 [Demo site](https://siricee.github.io/hexo-theme-Chic/2019/06/05/markdown_test/#Image) 中查看图片标题的效果和示例语法。\n\n## Customize 自定义\n- 代码高亮风格 在`hexo-theme-Chic\\themes\\Chic\\source\\css\\style.styl`中更改highlight为`_highlight`文件夹中的stylus文件即可更换代码高亮风格。\n\n- 自定义css(stylus语法) 您可以在`hexo-theme-Chic\\themes\\Chic\\source\\css\\custom.styl`路径文件中添加css规则\n\n- 自定义JavaScript 您可以在`hexo-theme-Chic\\themes\\Chic\\source\\js`路径中添加js脚本，并在_config.yml中`script`字段添加声明。\n\n## FAQ 提问\n1. 我在二级地址（非github page根repo，即username.github.io/Blog）上部署了hexo，为什么css、avatar等资源都404了？\n\n    答：此处需要另外填写主配置文件URL字段。以该主题repo为例：\n    ```yaml\n    # (blog/_config.yml)\n    \n    # URL\n    ## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'\n    url: https://siricee.github.io/hexo-theme-Chic/  # 此处为你的部署url\n    root: /hexo-theme-Chic/  # 此处为你的项目根文件夹url。\n    permalink: :year/:month/:day/:title/\n    permalink_defaults:\n    ```\n\n2. 我想将黑色主题设为默认全局主题该怎么做？\n   \n   答：此处只需要改一下`themes\\Chic\\source\\js\\script.js`中`doucument.ready`函数的内容。代码如下\n   ```javascript\n   document.ready(\n    function () {\n        // ...省略代码\n        const isDark = currentTheme === 'dark';\n        // 此行改为\n        // const isDark = currentTheme !== 'dark';\n   ```\n   即可实现效果。\n\n3. 常见问题待补充……  \n\n## Gallary 图片展示\n![screely-1560228577821.png](https://i.loli.net/2019/06/12/5d00a0850285252790.png)\n![screely-1560228791041.png](https://i.loli.net/2019/06/12/5d00a0856063661133.png)\n![screely-1560228621288.png](https://i.loli.net/2019/06/12/5d00a084e29cd40271.png)\n![screely-1560228761180.png](https://i.loli.net/2019/06/12/5d00a0855d28072392.png)\n\n![smartmockups_jwrd4ru3.png](https://i.loli.net/2019/06/12/5d00a085d115d16700.png)\n\n![smartmockups_jwrd9y4r.png](https://i.loli.net/2019/06/12/5d00a085ec26284832.png)\n\n## LICENSE 开源许可\nChic © [@Sirice](https://github.com/Siricee)\n\n\u003ca rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc-sa/4.0/\"\u003e\u003cimg alt=\"Creative Commons License\" style=\"border-width:0\" src=\"https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png\" /\u003e\u003c/a\u003e\u003cbr /\u003eThis work is licensed under a \u003ca rel=\"license\" href=\"http://creativecommons.org/licenses/by-nc-sa/4.0/\"\u003eCreative Commons Attribution-NonCommercial-ShareAlike 4.0 International License\u003c/a\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSiricee%2Fhexo-theme-Chic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSiricee%2Fhexo-theme-Chic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSiricee%2Fhexo-theme-Chic/lists"}