{"id":13431793,"url":"https://github.com/HCLonely/hexo-theme-webstack","last_synced_at":"2025-03-16T12:31:30.547Z","repository":{"id":41255950,"uuid":"269334927","full_name":"HCLonely/hexo-theme-webstack","owner":"HCLonely","description":"A hexo theme based on webstack. | 一个基于webstack的hexo主题。","archived":false,"fork":false,"pushed_at":"2023-04-19T03:14:33.000Z","size":2835,"stargazers_count":423,"open_issues_count":4,"forks_count":119,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-05-20T09:21:40.126Z","etag":null,"topics":["hexo","hexo-theme","webstack"],"latest_commit_sha":null,"homepage":"https://webstack.hclonely.com/","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/HCLonely.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-04T10:55:14.000Z","updated_at":"2024-06-03T18:02:18.043Z","dependencies_parsed_at":"2024-06-03T18:02:15.069Z","dependency_job_id":"af5b14fd-aa12-499b-b4f9-d2d2f10c5fbb","html_url":"https://github.com/HCLonely/hexo-theme-webstack","commit_stats":{"total_commits":21,"total_committers":2,"mean_commits":10.5,"dds":0.04761904761904767,"last_synced_commit":"2c0659650696d14deb3496816b5cfb9606c85578"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HCLonely%2Fhexo-theme-webstack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HCLonely%2Fhexo-theme-webstack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HCLonely%2Fhexo-theme-webstack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HCLonely%2Fhexo-theme-webstack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HCLonely","download_url":"https://codeload.github.com/HCLonely/hexo-theme-webstack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221663620,"owners_count":16859867,"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":["hexo","hexo-theme","webstack"],"created_at":"2024-07-31T02:01:05.952Z","updated_at":"2025-03-16T12:31:30.534Z","avatar_url":"https://github.com/HCLonely.png","language":"CSS","readme":"# hexo-theme-webstack\n\n[中文文档](https://github.com/HCLonely/hexo-theme-webstack/blob/master/README_CN.md)\n\n\u003e A Hexo theme based on [WebStackPage](https://github.com/WebStackPage/WebStackPage.github.io).\n\n![screenshot](https://github.com/HCLonely/hexo-theme-webstack/raw/master/screenshot/screenshot.png)\n\n## Installation\n\n### hexo \u003e= 4.0\n\n```shell\ngit clone https://github.com/HCLonely/hexo-theme-webstack themes/webstack\n```\n\n### hexo \u003e= 5.0\n\n```shell\nnpm install hexo-theme-webstack -S\n```\n\nor\n\n```shell\ncnpm install hexo-theme-webstack -S\n```\n\n## Configuration\n\n### hexo \u003e= 4.0\n\nCopy the `_config.example.yml` file in the `themes/webstack/` directory to the `rootDir/source/_data/` directory and rename it to `webstack.yml`.\n\nConfigure it by editing `webstack.yml`.\n\n### hexo \u003e= 5.0\n\n- If this theme is newly installed, a `_config.webstack.yml` file will be generated in the root directory after the installation is complete, and you can directly edit the `_config.webstack.yml` file for configuration.\n- If it is a theme upgrade, you can use the configuration method of hexo \u003e= 4.0, or you can move the original configuration file to the root directory and rename it to `_config.webstack.yml`.\n\n\u003e Note: Please keep only one of `rootDir/_config.webstack.yml` and `rootDir/source/_data/webstack.yml`!\n\n### favicon\n\n\u003e Website icon.\n\nExamples:\n```yml\nfavicon: /favicon.ico\n```\n\n### banner\n\n\u003e [Optional] Banner when sharing website to twitter and facebook.\n\nExamples:\n```yml\nbanner: /images/webstack_banner_cn.png\n```\n\n### logo\n\n\u003e Website logo.\n\n- `expanded`: The logo in the upper left corner of the expanded sidebar.\n- `collapsed`: The logo in the upper left corner of the retractable sidebar.\n- `dark`: The logo in the upper left corner when the top bar is dark, only the `about` page takes effect.\n\nExamples:\n```yml\nlogo:\n  expanded: /images/logo@2x.png\n  collapsed: /images/logo-collapsed@2x.png\n  dark: /images/logo_dark@2x.png\n```\n\n### flag\n\n\u003e Language identifier, multi-language please cooperate with [Subpage](#Subpage-configuration) use.\n\n- icon: Language icons, by default only `flag-cn` and `flag-us`, other icons please look for and store in `theme directory/source/images/flags/`.\n- name: Language name\n- default: Whether the language is the default language\n- index: The page link\n\nExamples:\n```yml\nflag:\n  - name: Chinese\n    default: true\n    icon: flag-cn\n    index: /index.html\n```\n\n### search\n\n\u003e Whether to show search box\n\nExamples:\n```yml\nsearch: true\n```\n\n### userDefinedSearchData\n\n\u003e Custom search engine\n\n- custom: Whether to enable custom configuration\n- thisSearch: Current search engine search link\n- thisSearchIcon: Current search engine icon link, format: `url(图片链接)`\n- hotStatus: Whether to enable hot word search function\n- data: Multiple search engine configurations\n  - name: Search engine name\n    img: Search engine search link\n    url: Search engine icon link, format: `url(图片链接)`\n\n示例：\n```yml\nuserDefinedSearchData:\n  custom: true\n  thisSearch: https://www.baidu.com/s?wd=\n  thisSearchIcon: url(https://www.baidu.com/favicon.ico)\n  hotStatus: true\n  data:\n    - name: 百度\n      img: url(https://www.baidu.com/favicon.ico)\n      url: https://www.baidu.com/s?wd=\n    - name: 谷歌\n      img: url(https://www.google.com/favicon.ico)\n      url: https://www.google.com/search?q=\n```\n\n### githubCorner\n\n\u003e [Github corner](http://tholman.com/github-corners/) in the upper right corner.\n\nExamples:\n```yml\ngithubCorner: '\u003ca href=\"https://github.com/HCLonely/hexo-theme-webstack\" class=\"github-corner\" aria-label=\"View source on GitHub\"\u003e\u003csvg width=\"80\" height=\"80\" viewBox=\"0 0 250 250\" style=\"fill:#151513; color:#fff; position: absolute; top: 0; border: 0; right: 0;\" aria-hidden=\"true\"\u003e\u003cpath d=\"M0,0 L115,115 L130,115 L142,142 L250,250 L250,0 Z\"\u003e\u003c/path\u003e\u003cpath d=\"M128.3,109.0 C113.8,99.7 119.0,89.6 119.0,89.6 C122.0,82.7 120.5,78.6 120.5,78.6 C119.2,72.0 123.4,76.3 123.4,76.3 C127.3,80.9 125.5,87.3 125.5,87.3 C122.9,97.6 130.6,101.9 134.4,103.2\" fill=\"currentColor\" style=\"transform-origin: 130px 106px;\" class=\"octo-arm\"\u003e\u003c/path\u003e\u003cpath d=\"M115.0,115.0 C114.9,115.1 118.7,116.5 119.8,115.4 L133.7,101.6 C136.9,99.2 139.9,98.4 142.2,98.6 C133.8,88.0 127.5,74.4 143.8,58.0 C148.5,53.4 154.0,51.2 159.7,51.0 C160.3,49.4 163.2,43.6 171.4,40.1 C171.4,40.1 176.1,42.5 178.8,56.2 C183.1,58.6 187.2,61.8 190.9,65.4 C194.5,69.0 197.7,73.2 200.1,77.6 C213.8,80.2 216.3,84.9 216.3,84.9 C212.7,93.1 206.9,96.0 205.4,96.6 C205.1,102.4 203.0,107.8 198.3,112.5 C181.9,128.9 168.3,122.5 157.7,114.1 C157.9,116.9 156.7,120.9 152.7,124.9 L141.0,136.5 C139.8,137.7 141.6,141.9 141.8,141.8 Z\" fill=\"currentColor\" class=\"octo-body\"\u003e\u003c/path\u003e\u003c/svg\u003e\u003c/a\u003e\u003cstyle\u003e.github-corner:hover .octo-arm{animation:octocat-wave 560ms ease-in-out}@keyframes octocat-wave{0%,100%{transform:rotate(0)}20%,60%{transform:rotate(-25deg)}40%,80%{transform:rotate(10deg)}}@media (max-width:500px){.github-corner:hover .octo-arm{animation:none}.github-corner .octo-arm{animation:octocat-wave 560ms ease-in-out}}\u003c/style\u003e'\n```\n\n### since\n\n\u003e Year of site establishment, shown at the bottom of the page.\n\nExamples:\n```yml\nsince: 2020\n```\n\n### menu\n\n\u003e **[Main] Sidebar menu settings**\n\n- name: Group name\n- icon: Group icon\n- config: [Main] Grouped content (see [Config](#config) for detailed settings), if there is a submenu, this item is not needed!\n- submenu: If there is a submenu, `config` is not required, this option contains `name`, `icon`, `config` options.\n\nExamples:\n```yml\nmenu:\n  - name: 常用工具\n    icon: far fa-star\n    config: hotTools\n  - name: 其他工具\n    icon: fas fa-tools\n    submenu:\n      - name: 开发工具\n        icon: fas fa-tools\n        config: devTools\n      - name: 我的博客\n        icon: fas fa-blog\n        config: myBlog\n```\n\n### expandAll\n\n\u003e Whether to expand the sidebar.\n\n示例：\n\n```yml\nexpandAll: true\n```\n\n### about\n\n\u003e About this site in the sidebar.\n\n- url: The link of about page.\n- name: Text displayed in the sidebar.\n- icon: Icon.\n\nExamples:\n```yml\nabout:\n  url: /about/\n  icon: far fa-heart\n  name: 关于本站\n```\n\n### aboutPage\n\n\u003e About page settings.\n\n1. Generate about page.\n\n```shell\nhexo new page about\n```\n\n2. Edit `source/about/index.md` and add `type:'about'`\n\n```yml\n---\ntitle: about\ndate: 2020-06-04 18:11:54\ntype: 'about'\n---\n```\n\n3. Editing `aboutPage` in theme configuration files.\n\n- website: The content of about this site.\n  - head: Headline.\n  - html: Content, support `html` syntax.\n- webmaster: The content of about webmaster.\n  - head: Headline.\n  - name: Webmaster's name\n  - url: Link.\n  - img: Avatar.\n  - description: Description.\n  - html: Content, support `html` syntax.\n\nExamples:\n```yml\naboutPage:\n  website:\n    head: 关于本站\n    html: '\u003cblockquote\u003e\u003cp\u003e本站是hexo主题\u003ca href=\"https://github.com/HCLonely/hexo-theme-webstack\"\u003ehexo-theme-webstack\u003c/a\u003e的demo站。\u003c/p\u003e\u003c/blockquote\u003e'\n  webmaster:\n    head: 关于站长\n    name: HCLonely\n    url: https://blog.hclonely.com/\n    img: /images/logos/myblog.png\n    description: 懒人一个\n    html: '\u003cbr /\u003e\u003cblockquote\u003e\u003cp\u003e本站是\u003ca href=\"https://github.com/HCLonely\"\u003eHCLonely\u003c/a\u003e基于\u003ca href=\"https://github.com/WebStackPage/WebStackPage.github.io\"\u003eWebStackPage\u003c/a\u003e项目做的一款\u003ca href=\"https://hexo.io/\"\u003eHexo\u003c/a\u003e主题。\u003c/p\u003e\u003c/blockquote\u003e'\n```\n\n### busuanzi\n\n\u003e Website statistics by busuanzi.\n\n- enable: Whether to enable this feature.\n- position: The number of visits is displayed, `footer` is displayed in the footer, and `sidebar` is displayed in the sidebar.\n- pv: The number of visits displayed by the traffic, `$pv` will be replaced by the number of visits.\n- uv: The number of visitors displayed, `$uv` will be replaced by the number of visitors.\n\nExamples:\n```yml\nbusuanzi:\n  enable: true\n  position: sidebar\n  pv: 本站总访问量$pv\n  uv: 本站总访客数$uv\n```\n\n### custom\n\n\u003e Customize `html` content.\n\n- head: Content inserted into the `\u003chead\u003e\u003c/head\u003e` tag.\n- body: Content inserted before the `\u003c/body\u003e` tag.\n\nExamples:\n```yml\ncustom:\n  head: |- # The following content is inserted into the \u003chead\u003e\u003c/head\u003e tag, you can set up multiple lines, pay attention to at least four spaces at the beginning of each line.\n    \u003clink rel=\"stylesheet\" type=\"text/css\" href=\"custom.css\"\u003e\n    \u003cscript src=\"custom.js\"\u003e\u003c/script\u003e\n  body: |- # Insert the following content before the \u003c/body\u003e tag, you can set multiple lines, pay attention to at least four spaces at the beginning of each line.\n    \u003cdiv\u003ecustom text\u003c/div\u003e\n    \u003cscript src=\"custom.js\"\u003e\u003c/script\u003e\n```\n\n## config\n\n\u003e [Main] Website content settings\n\n### Parameter\n\n- name: Website name.\n- url: Website link.\n- img: Website icon.\n- description: Website description.\n\nExamples:\n```yml\n- name: HCLonely Blog\n  url: https://blog.hclonely.com/\n  img: /images/logos/myBlog.png\n  description: 一个懒人的博客。\n```\n\n### Associate setting name and add website\n\nThe content of `config` set in `menu` and `submenu` is the name of this option.\n\nExamples `menu`：\n```yml\nmenu:\n  - name: Common tools\n    icon: far fa-star\n    config: hotTools\n```\nThere are two ways to add websites in the `Common Tools` group:\n\n- In the theme's `_config.yml` add:\n```yml\nhotTools:\n  - name: HCLonely Blog\n    url: https://blog.hclonely.com/\n    img: /images/logos/myBlog.png\n    description: 一个懒人的博客。\n  - name: Github\n    url: https://github.com/\n    img: /images/logos/github.png\n    description: 面向开源及私有软件项目的托管平台。\n```\n- Create a new `hotTools.yml` file in the `source/_data/` (not created by yourself), the content of the file is as follows:\n```yml\n- name: HCLonely Blog\n  url: https://blog.hclonely.com/\n  img: /images/logos/myBlog.png\n  description: 一个懒人的博客。\n- name: Github\n  url: https://github.com/\n  img: /images/logos/github.png\n  description: 面向开源及私有软件项目的托管平台。\n```\n\nEither of the above two methods can be selected. The second method is recommended.\n\n## Subpage configuration\n\n### Create subpage\n\nUse `hexo new page xxx` to create a child page, including the following descriptions, using `hexo new page child` as an example.\n\n### Modify the subpage configuration file\n\nAfter using the above command to generate the subpage, open the `root directory/source/child/index.md` file (subpage configuration file), and add a line `type:'child'` between the two `---` This configuration file takes effect. The sub-page uses the configuration of the homepage by default, and the sub-page preferentially uses the configuration between the two `---` sub-page configuration files. Each configuration item has the same configuration function as the homepage.\n\nSee the example[https://github.com/HCLonely/hexo-theme-webstack/tree/gh-pages/source/child/index.md](https://github.com/HCLonely/hexo-theme-webstack/tree/gh-pages/source/child/index.md)\n\n\u003e Since the subpage was basically completed a long time ago, it was later put on hold when it was busy. There may be some configuration or bugs that have been forgotten. If you have any questions, please feedback in time!\n","funding_links":[],"categories":["Content","优秀项目"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHCLonely%2Fhexo-theme-webstack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHCLonely%2Fhexo-theme-webstack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHCLonely%2Fhexo-theme-webstack/lists"}