{"id":15675002,"url":"https://github.com/justjavac/deno-docs","last_synced_at":"2025-05-06T23:32:46.057Z","repository":{"id":204849098,"uuid":"712805644","full_name":"justjavac/deno-docs","owner":"justjavac","description":"Deno 中文文档","archived":false,"fork":false,"pushed_at":"2023-12-05T06:12:04.000Z","size":13964,"stargazers_count":14,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T18:03:49.755Z","etag":null,"topics":["deno"],"latest_commit_sha":null,"homepage":"https://docs.denohub.com","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justjavac.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-01T08:30:18.000Z","updated_at":"2024-04-10T21:13:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"539c022b-53d7-46ca-884c-d821205013db","html_url":"https://github.com/justjavac/deno-docs","commit_stats":null,"previous_names":["justjavac/deno-docs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjavac%2Fdeno-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjavac%2Fdeno-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjavac%2Fdeno-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justjavac%2Fdeno-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justjavac","download_url":"https://codeload.github.com/justjavac/deno-docs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252787531,"owners_count":21804277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deno"],"created_at":"2024-10-03T15:54:32.369Z","updated_at":"2025-05-06T23:32:41.036Z","avatar_url":"https://github.com/justjavac.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Deno 中文文档\n\n[docs.denohub.com](https://docs.denohub.com) 的源码。Deno 中文文档站点是使用\n[Docusaurus 2](https://docusaurus.io/)\n构建的，这是一种专为文档网站优化的静态站点生成器。\n\n## 本地开发\n\n由于 Docusaurus 是使用 Node.js 构建和维护的，因此建议在本地开发时安装\n[Node.js 和 npm](https://nodejs.org/en/download)。一旦安装了 Node 和\nnpm，可以使用以下命令安装 Docusaurus 的依赖项：\n\n```\nnpm install\n```\n\n然后，可以使用以下命令启动本地开发服务器：\n\n```\nnpm start\n```\n\n这将在浏览器窗口中打开\n[localhost:3000](http://localhost:3000)，您将在此处看到您所做的任何文档内容更改实时更新。\n\n要在生产配置下测试生成的静态站点，运行：\n\n```\nnpm run build\n```\n\n这将在本地生成一个静态站点到 `build` 文件夹。要测试生产服务器，运行此命令：\n\n```\nnpm run serve\n```\n\n这将在 [localhost:8000](http://localhost:8000)\n上启动一个服务器，您可以在此处预览站点。\n\n有时，在更改 Docusaurus 配置后，您可能会遇到错误，需要清理 Docusaurus\n生成的资产。您可以通过运行以下命令来解决大多数在重构站点时遇到的错误：\n\n```\nnpm run clear\n```\n\n这将解决大多数在重构站点时遇到的错误。静态资源将从头开始重新构建，下次运行\n`npm run build` 或 `npm start` 时会重新构建。\n\n## 编辑内容\n\n文档站点的实际内容主要位于以下三个文件夹中：\n\n- `runtime` - Deno CLI / runtime 的文档\n- `deploy` - Deno Deploy 云服务的文档\n- `kv` - Deno KV，Deno 集成数据库的文档\n\n大多数文件都是 [markdown](https://docusaurus.io/docs/markdown-features)\n格式，但即使是 markdown 文件也会使用 [MDX](https://mdxjs.com/)\n进行处理，这使您可以在 markdown 文件中使用 JSX 语法。\n\n不同文档部分的左侧导航在以下文件中配置：\n\n- `sidebars/runtime.js` - Runtime 部分的侧边栏配置\n- `sidebars/deploy.js` - Deno Deploy 部分的侧边栏配置\n- `sidebars/kv.js` - KV 部分的侧边栏配置\n\n静态文件（如截图）可以直接包含在 `runtime`、`deploy` 或 `kv` 文件夹中，并通过\nmarkdown 中的相对 URL 引用。\n\nDocusaurus 提供了一些很好的 markdown\n扩展，例如标签页、警告和代码块。有关更多详细信息，请参考\n[Docusaurus 文档](https://docusaurus.io/docs/markdown-features)。\n\n## 在代码和内容中包含版本号\n\n偶尔，可能需要在内容或代码示例中动态包含当前的 Deno CLI\n或标准库版本。我们可以使用该存储库根目录下的 `replacements.json`\n文件来实现这一点。\n\n您想要更改一次，并在许多生成的文件中动态显示的任何值应包含在 `replacements.json`\n中。\n\n在代码示例中（用反引号括起来），您可以在代码示例中直接包含 `$`\n字符，然后是替换变量名称。在转换 markdown 时，当前版本号将在其中替换。\n\n```ts\nimport { copy } from \"https://deno.land/std@$STD_VERSION/fs/copy.ts\";\n```\n\n要在 markdown/MDX 内容中包含版本号，建议使用 `\u003cReplacement /\u003e` 组件：\n\n```mdx\nimport Replacement from \"@site/src/components/Replacement\";\n\n当前 CLI 版本是 **\u003cReplacement for=\"CLI_VERSION\"/\u003e**。\n```\n\n如果您正在编写内联 JSX，还可以直接使用替换对象，如下所示：\n\n```mdx\nimport { replacements } from \"@site/src/components/Replacement\";\n\n\u003cp\u003e\n  当前的 CLI 版本是 \u003ccode\u003e{ replacements.CLI_VERSION }\u003c/code\u003e。\n\u003c/p\u003e\n```\n\n## 许可证\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustjavac%2Fdeno-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustjavac%2Fdeno-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustjavac%2Fdeno-docs/lists"}