[ { "path": ".editorconfig", "content": "# http://editorconfig.org\nroot = true\n\n[*]\nindent_style = space\nindent_size = 2\nend_of_line = lf\ncharset = utf-8\ntrim_trailing_whitespace = true\ninsert_final_newline = true\n\n[*.md]\ntrim_trailing_whitespace = false\n\n[*.less]\nindent_style = space\nindent_size = 2\n\n[Makefile]\nindent_style = tab\n" }, { "path": ".eslintrc.js", "content": "const eslintrc = {\n \"parser\": \"babel-eslint\",\n \"extends\": \"airbnb\",\n \"env\": {\n \"browser\": true,\n \"node\": true,\n \"es6\": true,\n \"mocha\": true,\n \"jest\": true,\n \"jasmine\": true\n },\n \"plugins\": [\n \"react\",\n \"import\"\n ],\n \"parserOptions\": {\n parser: 'babel-eslint',\n },\n \"rules\": {\n \"linebreak-style\": 0,\n \"func-names\": 0,\n \"sort-imports\": 0,\n \"arrow-body-style\": 0,\n \"prefer-destructuring\": 0,\n \"max-len\": 0,\n \"consistent-return\": 0,\n \"comma-dangle\": [\n \"error\",\n \"always-multiline\"\n ],\n \"function-paren-newline\": 0,\n \"class-methods-use-this\": 0,\n \"react/sort-comp\": 0,\n \"react/prop-types\": 0,\n \"react/jsx-first-prop-new-line\": 0,\n \"react/require-extension\": 0,\n \"react/jsx-filename-extension\": [\n 1,\n {\n \"extensions\": [\n \".js\",\n \".jsx\"\n ]\n }\n ],\n \"import/extensions\": 0,\n \"import/no-unresolved\": 0,\n \"import/no-extraneous-dependencies\": 0,\n \"import/prefer-default-export\": 0,\n \"jsx-a11y/no-static-element-interactions\": 0,\n \"jsx-a11y/anchor-has-content\": 0,\n \"jsx-a11y/click-events-have-key-events\": 0,\n \"jsx-a11y/anchor-is-valid\": 0,\n \"jsx-a11y/label-has-for\": 0,\n \"jsx-a11y/no-noninteractive-element-interactions\": 0,\n \"jsx-a11y/mouse-events-have-key-events\": 0,\n \"react/no-danger\": 0,\n \"react/jsx-no-bind\": 0,\n \"react/forbid-prop-types\": 0,\n \"react/require-default-props\": 0,\n \"react/no-did-mount-set-state\": 0,\n \"react/no-array-index-key\": 0,\n \"react/no-find-dom-node\": 0,\n \"react/no-unused-state\": 0,\n \"react/no-unused-prop-types\": 0,\n \"react/default-props-match-prop-types\": 0,\n \"react/jsx-curly-spacing\": 0,\n \"react/no-render-return-value\": 0,\n 'react/jsx-uses-react': 0,\n 'react/react-in-jsx-scope': 0,\n \"object-curly-newline\": 0,\n \"no-param-reassign\": 0,\n \"no-return-assign\": 0,\n \"no-redeclare\": 0,\n \"no-restricted-globals\": 0,\n \"no-restricted-syntax\": 0,\n \"no-underscore-dangle\": 0,\n \"no-unused-expressions\": 0,\n \"no-use-before-define\": 0,\n \"semi\": [\"error\", \"never\"],\n \"quotes\": 0,\n \"no-plusplus\": 0\n }\n}\n\nif (process.env.NODE_ENV === 'development') {\n Object.assign(eslintrc.rules,\n {\n 'no-console': 0,\n 'no-unused-vars': 0,\n });\n}\n\nmodule.exports = eslintrc\n" }, { "path": ".github/FUNDING.yml", "content": "# These are supported funding model platforms\n\ngithub: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]\npatreon: # Replace with a single Patreon username\nopen_collective: # Replace with a single Open Collective username\nko_fi: # Replace with a single Ko-fi username\ntidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel\ncommunity_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry\nliberapay: # Replace with a single Liberapay username\nissuehunt: # Replace with a single IssueHunt username\notechie: # Replace with a single Otechie username\n# Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']\ncustom: ['http://muyunyun.cn/sponsor/']\n" }, { "path": ".github/config.yml", "content": "todo:\n keyword: \"@makeAnIssue\"\n" }, { "path": ".github/dependabot.yml", "content": "# see https://github.com/yi-Xu-0100/traffic-to-badge/blob/main/.github/dependabot.yml\nversion: 2\nupdates:\n # Enable version updates for npm\n - package-ecosystem: 'npm'\n directory: '/'\n schedule:\n interval: 'daily'\n # Maintain dependencies for GitHub Actions\n - package-ecosystem: 'github-actions'\n directory: '/'\n schedule:\n interval: 'daily'\n" }, { "path": ".github/stale.yml", "content": "# Configuration for probot-stale - https://github.com/probot/stale\n\n# Number of days of inactivity before an Issue or Pull Request becomes stale\ndaysUntilStale: 60\n\n# Number of days of inactivity before an Issue or Pull Request with the stale label is closed.\n# Set to false to disable. If disabled, issues still need to be closed manually, but will remain marked as stale.\ndaysUntilClose: 7\n\n# Only issues or pull requests with all of these labels are check if stale. Defaults to `[]` (disabled)\nonlyLabels: []\n\n# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable\nexemptLabels:\n - pinned\n - security\n - \"[Status] Maybe Later\"\n\n# Set to true to ignore issues in a project (defaults to false)\nexemptProjects: false\n\n# Set to true to ignore issues in a milestone (defaults to false)\nexemptMilestones: false\n\n# Set to true to ignore issues with an assignee (defaults to false)\nexemptAssignees: false\n\n# Label to use when marking as stale\nstaleLabel: wontfix\n\n# Comment to post when marking as stale. Set to `false` to disable\nmarkComment: >\n This issue has been automatically marked as stale because it has not had\n recent activity. It will be closed if no further activity occurs. Thank you\n for your contributions.\n\n# Comment to post when removing the stale label.\n# unmarkComment: >\n# Your comment here.\n\n# Comment to post when closing a stale Issue or Pull Request.\n# closeComment: >\n# Your comment here.\n\n# Limit the number of actions per hour, from 1-30. Default is 30\nlimitPerRun: 30\n\n# Limit to only `issues` or `pulls`\n# only: issues\n\n# Optionally, specify configuration settings that are specific to just 'issues' or 'pulls':\n# pulls:\n# daysUntilStale: 30\n# markComment: >\n# This pull request has been automatically marked as stale because it has not had\n# recent activity. It will be closed if no further activity occurs. Thank you\n# for your contributions.\n\n# issues:\n# exemptLabels:\n# - confirmed" }, { "path": ".github/workflows/gh-pages.yml", "content": "name: GitHub Pages\n\non:\n push:\n branches:\n - main\n pull_request:\n\njobs:\n deploy:\n runs-on: ubuntu-22.04\n permissions:\n contents: write\n concurrency:\n group: ${{ github.workflow }}-${{ github.ref }}\n steps:\n - uses: actions/checkout@v3\n\n - name: Setup Node\n uses: actions/setup-node@v3\n with:\n node-version: '14'\n\n - name: Get yarn cache\n id: yarn-cache\n run: echo \"YARN_CACHE_DIR=$(yarn cache dir)\" >> \"${GITHUB_OUTPUT}\"\n\n - name: Cache dependencies\n uses: actions/cache@v3\n with:\n path: ${{ steps.yarn-cache.outputs.YARN_CACHE_DIR }}\n key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}\n restore-keys: |\n ${{ runner.os }}-yarn-\n\n - run: yarn install --frozen-lockfile\n - run: yarn build\n\n - name: Deploy\n uses: peaceiris/actions-gh-pages@v3\n if: ${{ github.ref == 'refs/heads/main' }}\n with:\n github_token: ${{ secrets.GITHUB_TOKEN }}\n publish_dir: .crd-dist\n" }, { "path": ".github/workflows/greetings.yml", "content": "name: Greetings\n\non: [pull_request, issues]\n\njobs:\n greeting:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/first-interaction@v1\n with:\n repo-token: ${{ secrets.GITHUB_TOKEN }}\n issue-message: 'Welcome your first issue here, thanks'\n pr-message: 'Welcome your first pr here, thanks'\n" }, { "path": ".github/workflows/traffic2badge.yml", "content": "name: traffic2badge\non:\n push:\n branches:\n - main\n schedule:\n - cron: '1 0 * * *' #UTC\n\njobs:\n run:\n name: Make GitHub Traffic to Badge\n runs-on: ubuntu-latest\n steps:\n - name: Checkout Code\n uses: actions/checkout@v2.3.3\n\n - name: Get Commit Message\n id: message\n uses: actions/github-script@v3.0.0\n env:\n FULL_COMMIT_MESSAGE: '${{ github.event.head_commit.message }}'\n with:\n result-encoding: string\n script: |\n var message = `${process.env.FULL_COMMIT_MESSAGE}`;\n core.info(message);\n if (message != '') return message;\n var time = new Date(Date.now()).toISOString();\n core.info(time);\n return `Get traffic data at ${time}`;\n\n - name: Set Traffic\n id: traffic\n uses: yi-Xu-0100/traffic-to-badge@v1.4.0\n with:\n my_token: ${{ secrets.TRAFFIC_TOKEN }}\n #(default) static_list: ${{ github.repository }}\n #(default) traffic_branch: traffic\n #(default) views_color: brightgreen\n #(default) clones_color: brightgreen\n #(default) logo: github\n #(default) year:\n\n - name: Deploy\n uses: peaceiris/actions-gh-pages@v3.7.3\n with:\n github_token: ${{ secrets.GITHUB_TOKEN }}\n publish_branch: ${{ steps.traffic.outputs.traffic_branch }}\n publish_dir: ${{ steps.traffic.outputs.traffic_path }}\n user_name: 'github-actions[bot]'\n user_email: 'github-actions[bot]@users.noreply.github.com'\n full_commit_message: ${{ steps.message.outputs.result }}\n\n - name: Show Traffic Data\n run: |\n echo ${{ steps.traffic.outputs.traffic_branch }}\n echo ${{ steps.traffic.outputs.traffic_path }}\n cd ${{ steps.traffic.outputs.traffic_path }}\n ls -a" }, { "path": ".gitignore", "content": "node_modules\n.create-react-doc-dist\npackage-lock.json\n.cache\n.DS_Store\n.crd-dist/\n\n*.bak\n*.tem\n*.log\n*.temp\n#.swp\n*.*~\n~*.*\n\ndocs/忽略文件.md" }, { "path": ".npmignore", "content": ".cache\n.gitignore\n.editorconfig\n.create-react-doc-dist\nnode_modules\npackage-lock.json\ndist" }, { "path": ".npmrc", "content": "# .npmrc\n\nregistry=https://registry.npmjs.org/\n" }, { "path": ".yarnrc", "content": "# .yarnrc\nregistry \"https://registry.npmjs.org/\"\n" }, { "path": "CONTRIBUTING.md", "content": "# HOW TO CONTRIBUTE\n\n1. Welcome your pr! Before pr, talk about situations in the [issue](https://github.com/MuYunyun/create-react-doc/issues/new) firstly. If the situation is reasonable, go to the next step;\n2. Switch to the new branch based main, submit the pr to branch `qa/latest` after finishing development.\n\n## DEV\n\nRun these bash command firstly.\n\n```bash\n$ git clone https://github.com/MuYunyun/create-react-doc\n$ cd create-react-doc\n$ yarn && yarn bootstrap && yarn start\n```\n\nAnd now you can see the document is running at http://localhost:3000.\n\n## Test\n\nAfter merging pr to qa/latest and publish beta package. You should verify the feature/bugfix with following bash:\n\n```js\nyarn add create-react-doc@beta\n```" }, { "path": "README-en.md", "content": " _.-\"\\\n _.-\" \\\n ,-\" \\\n \\ create \\\n \\ \\ react \\\n \\ \\ doc \\\n \\ \\ _.-;\n \\ \\ _.-\" :\n \\ \\,-\" _.-\"\n \\( _.-\"\n `--\"\n\n[![npm version](https://img.shields.io/npm/v/create-react-doc)](https://badge.fury.io/js/create-react-doc)\n[![week download](https://img.shields.io/npm/dw/create-react-doc.svg)](https://www.npmjs.com/package/create-react-doc)\n![views](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/views.svg)\n![views](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/views_per_week.svg)\n![clones](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/clones_per_week.svg)\n![LICENSE MIT](https://img.shields.io/npm/l/create-react-doc.svg)\n\nEnglish | [简体中文](./README.md)\n\n# Create React Doc\n\n[Create React Doc](https://github.com/MuYunyun/create-react-doc) is a markdown document site generation tool using React just like [create-react-app](https://github.com/facebook/create-react-app), developers can use Create React Doc to develop, deploy documents or blog sites without worrying about additional environment configuration information.\n\n## Features\n\n* The idea of ​​building a site: Just write markdown files as a blog site [like me](https://github.com/MuYunyun/blog).\n* Out of box: One-click generation of documents and blog sites by specifying directories or documents, no need to care about site environment configuration information.\n* Performance: greatly improve site loading speed through pre-rendering and lazy loading.\n* Based on mdx: Support writing React components, mathematical formulas, etc. in markdown.\n* Search engine optimization: Support SEO, making documents easier to search.\n* Personalization: Support [custom theme](https://muyunyun.cn/create-react-doc/9f41fc98).\n* Workflow: Integrate Github actions, support automated packaging and publishing sites.\n\n> [Quick Start](https://muyunyun.cn/create-react-doc/290a4219)\n\n## Subject\n\nCreate React Doc provides the official default theme [crd-seed](https://github.com/MuYunyun/create-react-doc/tree/main/packages/crd-seed). The theme supports the following features:\n\n* Adapt to mobile and PC multi-terminal display.\n* Support dark mode.\n* The document supports embedded codepen, codesandbox.\n* GitHub linkage.\n* Support using tags to customize aggregate article content.\n\n[my blog](http://muyunyun.cn/blog) is based [crd-seed](https://github.com/MuYunyun/create-react-doc/tree/main/packages/crd-seed) theme to build。\n\n![](http://with.muyunyun.cn/90d3e357a31649b9466a828a92b6d88d.jpg)\n![](http://with.muyunyun.cn/2e7440e4256debda2d73a4e6392c7146.jpg-300)\n\nIf you want to customize or share personal themes, you can refer to the [Custom Theme](https://muyunyun.cn/create-react-doc/9f41fc98) chapter.\n\n## Get started quickly\n\n**Create React Doc** is very easy to use. Developers don't need to install or configure additional tools such as webpack or Babel, they are built-in and hidden in the scaffolding, so developers can concentrate on document writing.\n\nIf you want to create a site file `doc` under the current file, here are three ways to quickly build a site:\n\n### npx\n\n```bash\nnpx create-react-doc doc\n```\n\n### npm\n\n```bash\nnpm init create-react-doc doc\n```\n\n### yarn\n\n```bash\nyarn create react-doc doc\n```\n\n![](http://with.muyunyun.cn/0f0cf6e8cb68b18399eac2927f74b063.jpg)\n\n> If you want to pull the content of the template to the current folder, you can replace the `doc` of the above command with `.`, such as executing `npx create-react-doc .`.\n\nThen execute `cd doc && yarn && yarn start`, you can preview the site at `localhost: 3000`, if the site document changes, the site will automatically reload.\n\n\n\n## Site release\n\nIn the [Quick Start](http://muyunyun.cn/create-react-doc/QuickStart) section, it introduces how to quickly build a site. This section will introduce how to package and publish the built site to gh-pages.\n\n### Automatically package and publish to gh-pages (recommended)\n\nThe initialized template project integrates the [ci configuration](https://github.com/MuYunyun/create-react-doc/blob/main/packages/templates/default/.github/workflows/gh-pages.yml) of `Github action`, the user only needs to execute `git push` on the main branch to complete the automatic deployment of the site.\n\n![](http://with.muyunyun.cn/ea24d511f76efe5ba5d13bb6b1609aac.jpg)\n\nIf it is the first deployment, after performing the following operations, you need to select Github Pages as gh-pages in the setting tab of the project. (See [First Deployment with GITHUB_TOKEN](https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-first-deployment-with-github_token) for details)\n\n```bash\ngit init\ngit add.\ngit commit -m \"first commit\"\ngit branch -M main\ngit remote add origin https://github.com/user or organization name/project name.git\ngit push -u origin main\n```\n\n> For more content, please visit [Site Release](http://muyunyun.cn/create-react-doc/SiteRelease), [Advanced Usage](http://muyunyun.cn/create-react-doc/HighOrderusage), [other tools](http://muyunyun.cn/create-react-doc/othertools) and other chapters.\n\n## Practice Sharing\n\n* [基于 SSR 的预渲染首屏直出方案](http://muyunyun.cn/blog/g3v1c5bq)\n* [SEO 在 SPA 站点中的实践](http://muyunyun.cn/blog/ettzfags)\n" }, { "path": "README.md", "content": "\n _.-\"\\\n _.-\" \\\n ,-\" \\\n \\ create \\\n \\ \\ react \\\n \\ \\ doc \\\n \\ \\ _.-;\n \\ \\ _.-\" :\n \\ \\,-\" _.-\"\n \\( _.-\"\n `--\"\n\n[![npm version](https://img.shields.io/npm/v/create-react-doc)](https://badge.fury.io/js/create-react-doc)\n[![week download](https://img.shields.io/npm/dw/create-react-doc.svg)](https://www.npmjs.com/package/create-react-doc)\n![views](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/views.svg)\n![views](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/views_per_week.svg)\n![clones](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/clones_per_week.svg)\n![LICENSE MIT](https://img.shields.io/npm/l/create-react-doc.svg)\n\n[English](./README-en.md) | 简体中文\n\n# Create React Doc\n\n[Create React Doc](https://github.com/MuYunyun/create-react-doc) 是一个使用 React 的 markdown 文档站点生成工具。就像 [create-react-app](https://github.com/facebook/create-react-app) 一样，开发者可以使用 Create React Doc 来开发、部署文档或者博客站点而无需关心额外的环境配置信息。\n\n## 特性\n\n* 建站理念: `文件即站点` (Files as a Site)。\n* 开箱即用: 通过指定目录或文档, 一键生成文档、博客站点, 无需关心站点环境配置信息。\n* 流畅的用户体验: 内置 SSR 首屏直出方案(基于 gp-pages 服务)，以提升用户体验。\n* 基于 mdx: 支持在 markdown 中`书写 React 组件`、数学公式等。\n* 搜索引擎优化: 支持 SEO, 让文档更易被搜索。\n* 个性化: 支持[自定义主题](https://muyunyun.cn/create-react-doc/9f41fc98)。\n* 工作流: 集成 Github action, 支持自动化打包、发布站点。\n\n> [快速上手](https://muyunyun.cn/create-react-doc/290a4219)\n\n## 主题\n\ncreate-react-doc 提供了默认主题 [crd-seed](https://github.com/MuYunyun/create-react-doc/tree/main/packages/crd-seed)。\n\n该主题支持以下特性:\n\n- [x] 适配网页/移动端展示。\n- [x] 支持暗黑模式。\n- [x] 支持标签页自定义聚合文章内容。\n- [x] 内置评论模块。\n- [x] 支持内嵌展示 codepen、codesandbox 案例。\n- [x] 支持从文档页快速跳转到对应的 Github 文档页进行在线编辑。\n\n该主题效果可以参考[笔者博客](http://muyunyun.cn/blog)。\n\n![](http://with.muyunyun.cn/90d3e357a31649b9466a828a92b6d88d.jpg)\n![](http://with.muyunyun.cn/2e7440e4256debda2d73a4e6392c7146.jpg-300)\n\n如果您想定制化或者分享个人主题，可以参考[自定义主题](https://muyunyun.cn/create-react-doc/9f41fc98)章节。\n\n## 快速上手\n\n**create-react-doc** 非常容易上手。开发者不需要额外安装或配置 webpack 或者 Babel 等工具，它们被内置隐藏在脚手架中，因此开发者可以专心于文档的书写。\n\n如果你想在当前文件下建立站点文件 `doc`, 这里提供如下三种方式快速建站:\n\n### npx\n\n```bash\nnpx create-react-doc doc\n```\n\n### npm\n\n```bash\nnpm init create-react-doc doc\n```\n\n### yarn\n\n```bash\nyarn create react-doc doc\n```\n\n![](http://with.muyunyun.cn/0f0cf6e8cb68b18399eac2927f74b063.jpg)\n\n> 如果想把模板内容内容拉取到当前文件夹, 则可以将如上命令的 `doc` 替换为 `.`, 比如执行 `npx create-react-doc .`。\n\n接着执行 `cd doc && yarn && yarn start`, 可以在 `localhost: 3000` 预览站点, 如果站点文档发生改变, 站点将自动重新加载。\n\n\n\n## 站点发布\n\n在 [快速上手](https://muyunyun.cn/create-react-doc/290a4219) 一节中介绍了如何快速搭建站点, 本节将介绍如何将搭建好的站点打包、发布到 gh-pages。\n\n### 自动打包发布到 gh-pages (推荐)\n\n初始化的模板项目集成了 `Github action` 的 [ci 配置](https://github.com/MuYunyun/create-react-doc/blob/main/packages/templates/default/.github/workflows/gh-pages.yml), 使用方只需在 main 分支执行 `git push` 即可以完成站点的自动部署。\n\n![](http://with.muyunyun.cn/ea24d511f76efe5ba5d13bb6b1609aac.jpg)\n\n如果是第一次部署, 在执行以下操作后, 需要在项目的 setting 选项卡中将 Github Pages 选择为 gh-pages。(详情见 [First Deployment with GITHUB_TOKEN](https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-first-deployment-with-github_token))\n\n```bash\ngit init\ngit add .\ngit commit -m \"first commit\"\ngit branch -M main\ngit remote add origin https://github.com/用户或组织名/项目名.git\ngit push -u origin main\n```\n\n## 更多内容\n\n* [站点发布](http://muyunyun.cn/create-react-doc/ude9296y)\n* [高阶用法](http://muyunyun.cn/create-react-doc/9v9ug9h8)\n* [其它工具](http://muyunyun.cn/create-react-doc/292h2c5k)\n* [Front-matter](http://muyunyun.cn/create-react-doc/49g6b239)\n\n## 实践分享\n\n* [基于 SSR 的预渲染首屏直出方案](http://muyunyun.cn/blog/g3v1c5bq)\n* [SEO 在 SPA 站点中的实践](http://muyunyun.cn/blog/ettzfags)\n" }, { "path": "components/Button/index.jsx", "content": "import styles from './index.less'\n\nconst Button = ({\n children,\n}) => {\n return \n}\n\nexport default Button\n" }, { "path": "components/Button/index.less", "content": ".btn {\n color: #fff;\n background: #1890ff;\n border-color: #1890ff;\n text-shadow: 0 -1px 0 rgb(0 0 0 / 12%);\n box-shadow: 0 2px #0000000b;\n height: 40px;\n padding: 6.4px 15px;\n font-size: 16px;\n border-radius: 2px;\n line-height: 1.5715;\n position: relative;\n display: inline-block;\n font-weight: 400;\n white-space: nowrap;\n text-align: center;\n}" }, { "path": "components/index.jsx", "content": "import Button from './Button/index.jsx'\n\nexport {\n Button,\n}\n" }, { "path": "config.yml", "content": "# create-react-doc configuration.\n\n# Site\ntitle: Create React Doc\n\n# Menu dir\n## you can also set detailed dir, such as BasicSkill/css\n## todo: auto menu\nmenu: [\n docs/快速上手.md,\n docs/更新日志.md,\n docs/主题,\n docs/站点发布.md,\n docs/Front-matter.md,\n docs/数学公式.md,\n docs/书写组件.md,\n docs/高阶用法.md,\n docs/其它工具.md,\n docs/测试\n]\n## set init open menu keys\n# menuOpenKeys:\n\n# site theme\ndevTheme: packages/crd-seed/index\n# theme: crd-seed\n\n# Github\n## if you want to editing pages on github, you should config these arguments.\nuser: MuYunyun\nrepo: create-react-doc\ngithub-ribbons: true\ndomain: https://muyunyun.cn\nseo:\n google: true\n\n# Available values: en | zh-cn\nlanguage: en\n\n# Inject Custom Logic\ninject: injectLogic/index.js\n\n# Use abbrlink\nabbrlink: true\n\n# Show Tags in head\ntags: true\n\n# Config comment section\ncomment:\n # Giscus Config, The config parameter that's supported can be seen in [giscus-component](https://github.com/giscus/giscus-component#documentation).\n GiscusConfig:\n repoId: MDEwOlJlcG9zaXRvcnkyNjgwMTE4MzA=\n categoryId: DIC_kwDOD_mJNs4CSd1W\n" }, { "path": "docs/Front-matter.md", "content": "\n\n## Front-matter\n\nFront-matter 是文件最上方包裹在 `` 之间的区域，用于指定个别文件的变量，举例来说：\n\n```md\n\n```\n\n以下是预先定义的参数，您可在模板中使用这些参数值并加以利用。\n\n| 参数 | 描述 | 类型 |\n| :------- | :-------------------------------------------------------------- | :------- |\n| abbrlink | 短链。用于指定页面路由展示为指定短链，使用短链有助于 SEO 搜索。 | |\n| tags | 自定义标签 | string[] |\n\n## 链接持久化\n\n在以下场景需求场合中，可以展示短链以优化 URL 的显示。\n\n* SEO 场景下需要链接持久化。\n* URL 链接中存在中文会被转码展示。\n* 文档的路径与文件名经常变更。\n\n### 如何使用短链\n\n在 `config.yml` 增加配置 `abbrlink: true`\n\n```diff\n+ abbrlink: true\n```\n\n做好上述配置后，接着在控制台执行 `react-doc generate` 即可给 menu 配置属性中的所有文章目录文件加上短链资源。\n\n```bash\nreact-doc generate // 一键给所有文章加上短链\n```\n" }, { "path": "docs/主题/自定义主题.md", "content": "\n\n## 使用自定义主题\n\n切换主题非常简单, 只需要将根目录文件 `config.yml` 中的 `theme` 更改为您想使用的主题即可。\n\n```diff\n+ theme: custom-theme\n```\n\n### 如何开发自定义主题包\n\ncreate-react-doc 脚手架提供了脚本命令 `react-doc theme` 用来一键创建主题包开发环境。\n\n![](http://with.muyunyun.cn/2e4a4b11f96c0d38759700c05fe96267.gif)\n\n```js\n// 安装 create-react-doc\nyarn add create-react-doc -g\n// 执行 react-doc theme 并输入主题包名字\nreact-doc theme\n```\n\n进入到所创建主题目录, 执行 `yarn && yarn start`, 此时会自动打开浏览器, 并在屏幕中央显示 `Write docs happily now.`。如下图所示:\n\n![](http://with.muyunyun.cn/1a2bf34700afd77a95014d2d5f359ffa.jpg)\n\n恭喜你, 此时你已经将主题开发环境配置完成。接着便可以开始愉快地定制个人主题了。\n\n在所创建的主题项目中使用了 `react v18`，`react-router-dom v6`，项目支持使用 `less` 语法。\n\n```js\nimport { Switch, Route } from 'react-router-dom'\nimport styles from './index.less'\n\nconst CustomTheme = (props: CustomThemeProps) => {\n return (\n \n \n
Welcome to your own theme
\n \n \n )\n}\n\nexport default CustomTheme\n```\n\nCustomThemeProps 的接口类型暴露了菜单资源 `menuSource` 与路由资源 `routeData`, 自定义主题时可以按需使用它们。\n\n```js\ninterface CustomThemeProps {\n /** 菜单资源 */\n menuSource: {\n /** 文件名称 eg: '快速上手.md' */\n name: string\n /** 文件扩展名 eg: '.md' */\n extension: string\n /** 文件路径 eg: '/docs/快速上手.md' */\n path: string\n /** 路由路径 eg: ‘/快速上手’ */\n routePath: string\n /** 文件大小 eg: 924 */\n size: number\n /** 文件类型 eg: 'file' */\n type: string\n /** 文件创建日期 eg: '2020-11-11' */\n birthtime: string\n /** 文件修改日期 eg: '2021-01-14' */\n mtime: string\n }[]\n /** 路由资源 */\n routeData: {\n /** 文件名称 eg: '快速上手.md' */\n article: string\n /** 异步加载 markdown 组件函数 */\n component: AsyncRouteComponent(props)\n /** markdown 文章信息对象。若为文件则有 title 字段, 若为文件夹则无 title 字段 */\n mdconf: { title?: string }\n /** 文件路径 eg: '/docs/快速上手' */\n path: string\n }[]\n}\n```\n\n此外在自定义主题文件中可以自由使用由 webpack 注入的 `DOCSCONFIG` 对象中的变量, DOCSCONFIG 中的变量与项目根目录中的 `config.yml` 文件变量一一对应。\n\n比如 `config.yml` 配置如下所示:\n\n```bash\nmenu: ['Introduction']\ntheme: crd-seed\nuser: muyunyun\nrepo: https://github.com/MuYunyun/create-react-doc\nlanguage: en\n```\n\n则主题项目中可以通过如下方式获取到 `config.yml` 配置属性。\n\n```js\nconst { menu, theme, user } = DOCSCONFIG || {}\n```\n" }, { "path": "docs/主题/默认主题.md", "content": "\n\n## 默认主题\n\ncreate-react-doc 的默认主题为 [crd-seed](https://github.com/MuYunyun/create-react-doc/tree/main/packages/crd-seed)。\n\n该主题支持以下特性:\n\n- [x] 适配网页/移动端展示。\n- [x] 支持暗黑模式。\n- [x] 支持标签页自定义聚合文章内容。\n- [x] 内置评论模块。\n- [x] 支持内嵌展示 codepen、codesandbox 案例。\n- [x] 支持从文档页快速跳转到对应的 Github 文档页进行在线编辑。\n\n使用该主题搭建的项目有:\n\n* [blog](https://github.com/MuYunyun/blog), [站点](http://muyunyun.cn/blog)\n * ![](http://with.muyunyun.cn/90d3e357a31649b9466a828a92b6d88d.jpg)\n * ![](http://with.muyunyun.cn/2e7440e4256debda2d73a4e6392c7146.jpg-300)\n* [diana](https://github.com/MuYunyun/diana), [站点](https://muyunyun.cn/diana/)\n\n> 如果您有其它的改进优化想法, 欢迎留言补充\n\n## config.yml\n\n[config.yml](https://github.com/MuYunyun/create-react-doc/blob/main/packages/templates/default/_config.yml) 文件是配置站点主题功能的地方。\n\n它支持配置的属性如下:\n\n| 属性名 | 作用 | 类型 | 默认 |\n| :------------: | :----------------------------------: | :---------------------------------------------------------------------------------: | :------: |\n| title | 站点名 | string | |\n| menu | 作为站点菜单的文件/文件夹路径 | string[] | |\n| menuOpenKeys | 默认展开菜单的文件夹路径 | string | |\n| user | Github 用户名 | string | |\n| repo | Github 项目名 | string | |\n| language | 站点语言 | en \\| zh-cn | en |\n| github-ribbons | 是否在右上角显示 github 丝带 | boolean | false |\n| theme | 使用主题 | string | crd-seed |\n| devTheme | 开发自定义主题时, 需设置其为 true | string | ./index |\n| seo | 是否开启 SEO 优化 | { google?: boolean } | |\n| domain | SEO 优化的站点域名, 用于生成 sitemap | string | |\n| comment | 开启评论区，并进行相关配置 | { GiscusConfig: [Props](https://github.com/giscus/giscus-component#documentation) } | |\n\n详细用法可以参考 [config.yml](https://github.com/MuYunyun/blog/blob/main/config.yml)。" }, { "path": "docs/书写组件.md", "content": "\n\nimport { Button } from '../components/index.jsx'\n\n## 书写组件\n\n[create-react-doc](https://github.com/MuYunyun/create-react-doc) 内置了 [mdx](https://github.com/mdx-js/mdx), 你可以在 .md 文件中书写 React 组件, 因此你可以选择 create-react-doc 来快速搭建组件站点。\n\n## 例子\n### Button 组件\n\n```js\nimport { Button } from '../components/index.jsx'\n\n\n```\n\n" }, { "path": "docs/其它工具.md", "content": "\n\n## 其它工具\n\n### crd-leetcode-cli\n\n#### 背景\n\n当新增 LeetCode 题解时需要[手动更新表格](https://github.com/MuYunyun/blog/blob/main/LeetCode/README.md), 较为不便。[crd-leetcode-cli](https://github.com/MuYunyun/create-react-doc/tree/main/packages/leetcode-cli) 提供了更新 leetcode 站点中已 ac 题解的能力。\n\n#### 安装\n\n执行 `yarn add crd-leetcode-cli -g`, 国内用户可以执行 `cnpm install crd-leetcode-cli -g`\n\n#### 使用\n\n```bash\nleetcode download // 增量拉取 AC 题目(若无登录, 则会先执行登录逻辑)\nleetcode download -a // 全量拉取 AC 题目\nleetcode login // 登录\nleetcode logout // 登出\n```\n\n#### 自定义渲染表格\n\n插件提供了自定义渲染 markdown table 的能力。\n\n在项目根目录创建 [config.js](https://github.com/MuYunyun/blog/blob/main/config.js) 文件。\n\n在 config.js 内自定义生成 markdown 的 [transform_markdown_table 函数](https://github.com/MuYunyun/blog/blob/main/config.js#L5-L22)。\n\n```js\nconst transform_markdown_table = (dataArr: QuestionProps[]): string => {}\nmodule.exports = { transform_markdown_table }\n```\n\nQuestionProps 接口定义如下:\n\n| 名称 | 含义 | 例子 |\n| :--------: | :--------------: | :-----: |\n| questionId | 题号 | |\n| title | 标题 | Two Sum |\n| titleSlug | 标题的另一种模式 | two-sum |\n| difficulty | 难度 | |\n| topicTags | 题目所属标签 | |\n\n通过自定义 transform_markdown_table 函数, 便可得到如下 markdown table:\n\n![](http://with.muyunyun.cn/1938e43a45410090e8486e495e6d9fee.jpg)\n\n#### 技术细节\n\n* 使用 puppeteer 登录 leetcode 获取 cookie 信息。\n* 获取 cookie 后, 使用 graphql-request 调用 graphql 接口获取题目详情信息。\n* 自定义生成 markdown table。" }, { "path": "docs/快速上手.md", "content": "\n\n## 快速上手\n\n**create-react-doc** 非常容易上手。开发者不需要额外安装或配置 webpack 或者 Babel 等工具，它们被内置隐藏在脚手架中，因此开发者可以专心于文档的书写。\n\n如果你想在当前文件下建立站点文件 `doc`, 这里提供如下三种方式快速建站:\n\n### npx\n\n```bash\nnpx create-react-doc doc\n```\n\n### npm\n\n```bash\nnpm init create-react-doc doc\n```\n\n### yarn\n\n```bash\nyarn create react-doc doc\n```\n\n![](http://with.muyunyun.cn/0f0cf6e8cb68b18399eac2927f74b063.jpg)\n\n> 如果想把模板内容内容拉取到当前文件夹, 则可以将如上命令的 `doc` 替换为 `.`, 比如执行 `npx create-react-doc .`。\n\n接着执行 `cd doc && yarn && yarn start`, 可以在 `localhost: 3000` 预览站点, 如果站点文档发生改变, 站点将自动重新加载。\n\n\n" }, { "path": "docs/数学公式.md", "content": "\n\n## 数学公式\n\n支持在 `$$` 与 `$$` 之间书写 latex 数学公式即能显示在网页上。\n\n```js\n$$\nz = \\frac{x}{y}\n$$\n```\n\n被转化为:\n\n$$\nz = \\frac{x}{y}\n$$\n\n```js\n$$\nC_1 \\quad= \\quad c_2 + c_4^3\n$$\n```\n\n被转化为:\n\n$$\nC_1 \\quad= \\quad c_2 + c_4^3\n$$\n\n```js\n$$\ny = \\sqrt {x_1^2 + x_2^2 + x_3^2 + x_4^2}\n$$\n```\n\n被转化为:\n\n$$\ny = \\sqrt {x_1^2 + x_2^2 + x_3^2 + x_4^2}\n$$\n\n## 参考链接\n\n* [latex 数学公式示例汇总](https://zhuanlan.zhihu.com/p/34799800)\n" }, { "path": "docs/更新日志.md", "content": "\n\n# CHANGELOG\n\n`create-react-doc` 严格遵循 [Semantic Versioning 2.0.0](http://semver.org/lang/zh-CN/) 语义化版本规范。\n\n### 1.10.3\n\n`2022-11-26`\n\n- **Enhancement**\n\n - 🎈 更新主题字体样式为手写体风格。\n\n### 1.10.2\n\n`2022-11-19`\n\n- **Fix**\n\n - 🐞 修复 @giscus/react 包结构变更导致站点崩溃的问题。[issue](https://github.com/giscus/giscus-component/issues/783)\n\n- **Enhancement**\n\n - 🎈 使用 esbuild 代替 babel-loader 进行打包构建。[issue](https://github.com/MuYunyun/create-react-doc/issues/337)\n\n### 1.10.0\n\n`2022-11-10`\n\n- **Feature**\n\n - 🚀 主题内置评论模块，支持在 [config.yml](https://muyunyun.cn/create-react-doc/85li8wdd) 配置开启评论模块。\n\n### 1.9.2\n\n`2022-04-09`\n\n- **Fix**\n\n - 🐞 修复标签页包含重复标签归档的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/286)\n\n### 1.9.1\n\n`2022-04-05`\n\n- **Enhancement**\n\n - 🎈 升级基础包版本。[issue](https://github.com/MuYunyun/create-react-doc/issues/278)\n - 更新 react 版本从 v17 至 v18\n - 更新 react-router-dom 版本从 v4 至 v6。\n\n### 1.9.0\n\n`2022-04-01`\n\n- **Feature**\n\n - 🚀 支持配置展示标签页以自定义聚合文章内容。[issue](https://github.com/MuYunyun/create-react-doc/issues/264)\n\n### 1.8.2\n\n`2022-02-02`\n\n- **Enhancement**\n\n - 🎈 支持在本地环境调试项目源代码。[mr](https://github.com/MuYunyun/create-react-doc/pull/249)\n\n### 1.8.1\n\n`2022-01-17`\n\n- **Fix**\n\n - 🐞 修复 crd-scripts、crd-seed 遗漏指定安装 crd-client-utils 的问题。\n\n### 1.8.0\n\n`2022-01-16`\n\n- **Feature**\n\n - 🚀 支持 SSR 首屏直出方案(基于 gp-pages 服务)以避免预渲染带来的二次刷新产生页面抖动的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/103)\n - 🚀 新增 crd-client-utils 包以收录公用方法。\n\n### 1.7.0\n\n`2022-01-02`\n\n- **Feature**\n\n - 🚀 访问内容页路由时，收起菜单侧边栏以提高首屏加载体验。[issue](https://github.com/MuYunyun/create-react-doc/issues/219)\n - 优势一: 用户可以聚焦访问内容区，提升阅读体验。\n - 优势二: 菜单区域渲染内容复杂，隐藏其加载过程，提升首屏体验。\n - 🚀 菜单侧边栏展开后，选中项自动滚动到视口内。\n\n### 1.6.1\n\n`2021-12-27`\n\n- **Fix**\n\n - 🐞 修复访问多层级子菜单目录对应的路由时，对应菜单未被展开的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/222)。\n\n### 1.6.0\n\n`2021-10-30`\n\n- **Feature**\n\n - 🚀 SEO 搜索标题优化，优化 document.title 与 meta 标签。[issue](https://github.com/MuYunyun/create-react-doc/issues/203)\n\n### 1.5.3\n\n`2021-10-25`\n\n- **Fix**\n\n - 🐞 修复在使用短链时，站点 sitemap.xml 文件生成丢失的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/206)。\n\n### 1.5.2\n\n`2021-10-19`\n\n- **Fix**\n\n - 🐞 修复点击右上角 `Edit in GitHub` 链接跳转错误的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/205)。\n\n### 1.5.1\n\n`2021-10-19`\n\n- **Fix**\n\n - 🐞 修复页面首屏菜单栏未高亮选中的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/195)。\n\n### 1.5.0\n\n`2021-10-13`\n\n- **Feature**\n\n - 🚀 支持 react-doc generate 命令，给 md 文件自动补全短链。[issue](https://github.com/MuYunyun/create-react-doc/issues/87)、[mr](https://github.com/MuYunyun/create-react-doc/pull/194)\n\n### 1.4.0\n\n`2021-10-08`\n\n- **Feature**\n\n - 🚀 支持展示短链以让文章链接持久化。[issue](https://github.com/MuYunyun/create-react-doc/issues/87)、[mr](https://github.com/MuYunyun/create-react-doc/pull/193)\n - 🚀 支持在 Front-matter 区域中书写个别文件的变量。\n\n### 1.3.5\n\n`2021-09-24`\n\n- **Fix**\n\n - 🐞 修复路由过多时导致预渲染编译超时的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/182)\n - 🐞 修复初始化模板 menu 参数类型错误的问题。[mr](https://github.com/MuYunyun/create-react-doc/pull/181)\n\n### 1.3.4\n\n`2021-06-27`\n\n- **Fix**\n\n - 🐞 修复 npx create-react-doc doc 初始化生成文档项目报错的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/157)。\n\n### 1.3.3\n\n`2021-06-24`\n\n- **Fix**\n\n - 🐞 修复编译预渲染时, 缺少多层级目录文件生成的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/147)。\n\n### 1.3.0\n\n`2021-06-09`\n\n- **Feature**\n\n - 🚀 create-react-doc 集成 MDX。[issue](https://github.com/MuYunyun/create-react-doc/issues/138)、[mr](https://github.com/MuYunyun/create-react-doc/pull/143)\n - 🚀 支持在 markdown 文件中`书写 React 组件`。\n - 🚀 支持在 markdown 文件中`书写数学公式`。\n\n- **Enhancement**\n\n - 🎈 支持 yarn up、yarn up:dev 在 lerna 项目中快速安装包。[mr](https://github.com/MuYunyun/create-react-doc/pull/143/files?file-filters%5B%5D=.html&file-filters%5B%5D=.js&file-filters%5B%5D=.json&file-filters%5B%5D=.less&file-filters%5B%5D=.lock&file-filters%5B%5D=.sh)\n\n### 1.2.0\n\n- **Fix**\n\n - 🐞 修复路由数量过多, puppeteer 运行超时的问题。[issue](https://github.com/MuYunyun/blog/issues/115)。\n\n### 1.1.4\n\n- **Fix**\n\n - 🐞 修复点击 Edit In Github 失效的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/86)。\n\n### 1.1.0\n\n- **Feature**\n\n - 🚀 新增 crd-generator-sitemap 包, 用于生成 sitemap。\n - 🚀 配置文件中新增 domain 字段用于生成 sitemap。\n\n### 1.0.0\n\n- **Feature**\n\n - 🚀 文档支持预渲染。[pr](https://github.com/MuYunyun/create-react-doc/pull/95/files)\n - 🚀 路由由 hash 路由调整为 browser 路由。\n 🎈 站点 SEO 优化。[doc](https://github.com/MuYunyun/blog/issues/84#issuecomment-786418891)\n - 🚀 配置文件中 menu 字段类型从 string 调整为 array。\n\n### 0.3.30\n\n- **Feature**\n\n - 🚀 支持显示展示 pv、uv。[pr](https://github.com/MuYunyun/create-react-doc/pull/85)\n\n### 0.2.29\n\n- **Fix**\n\n - 🐞 修复首次进入菜单未高亮的问题。[issue](https://github.com/MuYunyun/create-react-doc/issues/78)。\n### 0.2.28\n\n- **Feature**\n\n - 🚀 支持自定义主题 ci。[pr](https://github.com/MuYunyun/create-react-doc/pull/80)\n\n### 0.2.27\n\n- **Feature**\n\n - 🚀 支持自定义主题。[pr](https://github.com/MuYunyun/create-react-doc/pull/77)\n\n### 0.2.22\n\n- **Feature**\n\n - 🚀 升级 React 16 至 17。[pr](https://github.com/MuYunyun/create-react-doc/pull/71)\n\n### 0.2.21\n\n- **Feature**\n\n - 🚀 升级 webpack4 至 webpack5。[pr](https://github.com/MuYunyun/create-react-doc/pull/65)\n\n### 0.2.14\n\n- **Feature**\n\n - 🚀 支持 inject 与 injectWithPathname 注入自定义逻辑。[pr](https://github.com/MuYunyun/create-react-doc/pull/65)\n\n### 0.2.14\n\n- **Feature**\n\n - 🚀 集成 Github action, 支持自动化打包、发布站点。\n\n### 0.2.7\n\n`2020-09-25`\n\n- **Feature**\n\n - 🚀 提供 @crd/leetcode-cli 提供将 leetcode 已 AC 的题目转化为 markdown table 的能力。[pr](https://github.com/MuYunyun/create-react-doc/pull/22)\n\n### 0.2.0\n\n`2020-08-02`\n\n- **Feature**\n\n - 🚀 站点支持全局搜索菜单标题与文件内容。[pr](https://github.com/MuYunyun/create-react-doc/pull/22)\n\n### 0.1.20\n\n`2020-07-13`\n\n- **Fix**\n\n - 🐞 fix [20](https://github.com/MuYunyun/create-react-doc/issues/20)。\n - 🐞 fix [17](https://github.com/MuYunyun/create-react-doc/issues/17)。\n\n- **Enhancement**\n\n - 🎈 项目结构重构为 monorepo。[pr](https://github.com/MuYunyun/create-react-doc/pull/16)\n\n### 0.1.0\n\n- **Feature**\n\n - 🚀 详细内容见 [issue](https://github.com/MuYunyun/create-react-doc/issues/2)" }, { "path": "docs/测试/测试标签.md", "content": "\n\n该页面用来测试自定义标签。\n" }, { "path": "docs/测试/测试路由.md", "content": "\n\n* 该页面用来测试未使用 abbrlink 的中文路径。\n" }, { "path": "docs/站点发布.md", "content": "\n\n## 站点发布\n\n在 [快速上手](http://muyunyun.cn/create-react-doc/%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B) 一节中介绍了如何快速搭建站点, 本节将介绍如何将搭建好的站点打包、发布到 gh-pages。\n\n### 自动打包发布到 gh-pages (推荐)\n\n初始化的模板项目集成了 `Github action` 的 [ci 配置](https://github.com/MuYunyun/create-react-doc/blob/main/packages/templates/default/.github/workflows/gh-pages.yml), 使用方只需在 main 分支执行 `git push` 即可以完成站点的自动部署。\n\n![](http://with.muyunyun.cn/ea24d511f76efe5ba5d13bb6b1609aac.jpg)\n\n如果是第一次部署, 在执行以下操作后, 需要在项目的 setting 选项卡中将 Github Pages 选择为 gh-pages。(详情见 [First Deployment with GITHUB_TOKEN](https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-first-deployment-with-github_token))\n\n```bash\ngit init\ngit add .\ngit commit -m \"first commit\"\ngit branch -M main\ngit remote add origin https://github.com/用户或组织名/项目名.git\ngit push -u origin main\n```\n\n### 手动打包发布\n\n如果需要发布到自定义服务器, 可以执行 `npm run build` 或者 `yarn build` 对将要发布的文档站点进行打包构建, 此时的文档网站已准备好进行部署。\n\n接着将打包出的 `.crd-dist` 的文件资源同步到目标服务器即可。" }, { "path": "docs/高阶用法.md", "content": "\n\n## 高阶用法\n\n与 git 文件结构类似, 如果在展示的文件夹中有私有文件不方便展示在文档站点, 可以在 `.gitignore` 文件中设置过滤文件, 这样它们就不会展示在文档站点中了。eg: [.gitignore](https://github.com/MuYunyun/blog/blob/main/.gitignore)\n\n### 插入自定义脚本\n\n在 `config.yml` 文件中加入 `inject` 字段。\n\n```diff\n+ inject: injectLogic/index.js\n```\n\n然后在根目录新建与 `inject` 字段相对应的文件, 声明 `injectWithPathname` 函数, 写入[自定义逻辑](https://github.com/MuYunyun/create-react-doc/injectLogic/index.js)。\n\n```js\n// perf injectWithPathname logic every pathname changes\nconst injectWithPathname = (pathname) => {}\n\nmodule.exports = { injectWithPathname }\n```" }, { "path": "gh-pages.js", "content": "const ghPages = require('gh-pages')\n\nghPages.publish(\n '.crd-dist',\n {\n branch: 'gh-pages',\n repo: 'https://github.com/MuYunyun/create-react-doc.git',\n },\n (error) => {\n if (error) {\n console.error(error)\n } else {\n console.log('docs sync success')\n }\n }\n)\n" }, { "path": "injectLogic/index.js", "content": "/* eslint-disable no-empty */\n// seo: perf inject logic only once\nconst inject = () => {\n // SEO for Google through https://search.google.com/search-console/welcome\n const meta = document.createElement('meta')\n meta.name = 'google-site-verification'\n meta.content = '7fyp1NuvXSRLM9KpMq5_YNE_0zFZkPnuV-SbVVFgWbI'\n document.head.appendChild(meta)\n}\n\n// perf injectWithPathname logic every pathname changes\nconst injectWithPathname = (pathname) => {}\n\nmodule.exports = { inject, injectWithPathname }\n" }, { "path": "lerna.json", "content": "{\n \"version\": \"1.10.3\",\n \"command\": {\n \"bootstrap\": {\n \"npmClientArgs\": [\n \"--no-package-lock\"\n ]\n },\n \"publish\": {\n \"allowBranch\": [\n \"main\",\n \"qa/latest\"\n ],\n \"message\": \"chore: publish\"\n }\n },\n \"//\": \"set yarn workspaces in root\",\n \"useWorkspaces\": true,\n \"npmClient\": \"yarn\"\n}\n" }, { "path": "package.json", "content": "{\n \"name\": \"create-react-doc\",\n \"private\": true,\n \"workspaces\": [\n \"packages/*\"\n ],\n \"description\": \"Fast static generated site. Just write markdown file.\",\n \"homepage\": \"http://muyunyun.cn/create-react-doc\",\n \"bin\": {\n \"react-doc\": \"bin/react-doc.js\"\n },\n \"scripts\": {\n \"bootstrap\": \"lerna bootstrap\",\n \"bootstrap --hoist\": \"lerna bootstrap --hoist\",\n \"clean\": \"lerna clean\",\n \"start\": \"yarn bootstrap && node packages/create-react-doc/index.js start\",\n \"build\": \"node packages/create-react-doc/index.js build\",\n \"deploy\": \"node packages/create-react-doc/index.js deploy\",\n \"release\": \"lerna publish\",\n \"release-qa\": \"lerna publish --npm-tag=beta\",\n \"cleanup\": \"rm -rf node_modules/gh-pages/.cache\",\n \"deploy:site\": \"npm run cleanup && node gh-pages\",\n \"up:dev\": \"sh utils/uppackage-dev.sh\",\n \"up\": \"sh utils/uppackage.sh\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/MuYunyun/create-react-doc\"\n },\n \"keywords\": [\n \"react\",\n \"create-react-doc\",\n \"blog\",\n \"markdown\"\n ],\n \"author\": \"muyunyun\",\n \"license\": \"MIT\",\n \"devDependencies\": {\n \"eslint\": \"^4.19.1\",\n \"eslint-config-airbnb\": \"^16.1.0\",\n \"eslint-plugin-import\": \"^2.11.0\",\n \"eslint-plugin-jsx-a11y\": \"^6.0.3\",\n \"eslint-plugin-react\": \"^7.7.0\",\n \"gh-pages\": \"^3.1.0\",\n \"lerna\": \"^3.22.1\"\n }\n}\n" }, { "path": "packages/crd-client-utils/.npmrc", "content": "# .npmrc\n\nregistry=https://registry.npmjs.org/\n\n# https://github.com/sass/node-sass#binary-configuration-parameters\nsass_binary_site=https://npm.taobao.org/mirrors/node-sass/\n\n# https://github.com/Medium/phantomjs#deciding-where-to-get-phantomjs\n# phantomjs_cdnurl=http://cnpmjs.org/downloads\nphantomjs_cdnurl=https://npm.taobao.org/dist/phantomjs\n" }, { "path": "packages/crd-client-utils/README.md", "content": "### crd-client-utils\n\n[create-react-doc](https://github.com/MuYunyun/create-react-doc) 的工具包。" }, { "path": "packages/crd-client-utils/index.js", "content": "import { useLayoutEffect, useEffect } from 'react'\n\nconst ifDev = env === 'dev'\nconst ifProd = env === 'prod'\nconst ifPrerender = window.__PRERENDER_INJECTED && window.__PRERENDER_INJECTED.prerender\n\n// Not only Prod env but also [some part of Dev env](https://github.com/MuYunyun/create-react-doc/blob/main/packages/crd-scripts/src/web/index.js#L10-L13)\n// need using useLayoutEffect. If meeting this case in the future, thinking about passing extra tag from .\nconst useEnhancedEffect = ifProd\n ? useLayoutEffect\n : useEffect\n\nexport {\n ifDev,\n ifProd,\n ifPrerender,\n useEnhancedEffect\n}\n" }, { "path": "packages/crd-client-utils/package.json", "content": "{\n \"name\": \"crd-client-utils\",\n \"version\": \"1.8.2\",\n \"description\": \"Utils with create react doc\",\n \"main\": \"index.js\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/MuYunyun/create-react-doc\",\n \"directory\": \"packages/utils\"\n },\n \"keywords\": [],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"author\": \"muyunyun\",\n \"license\": \"MIT\",\n \"gitHead\": \"ffc5e4cbc94a7356da558c2dbf46e2f39bb8b199\"\n}\n" }, { "path": "packages/crd-generator-sitemap/.npmrc", "content": "# .npmrc\n\nregistry=https://registry.npmjs.org/\n\n# https://github.com/sass/node-sass#binary-configuration-parameters\nsass_binary_site=https://npm.taobao.org/mirrors/node-sass/\n\n# https://github.com/Medium/phantomjs#deciding-where-to-get-phantomjs\n# phantomjs_cdnurl=http://cnpmjs.org/downloads\nphantomjs_cdnurl=https://npm.taobao.org/dist/phantomjs\n" }, { "path": "packages/crd-generator-sitemap/README.md", "content": "### crd-generator-sitemap\n\n[create-react-doc](https://github.com/MuYunyun/create-react-doc) SEO 插件, 用于生成站点地图。" }, { "path": "packages/crd-generator-sitemap/generate.js", "content": "const { getDocsConfig } = require('crd-utils')\n\n// template for google SEO\n// \n// muyunyun.cn/blog/xxx\n// {{ sNow | formatDate }}\n// daily\n// 1.0\n// \n\nconst docsConfig = getDocsConfig()\n\nconst template = content =>\n `\n\n ${content}\n\n`\n\n/**\n * generate sitemap for google.\n */\nconst generateSiteMap = (routes) => {\n const domain = docsConfig && docsConfig.domain\n const repo = docsConfig && docsConfig.repo\n let content = ''\n for (let i = 0; i < routes.length; i++) {\n if (i === routes.length - 1) {\n content +=\n` \n ${domain}/${repo}${routes[i]}\n `\n } else {\n content +=\n` \n ${domain}/${repo}${routes[i]}\n \\n`\n }\n }\n return template(content)\n}\n\nmodule.exports = {\n generateSiteMap,\n}\n" }, { "path": "packages/crd-generator-sitemap/index.js", "content": "const { generateSiteMap } = require('./generate')\n\nmodule.exports = {\n generateSiteMap,\n}\n" }, { "path": "packages/crd-generator-sitemap/package.json", "content": "{\n \"name\": \"crd-generator-sitemap\",\n \"version\": \"1.3.4\",\n \"description\": \"generator sitemap for create-react-doc\",\n \"main\": \"index.js\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/MuYunyun/create-react-doc\",\n \"directory\": \"packages/crd-generator-sitemap\"\n },\n \"keywords\": [],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"author\": \"muyunyun\",\n \"license\": \"MIT\",\n \"gitHead\": \"ffc5e4cbc94a7356da558c2dbf46e2f39bb8b199\"\n}\n" }, { "path": "packages/crd-scripts/.npmrc", "content": "# .npmrc\n\nregistry=https://registry.npmjs.org/\n\n# https://github.com/sass/node-sass#binary-configuration-parameters\nsass_binary_site=https://npm.taobao.org/mirrors/node-sass/\n\n# https://github.com/Medium/phantomjs#deciding-where-to-get-phantomjs\n# phantomjs_cdnurl=http://cnpmjs.org/downloads\nphantomjs_cdnurl=https://npm.taobao.org/dist/phantomjs\n" }, { "path": "packages/crd-scripts/README.md", "content": " _.-\"\\\n _.-\" \\\n ,-\" \\\n \\ create \\\n \\ \\ react \\\n \\ \\ doc \\\n \\ \\ _.-;\n \\ \\ _.-\" :\n \\ \\,-\" _.-\"\n \\( _.-\"\n `--\"\n\n# crd-scripts\n\ncrd-scripts 封装提供了一系列构建、发布脚本。\n" }, { "path": "packages/crd-scripts/index.js", "content": "const initProject = require('./src/commands/initProject')\nconst initTheme = require('./src/commands/initTheme')\nconst initCache = require('./src/utils/initCache')\nconst Servers = require('./src/server')\nconst Build = require('./src/build')\nconst Deploy = require('./src/deploy')\nconst Generate = require('./src/generate')\nconst paths = require('./src/conf/path')\n\nmodule.exports = {\n initProject,\n initTheme,\n initCache,\n Servers,\n Build,\n Deploy,\n Generate,\n paths,\n}\n" }, { "path": "packages/crd-scripts/package.json", "content": "{\n \"name\": \"crd-scripts\",\n \"version\": \"1.10.3\",\n \"description\": \"Scripts using with Create React Doc\",\n \"main\": \"index.js\",\n \"dependencies\": {\n \"@mdx-js/loader\": \"^1.6.22\",\n \"@nuxtjs/friendly-errors-webpack-plugin\": \"^2.0.2\",\n \"babel-eslint\": \"^8.0.1\",\n \"chalk\": \"^4.1.0\",\n \"colors-cli\": \"^1.0.13\",\n \"copy-markdown-image-webpack-plugin\": \"^2.0.0\",\n \"copy-template-dir\": \"^1.3.0\",\n \"crd-client-utils\": \"^1.8.2\",\n \"crd-generator-sitemap\": \"^1.3.4\",\n \"crd-prerender-spa-plugin\": \"^0.2.0\",\n \"crd-theme\": \"^1.10.3\",\n \"crd-utils\": \"^1.5.0\",\n \"css-loader\": \"^0.28.7\",\n \"css-minimizer-webpack-plugin\": \"^1.2.0\",\n \"detect-port\": \"^1.2.2\",\n \"esbuild-loader\": \"^2.20.0\",\n \"eslint\": \"^7.11.0\",\n \"eslint-loader\": \"^4.0.2\",\n \"file-loader\": \"^1.1.11\",\n \"fs-extra\": \"^5.0.0\",\n \"gh-pages\": \"^1.2.0\",\n \"html-webpack-plugin\": \"^4.5.1\",\n \"less-loader\": \"^7.2.1\",\n \"loading-cli\": \"^1.0.6\",\n \"local-ip-url\": \"^1.0.1\",\n \"mini-css-extract-plugin\": \"^0.4.0\",\n \"open-browsers\": \"^1.1.1\",\n \"path-browserify\": \"^1.0.1\",\n \"postcss-flexbugs-fixes\": \"^3.3.1\",\n \"postcss-loader\": \"^2.0.9\",\n \"process\": \"^0.11.10\",\n \"rehype-katex\": \"^5.0.0\",\n \"remark-math\": \"^3.0.1\",\n \"rimraf\": \"^2.6.2\",\n \"string-replace-loader\": \"^3.0.1\",\n \"style-loader\": \"^0.19.1\",\n \"upath\": \"^1.0.2\",\n \"url-replace-loader\": \"^1.0.0\",\n \"webpack\": \"^5.12.2\",\n \"webpack-dev-middleware\": \"^3.7.1\",\n \"webpack-dev-server\": \"^3.8.1\",\n \"webpack-hot-dev-clients\": \"^1.0.4\",\n \"webpackbar\": \"^4.0.0\",\n \"write\": \"^1.0.3\",\n \"yamljs\": \"^0.3.0\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/MuYunyun/create-react-doc\",\n \"directory\": \"packages/scripts\"\n },\n \"keywords\": [],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"author\": \"muyunyun\",\n \"license\": \"MIT\",\n \"gitHead\": \"ffc5e4cbc94a7356da558c2dbf46e2f39bb8b199\"\n}\n" }, { "path": "packages/crd-scripts/src/build.js", "content": "const webpack = require('webpack')\nconst fs = require('fs')\nconst { docsConfig } = require('crd-utils')\nconst conf = require('./conf/webpack.config.prod')\nrequire('colors-cli/toxic')\n\nmodule.exports = function serve(program) {\n if (!fs.existsSync(docsConfig)) {\n console.log('please check config.yml in root dir!\\n')\n return\n }\n const webpackConf = conf(program)\n const compiler = webpack(webpackConf)\n compiler.run((err, stats) => {\n if (err) { throw err }\n // 官方输出参数\n // https://webpack.js.org/configuration/stats/\n // https://github.com/webpack/webpack/issues/538#issuecomment-59586196\n /* eslint-disable */\n console.log(stats.toString({\n colors: true,\n children: false,\n chunks: false,\n modules: false,\n errors: true,\n errorDetails: true,\n errorStack: true,\n warningsFilter: (warning) => {\n return true\n }\n }))\n })\n}\n" }, { "path": "packages/crd-scripts/src/commands/initProject.js", "content": "const path = require('path')\nconst { execSync } = require('child_process')\nconst fs = require('fs-extra')\nconst { templatePath, resolveApp } = require('crd-utils')\nconst copyTemplate = require('copy-template-dir')\nconst paths = require('../conf/path')\n\nconst log = console.log; // eslint-disable-line\n\n// eslint-disable-next-line no-unused-vars\nmodule.exports = function (params) {\n // process.argv[2] means the first argument after react-doc, eg react doc abc, process.argv[2] is abc\n const outDir = path.join(paths.projectPath, process.argv[2])\n const projectName = path.basename(outDir)\n\n const crdpkg = require(paths.crdPackage); // eslint-disable-line\n // replace the last vertion with x, so it'll install autoly when the last vertion changes.\n const CRD_VERSION = crdpkg.version.split('.').slice(0, 2).concat('x').join('.')\n\n // clear output dir\n if (!fs.pathExistsSync(outDir)) {\n fs.ensureDirSync(outDir)\n }\n\n const defaultTemplatePath = `${templatePath}/default`\n\n // copy template, see https://github.com/MuYunyun/create-react-doc/issues/50\n if (!fs.pathExistsSync(defaultTemplatePath)) {\n execSync('mkdir temp && cd temp && yarn add crd-templates -D')\n }\n const templatePathInTemp = resolveApp('temp/node_modules/crd-templates/default')\n if (fs.pathExistsSync(templatePathInTemp)) {\n copyTemplate(templatePathInTemp, outDir, {\n name: projectName,\n crdVersion: CRD_VERSION,\n }, (err, createdFiles) => {\n if (err) return log(`Copy Tamplate Error: ${err} !!!`.red)\n createdFiles.sort().forEach((createdFile) => {\n log(` ${'create'.green} ${createdFile.replace(paths.projectPath, '')}`)\n })\n // to hack https://github.com/yoshuawuyts/copy-template-dir/issues/16\n execSync(`cp -r ${templatePathInTemp}/.github ${outDir}`)\n execSync('rm -rf temp')\n log('\\n initialization finished!\\n'.green)\n const cmdstr = `cd ${projectName} && yarn && yarn start`.cyan\n log(` Run the ${cmdstr} to start the website.\\n\\n`)\n })\n } else {\n log(` ❎ crd-templates install fail.\\n\\n`)\n }\n}\n" }, { "path": "packages/crd-scripts/src/commands/initTheme.js", "content": "/**\n * This file is to init theme quickly.\n */\nconst path = require('path')\nconst { execSync } = require('child_process')\nconst fs = require('fs-extra')\nconst { templatePath } = require('crd-utils')\nconst copyTemplate = require('copy-template-dir')\nconst paths = require('../conf/path')\n\nconst log = console.log; // eslint-disable-line\n\n// eslint-disable-next-line no-unused-vars\nmodule.exports = function (themeName) {\n const outDir = path.join(paths.projectPath, themeName)\n\n const crdpkg = require(paths.crdPackage); // eslint-disable-line\n // replace the last vertion with x, so it'll install autoly when the last vertion changes.\n const CRD_VERSION = crdpkg.version.split('.').slice(0, 2).concat('x').join('.')\n\n // clear output dir\n if (!fs.pathExistsSync(outDir)) {\n fs.ensureDirSync(outDir)\n }\n\n const defaultTemplatePath = `${templatePath}/theme/default`\n\n if (!fs.pathExistsSync(defaultTemplatePath)) {\n execSync('mkdir temp && cd temp && yarn add crd-templates -D')\n }\n copyTemplate(defaultTemplatePath, outDir, {\n name: themeName,\n crdVersion: CRD_VERSION,\n }, (err, createdFiles) => {\n if (err) return log(`Copy Tamplate Error: ${err} !!!`.red)\n createdFiles.sort().forEach((createdFile) => {\n log(` ${'create'.green} ${createdFile.replace(paths.projectPath, '')}`)\n })\n execSync('rm -rf temp')\n log('\\n initialization finished!\\n'.green)\n const cmdstr = `cd ${themeName} && yarn && yarn start`.cyan\n log(` Run the ${cmdstr} to start the website.\\n\\n`)\n })\n}\n" }, { "path": "packages/crd-scripts/src/conf/getDirTree.js", "content": "const { directoryTree } = require('./node-directory-tree')\n\nconst getDirTree = (cmd) => {\n const dir = cmd.markdownPaths\n const dirs = Array.isArray(dir) ? dir : [dir]\n const otherProps = {\n mdconf: true,\n extensions: /\\.md/,\n prerender: true,\n }\n const mapTagsWithArticle = []\n const dirTree = dirs.map(path => directoryTree({\n path,\n options: otherProps,\n mapTagsWithArticle\n }))\n return {\n dirTree,\n // map tags with path. [{ tagName: 'custom Tag 1', mapArticle: [{ path, name }]}]\n mapTagsWithArticle\n }\n}\n\nmodule.exports = {\n getDirTree,\n}\n" }, { "path": "packages/crd-scripts/src/conf/getPrerenderRoutes.js", "content": "// eg: ['docs/quick_start.md', 'a']\n// output: ['/quick_start', '/a/b', '/a/b/c']\nconst getPrerenderRoutes = (dirTree) => {\n const dpCloneDirTree = JSON.parse(JSON.stringify(dirTree))\n const result = recursiveDirTree(dpCloneDirTree)\n result.push('/404')\n result.push('/tags')\n return result\n}\n\nfunction recursiveDirTree(data) {\n return recursive(\n data,\n '',\n []\n )\n}\n\nfunction recursive(\n data,\n routePath,\n prerenderRouteArr,\n) {\n data.forEach((item) => {\n const { mdconf } = item || {}\n const { abbrlink, tags } = mdconf || {}\n const composeRouteName = `${routePath}/${item.name}`.replace(/.md$/, '')\n\n if (item.type === 'directory') {\n if (item.children && item.children.length > 0) {\n item.children = recursive(\n item.children,\n composeRouteName,\n prerenderRouteArr,\n )\n } else {\n item.children = []\n }\n } else if (item.type === 'file') {\n const prerenderRouteName = abbrlink\n ? `/${abbrlink}`\n : composeRouteName\n prerenderRouteArr.push(prerenderRouteName)\n }\n })\n return prerenderRouteArr\n}\n\nmodule.exports = {\n getPrerenderRoutes\n}\n" }, { "path": "packages/crd-scripts/src/conf/node-directory-tree.js", "content": "/* eslint-disable no-undef */\nconst fs = require('fs')\nconst PATH = require('path')\nconst YAML = require('yamljs')\nconst { execSync } = require('child_process')\nconst {\n replaceForFrontMatter,\n generateRandomId,\n} = require('crd-utils')\nconst { getDigitFromDir, timeFormat } = require('../utils')\n\nconst constants = {\n DIRECTORY: 'directory',\n FILE: 'file',\n}\n\nfunction safeReadDirSync(path) {\n let dirData = {}\n try {\n /**\n * to make sure it's ordered like such rules, link issue: https://github.com/nodejs/node/issues/3232\n * 1.x 1.x\n * 2.x instead of 10.x\n * 10.x 2.x\n */\n dirData = fs.readdirSync(path).sort((dir1, dir2) => {\n const dir1Digit = getDigitFromDir(dir1)\n const dir2Digit = getDigitFromDir(dir2)\n if (dir1Digit && dir2Digit) {\n return dir1Digit - dir2Digit\n }\n return 0\n })\n } catch (ex) {\n if (ex.code === 'EACCES')\n // User does not have permissions, ignore directory\n // eslint-disable-next-line brace-style\n { return null }\n throw ex\n }\n return dirData\n}\n\n// collect unique tags from all articles.\nconst tagsArr = []\n\n/** build directory Tree, fork from https://github.com/mihneadb/node-directory-tree\n * path: path for file\n * options: {\n * exclude: RegExp|RegExp[] - A RegExp or an array of RegExp to test for exclusion of directories.\n * extensions : RegExp - A RegExp to test for exclusion of files with the matching extension.\n * mdconf: Boolean.\n * prerender: Boolean. Used for prerender.\n * generate: Boolean. Used for generating info in front-matter.\n * }\n * mapTagsWithArticle: [{\n * tagName: 'customTag1', // tag type name\n * mapArticle: [{\n * path, // click tag to jump route such as /tags/customTag1\n * title // the name of article\n * }]\n * }]\n */\nfunction directoryTree({\n path,\n options,\n routePath = '',\n mapTagsWithArticle\n}) {\n const name = PATH.basename(path, '.md')\n const item = { name }\n const routePropsCurrent = `${routePath}/${name}`\n if (!options.prerender) {\n item.path = path\n }\n let stats\n try {\n stats = fs.statSync(path)\n } catch (e) {\n return null\n }\n\n // Skip if it matches the exclude regex\n if (options && options.exclude && options.exclude.test(path)) return null\n\n if (stats.isFile()) {\n const ext = PATH.extname(path).toLowerCase()\n\n // Skip if it does not match the extension regex\n if (options && options.extensions && !options.extensions.test(ext)) { return null }\n\n if (options && options.mdconf) {\n item.type = constants.FILE\n const contentStr = fs.readFileSync(path).toString()\n if (!contentStr) return\n const contentMatch = contentStr.match(/^/)\n /** generate abbrlink in FrontMatter */\n if (options.generate) {\n const randomId = generateRandomId(8)\n if (!contentMatch) {\n replaceForFrontMatter({\n path,\n target: `\\n`\n })\n }\n if (contentMatch && contentMatch[1].indexOf('abbrlink') === -1) {\n replaceForFrontMatter({\n path,\n source: contentMatch[1],\n target: `\\nabbrlink: ${randomId}${contentMatch[1]}`\n })\n console.log('✅ replaceForFrontMatter success')\n }\n }\n\n const yamlParse = contentMatch ? YAML.parse(contentMatch[1]) : {}\n const { tags: articleTags, abbrlink } = yamlParse\n if (Array.isArray(articleTags) && Array.isArray(mapTagsWithArticle)) {\n const cpArticleTags = Array.from(new Set(articleTags))\n for (let i = 0; i < cpArticleTags.length; i++) {\n const articleTag = cpArticleTags[i]\n const articleTagIndex = tagsArr.indexOf(articleTag)\n if (articleTagIndex > -1) {\n mapTagsWithArticle[articleTagIndex]['mapArticle'].push({\n path: abbrlink ? `/${abbrlink}` : routePropsCurrent,\n title: name\n })\n } else {\n tagsArr.push(cpArticleTags[i])\n mapTagsWithArticle.push({\n tagName: cpArticleTags[i],\n mapArticle: [{\n path: abbrlink ? `/${abbrlink}` : routePropsCurrent,\n title: name\n }]\n })\n }\n }\n }\n\n item.mdconf = yamlParse\n try {\n // see https://stackoverflow.com/questions/2390199/finding-the-date-time-a-file-was-first-added-to-a-git-repository/2390382#2390382\n const result = execSync(`git log --format=%aD ${path} | tail -1`)\n item.birthtime =\n Buffer.isBuffer(result) && timeFormat(new Date(result))\n } catch (error) {\n console.log(`❎ error: ${error.message}`)\n }\n try {\n // see https://stackoverflow.com/questions/22497597/get-the-last-modification-data-of-a-file-in-git-repo\n const result = execSync(`git log -1 --pretty=\"format:%ci\" ${path}`)\n item.mtime = Buffer.isBuffer(result) && timeFormat(new Date(result))\n } catch (error) {\n console.log(`❎ error: ${error.message}`)\n }\n item.size = stats.size // File size in bytes\n item.extension = ext\n if (!options.prerender) {\n item.relative = item.path.replace(process.cwd(), '')\n item.isEmpty = contentMatch\n ? !String.prototype.trim.call(contentStr.replace(contentMatch[0], ''))\n : true\n const uglifyContent = contentStr.replace(/\\s/g, '')\n item.content = uglifyContent\n }\n }\n } else if (stats.isDirectory()) {\n const dirData = safeReadDirSync(path)\n if (dirData === null) return null\n item.children = dirData\n .map(child =>\n directoryTree({\n path: PATH.join(path, child),\n options,\n routePath: routePropsCurrent,\n mapTagsWithArticle\n }),\n )\n .filter(e => !!e)\n item.type = constants.DIRECTORY\n if (!options.prerender) {\n item.size = item.children.reduce((prev, cur) => prev + cur.size, 0)\n }\n } else {\n return null // Or set item.size = 0 for devices, FIFO and sockets ?\n }\n return item\n}\n\nmodule.exports = {\n directoryTree\n}\n" }, { "path": "packages/crd-scripts/src/conf/path.js", "content": "const path = require('path')\nconst fs = require('fs')\nconst { execSync } = require('child_process')\nconst { resolveApp, docsConfig, getDocsConfig } = require('crd-utils')\nconst chalk = require('chalk')\n\n// handle the problem of symbol in any platform\nconst appDirectory = fs.realpathSync(process.cwd())\n\nconst modPath = resolveApp('node_modules')\n// get config crd from package.json\nfunction getCrdConf() {\n const packagePath = resolveApp('./package.json')\n let conf = {}\n if (fs.existsSync(packagePath)) {\n const confPkg = require(packagePath); // eslint-disable-line\n conf = confPkg.crd\n }\n return conf\n}\n\nfunction getConfigFilePath(fileName, type) {\n const conf = getCrdConf()\n // read config\n if (conf && conf[type]) {\n // load theme dir\n if (type === 'theme') {\n if (!conf[type]) conf[type] = fileName\n const _path = path.resolve(appDirectory, 'theme', conf[type])\n const _NodeModulesPath = path.resolve(\n appDirectory,\n 'node_modules',\n conf[type],\n )\n if (fs.existsSync(_path)) {\n return fs.realpathSync(_path)\n } else if (fs.existsSync(_NodeModulesPath)) {\n return fs.realpathSync(_NodeModulesPath)\n }\n return false\n }\n if (/^(favicon|logo)$/.test(type)) {\n return path.resolve(appDirectory, conf[type])\n }\n }\n const _filepath = path.resolve(appDirectory, fileName)\n if (fs.existsSync(_filepath)) {\n // favicon|logo in default root dir.\n return _filepath\n }\n return false\n}\n\n// Get favicon path\nconst faviconPath = () => {\n const _path = getConfigFilePath('./favicon.ico', 'favicon')\n if (_path) return _path\n // the path'll be writen dynamiclly in the future\n return resolveApp('node_modules/crd-theme/favicon.ico')\n}\n\n// Get logo path\nconst logoPath = () => {\n const _path = getConfigFilePath('./logo.svg', 'logo')\n if (_path) return _path\n return false\n}\n\nlet theme = ''\n// theme in develop mode.\nlet devTheme = false\n\nconst getTheme = () => {\n if (docsConfig) {\n const docsConfigObj = getDocsConfig()\n if (!docsConfigObj) return\n if (docsConfigObj.devTheme) {\n devTheme = docsConfigObj.devTheme\n theme = docsConfigObj.devTheme\n } else {\n theme = docsConfigObj.theme\n\n // install custom theme\n if (!fs.existsSync(resolveApp(`node_modules/${theme}`))) {\n // todo: chalkblue(xxx) not show in the terminal\n chalk.blue(`Install theme ${theme}`)\n // -W means ignore-workspace-root-check\n execSync(`yarn add ${theme} -D -W`)\n chalk.blue(`Install theme ${theme} done`)\n } else {\n chalk.blue(`Upgrade theme ${theme}`)\n // -W means ignore-workspace-root-check\n execSync(`yarn upgrade ${theme}`)\n chalk.blue(`Upgrade theme ${theme} done`)\n }\n }\n }\n}\n\ngetTheme()\n\n// get exclude folders\nfunction getExcludeFoldersRegExp() {\n if (!fs.existsSync(modPath)) return []\n let regexp = fs.readdirSync(modPath)\n /** whitelist to include */\n const whiteListRegExp = new RegExp(`create-react-doc(.*)|crd-scripts|crd-theme|${theme}`)\n regexp = regexp.filter(\n item => !whiteListRegExp.test(item),\n // item => !/create-react-doc(.*)|crd-scripts|crd-theme/.test(item),\n )\n regexp = regexp.map((item) => {\n let rgxPath = `node_modules${path.sep}${item}`\n if (path.sep === '\\\\') {\n // to watch: is '\\\\' needful?\n rgxPath = `node_modules\\\\${path.sep}${item}`\n }\n return new RegExp(rgxPath)\n })\n return regexp\n}\n\n// crd tool dir\nconst toolDirectory = fs.realpathSync(__dirname)\nconst resolveTool = relativePath => path.resolve(toolDirectory, relativePath)\n\nmodule.exports = {\n // markdown dir\n crdConf: getCrdConf(),\n defaultTheme: devTheme\n ? resolveApp(`${devTheme}`)\n : resolveApp(`node_modules/${theme}`),\n defaultNodeModules: modPath,\n projectPath: appDirectory,\n publicPath: '',\n logoPath: logoPath(),\n // crd tool dir\n getExcludeFoldersRegExp: getExcludeFoldersRegExp(),\n crdPackage: resolveTool('../../package.json'),\n defaultFaviconPath: faviconPath(),\n appIndexJs: resolveTool('../web/index.js'),\n appDir: resolveTool('../web'),\n}\n" }, { "path": "packages/crd-scripts/src/conf/rawTreeReplaceLoader.js", "content": "// A variation of https://github.com/react-doc/node-directory-tree-md/blob/master/lib/directory-tree-md.js\nconst { directoryTree } = require('./node-directory-tree')\nconst PATH = require('path')\nconst { ifInGitIgnore } = require('../utils/index')\n\nfunction getAllWatchPath(arr, pathArr = []) {\n arr.forEach((item) => {\n const mdfilePathInProject = item.path.replace(\n process.cwd() + PATH.sep,\n '',\n )\n if (!ifInGitIgnore(mdfilePathInProject) && item.type === 'file') {\n pathArr.push(item.path)\n }\n if (item.children && item.children.length > 0) {\n pathArr.concat(getAllWatchPath(item.children, pathArr))\n }\n })\n return pathArr\n}\n\nfunction replacePath(dirs, path) {\n for (let i = 0; i < dirs.length; i += 1) {\n const element = PATH.dirname(dirs[i])\n const reg = new RegExp(`^${element}`, 'gi')\n if (reg.test(path)) {\n path = path.replace(reg, '')\n break\n }\n }\n return path\n}\n\nfunction getRelativePath(arr, relativePath, dirs) {\n const pathArr = []\n arr.forEach((item) => {\n if (relativePath && item.path) {\n item.path = replacePath(dirs, item.path)\n }\n if (item.children && item.children.length > 0) {\n item.children = getRelativePath(item.children, relativePath, dirs)\n }\n const notInGitIgnore = !ifInGitIgnore(item.path.replace(PATH.sep, ''))\n if (notInGitIgnore) {\n pathArr.push(item)\n }\n })\n return pathArr\n}\n\nmodule.exports = function (source) {\n // get option config from webpack loader, here is https://github.com/MuYunyun/create-react-doc/blob/main/packages/scripts/src/conf/webpack.config.prod.js#L61-L70\n const options = this.getOptions() || {}\n const { include, directoryTrees } = options\n const { dir, relativePath, ...otherProps } = directoryTrees\n let content = typeof source === 'string' ? JSON.parse(source) : source\n // It's said loader resuls are flagged as cacheable. See https://webpack.js.org/api/loaders/#thiscacheable.\n // if (this.cacheable) this.cacheable()\n if (directoryTrees && (!include || include.test(this.resourcePath))) {\n const dirs = Array.isArray(dir) ? dir : [dir]\n const dirTree = dirs.map(path => directoryTree({\n path,\n options: otherProps,\n }))\n\n const filemd = getAllWatchPath(dirTree)\n filemd.forEach((fileItem) => {\n this.addDependency(fileItem)\n })\n // replace full file path with relative path\n content = getRelativePath(\n dirTree,\n relativePath,\n dirs,\n )\n }\n content = JSON.stringify(content)\n .replace(/\\u2028/g, '\\\\u2028')\n .replace(/\\u2029/g, '\\\\u2029')\n\n return `module.exports = ${content}`\n}\n" }, { "path": "packages/crd-scripts/src/conf/webpack.config.dev.js", "content": "const autoprefixer = require('autoprefixer')\nconst webpack = require('webpack')\nconst path = require('path')\nconst upath = require('upath')\nconst HtmlWebpackPlugin = require('html-webpack-plugin')\nconst { defaultHTMLPath } = require('crd-utils')\nconst FriendlyErrorsWebpackPlugin = require('@nuxtjs/friendly-errors-webpack-plugin')\nconst { getDocsConfig } = require('crd-utils')\nconst { getDirTree } = require('./getDirTree')\nconst config = require('./webpack.config')\nconst paths = require('./path')\n\nmodule.exports = function (cmd) {\n const docsConfig = getDocsConfig()\n const { mapTagsWithArticle } = getDirTree(cmd)\n config.mode = 'development'\n config.devtool = 'eval-source-map'\n config.entry = [\n require.resolve('react-hot-loader/patch'),\n require.resolve('webpack-hot-dev-clients/webpackHotDevClient'),\n paths.appIndexJs,\n ]\n config.output.publicPath = '/'\n config.module.rules = config.module.rules.map((item) => {\n if (item.oneOf) {\n const loaders = []\n loaders.push({\n // Process JS with Babel.\n test: /\\.(js|jsx)$/,\n exclude: paths.getExcludeFoldersRegExp.concat(/\\.(cache)/),\n use: [\n {\n loader: require.resolve('string-replace-loader'),\n options: {\n multiple: [\n { search: '__project_root__', replace: upath.normalizeSafe(paths.projectPath), flags: 'ig' },\n { search: '__project_theme__', replace: upath.normalizeSafe(paths.defaultTheme), flags: 'ig' },\n ],\n },\n },\n {\n loader: 'esbuild-loader',\n options: {\n loader: 'jsx',\n target: 'es2015',\n // This will make esbuild automatically generate import statements,\n // making the ProviderPlugin unnecesary if used only for \"react\".\n // Note that this option makes sense only when used in conjuction\n // with React >16.40.0 || >17\n // https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html\n jsx: 'automatic',\n }\n },\n ],\n })\n // https://ilikekillnerds.com/2018/03/disable-webpack-4-native-json-loader/\n loaders.push({\n test: /crd\\.json$/,\n // 禁用 Webpack 4 本身的 JSON 加载程序\n type: 'javascript/auto',\n use: [\n {\n loader: `${path.join(__dirname, './rawTreeReplaceLoader.js')}`,\n options: {\n include: /crd\\.json$/,\n directoryTrees: {\n dir: cmd.markdownPaths,\n mdconf: true,\n extensions: /\\.md/,\n relativePath: true,\n },\n },\n },\n ],\n })\n\n loaders.push({\n test: /\\.(css|less)$/,\n use: [\n require.resolve('style-loader'),\n {\n loader: require.resolve('css-loader'),\n options: {\n modules: true,\n localIdentName: '[local]--[hash:base64:5]',\n importLoaders: 1,\n },\n },\n {\n loader: require.resolve('postcss-loader'),\n options: {\n // Necessary for external CSS imports to work\n // https://github.com/facebookincubator/create-react-app/issues/2677\n ident: 'postcss',\n plugins: () => [\n require(\"postcss-flexbugs-fixes\"), // eslint-disable-line\n autoprefixer({\n browsers: [\n '>1%',\n 'last 4 versions',\n 'Firefox ESR',\n 'not ie < 9', // React doesn't support IE8 anyway\n ],\n flexbox: 'no-2009',\n }),\n ],\n },\n },\n require.resolve('less-loader'),\n ],\n })\n\n item.oneOf = loaders.concat(item.oneOf)\n }\n return item\n })\n\n config.optimization = {\n // 将模块名称添加到工厂功能，以便它们显示在浏览器分析器中。\n // 当接收到热更新信号时，在浏览器 console 控制台打印更多可读性高的模块名称等信息\n moduleIds: 'named',\n }\n\n config.plugins = config.plugins.concat([\n new webpack.DefinePlugin({\n env: JSON.stringify('dev'),\n mapTagsWithArticle: JSON.stringify(mapTagsWithArticle)\n }),\n new webpack.HotModuleReplacementPlugin(),\n new HtmlWebpackPlugin({\n inject: true,\n favicon: paths.defaultFaviconPath,\n template: defaultHTMLPath,\n title: docsConfig && docsConfig.title ? docsConfig.title : 'Create React Doc',\n }),\n new FriendlyErrorsWebpackPlugin({\n clearConsole: true,\n }),\n ])\n return config\n}\n" }, { "path": "packages/crd-scripts/src/conf/webpack.config.js", "content": "/* eslint-disable global-require */\n/* eslint-disable import/no-dynamic-require */\nconst webpack = require('webpack')\nconst webpackbar = require('webpackbar')\nconst fs = require('fs')\nconst { resolveApp, docsConfig, docsBuildDist } = require('crd-utils')\nconst { getDocsConfig } = require('crd-utils')\n// const { getSearchContent } = require('../utils');\nconst remarkMath = require('remark-math')\nconst rehypeKatex = require('rehype-katex')\nconst paths = require('./path')\nconst pkg = require('../../package.json')\n\nconst define = {\n FOOTER: null,\n DOCSCONFIG: null,\n INJECT: null,\n}\nif (paths.crdConf && paths.crdConf.footer && typeof paths.crdConf.footer === 'string') {\n define.FOOTER = JSON.stringify(paths.crdConf.footer)\n}\n/* custom define docs config */\nif (docsConfig) {\n // const searchContent = getSearchContent();\n const docsConfigObj = getDocsConfig()\n define.DOCSCONFIG = JSON.stringify(docsConfigObj)\n // todo: searchContent affects the performance, so take annotation here templately.\n // define.SEARCHCONTENT = searchContent && searchContent.toString();\n\n // if there is inject logic in docsConfigObj\n if (docsConfigObj && docsConfigObj.inject && fs.existsSync(resolveApp(docsConfigObj.inject))) {\n define.INJECT = require(resolveApp(docsConfigObj.inject))\n }\n}\n\nmodule.exports = {\n entry: {},\n output: {\n path: docsBuildDist,\n publicPath: paths.publicPath,\n filename: 'js/[name].[hash:8].js',\n chunkFilename: 'js/[name].[hash:8].js',\n },\n module: {\n rules: [\n {\n // “oneOf”将遍历所有以下加载程序，直到一个符合要求。\n // 当没有加载器匹配时，它将返回到加载程序列表末尾的“file”加载器。\n oneOf: [\n {\n test: /\\.(svg|png|bmp|jpg|jpeg|gif)$/,\n loader: require.resolve('url-replace-loader'),\n options: {\n limit: 10000,\n name: 'img/[name].[hash:8].[ext]',\n replace: [\n {\n test: /crd\\.logo\\.svg$/,\n path: paths.logoPath,\n },\n ],\n },\n },\n {\n test: /\\.md$/,\n use: [\n {\n loader: 'esbuild-loader',\n options: {\n loader: 'jsx',\n target: 'es2015',\n // This will make esbuild automatically generate import statements,\n // making the ProviderPlugin unnecesary if used only for \"react\".\n // Note that this option makes sense only when used in conjuction\n // with React >16.40.0 || >17\n // https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html\n jsx: 'automatic',\n }\n },\n {\n loader: require.resolve('@mdx-js/loader'),\n options: {\n remarkPlugins: [\n [\n remarkMath,\n {\n /* options */\n },\n ],\n ],\n rehypePlugins: [\n [\n rehypeKatex,\n {\n /* options */\n },\n ],\n ],\n },\n },\n ],\n exclude: /(node_modules)/,\n },\n // “file-loader”确保这些资源由WebpackDevServer服务。\n // 当您导入资源时，您将获得（虚拟）文件名。\n // 在生产中，它们将被复制到`build`文件夹。\n // 此加载程序不使用“test”，因此它将捕获所有模块\n {\n // 排除`js`文件以保持“css”加载器工作，因为它注入它的运行时，否则将通过“文件”加载器处理。\n // 还可以排除“html”和“json”扩展名，以便它们被webpacks内部加载器处理。\n exclude: [/\\.js$/, /\\.html$/, /\\.json$/],\n loader: require.resolve('file-loader'),\n options: {\n name: 'static/[name].[hash:8].[ext]',\n },\n },\n ],\n },\n ],\n },\n plugins: [\n // eslint-disable-next-line new-cap\n new webpackbar({ name: pkg.name }),\n new webpack.DefinePlugin({\n VERSION: JSON.stringify(pkg.version),\n ...define,\n }),\n // fix \"process is not defined\" error:\n new webpack.ProvidePlugin({\n process: 'process/browser',\n }),\n ],\n resolve: {\n fallback: {\n path: require.resolve('path-browserify'),\n },\n },\n}\n" }, { "path": "packages/crd-scripts/src/conf/webpack.config.prod.js", "content": "const autoprefixer = require('autoprefixer')\nconst path = require('path')\nconst upath = require('upath')\nconst webpack = require('webpack')\nconst HtmlWebpackPlugin = require('html-webpack-plugin')\nconst CopyMarkdownImageWebpackPlugin = require('copy-markdown-image-webpack-plugin')\nconst MiniCssExtractPlugin = require('mini-css-extract-plugin')\nconst PrerenderSPAPlugin = require('crd-prerender-spa-plugin')\nconst { generateSiteMap } = require('crd-generator-sitemap')\nconst fs = require('fs-extra')\nconst { defaultHTMLPath, docsBuildDist } = require('crd-utils')\nconst { getDocsConfig } = require('crd-utils')\nconst config = require('./webpack.config')\nconst paths = require('./path')\nconst { getPrerenderRoutes } = require('./getPrerenderRoutes')\nconst { getDirTree } = require('./getDirTree')\n\nconst Renderer = PrerenderSPAPlugin.PuppeteerRenderer\n\nmodule.exports = function (cmd) {\n const docsConfig = getDocsConfig()\n const { dirTree, mapTagsWithArticle } = getDirTree(cmd)\n const routes = getPrerenderRoutes(dirTree)\n\n config.mode = 'production'\n config.entry = [paths.appIndexJs]\n // config.output.filename = 'js/[hash:8].js'\n config.output.chunkFilename = 'js/[name].[hash:8].js'\n config.output.publicPath = docsConfig.repo ? `/${docsConfig.repo}/` : '/'\n config.output.path = docsConfig.repo ? `${docsBuildDist}/${docsConfig.repo}` : docsBuildDist\n config.module.rules = config.module.rules.map((item) => {\n if (item.oneOf) {\n const loaders = []\n loaders.push({\n // Process JS with Babel.\n test: /\\.(js|jsx)$/,\n exclude: paths.getExcludeFoldersRegExp.concat(/\\.(cache)/),\n use: [\n {\n loader: require.resolve('string-replace-loader'),\n options: {\n multiple: [\n { search: '__project_root__', replace: upath.normalizeSafe(paths.projectPath), flags: 'ig' },\n { search: '__project_theme__', replace: upath.normalizeSafe(paths.defaultTheme), flags: 'ig' },\n ],\n },\n },\n {\n loader: 'esbuild-loader',\n options: {\n loader: 'jsx',\n target: 'es2015',\n // This will make esbuild automatically generate import statements,\n // making the ProviderPlugin unnecesary if used only for \"react\".\n // Note that this option makes sense only when used in conjuction\n // with React >16.40.0 || >17\n // https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html\n jsx: 'automatic',\n }\n },\n ],\n })\n // https://ilikekillnerds.com/2018/03/disable-webpack-4-native-json-loader/\n loaders.push({\n test: /crd\\.json$/,\n // 禁用 Webpack 4 本身的 JSON 加载程序\n type: 'javascript/auto',\n use: [\n {\n loader: `${path.join(__dirname, './rawTreeReplaceLoader.js')}`,\n options: {\n include: /crd\\.json$/, // 检查包含的文件名字\n directoryTrees: {\n // 指定目录生成目录树，json\n dir: cmd.markdownPaths,\n mdconf: true,\n extensions: /\\.md/,\n relativePath: true,\n },\n },\n },\n ],\n })\n\n loaders.push({\n test: /\\.(css|less)$/,\n use: [\n MiniCssExtractPlugin.loader,\n {\n loader: require.resolve('css-loader'),\n options: {\n modules: true,\n localIdentName: '[local]-[hash:base64:5]',\n importLoaders: 1,\n },\n },\n {\n loader: require.resolve('postcss-loader'),\n options: {\n // Necessary for external CSS imports to work\n // https://github.com/facebookincubator/create-react-app/issues/2677\n ident: 'postcss',\n plugins: () => [\n require('postcss-flexbugs-fixes'), // eslint-disable-line\n autoprefixer({\n browsers: [\n '>1%',\n 'last 4 versions',\n 'Firefox ESR',\n 'not ie < 9', // React doesn't support IE8 anyway\n ],\n flexbox: 'no-2009',\n }),\n ],\n },\n },\n require.resolve('less-loader'),\n ],\n })\n\n item.oneOf = loaders.concat(item.oneOf)\n }\n return item\n })\n config.optimization = {\n // minimize: true,\n // minimizer: [\n // // For webpack@5 you can use the `...` syntax to extend existing minimizers (i.e. `terser-webpack-plugin`), uncomment the next line\n // // `...`,\n // new CssMinimizerPlugin(),\n // ],\n }\n\n config.plugins = config.plugins.concat([\n new webpack.DefinePlugin({\n env: JSON.stringify('prod'),\n mapTagsWithArticle: JSON.stringify(mapTagsWithArticle)\n }),\n new HtmlWebpackPlugin({\n inject: true,\n favicon: paths.defaultFaviconPath,\n template: defaultHTMLPath,\n title:\n docsConfig && docsConfig.title ? docsConfig.title : 'Create React Doc',\n minify: {\n removeAttributeQuotes: true,\n collapseWhitespace: true,\n html5: true,\n minifyCSS: true,\n removeComments: true,\n removeEmptyAttributes: true,\n },\n }),\n new CopyMarkdownImageWebpackPlugin({\n dir: cmd.markdownPaths,\n toDir: config.output.path,\n }),\n // new webpack.optimize.DedupePlugin(),\n new MiniCssExtractPlugin({\n // Options similar to the same options in webpackOptions.output\n // both options are optional\n filename: 'css/[contenthash].css',\n chunkFilename: 'css/[id].css',\n }),\n new PrerenderSPAPlugin({\n // Required - The path to the webpack-outputted app to prerender.\n staticDir: docsBuildDist,\n outputDir: docsConfig.repo\n ? `${docsBuildDist}/${docsConfig.repo}`\n : docsBuildDist,\n indexPath: docsConfig.repo\n ? `${docsBuildDist}/${docsConfig.repo}/index.html`\n : `${docsBuildDist}/index.html`,\n // Required - Routes to render.\n routes,\n successCb: async () => {\n if (docsConfig.repo) {\n // not use fs.move here or it'll throw error in github action\n await fs.copy(`${docsBuildDist}/${docsConfig.repo}`, docsBuildDist)\n await fs.remove(`${docsBuildDist}/${docsConfig.repo}`)\n const defaultPath = (dirTree.find(data => data.name === 'README.md')\n && dirTree.find(data => data.name === 'README.md').mdconf\n && dirTree.find(data => data.name === 'README.md').mdconf.abbrlink) || 'README'\n // move README as root index.html\n await fs.copy(`${docsBuildDist}/${defaultPath}/index.html`, `${docsBuildDist}/index.html`)\n console.log('✅ generate prerender file success!')\n if (docsConfig.seo) {\n if (docsConfig.seo.google) {\n fs.writeFileSync(`${docsBuildDist}/sitemap.xml`, generateSiteMap(routes))\n }\n }\n console.log('✅ generate sitemap file success!')\n }\n },\n // The actual renderer to use. (Feel free to write your own)\n // Available renderers: https://github.com/Tribex/prerenderer/tree/master/renderers\n renderer: new Renderer({\n // Optional - The name of the property to add to the window object with the contents of `inject`.\n injectProperty: '__PRERENDER_INJECTED',\n // Optional - Any values you'd like your app to have access to via `window.injectProperty`.\n inject: {\n prerender: true,\n },\n // Optional - defaults to 0, no limit.\n // Routes are rendered asynchronously.\n // Use this to limit the number of routes rendered in parallel.\n maxConcurrentRoutes: 4,\n // https://pptr.dev/#?product=Puppeteer&version=v5.5.0&show=api-pagegotourl-options\n navigationOptions: {\n timeout: 0\n }\n }),\n }),\n ])\n return config\n}\n" }, { "path": "packages/crd-scripts/src/conf/webpack.config.server.js", "content": "const protocol = process.env.HTTPS === 'true' ? 'https' : 'http'\n\nmodule.exports = (cmd, webpackConf) => {\n return {\n // 启用生成文件的gzip压缩。\n compress: true,\n // 沉默WebpackDevServer自己的日志，因为它们通常没有用处。\n // 这个设置仍然会显示编译警告和错误。\n clientLogLevel: 'none',\n // contentBase: conf.output.appPublic,\n publicPath: webpackConf.output.publicPath,\n hot: true,\n historyApiFallback: {\n // 带点的路径仍应使用历史回退。\n // See https://github.com/facebookincubator/create-react-app/issues/387.\n disableDotRule: true,\n },\n // historyApiFallback: true,\n // WebpackDevServer默认是嘈杂的，所以我们发出自定义消息\n // 通过上面的`compiler.plugin`调用来监听编译器事件。\n quiet: true,\n // 如果HTTPS环境变量设置为“true”，则启用HTTPS\n https: protocol === 'https',\n // 告诉服务器从哪里提供内容。提供静态文件，这只是必要的。\n contentBase: cmd.markdownPaths,\n // 通知服务器观察由devServer.contentBase选项提供的文件。\n // it'll reload page when file change.\n watchContentBase: true,\n // avoid cpu overload in some case\n watchOptions: {\n ignored: /node_modules/,\n },\n }\n}\n" }, { "path": "packages/crd-scripts/src/deploy.js", "content": "const ghpages = require('gh-pages')\nconst loading = require('loading-cli')\n\nconst log = console.log; // eslint-disable-line\n\nmodule.exports = function server(cmd, docsConfig) {\n if (!docsConfig) {\n console.log('please check config.yml in root dir!\\n')\n return\n }\n if (!docsConfig.user || !docsConfig.repo) {\n console.log('please check user and repo in config.yml!\\n')\n return\n }\n const { user, repo, publish } = docsConfig\n log(' Start deploy to your git repo'.green)\n const load = loading({\n text: 'Please wait ...'.blue,\n color: 'blue',\n interval: 100,\n stream: process.stdout,\n }).start()\n\n ghpages.publish(\n cmd.output,\n {\n branch: cmd.branch,\n repo: publish || `https://github.com/${user}/${repo}.git`,\n message: `Update website, ${new Date()}!`,\n },\n (err) => {\n load.stop()\n if (err) {\n return log(err)\n }\n log(`\\n Push to ${cmd.branch} success!\\n`.green.bold)\n },\n )\n}\n\n" }, { "path": "packages/crd-scripts/src/generate.js", "content": "const fs = require('fs')\nconst { docsConfig } = require('crd-utils')\nconst { directoryTree } = require('./conf/node-directory-tree')\n\nmodule.exports = function generate(program) {\n if (!fs.existsSync(docsConfig)) {\n console.log('❎ please check config.yml in root dir!\\n')\n return\n }\n\n const dir = program.markdownPaths\n const dirs = Array.isArray(dir) ? dir : [dir]\n const otherProps = {\n mdconf: true,\n extensions: /\\.md/,\n generate: true\n }\n dirs.map(path => directoryTree({\n path,\n options: otherProps,\n }))\n console.log('✅ generate success!')\n}\n" }, { "path": "packages/crd-scripts/src/server.js", "content": "const webpack = require('webpack')\nconst WebpackDevServer = require('webpack-dev-server')\nconst openBrowsers = require('open-browsers')\nconst detect = require('detect-port')\nconst fs = require('fs')\nconst { docsConfig } = require('crd-utils')\nconst prepareUrls = require('local-ip-url/prepareUrls')\nconst conf = require('./conf/webpack.config.dev')\nconst createDevServerConfig = require('./conf/webpack.config.server')\nrequire('colors-cli/toxic')\n\nfunction clearConsole() {\n // process.stdout.write(process.platform === 'win32' ? '\\x1B[2J\\x1B[0f' : '\\x1B[2J\\x1B[3J\\x1B[H');\n}\n\nmodule.exports = function server(cmd) {\n if (!fs.existsSync(docsConfig)) {\n console.log('please check config.yml in root dir!\\n')\n return\n }\n const HOST = cmd.host\n let DEFAULT_PORT = cmd.port\n const webpackConf = conf(cmd)\n const compiler = webpack(webpackConf)\n\n detect(DEFAULT_PORT).then((_port) => {\n if (DEFAULT_PORT !== _port) DEFAULT_PORT = _port\n\n const protocol = process.env.HTTPS === 'true' ? 'https' : 'http'\n const urls = prepareUrls({ protocol, host: HOST, port: DEFAULT_PORT })\n // https://webpack.js.org/api/compiler-hooks/#aftercompile\n // print log after being compiled\n compiler.hooks.done.tap('done', () => {\n /* eslint-disable */\n console.log(`Dev Server Listening at Local: ${urls.localUrl.green}`);\n console.log(` On Your Network: ${urls.lanUrl.green}`);\n console.log(`\\nTo create a production build, use ${'npm run build'.blue_bt}.`);\n /* eslint-enable */\n })\n\n new WebpackDevServer(compiler, createDevServerConfig(cmd, webpackConf)).listen(DEFAULT_PORT, HOST, (err) => {\n if (err) {\n return console.log(err); // eslint-disable-line\n }\n clearConsole()\n // open browser\n openBrowsers(urls.localUrl)\n })\n }).catch((err) => {\n console.log(err); // eslint-disable-line\n })\n}\n" }, { "path": "packages/crd-scripts/src/utils/index.js", "content": "const fs = require('fs')\nconst { docsGitIgnore, searchFilePath } = require('crd-utils')\n\n/**\n * judege cur file if in git ignore.\n */\nexports.ifInGitIgnore = (mdfilePathInProject) => {\n let gitIgnoreContentArr = []\n if (fs.existsSync(docsGitIgnore)) {\n const gitIgnoreContent = fs.readFileSync(docsGitIgnore)\n gitIgnoreContentArr = gitIgnoreContent.toString().split('\\n')\n }\n return gitIgnoreContentArr.indexOf(mdfilePathInProject) > -1\n}\n\n/**\n * to get dight from cur dir.\n * If there are order && unorder file in one same folder, the unorder file'll be in front of order file.\n * eg:\n * '1.xx' => 1\n * 'xx' => 0\n */\nexports.getDigitFromDir = (dir) => {\n const matchedResult = dir.match(/^((\\d)*)\\.(\\s|\\S)*$/)\n if (matchedResult && matchedResult[1]) {\n return parseInt(matchedResult[1], 10)\n }\n return 0\n}\n\nfunction paddingTwoDigits(digit) {\n return digit < 10 ? `0${digit}` : digit\n}\n\n/**\n * format time\n */\nexports.timeFormat = (date) => {\n if (isNaN(date.getFullYear()) || isNaN(date.getMonth()) || isNaN(date.getDate())) return null\n return `${date.getFullYear()}-${paddingTwoDigits(\n date.getMonth() + 1,\n )}-${paddingTwoDigits(date.getDate())}`\n}\n\nexports.getSearchContent = () => {\n if (!fs.existsSync(searchFilePath)) {\n console.log('there is no find .cache/search.js in root dir!\\n')\n return null\n }\n return fs.readFileSync(searchFilePath)\n}\n\n" }, { "path": "packages/crd-scripts/src/utils/initCache.js", "content": "const write = require('write')\nconst path = require('path')\nconst { cacheDirPath, getDocsConfig } = require('crd-utils')\nconst { directoryTree } = require('../conf/node-directory-tree')\n\nmodule.exports = function (program, cb) {\n const treeData = program.markdownPaths.map((markdownPath) => {\n return directoryTree({\n path: markdownPath,\n options: {\n mdconf: true, // Markdown config for exsiting file.\n extensions: /\\.md/,\n },\n })\n })\n // to collect search data\n const searchData = []\n const docsConfig = getDocsConfig()\n const useSearchPlugin = docsConfig.search && docsConfig.host\n\n function dfsMap(data) {\n // eslint-disable-next-line no-plusplus\n for (let i = 0; i < data.length; i++) {\n if (data[i].children) {\n dfsMap(data[i].children)\n } else {\n const searchMapKeys = docsConfig.search_map ? Object.keys(docsConfig.search_map) : []\n // eslint-disable-next-line no-plusplus\n for (let x = 0; x < searchMapKeys.length; x++) {\n if (data[i].relative) {\n const searchMapIndex = data[i].relative.indexOf(searchMapKeys[x])\n if (searchMapIndex !== -1 && typeof searchMapIndex === 'number') {\n const effectedPath = data[i].relative.replace(\n searchMapKeys[x],\n docsConfig.search_map[searchMapKeys[x]],\n )\n searchData.push({\n title: data[i].name,\n url: `${effectedPath.replace(/.md/g, '')}`,\n content: data[i].content,\n })\n break\n }\n }\n }\n }\n }\n }\n if (useSearchPlugin) {\n // README\n searchData.push({\n title: 'README',\n url: 'README',\n content: treeData[0].content,\n })\n // map treeData to generate search data source\n dfsMap(treeData)\n const writeSearchPath = path.resolve(\n process.cwd(),\n cacheDirPath,\n 'search.js',\n )\n write.sync(\n writeSearchPath,\n `${JSON.stringify(\n searchData,\n )}`,\n )\n }\n cb()\n}\n" }, { "path": "packages/crd-scripts/src/web/Router.js", "content": "import { BrowserRouter, Route, Routes } from 'react-router-dom'\nimport theme from 'crd-theme'\nimport menuSource from './crd.json'\n\n/**\n * serialize router data\n */\nfunction routeData(data, arrayRoute = [], routePath = '/', article) {\n data.forEach((item) => {\n const routePropsCurrent = `${routePath}${item.name}`.replace(/.md$/, '')\n const { mdconf, ...otherItem } = item\n arrayRoute.push({\n path: routePropsCurrent,\n mdconf: mdconf || { title: item.name },\n props: { ...otherItem },\n article: article || item.name,\n })\n if (item.children && item.children.length > 0) {\n arrayRoute.concat(routeData(item.children, arrayRoute, `${routePropsCurrent}/`, article || item.name))\n }\n })\n return arrayRoute\n}\n\nfunction menuSourceFormat(data, routePath, article) {\n const arr = []\n data.forEach((item) => {\n const routePropsCurrent = `${routePath || ''}/${item.name}`.replace(/.md$/, '')\n if (item.type === 'directory') {\n if (item.children && item.children.length > 0) {\n item.title = item.name.replace(item.extension, '')\n item.mdconf = {}\n item.props = { isEmpty: true }\n item.children = menuSourceFormat(item.children, routePropsCurrent, article || item.name)\n } else {\n item.title = item.name.replace(item.extension, '')\n item.mdconf = { title: item.name }\n item.props = { isEmpty: true }\n item.children = []\n }\n } else {\n item.title = item.mdconf && item.mdconf.title ? item.mdconf.title : item.name.replace(item.extension, '')\n if (!item.mdconf) {\n item.props = { isEmpty: true }\n }\n }\n item.routePath = routePropsCurrent\n item.article = article || item.name\n arr.push(item)\n })\n return arr\n}\n\nconst RoutersContainer = ({ ...props }) => {\n return (\n \n \n \n )\n}\n\nexport default function RouterRoot() {\n return (\n \n \n \n )\n}\n" }, { "path": "packages/crd-scripts/src/web/crd.json", "content": "[]\n" }, { "path": "packages/crd-scripts/src/web/index.js", "content": "import { hydrate } from 'react-dom'\nimport { renderToString } from 'react-dom/server';\n// import { hydrateRoot } from 'react-dom/client'\nimport { ifDev, ifPrerender } from 'crd-client-utils'\nimport RouterRoot from './Router'\n\nif (ifDev) {\n // dev render\n document.getElementById('root').innerHTML = renderToString()\n hydrate(\n ,\n document.getElementById('root'),\n )\n // hydrateRoot(\n // document.getElementById('root'),\n // ,\n // )\n} else if (ifPrerender) {\n // prerender\n document.getElementById('root').innerHTML = renderToString()\n} else {\n // prod render:\n // It'll cause some [unkown error](https://github.com/MuYunyun/create-react-doc/issues/278) using hydrateRoot here.\n // So still using hydrate temporarily.\n hydrate(\n ,\n document.getElementById('root'),\n )\n // hydrateRoot(\n // document.getElementById('root'),\n // ,\n // )\n}\n" }, { "path": "packages/crd-seed/.npmrc", "content": "# .npmrc\n\nregistry=https://registry.npmjs.org/\n\n# https://github.com/sass/node-sass#binary-configuration-parameters\nsass_binary_site=https://npm.taobao.org/mirrors/node-sass/\n\n# https://github.com/Medium/phantomjs#deciding-where-to-get-phantomjs\n# phantomjs_cdnurl=http://cnpmjs.org/downloads\nphantomjs_cdnurl=https://npm.taobao.org/dist/phantomjs\n" }, { "path": "packages/crd-seed/README.md", "content": "## 主题\n\ncreate-react-doc 提供了官方默认主题 [crd-seed](https://github.com/MuYunyun/create-react-doc/tree/main/packages/crd-seed)。该主题支持以下特性:\n\n* 适配移动、PC 多端展示。\n* 支持暗黑模式。\n* 文档支持内嵌 codepen、codesandbox。\n* GitHub 联动。\n\n使用该主题搭建的项目有:\n\n* [blog](https://github.com/MuYunyun/blog), [站点](http://muyunyun.cn/blog)\n * ![](http://with.muyunyun.cn/90d3e357a31649b9466a828a92b6d88d.jpg)\n * ![](http://with.muyunyun.cn/2e7440e4256debda2d73a4e6392c7146.jpg-300)\n* [diana](https://github.com/MuYunyun/diana), [站点](https://muyunyun.cn/diana/)\n\n如果您想定制化或者分享个人主题, 可以参考[自定义主题](http://muyunyun.cn/create-react-doc/自定义主题)章节。" }, { "path": "packages/crd-seed/component/Affix/affix.js", "content": "import { useState, useEffect, useRef } from 'react'\nimport { throttle } from './utils'\n\nconst Affix = ({\n offsetTop,\n offsetBottom,\n children,\n target,\n onChange,\n className,\n wrapperClassName,\n style,\n width,\n affixStyle,\n}) => {\n const placeholderRef = useRef(null)\n const wrapperRef = useRef(null)\n const widthRef = useRef(width)\n const [positionStyle, setPositionStyle] = useState({})\n // 滚动元素\n let scrollElm = window\n // 是否是绝对布局模式\n const fixedRef = useRef(false)\n const [fixed, setFixed] = useState(fixedRef.current)\n\n useEffect(() => {\n widthRef.current = width\n }, [width])\n\n useEffect(() => {\n // 在子节点移开父节点后保持原来占位\n setWrapperDimension()\n }, [fixed, width])\n\n useEffect(() => {\n if (target) scrollElm = target()\n scrollElm.addEventListener('scroll', scroll)\n return () => {\n if (target) scrollElm = target()\n scrollElm.removeEventListener('scroll', scroll)\n }\n }, [offsetTop, offsetBottom])\n\n const validValue = (value) => {\n return typeof value === 'number'\n }\n const setWrapperDimension = () => {\n const { width: wrapperRefWidth, height: wrapperRefHeight } = wrapperRef.current\n ? wrapperRef.current.getBoundingClientRect()\n : {}\n placeholderRef.current &&\n (placeholderRef.current.style.height = `${wrapperRefHeight}px`)\n placeholderRef.current &&\n (placeholderRef.current.style.width =\n typeof width === 'number' ? `${width}px` : `${wrapperRefWidth}px`)\n wrapperRef.current &&\n (wrapperRef.current.style.width =\n typeof width === 'number' ? `${width}px` : `${wrapperRefWidth}px`)\n }\n const updateFixed = () => {\n fixedRef.current = !fixedRef.current\n setFixed(fixedRef.current)\n }\n const handleScroll = () => {\n const rect =\n placeholderRef.current && placeholderRef.current.getBoundingClientRect()\n if (!rect) return\n let { top, bottom } = rect\n const updatePositionStyle = {\n width:\n typeof widthRef.current === 'number'\n ? widthRef.current\n : placeholderRef.current &&\n placeholderRef.current.getBoundingClientRect().width,\n zIndex: 999,\n }\n let containerTop = 0 // 容器距离视口上侧的距离\n let containerBottom = 0 // 容器距离视口下侧的距离\n\n if (scrollElm === window) {\n bottom = window.innerHeight - bottom\n } else {\n const containerRect = scrollElm && scrollElm.getBoundingClientRect()\n containerTop = containerRect && containerRect.top\n containerBottom = containerRect && containerRect.bottom\n top -= containerTop // 距离容器顶部的距离\n bottom = containerBottom - bottom // 距离容器底部的距离\n }\n\n if (\n (validValue(offsetTop) && top <= offsetTop) ||\n (validValue(offsetBottom) && bottom <= offsetBottom)\n ) {\n if (!fixedRef.current) {\n updatePositionStyle.position = 'fixed'\n validValue(offsetTop) && (updatePositionStyle.top = offsetTop + containerTop)\n validValue(offsetBottom) &&\n (updatePositionStyle.bottom =\n scrollElm === window\n ? bottom\n : window.innerHeight - (containerBottom - offsetBottom))\n onChange && onChange(true)\n updateFixed()\n setPositionStyle(updatePositionStyle)\n }\n } else if (fixedRef.current) {\n updatePositionStyle.position = 'relative'\n onChange && onChange(false)\n updateFixed()\n setPositionStyle(updatePositionStyle)\n }\n }\n\n const scroll = throttle(handleScroll, 20)\n\n return (\n
\n \n {children}\n
\n \n )\n}\n\nexport default Affix\n" }, { "path": "packages/crd-seed/component/Affix/index.js", "content": "import Affix from './affix'\n\nexport default Affix\n" }, { "path": "packages/crd-seed/component/Affix/utils/index.js", "content": "const throttle = (fn, wait) => {\n let inThrottle\n let lastFn\n let lastTime\n return function () {\n const context = this\n // eslint-disable-next-line prefer-rest-params\n const args = arguments\n if (!inThrottle) {\n fn.apply(context, args)\n lastTime = Date.now()\n inThrottle = true\n } else {\n clearTimeout(lastFn)\n lastFn = setTimeout(() => {\n if (wait - (Date.now() - lastTime) <= 0) {\n fn.apply(context, args)\n lastTime = Date.now()\n }\n }, Math.max(wait - (Date.now() - lastTime), 0))\n }\n }\n}\n\nexport { throttle }\n" }, { "path": "packages/crd-seed/component/Footer/index.js", "content": "import cx from 'classnames'\nimport styles from './index.less'\n\nconst version = VERSION; // eslint-disable-line\nconst footer = FOOTER; // eslint-disable-line\n\nconst FooterView = ({ inlineCollapsed }) => {\n return (\n \n {footer ? (\n
\n ) : (\n <>\n
\n {`Powered by${' '}`}\n \n Create React Doc\n \n .\n
\n
\n \n |\n \n
\n \n\n )}\n
\n )\n}\n\nexport default FooterView\n" }, { "path": "packages/crd-seed/component/Footer/index.less", "content": ".footer {\n font-size: 14px;\n text-align: center;\n border-top: 1px solid #e9e9e9;\n margin: 50px 0 0 240px;\n padding: 20px 0 50px 0;\n clear: both;\n color: #999;\n transition: margin .2s ease-in-out;\n\n a {\n color: #758AC5;\n\n &:hover {\n color: #0800ff;\n }\n }\n\n .powered_by {\n margin-bottom: 8px;\n }\n\n &-inlineCollapsed {\n margin: 50px 0 0 0;\n }\n\n .uv_count, .pv_count {\n margin-left: 5px;\n }\n\n .split {\n margin: 0 5px;\n }\n}" }, { "path": "packages/crd-seed/component/Header/index.js", "content": "import { useState } from 'react'\nimport cx from 'classnames'\nimport { Link } from 'react-router-dom'\nimport Switch from 'react-switch'\nimport { ifProd } from 'crd-client-utils'\nimport { isMobile } from '../../utils'\nimport Search from '../Search'\nimport styles from './index.less'\n\nconst Header = ({\n className,\n logo,\n}) => {\n // eslint-disable-next-line no-undef\n const { user, repo, tags } = DOCSCONFIG || {}\n const [checked, setChecked] = useState(false)\n const handleChange = (value) => {\n value\n ? document.body.classList.add(styles.darkMode)\n : document.body.classList.remove(styles.darkMode)\n setChecked(value)\n }\n return (\n
\n
\n \n
\n {logo && \"logo\"}\n {!isMobile && (\n \n {(DOCSCONFIG && DOCSCONFIG.title) || 'Create React Doc'}\n \n )}\n
\n \n {DOCSCONFIG && DOCSCONFIG.search ? : null}\n
\n
\n {\n tags\n ? \n 标签\n \n : null\n }\n \n }\n checkedIcon={\n \n }\n />\n \n \n \n \n \n \n \n
\n
\n )\n}\n\nexport default Header\n" }, { "path": "packages/crd-seed/component/Header/index.less", "content": "@import '../../style/base.less';\n\n.logo {\n float: left;\n padding: 0 0 0 15px;\n\n img {\n height: 28px;\n vertical-align: middle;\n }\n\n span {\n vertical-align: middle;\n }\n\n img+span {\n margin-left: 10px;\n }\n}\n\n.header {\n box-shadow: 0 2px 8px #f0f1f2;\n line-height: 60px;\n height: 60px;\n position: relative;\n width: 100%;\n top: 0;\n z-index: @header-zIndex;\n display: flex;\n\n .wrapper {\n flex: 1;\n display: flex;\n align-items: center;\n\n .titleLink {\n display: inline-block;\n }\n\n .search {\n margin-left: 40px;\n max-width: 200px;\n display: flex;\n align-items: center;\n }\n\n .select {\n width: 200px;\n }\n }\n\n .rightArea {\n display: flex;\n align-items: center;\n\n .sun {\n position: absolute;\n left: 5px;\n top: 4px;\n }\n\n .moon {\n position: absolute;\n right: 5px;\n top: 4px;\n }\n\n .github-corner {\n display: block;\n\n &:hover {\n .octo-arm {\n animation: octocat-wave 560ms ease-in-out;\n }\n }\n }\n\n svg {\n vertical-align: bottom;\n }\n }\n}\n\n.tags {\n font-size: 15px;\n margin-right: 16px;\n}\n\n@keyframes octocat-wave {\n 0%, 100% {\n transform: rotate(0);\n }\n 20%, 60% {\n transform: rotate(-25deg);\n }\n 40%, 80% {\n transform: rotate(100deg);\n }\n}\n\n.pageTitle {\n font-size: 30px;\n line-height: 38px;\n color: #0d1a26;\n font-weight: 500;\n margin-bottom: 20px;\n margin-top: 8px;\n padding-left: 20px;\n}\n\n.darkMode {\n filter: invert(100%) hue-rotate(180deg);\n\n .no-dark-mode {\n filter: invert(100%) hue-rotate(180deg);\n }\n}" }, { "path": "packages/crd-seed/component/Icon/Icon.js", "content": "import { useEffect } from 'react'\nimport cx from 'classnames'\nimport loadSprite from './loadSprite'\nimport styles from './style/index.less'\n\n/* omit some props depends on arr */\nconst omit = (props, arr) =>\n Object.keys(props)\n .filter(k => arr.indexOf(k) === -1)\n // eslint-disable-next-line no-sequences\n .reduce((acc, key) => ((acc[key] = props[key]), acc), {})\n\nfunction Icon(props) {\n const { type, color, prefixCls = 'icon', size, style, className, ...rest } = props\n\n useEffect(() => {\n loadSprite(props)\n }, [type])\n\n const newClassName = cx(styles[prefixCls], className)\n const cloneStyle = { ...style }\n if (color) {\n cloneStyle.color = color\n }\n if (size) {\n cloneStyle.fontSize = size\n }\n\n const restProps = omit(rest, ['svgContent'])\n\n return (\n \n \n \n )\n}\n\nexport default Icon\n" }, { "path": "packages/crd-seed/component/Icon/iconsInfo.js", "content": "export const IconsInfo = {\n folder:\n '',\n file:\n '',\n edit:\n '',\n 'update-time':\n '',\n 'create-time':\n '',\n search:\n '',\n}\n" }, { "path": "packages/crd-seed/component/Icon/index.js", "content": "import Icon from './Icon'\n\nexport default Icon\n" }, { "path": "packages/crd-seed/component/Icon/loadSprite.js", "content": "import { IconsInfo } from './iconsInfo'\n\n/* tslint:disable:max-line-length */\n// inspried by https://github.com/kisenka/svg-sprite-loader/blob/master/runtime/browser-sprite.js\n// Much simplified, do make sure run this after document ready\nconst svgSprite = contents => `\n \n \n ${contents}\n \n \n`\n/**\n * '' =>\n * ' viewBox=\"0 0 1024 1024\"> {\n return svgContent.split('svg')[1]\n}\n\nconst renderSvgSprite = (props) => {\n const { svgContent, type } = props\n const customIconsInfo = svgContent\n ? {\n [`${type}`]: svgContent,\n }\n : {}\n const mergeSvgInfo = { ...IconsInfo, ...customIconsInfo }\n const symbols = Object.keys(mergeSvgInfo)\n .map((iconName) => {\n const getContent = handleSvgContent(mergeSvgInfo[iconName])\n return ``\n })\n .join('')\n return svgSprite(symbols)\n}\n\nconst loadSprite = (props) => {\n const { type, svgContent } = props\n if (!document) {\n return\n }\n const existing = document.getElementById('__CRD_SVG_SPRITE_NODE__')\n const mountNode = document.body\n\n if (!existing) {\n mountNode &&\n typeof mountNode.insertAdjacentHTML === 'function' &&\n mountNode.insertAdjacentHTML('afterbegin', renderSvgSprite(props))\n } else if (svgContent) {\n const defs = existing.children[0]\n const svgChildren = defs.children\n const svgChildrenIds = svgChildren ? [].slice.call(svgChildren).map(r => (r).id) : []\n if (svgChildrenIds.indexOf(type) !== -1) return\n defs.innerHTML += ``\n }\n}\n\nexport default loadSprite\n" }, { "path": "packages/crd-seed/component/Icon/style/index.less", "content": ".icon {\n font-size: 24px;\n vertical-align: middle;\n fill: currentColor;\n background-size: cover;\n width: 1em;\n height: 1em;\n}\n" }, { "path": "packages/crd-seed/component/Menu/Menu.js", "content": "import { useState } from 'react'\nimport cx from 'classnames'\nimport MenuItem from './MenuItem'\nimport { SubMenu } from './SubMenu'\nimport { MenuProvider } from './context'\nimport styles from './style/index.less'\n\nconst Menu = ({\n theme = 'light',\n children,\n selectedKey,\n onSelect = () => {},\n inlineCollapsed = false,\n defaultOpenKeys = [],\n menuStyle,\n toggle,\n}) => {\n /* 存储 hover 状态的 key 值, 在垂直模式中需要根据 hover 的 key 值高亮父节点 */\n const [hoverKey, setHoverKey] = useState('')\n const MenuContext = {\n theme,\n mode: 'inline',\n inlineCollapsed,\n defaultOpenKeys,\n selectedKey,\n onSelect,\n hoverKey,\n onHoverKey: setHoverKey,\n }\n const renderToggle = () => {\n return (\n \n \n \n )\n }\n const renderMenu = () => {\n return (\n \n {children}\n \n )\n }\n\n return (\n \n {renderToggle()}\n {renderMenu()}\n \n )\n}\n\nMenu.Item = MenuItem\nMenu.SubMenu = SubMenu\n\nexport default Menu\n" }, { "path": "packages/crd-seed/component/Menu/MenuItem.js", "content": "import { useEffect, useRef } from 'react'\nimport cx from 'classnames'\nimport { getMenuStyle } from './util'\nimport { useMenuContext } from './context'\nimport styles from './style/index.less'\n\nfunction MenuItem({\n title = '',\n icon,\n keyValue = '',\n level = 0,\n}) {\n const {\n theme,\n selectedKey,\n onSelect,\n onHoverKey,\n inlineCollapsed\n } = useMenuContext()\n const menuItemRef = useRef(null)\n const menuItemselected = keyValue.indexOf(selectedKey) > -1\n const menuUnFoldDelayTime = 300\n\n useEffect(() => {\n if (menuItemselected && (inlineCollapsed === false)) {\n setTimeout(() => {\n menuItemRef.current.scrollIntoView({\n block: 'center',\n behavior: 'smooth'\n })\n }, menuUnFoldDelayTime)\n }\n }, [keyValue, selectedKey, inlineCollapsed])\n\n const handleOnClick = () => {\n onSelect(keyValue)\n }\n\n const renderMenuItem = () => {\n return (\n {\n onHoverKey(keyValue)\n }}\n onMouseLeave={() => onHoverKey('')}\n onClick={handleOnClick}\n style={getMenuStyle(level, 'menuItem')}\n ref={menuItemRef}\n >\n {icon ? {icon} : null}\n {title}\n \n )\n }\n\n return renderMenuItem()\n}\n\nexport default MenuItem\n" }, { "path": "packages/crd-seed/component/Menu/SubMenu.js", "content": "import { useState, useRef, Fragment, Children, cloneElement } from 'react'\nimport cx from 'classnames'\nimport { useEnhancedEffect } from 'crd-client-utils'\nimport Transition from './transition'\nimport { getMenuStyle } from './util'\nimport { useMenuContext } from './context'\nimport styles from './style/index.less'\n\nfunction useCurrent(\n initialValue\n) {\n const currentRef = useRef(initialValue)\n const [state, setState] = useState(initialValue)\n currentRef.current = state\n const set = (value) => {\n currentRef.current = value\n setState(value)\n }\n const get = () => currentRef.current\n return [get, set]\n}\n\nfunction SubMenu({\n children,\n title,\n icon,\n level = 0,\n keyValue = '',\n onTitleClick = () => {},\n}) {\n const {\n selectedKey,\n mode,\n hoverKey,\n onHoverKey,\n defaultOpenKeys = [],\n } = useMenuContext()\n const [menuOpen, setMenuOpen] = useState(defaultOpenKeys.indexOf(keyValue) !== -1)\n const curSubmenu = useRef(null)\n const popupSubMenu = useRef(null)\n\n const [getParentMenuHover, setParentMenuHover] = useCurrent(false)\n\n const gapDistance = 4\n\n useEnhancedEffect(() => {\n if (popupSubMenu.current && curSubmenu.current) {\n popupSubMenu.current.style.left = `${curSubmenu.current.getBoundingClientRect().right +\n gapDistance}px`\n popupSubMenu.current.style.top = `${curSubmenu.current.getBoundingClientRect().top}px`\n }\n }, [getParentMenuHover()])\n\n /**\n * judege if is React Fragment.\n */\n function isReactFragment(variableToInspect) {\n if (variableToInspect.type) {\n return variableToInspect.type === Fragment\n }\n return variableToInspect === Fragment\n }\n\n /* 行内模式下, 渲染子节点 */\n const renderChild = (child) => {\n return (\n // eslint-disable-next-line quotes\n <>\n {Children.map(child || children, (reactNode) => {\n if (!reactNode || typeof reactNode !== 'object') {\n return null\n }\n const childElement = reactNode\n if (\n isReactFragment(childElement) &&\n childElement.props.children\n ) {\n return renderChild(childElement.props.children)\n }\n return cloneElement(childElement, {\n level: level + 1,\n ...childElement.props,\n })\n // eslint-disable-next-line quotes\n })}\n \n )\n }\n\n const handleParentMouseEnter = () => {\n setParentMenuHover(true)\n onHoverKey(keyValue)\n }\n\n const handleParentMouseLeave = () => {\n onHoverKey('')\n }\n\n /* 处理 menu 开闭状态 */\n const handleMenuStatus = () => {\n onTitleClick(keyValue)\n mode === 'inline' && setMenuOpen(!menuOpen)\n }\n\n /* 判断 subMenu 是否被选中, 当子节点被选中时, 父节点也会被高亮;\n 同时在 vertical 模式时, 当子节点被 hover 时, 父节点也会被高亮; */\n const judgeSubmenuSelect = (reactChildren) => {\n const result = Children.toArray(reactChildren).some((reactNode) => {\n if (!reactNode || typeof reactNode !== 'object') {\n return false\n }\n\n const childElement = reactNode\n // eslint-disable-next-line no-shadow\n const { keyValue } = childElement.props\n const originKey = keyValue ? String(keyValue) : ''\n if (childElement.type.name === 'MenuItem') {\n return selectedKey.split('').indexOf(originKey) !== -1 || hoverKey === originKey\n }\n if (childElement.type.name === 'SubMenu') {\n return judgeSubmenuSelect(childElement.props.children) || hoverKey === originKey\n }\n return false\n })\n return result\n }\n\n return (\n onHoverKey(keyValue)}\n ref={curSubmenu}\n >\n \n \n {icon ? {icon} : null}\n {title}\n \n {mode === 'inline' ? (\n \n
    {renderChild()}
\n \n ) : null}\n \n )\n}\n\nexport { SubMenu }\n" }, { "path": "packages/crd-seed/component/Menu/context.js", "content": "import { createContext, useContext } from 'react'\n\nconst MenuContext = createContext(undefined)\n\nexport const MenuProvider = ({ children, value }) => (\n {children}\n)\n\nexport const useMenuContext = () => useContext(MenuContext)\n" }, { "path": "packages/crd-seed/component/Menu/index.js", "content": "import Menu from './Menu'\n\nexport default Menu\n" }, { "path": "packages/crd-seed/component/Menu/style/index.less", "content": "@import './theme.less';\n\n.menu {\n box-sizing: border-box;\n list-style: none;\n margin: 0;\n padding: 0;\n color: @menu-color;\n background: @menu-background;\n user-select: none;\n transition: background .2s ease-in-out, width .2s ease-in-out;\n overflow: auto;\n user-select: none;\n font-weight: 600;\n\n &-item {\n // margin: 0 16px 0 15px;\n white-space: nowrap;\n cursor: pointer;\n height: 40px;\n line-height: 40px;\n padding: 0 16px;\n color: @menu-color;\n position: relative;\n cursor: pointer;\n // overflow: hidden;\n // white-space: nowrap;\n // text-overflow: ellipsis;\n\n &-selected {\n position: relative;\n background: @menu-background-selected;\n color: @menu-color-selected;\n\n a {\n color: @menu-color-selected!important;\n }\n }\n\n /* icon */\n i {\n margin-right: 10px;\n }\n\n a {\n color: rgba(0, 0, 0, 0.8);\n cursor: pointer;\n display: inline-block;\n text-decoration: none;\n\n &::before {\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n content: '';\n position: absolute;\n background-color: transparent;\n }\n }\n\n &-title {\n vertical-align: middle;\n }\n }\n\n &-item:hover {\n color: @menu-color-hover;\n\n & .menu-icon {\n color: @menu-color-hover;\n }\n }\n\n .submenu {\n line-height: 40px;\n cursor: pointer;\n overflow: hidden;\n\n &-title {\n position: relative;\n padding: 0 28px 0 0;\n font-size: 14px;\n cursor: pointer;\n margin-left: 20px;\n // overflow: hidden;\n // white-space: nowrap;\n // text-overflow: ellipsis;\n }\n\n &-title:hover {\n color: @menu-color-hover;\n\n .submenu-arrow {\n\n &::before,\n &::after {\n background: @menu-color-hover;\n }\n }\n }\n\n &-arrow {\n display: inline-block;\n width: 10px;\n flex-shrink: 0;\n // margin: 0 3px 0 1px;\n margin: 0 3px 0 -12px;\n position: relative;\n top: -5px;\n\n &::before,\n &::after {\n content: '';\n position: absolute;\n width: 6px;\n height: 1.5px;\n background: @arrow-background;\n transition: background .2s cubic-bezier(0.645, 0.045, 0.355, 1),\n transform .2s cubic-bezier(0.645, 0.045, 0.355, 1),\n top .2s cubic-bezier(0.645, 0.045, 0.355, 1),\n -webkit-transform .2s cubic-bezier(0.645, 0.045, 0.355, 1);\n }\n\n &::before {\n transform: rotate(45deg) translateY(-2px);\n }\n\n &::after {\n transform: rotate(-45deg) translateY(2px);\n }\n\n &-open {\n &::before {\n transform: rotate(-45deg) translateX(2px);\n }\n\n &::after {\n transform: rotate(45deg) translateX(-2px);\n }\n }\n }\n\n &-selected {\n color: @menu-color-selected;\n }\n }\n\n &-inline {\n width: 100%;\n\n .menu-item {\n &-selected {\n &::after {\n content: '';\n position: absolute;\n width: 3px;\n background: @menu-inline-selected;\n top: 0;\n bottom: 0;\n right: 0;\n }\n }\n }\n\n .submenu {\n &-arrow {\n &::before {\n transform: rotate(45deg) translateY(-2px);\n }\n\n &::after {\n transform: rotate(-45deg) translateY(2px);\n }\n\n &-open {\n &::before {\n transform: rotate(-45deg) translateX(2px);\n }\n\n &::after {\n transform: rotate(45deg) translateX(-2px);\n }\n }\n }\n }\n\n /* fold */\n &-collapsed {\n width: 0px;\n\n .menu-item {\n padding: 0 24px !important;\n\n &-title {\n opacity: 0;\n }\n }\n\n .submenu {\n &-title {\n padding: 0 24px !important;\n\n &-field {\n opacity: 0;\n }\n\n .submenu-arrow {\n display: none;\n }\n }\n }\n }\n }\n\n &-icon {\n margin-right: 4px;\n }\n}\n\n/* submenu fold/unfold animation */\n.collapse-transition {\n overflow: hidden;\n transition: height .2s ease-in-out;\n}\n\n.toggle {\n position: absolute;\n width: 30px;\n height: 30px;\n left: 240px;\n top: 200px;\n transition: left .2s linear;\n box-shadow: 2px 0 8px rgba(0, 0, 0, .15);\n border-radius: 0 4px 4px 0;\n cursor: pointer;\n display: flex;\n align-items: center;\n justify-content: center;\n background: #fff;\n\n &-icon {\n position: relative;\n background: 0 0;\n width: 12px;\n height: 2px;\n background: #333;\n transition: background .2s cubic-bezier(.78, .14, .15, .86);\n\n &::before,\n &::after {\n content: '';\n display: block;\n position: absolute;\n background: #333;\n width: 50%;\n height: 2px;\n }\n\n &::before {\n transform: translateY(-2px) rotate(-45deg);\n }\n\n &::after {\n transform: translateY(2px) rotate(45deg);\n }\n\n &-close {\n background: #333;\n\n &::before,\n &::after {\n content: '';\n display: block;\n position: absolute;\n background: #333;\n width: 100%;\n height: 2px;\n transform: rotate(0deg);\n }\n\n &::before {\n top: -4px;\n }\n\n &::after {\n top: 4px;\n }\n }\n }\n\n &-collapsed {\n left: 0px;\n }\n}" }, { "path": "packages/crd-seed/component/Menu/style/theme.less", "content": "/* light */\n@menu-color: rgba(0, 0, 0, 0.65);\n@menu-background: #fff;\n@menu-color-hover: #1890ff;\n@menu-color-selected: #1890ff;\n@menu-inline-selected: #1199ee;\n@menu-background-selected: #e6f7ff;\n@arrow-background: #333;" }, { "path": "packages/crd-seed/component/Menu/transition.js", "content": "import { useEffect, useRef, useCallback } from 'react'\nimport styles from './style/index.less'\n\nconst ANIMATION_DURATION = 200\n\nexport default function Transition({\n isShow,\n children,\n}) {\n const mounted = useRef(false)\n const collapseRef = useRef(null)\n const timer = useRef({})\n\n // prepare\n const beforeEnter = () => {\n const el = collapseRef.current\n el.style.height = '0px'\n }\n\n const afterEnter = useCallback(() => {\n const el = collapseRef.current\n el.style.display = 'block'\n el.style.height = ''\n }, [])\n\n // start\n const enter = useCallback(() => {\n const el = collapseRef.current\n el.style.display = 'block'\n if (el.scrollHeight !== 0) {\n el.style.height = `${el.scrollHeight}px`\n }\n\n timer.current.enterTimer = setTimeout(() => afterEnter(), ANIMATION_DURATION)\n }, [afterEnter])\n\n const beforeLeave = useCallback(() => {\n const el = collapseRef.current\n\n el.style.display = 'block'\n if (el.scrollHeight !== 0) {\n el.style.height = `${el.scrollHeight}px`\n }\n }, [])\n\n const afterLeave = useCallback(() => {\n const el = collapseRef.current\n\n el.style.display = 'none'\n el.style.height = ''\n }, [])\n\n const leave = useCallback(() => {\n const el = collapseRef.current\n if (el.scrollHeight !== 0) {\n el.style.height = '0px'\n }\n timer.current.leaveTimer = setTimeout(() => afterLeave(), ANIMATION_DURATION)\n }, [afterLeave])\n\n const triggerChange = useCallback(\n (isShow) => {\n clearTimeout(timer.current.enterTimer)\n clearTimeout(timer.current.leaveTimer)\n if (isShow) {\n beforeEnter()\n enter()\n } else {\n beforeLeave()\n leave()\n }\n },\n [beforeLeave, enter, leave]\n )\n\n useEffect(() => {\n if (!mounted.current) {\n mounted.current = true\n beforeEnter()\n if (isShow) {\n enter()\n }\n } else {\n triggerChange(isShow)\n }\n }, [enter, isShow, triggerChange])\n\n return (\n
\n {children}\n
\n )\n}\n" }, { "path": "packages/crd-seed/component/Menu/util.js", "content": "/* 获取 menu 样式\n level: 层级\n*/\nconst getMenuStyle = (level, type) => {\n const basicStyle = {\n fontSize: level === 0 ? '14px' : '12px',\n }\n if (type === 'menuItem') {\n return {\n ...basicStyle,\n paddingLeft: `${21 + (level * 16)}px`,\n }\n }\n return {\n ...basicStyle,\n paddingLeft: `${level * 16}px`,\n }\n}\n\nexport { getMenuStyle }\n" }, { "path": "packages/crd-seed/component/NoMatch/index.js", "content": "import styles from './index.less'\n\nconst NoMatch = () => {\n // eslint-disable-next-line no-undef\n const { user, repo } = DOCSCONFIG || {}\n return (\n \n \n \n \n \n \n
\n

404

\n
你似乎来到了没有知识存在的荒原...
\n
在 github 访问该项目
\n
\n )\n}\n\nexport default NoMatch\n" }, { "path": "packages/crd-seed/component/NoMatch/index.less", "content": ".noMatch {\n position: relative;\n width: 100%;\n height: 80%;\n text-align: center;\n border-spacing: 0;\n border-collapse: collapse;\n color: #a2a2a2;\n\n h1 {\n color: #717171;\n font-size: 68px;\n line-height: 54px;\n font-weight: 500;\n }\n}" }, { "path": "packages/crd-seed/component/Search/README.md", "content": "### API\n\n| props | description | type | default |\n| :---------: | :---------: | :----: | :------: |\n| placeholder | placeholder | string | 'Search' |\n| className | css | string | -- |\n" }, { "path": "packages/crd-seed/component/Search/index.js", "content": "import { useState, useEffect } from 'react'\nimport cx from 'classnames'\nimport Icon from '../Icon'\nimport styles from './index.less'\n\nconst Search = ({\n placeholder = 'Search',\n className,\n}) => {\n const [value, setValue] = useState('')\n // const [searchContent, setSearchContent] = useState([]);\n // const showSearchContent = value.length > 0 && searchContent.length > 0;\n useEffect(() => {\n /* eslint-disable-next-line no-undef */\n // if (SEARCHCONTENT) {\n // /* eslint-disable-next-line no-undef */\n // const filterSearch = SEARCHCONTENT.filter((r) => {\n // return r.title.includes(value) || r.content.includes(value);\n // });\n // setSearchContent(filterSearch);\n // }\n }, [value])\n return (\n
\n \n {\n setValue(e.target.value)\n }}\n />\n {/* {showSearchContent ? (\n
    \n {searchContent.map((search) => {\n return (\n {\n location.hash = search.url;\n }}\n key={search.url}\n >\n {search.title}\n {search.content}\n \n );\n })}\n
\n ) : null} */}\n
\n )\n}\n\nexport default Search\n" }, { "path": "packages/crd-seed/component/Search/index.less", "content": ".search {\n position: relative;\n\n input {\n line-height: 1.5;\n font-size: 14px;\n color: #999;\n outline: 0;\n border-radius: 4px;\n border: 0;\n width: 200px;\n }\n\n .panel {\n position: absolute;\n width: 350px;\n top: 50px;\n left: 0;\n background: rgba(255, 255, 255);\n max-height: 400px;\n box-shadow: rgba(101, 119, 134, 0.2) 0px 0px 15px, rgba(101, 119, 134, 0.15) 0px 0px 3px 1px;\n overflow-y: auto;\n\n li {\n padding: 0 5px;\n list-style: none;\n border: 1px solid rgb(230, 236, 240);\n }\n }\n\n .searchItem {\n display: flex;\n }\n\n .title {\n display: inline-block;\n width: 90px;\n overflow: hidden;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n\n .content {\n display: inline-block;\n width: 245px;\n overflow: hidden;\n white-space: nowrap;\n text-overflow: ellipsis;\n }\n}" }, { "path": "packages/crd-seed/component/Tags/index.js", "content": "import { Link, useMatch } from 'react-router-dom'\nimport { ifProd } from 'crd-client-utils'\nimport { ifAddPrefix } from '../../utils'\nimport styles from './index.less'\n\n/**\n * name: the name of tag category.\n */\nconst Tags = () => {\n const { user, repo } = DOCSCONFIG || {}\n const path = ifAddPrefix ? `/${repo}/tags/:name` : '/tags/:name'\n const routeMatch = useMatch(path) || {}\n const { name } = routeMatch.params || {}\n\n return (\n
\n
{name || 'Tags'}
\n
\n {\n name\n ? mapTagsWithArticle.find(({ tagName }) => tagName === name)?.mapArticle.map(({ path, title }) => {\n return \n {title}\n \n })\n : mapTagsWithArticle.map(({ tagName }) => {\n return \n {tagName}\n \n })\n }\n
\n
\n )\n}\n\nexport default Tags\n" }, { "path": "packages/crd-seed/component/Tags/index.less", "content": ".tags {\n width: 100%;\n padding: 0 20px;\n height: 100%;\n display: flex;\n align-items: center;\n justify-content: center;\n flex-direction: column;\n\n &-title {\n font-size: 24px;\n font-weight: 400;\n text-align: center;\n }\n\n &-content {\n width: 100%;\n margin-top: 20px;\n }\n\n &-text {\n color: #6f6f6f;\n padding: 10px;\n display: inline-flex;\n }\n}" }, { "path": "packages/crd-seed/index.js", "content": "import { Routes, Route, Navigate } from 'react-router-dom'\nimport BasicLayout from './layout'\nimport NoMatch from './component/NoMatch'\nimport './index.less'\n\n// run in the Web/Router.js\nconst ThemeSeed = (props) => {\n return (\n \n } />\n } />\n \n )\n}\n\nexport default ThemeSeed\n" }, { "path": "packages/crd-seed/index.less", "content": "body {\n font-family: cursive, sans-serif;\n}\n\nbody,\nhtml {\n position: relative;\n}\n\nbody,\nhtml,\nul,\nli {\n margin: 0;\n padding: 0;\n}\n\na {\n color: #314659;\n text-decoration: none;\n transition: color .3s;\n\n &:hover {\n color: #1890ff;\n }\n}\n\n*,\n*::before,\n*::after {\n box-sizing: border-box;\n}\n\n:global {\n #root {\n height: 100%;\n background: white;\n }\n}" }, { "path": "packages/crd-seed/language/index.js", "content": "const languageMap = {\n en: {\n create_tm: 'create',\n modify_tm: 'modify',\n },\n 'zh-cn': {\n create_tm: '创建',\n modify_tm: '修改',\n },\n}\n\nexport default languageMap\n" }, { "path": "packages/crd-seed/layout/index.js", "content": "import * as React from 'react'\nimport { Routes, Link, Route, Navigate, useLocation } from 'react-router-dom'\nimport cx from 'classnames'\nimport { ifDev, ifProd, ifPrerender } from 'crd-client-utils'\nconst Giscus = require('@giscus/react')\nimport Menu from '../component/Menu'\nimport Icon from '../component/Icon'\nimport Affix from '../component/Affix'\nimport Header from '../component/Header'\nimport Footer from '../component/Footer'\nimport Tags from '../component/Tags'\nimport languageMap from '../language'\nimport { isMobile, ifAddPrefix } from '../utils'\nimport { getOpenSubMenuKeys } from './utils'\nimport logo from '../crd.logo.svg'\nimport styles from './index.less'\nimport '../style/mobile.less'\n\nconst { useState, useEffect, useMemo } = React\nconst SubMenu = Menu.SubMenu\n\nfunction BasicLayout({\n routeData,\n menuSource\n}) {\n const location = useLocation()\n const { pathname } = location\n const {\n user,\n repo,\n branch = 'main',\n language = 'en',\n menuOpenKeys,\n tags,\n comment\n } = DOCSCONFIG || {}\n\n const [inlineCollapsed, setInlineCollapsed] = useState(true)\n const [selectedKey, setSelectedKey] = useState('')\n const curOpenKeys = getOpenSubMenuKeys({\n pathname,\n menuSource,\n menuOpenKeys\n })\n const defaultPath = (routeData.find(data => data.path === '/README')\n && routeData.find(data => data.path === '/README').mdconf\n && routeData.find(data => data.path === '/README').mdconf.abbrlink) || 'README'\n\n useEffect(() => {\n if (ifPrerender) {\n scrollToTop()\n INJECT?.inject?.()\n }\n }, [])\n\n useEffect(() => {\n INJECT?.injectWithPathname?.(pathname)\n }, [pathname])\n\n useEffect(() => {\n const { pathname } = location\n let newPathName = pathname\n // fix https://github.com/MuYunyun/create-react-doc/issues/195\n if (newPathName.endsWith('/')) {\n newPathName = newPathName.slice(0, newPathName.length - 1)\n }\n if (newPathName.startsWith(`/${repo}`)) {\n newPathName = newPathName.slice(`/${repo}`.length, newPathName.length)\n }\n setSelectedKey(newPathName || defaultPath)\n }, location.pathname)\n\n const scrollToTop = () => {\n document.body.scrollTop = 0\n document.documentElement.scrollTop = 0\n window.scrollTo(0, 0)\n }\n const renderSubMenuItem = (menus) => {\n return (\n <>\n {menus.map((item, index) => {\n const { mdconf, routePath } = item || {}\n const { abbrlink } = mdconf || {}\n const path = abbrlink ? `/${abbrlink}` : routePath\n // item.path carrys .md here.\n return item.children && item.children.length > 0 ? (\n }\n >\n {renderSubMenuItem(item.children)}\n \n ) : (\n }\n keyValue={abbrlink ? `/${abbrlink}` : item.path}\n title={\n item &&\n item.type === \"directory\" &&\n item.props &&\n item.props.isEmpty ? (\n \n {(item.mdconf && item.mdconf.title) || item.name}\n \n ) : (\n -1}\n >\n {item && item.mdconf && item.mdconf.title\n ? item.mdconf.title\n : item.title}\n \n )\n }\n />\n )\n })}\n \n )\n }\n const renderMenu = (menus) => {\n if (menus.length < 1) return null\n\n return (\n \n {\n setInlineCollapsed(!inlineCollapsed)\n }}\n menuStyle={{\n height: \"100vh\",\n overflow: \"auto\",\n }}\n selectedKey={selectedKey}\n onSelect={(keyValue) => {\n setSelectedKey(keyValue)\n }}\n defaultOpenKeys={curOpenKeys}\n >\n {renderSubMenuItem(menus || [])}\n \n \n )\n }\n /**\n * This section is to show article's relevant information\n * such as edit in github and so on.\n */\n const renderPageHeader = () => {\n const curMenuSource = routeData.filter(r => {\n if (r.props.type === 'directory') return false\n return pathname.indexOf(r.mdconf.abbrlink) > -1 || decodeURIComponent(pathname).indexOf(r.path) > -1\n })\n const editPathName = curMenuSource[0] && curMenuSource[0].props.path\n const isNotTagPage = location.pathname.indexOf('/tags') === -1\n return (\n
\n {user && repo && isNotTagPage ? (\n \n \n Edit in GitHub\n \n ) : null}\n
\n )\n }\n\n /**\n * This section is to render comment area.\n * Every pathname should has its own comment module.\n */\n const renderComment = useMemo(() => {\n return \n }, [pathname])\n\n /**\n * This section is to show article's relevant information\n * such as edit in created time、edited time and so on.\n */\n const renderPageFooter = () => {\n // in local env, data.path is to be /READEME, however pathname may be /Users/mac/.../.crd-dist/READEME/index.html\n const matchData = routeData.find((data) => pathname.indexOf(data.path) > -1)\n const matchProps = matchData && matchData.props\n return (\n
\n {matchProps && matchProps.birthtime ? (\n \n \n {languageMap[language].create_tm}:\n {matchProps.birthtime}\n \n ) : null}\n {matchProps && matchProps.mtime ? (\n \n \n {languageMap[language].modify_tm}:\n \n {routeData.find((data) => pathname.indexOf(data.path) > -1).props.mtime}\n \n \n ): null}\n
\n )\n }\n const isCurentChildren = () => {\n const getRoute = routeData.filter((data) => pathname.indexOf(data.path) > -1)\n const article = getRoute.length > 0 ? getRoute[0].article : null\n const childs = menuSource.filter(\n (data) =>\n article === data.article && data.children && data.children.length > 1\n )\n return childs.length > 0\n }\n const isChild = isCurentChildren()\n const renderMenuContainer = () => {\n return (\n <>\n \n {renderMenu(menuSource)}\n \n {\n e.stopPropagation()\n setInlineCollapsed(true)\n }}\n />\n \n )\n }\n\n const renderContent = () => {\n return (\n \n \n {/* see https://reacttraining.com/react-router/web/api/Redirect/exact-bool */}\n }\n />\n {routeData.map((item) => {\n const { path, mdconf, component } = item\n const { abbrlink } = mdconf\n const enhancePath = abbrlink ? `/${abbrlink}` : path\n const Comp = component\n return (\n }\n />\n )\n })}\n {\n tags\n ? <>\n }\n />\n }\n />\n \n : null\n }\n {/* Todo: follow up how to use Redirect to back up the rest of route. */}\n {/* */}\n \n {comment?.GiscusConfig ? renderComment : null}\n {renderPageFooter()}\n \n )\n }\n\n return (\n
\n
\n \n {renderPageHeader()}\n {renderMenuContainer()}\n {renderContent()}\n
\n
\n \n )\n}\n\nexport default BasicLayout\n" }, { "path": "packages/crd-seed/layout/index.less", "content": "@import '../style/base.less';\n\n.wrapper {\n &::after {\n content: '';\n display: block;\n clear: both;\n }\n}\n\n.wrapperContent {\n padding: 40px 0 0 0;\n margin: 0px auto 0;\n position: relative;\n min-height: 100vh;\n\n .pageHeader,\n .pageFooter {\n position: absolute;\n right: 40px;\n font-size: 13px;\n display: flex;\n align-items: center;\n }\n\n .pageHeader {\n top: 20px;\n }\n\n .pageFooter {\n bottom: -23px;\n\n .position {\n margin-right: 6px;\n display: flex;\n align-items: center;\n }\n }\n\n .icon {\n margin-right: 3px;\n }\n}\n\n.wrapperMobile {\n // padding-top: 0;\n}\n\n.menuWrapper {\n width: 240px;\n float: left;\n position: absolute;\n font-size: 14px;\n color: #6d6d6d;\n transition: width .2s linear;\n z-index: @menu-zIndex;\n\n ul li {\n list-style: none;\n }\n\n ul ul {\n padding: 0 0 0 0;\n }\n\n li {\n // padding: 0 0 0 21px;\n line-height: 40px;\n }\n\n li li {\n padding: 0 0 0 0;\n }\n\n // :global {\n // .active a {\n // color: #1890ff;\n // }\n // }\n\n &-inlineCollapsed {\n width: 0;\n }\n\n .affixPlaceholder {\n transition: width .2s linear;\n }\n\n .affixWrapper {\n border-right: 1px solid rgb(233, 233, 233);\n transition: width .2s linear;\n width: 0px;\n }\n}\n\n.menuMask {\n position: absolute;\n top: 0;\n bottom: 0;\n left: 0;\n right: 0;\n background: rgba(0, 0, 0, .3);\n z-index: @menu-mask-zIndex;\n transition: opacity .3s cubic-bezier(.78, .14, .15, .86)\n}\n\n.content {\n margin-left: 240px;\n min-height: 300px;\n transition: margin-left .2s ease-in-out;\n position: relative;\n\n &-fullpage {\n margin-left: 0px;\n }\n}\n\n.contentNoMenu {\n min-height: 400px;\n}\n\ngiscus-widget {\n display: flex;\n margin: auto;\n max-width: 940px;\n}\n" }, { "path": "packages/crd-seed/layout/utils.js", "content": "/**\n * get keys of open sub menu from pathname\n * {\n * pathname: pathname of location,\n * when pathname is /9f41fc98, the result is ['/docs/主题'].\n * when pathname is /测试/测试路由, the result is ['/docs/测试']\n * menuOpenKeys: means extra show open keys in config.yml\n * }\n */\nfunction getOpenSubMenuKeys({\n pathname,\n menuSource,\n menuOpenKeys\n}) {\n const result = []\n getOpenSubMenuKeysForAbbrLink(\n menuSource,\n decodeURI(pathname),\n result\n )\n\n /** default open menu from config.yml */\n if (menuOpenKeys) {\n result.push(...menuOpenKeys.split(','))\n }\n\n return result\n}\n\nfunction getOpenSubMenuKeysForAbbrLink(source, pathname, result) {\n for (let i = 0; i < source.length; i++) {\n const { type, path, mdconf } = source[i]\n if (type === 'directory') {\n result.push(path)\n const ifFind = getOpenSubMenuKeysForAbbrLink(source[i].children, pathname, result)\n if (ifFind) return true\n result.pop()\n } else {\n if (\n pathname.indexOf(mdconf.abbrlink) > -1 // used with abbrlink\n || (pathname.indexOf(source[i].routePath) > -1) // used not with abbrlink\n ) {\n return true\n }\n }\n }\n}\n\nexport { getOpenSubMenuKeys }\n" }, { "path": "packages/crd-seed/package.json", "content": "{\n \"name\": \"crd-seed\",\n \"version\": \"1.10.3\",\n \"description\": \"Default Theme with Create React Doc\",\n \"main\": \"index.js\",\n \"dependencies\": {\n \"@giscus/react\": \"2.2.2\",\n \"crd-client-utils\": \"^1.8.2\",\n \"react-router-dom\": \"^6.3.0\",\n \"react-switch\": \"^5.0.1\"\n },\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/MuYunyun/create-react-doc\",\n \"directory\": \"packages/theme-seed\"\n },\n \"keywords\": [],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"author\": \"muyunyun\",\n \"license\": \"MIT\",\n \"gitHead\": \"ffc5e4cbc94a7356da558c2dbf46e2f39bb8b199\"\n}\n" }, { "path": "packages/crd-seed/style/base.less", "content": "// z-index\n@menu-zIndex: 99;\n@menu-mask-zIndex: 90;\n@header-zIndex: 100;" }, { "path": "packages/crd-seed/style/mobile.less", "content": "// remove the blue area in the mobile\n:global {\n div,\n input,\n textarea,\n button,\n select,\n a,\n li {\n -webkit-tap-highlight-color: rgba(0, 0, 0, 0);\n }\n}" }, { "path": "packages/crd-seed/utils/index.js", "content": "import isClient from 'diana/lib/isClient'\nimport { ifProd, ifPrerender } from 'crd-client-utils'\n\n/** judge if is in mobile */\nconst isMobile = isClient() ? 'ontouchend' in window : false\n\n// decide to if add prefix for path, eg: '/' or '/${repo}'\nconst ifAddPrefix = ifProd && !ifPrerender\n\nexport { isMobile, ifAddPrefix }\n" }, { "path": "packages/crd-templates/.npmrc", "content": "# .npmrc\n\nregistry=https://registry.npmjs.org/\n" }, { "path": "packages/crd-templates/README.md", "content": " _.-\"\\\n _.-\" \\\n ,-\" \\\n \\ create \\\n \\ \\ react \\\n \\ \\ doc \\\n \\ \\ _.-;\n \\ \\ _.-\" :\n \\ \\,-\" _.-\"\n \\( _.-\"\n `--\"\n\n# crd-templates\n\ncrd-templates 集成了 create-react-doc 中相关模板文件。\n" }, { "path": "packages/crd-templates/default/.github/workflows/gh-pages.yml", "content": "name: github pages\non:\n push:\n branches:\n - main\n\njobs:\n deploy:\n runs-on: ubuntu-18.04\n steps:\n - uses: actions/checkout@v2\n\n - name: Setup Node\n uses: actions/setup-node@v2.1.3\n with:\n node-version: '12.x'\n\n - name: Get yarn cache\n id: yarn-cache\n run: echo \"::set-output name=dir::$(yarn cache dir)\"\n\n - name: Cache dependencies\n uses: actions/cache@v2\n with:\n path: ${{ steps.yarn-cache.outputs.dir }}\n key: ${{ runner.os }}-website-${{ hashFiles('**/yarn.lock') }}\n restore-keys: |\n ${{ runner.os }}-website-\n\n - run: yarn install --frozen-lockfile\n - run: yarn build\n\n - name: Deploy\n uses: peaceiris/actions-gh-pages@v3\n with:\n github_token: ${{ secrets.GITHUB_TOKEN }}\n publish_dir: .crd-dist" }, { "path": "packages/crd-templates/default/.npmrc", "content": "# .npmrc\nregistry=https://registry.npmjs.org/\n" }, { "path": "packages/crd-templates/default/Introduction/hello_world.md", "content": "Write docs happily now.\n\nIf there is any problem, welcome give issue [there](https://github.com/MuYunyun/create-react-doc/issues).\n" }, { "path": "packages/crd-templates/default/README.md", "content": " _.-\"\\\n _.-\" \\\n ,-\" \\\n \\ create \\\n \\ \\ react \\\n \\ \\ doc \\\n \\ \\ _.-;\n \\ \\ _.-\" :\n \\ \\,-\" _.-\"\n \\( _.-\"\n `--\"\n\n[![npm version](https://img.shields.io/npm/v/create-react-doc)](https://badge.fury.io/js/create-react-doc)\n[![week download](https://img.shields.io/npm/dw/create-react-doc.svg)](https://www.npmjs.com/package/create-react-doc)\n![views](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/views.svg)\n![views](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/views_per_week.svg)\n![clones](https://raw.githubusercontent.com/MuYunyun/create-react-doc/traffic/traffic-create-react-doc/clones_per_week.svg)\n![LICENSE MIT](https://img.shields.io/npm/l/create-react-doc.svg)\n\n# Create React Doc\n\nCreate React Doc 是一个使用 React 的 markdown 文档站点生成工具。就像 [create-react-app](https://github.com/facebook/create-react-app) 一样，开发者可以使用 Create React Doc 来开发、部署 markdown 站点或者博客而无需关心站点环境配置信息。\n\n## 特性\n\n* 建站理念: 文件即站点 (Files as a site)。\n* 开箱即用: 一键生成可运行文档站点, 无需关心站点环境配置信息。\n* 自定义展示目录: 天然适合搭建 monorepo 文档、博客等站点。\n* 性能: 文档支持懒加载提升站点加载速度。\n* 工作流: 集成 Github action, 自动化打包、发布站点。\n\n> [快速上手](http://muyunyun.cn/create-react-doc/%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B)\n\n## 主题\n\n当前默认使用的主题是 [crd-seed](https://github.com/MuYunyun/create-react-doc/tree/main/packages/crd-seed)。\n\n使用该主题搭建的站点\n\n* [blog](http://muyunyun.cn/blog)\n * ![](http://with.muyunyun.cn/90d3e357a31649b9466a828a92b6d88d.jpg)\n * ![](http://with.muyunyun.cn/2e7440e4256debda2d73a4e6392c7146.jpg-300)\n* [diana](https://muyunyun.cn/diana/)\n\n> 如果你的产品从中受益，欢迎留言补充\n\n## 快速上手\n\n**create-react-doc** 非常容易上手。开发者不需要额外安装或配置 webpack 或者 Babel 等工具，它们被内置隐藏在脚手架中，因此开发者可以专心于文档的书写。\n\n如果你想在当前文件下建立站点文件 `doc`, 这里提供如下三种方式快速建站:\n\n### npx\n\n```bash\nnpx create-react-doc doc\n```\n\n### npm\n\n```bash\nnpm init create-react-doc doc\n```\n\n### yarn\n\n```bash\nyarn create react-doc doc\n```\n\n![](http://with.muyunyun.cn/0f0cf6e8cb68b18399eac2927f74b063.jpg)\n\n> 如果想把模板内容内容拉取到当前文件夹, 则可以将如上命令的 `doc` 替换为 `.`, 比如执行 `npx create-react-doc .`。\n\n接着执行 `cd doc && yarn && yarn start`, 可以在 `localhost: 3000` 预览站点, 如果站点文档发生改变, 站点将自动重新加载。\n\n\n\n## 高阶用法\n\n与 git 文件结构类似, 如果在展示的文件夹中有私有文件不方便展示在文档站点, 可以在 `.gitignore` 文件中设置过滤文件, 这样它们就不会展示在文档站点中了。eg: [.gitignore](https://github.com/MuYunyun/blog/blob/main/.gitignore)\n\n## 其它工具\n\n* [crd-leetcode-cli](https://github.com/MuYunyun/create-react-doc/tree/main/packages/leetcode-cli): 提供将 [leetcode](https://leetcode-cn.com/) 中已 AC 的题目转化为 markdown 表格的能力。" }, { "path": "packages/crd-templates/default/_.gitignore", "content": "node_modules\npackage-lock.json\n.DS_Store\n.cache\n.crd-dist\n" }, { "path": "packages/crd-templates/default/_config.yml", "content": "# details see http://muyunyun.cn/create-react-doc/默认主题\n\n# Site\n# title:\n\n# Menu dir\n## you can also set detailed dir, such as BasicSkill/css\nmenu: ['Introduction']\n## set init open menu keys\n# menuOpenKeys:\n\n# site theme\ntheme: crd-seed\n\n# Github\n## if you want to editing pages on github, you should config these arguments.\n# user:\n# repo:\n\n# Available values: en | zh-cn\nlanguage: en" }, { "path": "packages/crd-templates/default/_package.json", "content": "{\n \"name\": \"{{name}}\",\n \"version\": \"1.0.0\",\n \"description\": \"Describe {{name}} here\",\n \"scripts\": {\n \"start\": \"react-doc start\",\n \"build\": \"react-doc build\",\n \"deploy\": \"react-doc deploy\"\n },\n \"keywords\": [\n \"{{name}}\",\n \"react-doc\",\n \"react\"\n ],\n \"devDependencies\": {\n \"create-react-doc\": \"{{crdVersion}}\"\n },\n \"author\": \"\",\n \"license\": \"MIT\"\n}\n" }, { "path": "packages/crd-templates/package.json", "content": "{\n \"name\": \"crd-templates\",\n \"version\": \"1.10.0\",\n \"description\": \"Default Templates with Create React Doc\",\n \"repository\": {\n \"type\": \"git\",\n \"url\": \"https://github.com/MuYunyun/create-react-doc\",\n \"directory\": \"packages/templates\"\n },\n \"keywords\": [],\n \"publishConfig\": {\n \"access\": \"public\"\n },\n \"author\": \"muyunyun\",\n \"license\": \"MIT\",\n \"gitHead\": \"\"\n}\n" }, { "path": "packages/crd-templates/theme/default/Introduction/hello_world.md", "content": "Write docs happily now.\n\nIf there is any problem, welcome give issue [here](https://github.com/MuYunyun/create-react-doc/issues).\n" }, { "path": "packages/crd-templates/theme/default/README.md", "content": " _.-\"\\\n _.-\" \\\n ,-\" \\\n \\ create \\\n \\ \\ react \\\n \\ \\ doc \\\n \\ \\ _.-;\n \\ \\ _.-\" :\n \\ \\,-\" _.-\"\n \\( _.-\"\n `--\"\n\n### {{name}}\n\nThis is {{name}} theme for [create-react-doc](https://github.com/MuYunyun/create-react-doc)." }, { "path": "packages/crd-templates/theme/default/_.gitignore", "content": "node_modules\npackage-lock.json\n.DS_Store\n.cache\n.crd-dist\nconfig.yml\nIntroduction" }, { "path": "packages/crd-templates/theme/default/_.npmrc", "content": "# .npmrc\nregistry=https://registry.npmjs.org/\n" }, { "path": "packages/crd-templates/theme/default/_config.yml", "content": "# details see http://muyunyun.cn/create-react-doc/默认主题\n\n# Site\n# title:\n\n# Menu dir\n## you can also set detailed dir, such as BasicSkill/css\nmenu: ['Introduction']\n## set init open menu keys\n# menuOpenKeys:\n\n# site theme\ndevTheme: ./index\n\n# Github\n## if you want to editing pages on github, you should config these arguments.\n# user:\n# repo:\n\n# Available values: en | zh-cn\nlanguage: en" }, { "path": "packages/crd-templates/theme/default/_index.js", "content": "// The position of current index.js should be kept.\nimport { Routes, Route, Navigate } from 'react-router-dom'\nimport styles from './index.less'\n\nconst {{name}} = ({routeData, menuSource}) => {\n return (\n
\n \n }\n />\n {routeData.map((item) => {\n const Comp = item.component\n return (\n }\n />\n )\n })}\n \n
\n )\n}\n\nexport default {{name}}\n" }, { "path": "packages/crd-templates/theme/default/_index.less", "content": ".center {\n height: 100vh;\n width: 100vw;\n display: flex;\n align-items: center;\n justify-content: center;\n}" }, { "path": "packages/crd-templates/theme/default/_package.json", "content": "{\n \"name\": \"{{name}}\",\n \"version\": \"0.1.0\",\n \"description\": \"{{name}} theme for create-react-doc\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"start\": \"react-doc start\"\n },\n \"keywords\": [\n \"{{name}}\",\n \"react-doc\",\n \"react\",\n \"create-react-doc\",\n \"theme\"\n ],\n \"devDependencies\": {\n \"create-react-doc\": \"{{crdVersion}}\"\n },\n \"dependencies\": {\n \"react-router-dom\": \"^6.3.0\"\n },\n \"author\": \"\",\n \"license\": \"MIT\"\n}\n" }, { "path": "packages/crd-theme/.npmrc", "content": "# .npmrc\n\nregistry=https://registry.npmjs.org/\n\n# https://github.com/sass/node-sass#binary-configuration-parameters\nsass_binary_site=https://npm.taobao.org/mirrors/node-sass/\n\n# https://github.com/Medium/phantomjs#deciding-where-to-get-phantomjs\n# phantomjs_cdnurl=http://cnpmjs.org/downloads\nphantomjs_cdnurl=https://npm.taobao.org/dist/phantomjs\n" }, { "path": "packages/crd-theme/README.md", "content": "### crd-theme\n\n[create-react-doc](https://github.com/MuYunyun/create-react-doc) 的主题加载包。提供了懒加载, 文件内容解析等能力。" }, { "path": "packages/crd-theme/component/Loading/index.js", "content": "import styles from './index.less'\n\nconst Loading = () => {\n return (\n
\n 正在加载中....\n
\n )\n}\n\nexport default Loading\n" }, { "path": "packages/crd-theme/component/Loading/index.less", "content": ".loading {\n text-align: center;\n min-height: 450px;\n padding: 30px 0;\n}\n" }, { "path": "packages/crd-theme/index.html", "content": "\n\n\n\n <%= htmlWebpackPlugin.options.title %>\n \n \n \n \n \n \n\n\n\n
\n\n\n\n\n" }, { "path": "packages/crd-theme/index.js", "content": "import * as React from 'react'\nimport Markdown from './markdown'\nimport './index.less'\n\nexport default function (props) {\n // routing load component\n if (props.routeData && props.routeData.length > 0) {\n props.routeData.map((item) => {\n item.component = Markdown\n return item\n })\n }\n\n // support for custom theme.\n const CustomTheme = require('__project_theme__').default\n\n // use custom theme here.\n return (\n \n )\n}\n" }, { "path": "packages/crd-theme/index.less", "content": "body,\nhtml {\n position: relative;\n}\n\nbody,\nhtml,\nul,\nli {\n margin: 0;\n padding: 0;\n}\n\na {\n color: #314659;\n text-decoration: none;\n transition: color .3s;\n\n &:hover {\n color: #1890ff;\n }\n}\n\n*,\n*::before,\n*::after {\n box-sizing: border-box;\n}\n\n:global {\n #root {\n height: 100%;\n background: white;\n }\n}" }, { "path": "packages/crd-theme/markdown/Link.js", "content": "import styles from './Link.less'\n\nexport default ({ title, href, children }) => {\n let link = href.replace(/(\\/|\\/show\\/|\\/show)$/g, '')\n if (\n /^(http(?:|s):)\\/\\/(jsfiddle.net|runjs.cn|codepen.io|codesandbox.io)/.test(link) &&\n !/^(https|http):\\/\\/(jsfiddle.net|runjs.cn|codepen.io|codesandbox.io)(?:|\\/)$/.test(link)\n ) {\n const regexRunjs = /(https|http):\\/\\/runjs.cn\\/code\\/(.*)/gi\n const regexCodepen = /(https|http):\\/\\/codepen.io\\/(.*)\\/pen\\/(.*)/gi\n const regexCodesandbox = /(https|http):\\/\\/codesandbox.io\\/(s|embed)\\/(.*)/gi\n const runjs = regexRunjs.exec(link)\n const codepen = regexCodepen.exec(link)\n const codesandbox = regexCodesandbox.exec(link)\n if (runjs && runjs.length > 2) {\n link = `http://sandbox.runjs.cn/show/${runjs[2]}`\n } else if (codepen && codepen.length === 4) {\n link = `https://codepen.io/${codepen[2]}/embed/${codepen[3]}?height=400`\n } else if (codesandbox && codesandbox.length === 4) {\n link = `https://codesandbox.io/embed/${codesandbox[3]}`\n } else {\n link = `${link}/show/`\n }\n return (\n