From 9c1b9a9de654c93dff30936edb22b089bbc78ea1 Mon Sep 17 00:00:00 2001 From: "hexo-crowdin[bot]" <159447924+hexo-crowdin[bot]@users.noreply.github.com> Date: Thu, 2 Jan 2025 01:11:23 +0000 Subject: [PATCH] l10n(zh-CN): New translations from Crowdin --- source/zh-cn/api/console.md | 4 +-- source/zh-cn/api/events.md | 10 +++--- source/zh-cn/api/filter.md | 10 +++--- source/zh-cn/api/generator.md | 12 +++---- source/zh-cn/api/index.md | 4 +-- source/zh-cn/api/injector.md | 6 ++-- source/zh-cn/api/migrator.md | 2 +- source/zh-cn/api/posts.md | 6 ++-- source/zh-cn/api/renderer.md | 4 +-- source/zh-cn/api/rendering.md | 4 +-- source/zh-cn/api/router.md | 2 +- source/zh-cn/api/scaffolds.md | 2 +- source/zh-cn/api/themes.md | 12 +++---- source/zh-cn/docs/commands.md | 34 ++++++++++---------- source/zh-cn/docs/configuration.md | 20 ++++++------ source/zh-cn/docs/contributing.md | 14 ++++---- source/zh-cn/docs/data-files.md | 2 +- source/zh-cn/docs/front-matter.md | 4 +-- source/zh-cn/docs/helpers.md | 4 +-- source/zh-cn/docs/tag-plugins.md | 8 ++--- source/zh-cn/docs/templates.md | 2 +- source/zh-cn/docs/troubleshooting.md | 48 ++++++++++++++-------------- source/zh-cn/docs/writing.md | 36 ++++++++++----------- 23 files changed, 125 insertions(+), 125 deletions(-) diff --git a/source/zh-cn/api/console.md b/source/zh-cn/api/console.md index 90c614c7f3..f34e2eaedf 100644 --- a/source/zh-cn/api/console.md +++ b/source/zh-cn/api/console.md @@ -18,13 +18,13 @@ hexo.extend.console.register(name, desc, options, function (args) { | `desc` | 描述 | | `options` | 选项 | -An argument `args` will be passed into the function. This is the argument that users type into the terminal. It's parsed by [Minimist][]. +`args` 参数会被传递到 `function` 中。 这是用户输入终端的参数。 它由 [Minimist][] 解析。 ## 选项 ### 用法 -The usage of a console command. 例如: +控制台命令的用法。 例如: ```js { diff --git a/source/zh-cn/api/events.md b/source/zh-cn/api/events.md index 47c90d215e..0ff9229b20 100644 --- a/source/zh-cn/api/events.md +++ b/source/zh-cn/api/events.md @@ -6,23 +6,23 @@ Hexo 继承了 [EventEmitter][]。 您可以用 `on` 方法监听 Hexo 所发布 ### deployBefore -Emitted before deployment begins. +在部署开始前触发。 ### deployAfter -Emitted after deployment finishes. +在部署完成后触发。 ### exit -在 Hexo 结束前发布。 +在 Hexo 退出前触发。 ### generateBefore -Emitted before generation begins. +在生成器开始前触发。 ### generateAfter -Emitted after generation finishes. +在生成器后触发。 ### new diff --git a/source/zh-cn/api/filter.md b/source/zh-cn/api/filter.md index e9c362e430..3ff0b9a9a8 100644 --- a/source/zh-cn/api/filter.md +++ b/source/zh-cn/api/filter.md @@ -2,7 +2,7 @@ title: 过滤器(Filter) --- -A filter is used to modify some specified data. Hexo passes data to filters in sequence and the filters then modify the data one after the other. This concept was borrowed from [WordPress](http://codex.wordpress.org/Plugin_API#Filters). +过滤器用于修改某些指定的数据。 Hexo 将数据按顺序传递给过滤器,然后过滤器逐个修改数据。 这个概念是从 [WordPress](http://codex.wordpress.org/Plugin_API#Filters) 借鉴的。 ## 概要 @@ -30,7 +30,7 @@ hexo.extend.filter.execSync(type, data, options); | 选项 | 描述 | | --------- | ---------- | -| `context` | Context | +| `context` | 內容 | | `args` | 参数。 必须为数组。 | `data` 会作为第一个参数传入每个过滤器。 而您可以在过滤器中通过返回值改变下一个过滤器中的 `data`。 如果什么都没有返回的话则会保持原本的 data。 您还可以使用 `args` 指定过滤器的其他参数。 举例来说: @@ -143,7 +143,7 @@ hexo.extend.filter.register("before_generate", function () { ### after_generate -Executed after generation finishes. +在生成完成后执行。 ```js hexo.extend.filter.register("after_generate", function () { @@ -186,7 +186,7 @@ hexo.extend.filter.register("new_post_path", function (data, replace) { ### post_permalink -Used to determine the permalink of posts. +用于确定帖子的永久链接。 ```js hexo.extend.filter.register("post_permalink", function (data) { @@ -200,7 +200,7 @@ hexo.extend.filter.register("post_permalink", function (data) { ### after_clean -Executed after generated files and cache are removed with `hexo clean` command. +在使用`hexo clean`命令删除生成的文件和缓存后执行。 ```js hexo.extend.filter.register("after_clean", function () { diff --git a/source/zh-cn/api/generator.md b/source/zh-cn/api/generator.md index 5c94a5c91c..6d572feee2 100644 --- a/source/zh-cn/api/generator.md +++ b/source/zh-cn/api/generator.md @@ -32,11 +32,11 @@ hexo.extend.generator.register("test", function (locals) { }); ``` -| 属性 | 描述 | -| -------- | ----------------------------------------------------------------------------------------------------------------------------------------- | -| `path` | 路径。 不可包含开头的 `/`。 | -| `data` | 数据 | -| `layout` | 布局。 Specify the layouts for rendering. The value can be a string or an array. If it's ignored then the route will return `data` directly. | +| 属性 | 描述 | +| -------- | ---------------------------------------------------- | +| `path` | 路径。 不可包含开头的 `/`。 | +| `data` | 数据 | +| `layout` | 布局。 指定用于渲染的布局。 该值可以是一个字符串或数组。 如果它被忽略,路由将直接返回 `data`。 | 在原始文件更新时,Hexo 会执行所有生成器并重建路由。 **请直接回传数据,不要直接访问路由。** @@ -46,7 +46,7 @@ hexo.extend.generator.register("test", function (locals) { 在 `archives/index.html` 建立一归档页面。 把所有文章当作数据传入模板内。 这个数据也就等同于模板中的 `page` 变量。 -Next, set the `layout` attribute to render with the theme templates. We're setting two layouts in this example: if the `archive` layout doesn't exist, the `index` layout will be used instead. +接下来,设置 `layout` 属性以使用主题模板进行渲染。 我们在此示例中设置了两个布局:如果 `archive` 布局不存在,则将使用 `index` 布局。 ```js hexo.extend.generator.register("archive", function (locals) { diff --git a/source/zh-cn/api/index.md b/source/zh-cn/api/index.md index 74cbf4b951..71efc7edf6 100644 --- a/source/zh-cn/api/index.md +++ b/source/zh-cn/api/index.md @@ -31,7 +31,7 @@ hexo.init().then(function () { Hexo 提供了两种方法来加载文件:`load` 和 `watch`。 `load` 用于加载 `source` 文件夹中的所有文件以及主题数据。 `watch` 执行与 `load` 相同的操作,但还会开始连续监视文件更改。 -Both methods will load the list of files and pass them to the corresponding processors. After all files have been processed, they will call upon the generators to create the routes. +这两种方法都将加载文件列表并将它们传递给对应的处理器。 处理完所有文件后,它们将调用生成器创建路由。 ```js hexo.load().then(function () { @@ -45,7 +45,7 @@ hexo.watch().then(function () { ## 执行指令 -Any console command can be called explicitly using the `call` method on the Hexo instance. Such a call takes two arguments: the name of the console command, and an options argument. Different options are available for the different console commands. +任何控制台命令都可以在 Hexo 实例上明确使用 `call` 方法。 这种调用需要两个参数:控制台命令的名称和选项参数。 不同的控制台命令可用不同的选项。 ```js hexo.call("generate", {}).then(function () { diff --git a/source/zh-cn/api/injector.md b/source/zh-cn/api/injector.md index 7d70fb6d7f..6650252e36 100644 --- a/source/zh-cn/api/injector.md +++ b/source/zh-cn/api/injector.md @@ -12,9 +12,9 @@ hexo.extend.injector.register(entry, value, to); ### entry `` -Where the code will be injected inside the HTML. +在 HTML 中的注入代码的位置。 -Support those values: +支持这些值: - `head_begin`: 注入在 `` 之后(默认) - `head_end`: 注入在 `` 之前 @@ -29,7 +29,7 @@ Support those values: ### to `` -Which page will code snippets being injected. +哪些页面会被注入代码 - `default`: 注入到每个页面(默认值) - `home`: 只注入到主页(`is_home()` 为 `true` 的页面) diff --git a/source/zh-cn/api/migrator.md b/source/zh-cn/api/migrator.md index 5dd603beb7..f818ec64b5 100644 --- a/source/zh-cn/api/migrator.md +++ b/source/zh-cn/api/migrator.md @@ -1,5 +1,5 @@ --- -title: Migrator +title: 迁移器 --- 迁移器帮助开发者从其他系统迁移到 Hexo。 diff --git a/source/zh-cn/api/posts.md b/source/zh-cn/api/posts.md index 41347483c6..e0640e385a 100644 --- a/source/zh-cn/api/posts.md +++ b/source/zh-cn/api/posts.md @@ -13,7 +13,7 @@ hexo.post.create(data, replace); | `data` | 数据 | | `replace` | 替换现有文件 | -The attributes of a post can be defined in `data`. The table below is not exhaustive. Additional attributes may be appended to the front-matter. +帖子的属性可以在 `data` 中定义。 下面的表格并不详尽。 其他属性可以添加在 front-matter 中。 | Data | 描述 | | -------- | ----------------------------------- | @@ -34,7 +34,7 @@ hexo.post.publish(data, replace); | `data` | 数据 | | `replace` | 替换现有文件 | -The attributes of a post can be defined in `data`. The table below is not exhaustive. Additional attributes may be appended to the front-matter. +帖子的属性可以在 `data` 中定义。 下面的表格并不详尽。 其他属性可以添加在 front-matter 中。 | Data | 描述 | | -------- | ---------------------------- | @@ -52,7 +52,7 @@ hexo.post.render(source, data); | `source` | 文件的完整路径(可忽略) | | `data` | 数据 | -The data must contain the `content` attribute. If not, Hexo will try to read the original file. 此函数的执行顺序为: +data 中必须包含 `content` 属性。 否则,Hexo 将尝试读取原始文件。 此函数的执行顺序为: - 执行 `before_post_render` 过滤器 - 使用 Markdown 或其他渲染器渲染(根据扩展名而定) diff --git a/source/zh-cn/api/renderer.md b/source/zh-cn/api/renderer.md index d038f72cdc..88772971dd 100644 --- a/source/zh-cn/api/renderer.md +++ b/source/zh-cn/api/renderer.md @@ -1,8 +1,8 @@ --- -title: Renderer +title: 渲染器 --- -A renderer is used to render content. +渲染器用于渲染内容。 ## 概要 diff --git a/source/zh-cn/api/rendering.md b/source/zh-cn/api/rendering.md index 090137d395..6e73622b6f 100644 --- a/source/zh-cn/api/rendering.md +++ b/source/zh-cn/api/rendering.md @@ -26,7 +26,7 @@ hexo.render.render({ path: "path/to/file.swig" }).then(function (result) { ## 渲染选项 -You can pass in an options object as the second argument. +您可以将选项对象作为第二个参数传入。 ```js hexo.render.render({ text: "" }, { foo: "foo" }).then(function (result) { @@ -58,7 +58,7 @@ hexo.render.isRenderable("image.png"); // false ## 获取文件的输出扩展名 -Use the `getOutput` method to get the extension of the rendered output. If a file is not renderable, the method will return an empty string. +使用 `getOutput` 方法来获取渲染输出的扩展名。 如果文件不可渲染,这个方法将返回空字符串。 ```js hexo.render.getOutput("layout.swig"); // html diff --git a/source/zh-cn/api/router.md b/source/zh-cn/api/router.md index 22147f477f..854d350519 100644 --- a/source/zh-cn/api/router.md +++ b/source/zh-cn/api/router.md @@ -39,7 +39,7 @@ hexo.route.set("index.html", function (callback) { }); ``` -You can also set a boolean for whether a path has been modified or not. This can speed up file generation as it allows for ignoring the unmodified files. +您也可以设置一个布尔值来声明路径是否被修改。 这可以加快文件生成,因为它允许忽略未修改的文件。 ```js hexo.route.set("index.html", { diff --git a/source/zh-cn/api/scaffolds.md b/source/zh-cn/api/scaffolds.md index d49bcb5da0..2017904683 100644 --- a/source/zh-cn/api/scaffolds.md +++ b/source/zh-cn/api/scaffolds.md @@ -1,5 +1,5 @@ --- -title: Scaffolds +title: 脚手架 --- ## 获得脚手架 diff --git a/source/zh-cn/api/themes.md b/source/zh-cn/api/themes.md index 7337d30ff2..c287eb2ecf 100644 --- a/source/zh-cn/api/themes.md +++ b/source/zh-cn/api/themes.md @@ -4,27 +4,27 @@ title: 主题 `hexo.theme` 除了继承 [Box](box.html) 外,还具有存储模板的功能。 -## Get a View +## 获取视图 ```js hexo.theme.getView(path); ``` -## Set a View +## 设置视图 ```js hexo.theme.setView(path, data); ``` -## Remove a View +## 移除视图 ```js hexo.theme.removeView(path); ``` -## View +## 视图 -模板本身有两个方法可供使用:`render` 和 `renderSync`。 These two methods are identical, but the former is asynchronous and the latter is synchronous. So for the sake of simplicity, we will only discuss `render` here. +模板本身有两个方法可供使用:`render` 和 `renderSync`。 这两种方法是相同的,但是前者是异步的,后者是同步的。 所以为了简洁起见,我们将只在这里讨论 `render`。 ```js var view = hexo.theme.getView("layout.swig"); @@ -34,4 +34,4 @@ view.render({ foo: 1, bar: 2 }).then(function (result) { }); ``` -您可以以向 `render` 方法传入对象作为参数,`render` 方法会先使用对应的渲染引擎进行解析,并加载 [辅助函数](helper.html)。 When rendering is complete, it will try to find whether a layout exists. If `layout` is `false` or if it doesn't exist, the result will be returned directly. +您可以以向 `render` 方法传入对象作为参数,`render` 方法会先使用对应的渲染引擎进行解析,并加载 [辅助函数](helper.html)。 当渲染完成时,它将尝试查找布局是否存在。 如果 `layout` 为 `false` 或者如果它不存在,将直接返回结果。 diff --git a/source/zh-cn/docs/commands.md b/source/zh-cn/docs/commands.md index 942a0d20d4..3a67bd9f86 100644 --- a/source/zh-cn/docs/commands.md +++ b/source/zh-cn/docs/commands.md @@ -21,7 +21,7 @@ $ hexo init [folder] $ hexo new [layout] ``` -新建一篇文章。 如果没有设置 `layout` 的话,默认使用 [\_config.yml](configuration.html) 中的 `default_layout` 参数代替。 Use the layout `draft` to create a draft. 如果标题包含空格的话,请使用引号括起来。 +新建一篇文章。 如果没有设置 `layout` 的话,默认使用 [\_config.yml](configuration.html) 中的 `default_layout` 参数代替。 使用布局 `draft` 来创建草稿。 如果标题包含空格的话,请使用引号括起来。 | 选项 | 描述 | | ----------------- | ----------------- | @@ -37,7 +37,7 @@ hexo new page --path about/me "About me" 以上命令会创建一个 `source/about/me.md` 文件,同时 Front Matter 中的 title 为 `"About me"` -注意! title 是必须指定的! For example, this will not result in the behaviour you might expect: +注意! title 是必须指定的! 例如,这不会产生您可能期望的行为: ```bash hexo new page --path about/me @@ -53,13 +53,13 @@ $ hexo generate 生成静态文件。 -| 选项 | 描述 | -| --------------------- | -------------------------------- | -| `-d`, `--deploy` | Deploy after generation finishes | -| `-w`, `--watch` | 监视文件变动 | -| `-b`, `--bail` | 生成过程中如果发生任何未处理的异常则抛出异常 | -| `-f`, `--force` | 强制重新生成 | -| `-c`, `--concurrency` | 要同时生成的文件的最大数量。 默认无限制 | +| 选项 | 描述 | +| --------------------- | ---------------------- | +| `-d`, `--deploy` | 在生成完成后部署。 | +| `-w`, `--watch` | 监视文件变动 | +| `-b`, `--bail` | 生成过程中如果发生任何未处理的异常则抛出异常 | +| `-f`, `--force` | 强制重新生成 | +| `-c`, `--concurrency` | 要同时生成的文件的最大数量。 默认无限制 | ## publish @@ -77,11 +77,11 @@ $ hexo server 启动服务器。 默认情况下,访问网址为: `http://localhost:4000/`。 -| 选项 | 描述 | -| ---------------- | -------------------------------------- | -| `-p`, `--port` | 重设端口 | -| `-s`, `--static` | 只使用静态文件 | -| `-l`, `--log` | Enable logger. Override logger format. | +| 选项 | 描述 | +| ---------------- | ----------------------------- | +| `-p`, `--port` | 重设端口 | +| `-s`, `--static` | 只使用静态文件 | +| `-l`, `--log` | 启用日志。 Override logger format. | ## deploy @@ -91,9 +91,9 @@ $ hexo deploy 部署你的网站。 -| 选项 | 描述 | -| ------------------ | -------------------------- | -| `-g`, `--generate` | Generate before deployment | +| 选项 | 描述 | +| ------------------ | ------ | +| `-g`, `--generate` | 在部署前生成 | ## render diff --git a/source/zh-cn/docs/configuration.md b/source/zh-cn/docs/configuration.md index c6313c1342..c2a9949eea 100644 --- a/source/zh-cn/docs/configuration.md +++ b/source/zh-cn/docs/configuration.md @@ -45,8 +45,8 @@ pretty_urls: | 设置 | 描述 | 默认值 | | -------------- | ----------------------------------------------------------------------------------------------------------------- | ---------------- | -| `source_dir` | Source folder. Where your content is stored | `source` | -| `public_dir` | Public folder. Where the static site will be generated | `public` | +| `source_dir` | Source 文件夹 存储内容的位置 | `source` | +| `public_dir` | Public 文件夹 生成静态站点的位置 | `public` | | `tag_dir` | 标签文件夹 | `tags` | | `archive_dir` | 归档文件夹 | `archives` | | `category_dir` | 分类文件夹 | `categories` | @@ -79,7 +79,7 @@ skip_render: "_posts/test-post.md" | `external_link.enable` | 在新标签中打开链接 | `true` | | `external_link.field` | 对整个网站(`site`)生效或仅对文章(`post`)生效 | `site` | | `external_link.exclude` | 需要排除的域名。 主域名和子域名如 `www` 需分别配置 | `[]` | -| `filename_case` | Transform filenames to `1` lower case; `2` upper case | `0` | +| `filename_case` | 设置为 `1` ,将文件名转换为小写形式; 设置为 `2` ,将文件名转换为大写形式。 | `0` | | `render_drafts` | 显示草稿 | `false` | | `post_asset_folder` | 启用 [资源文件夹](asset-folders.html) | `false` | | `relative_link` | 把链接改为与根目录的相对位址 | `false` | @@ -90,13 +90,13 @@ skip_render: "_posts/test-post.md" ### 首页设置 -| 设置 | 描述 | 默认值 | -| -------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------- | -| `index_generator` | Generate an archive of posts, powered by [hexo-generator-index](https://github.com/hexojs/hexo-generator-index) | | -| `index_generator.path` | Root path for your blog's index page | `''` | -| `index_generator.per_page` | Posts displayed per page. | `10` | -| `index_generator.order_by` | Posts order. Order by descending date (new to old) by default. | `-date` | -| `index_generator.pagination_dir` | URL format, see [Pagination](#Pagination) setting below | `page` | +| 设置 | 描述 | 默认值 | +| -------------------------------- | ----------------------------------------------------------------------------------- | ------- | +| `index_generator` | 生成帖子归档。由 [hexo-generator-index](https://github.com/hexojs/hexo-generator-index) 驱动。 | | +| `index_generator.path` | 博客索引页面的根路径 | `''` | +| `index_generator.per_page` | 每页显示帖子数 | `10` | +| `index_generator.order_by` | 帖子排列顺序。 默认情况下按日期降序(从新到旧)。 | `-date` | +| `index_generator.pagination_dir` | URL 格式,请参阅下面的 [分页](#Pagination) 设置 | `page` | ### 分类 & 标签 diff --git a/source/zh-cn/docs/contributing.md b/source/zh-cn/docs/contributing.md index 9fca2eb766..b9f44eb357 100644 --- a/source/zh-cn/docs/contributing.md +++ b/source/zh-cn/docs/contributing.md @@ -22,7 +22,7 @@ title: 贡献 ### 工作流 -1. Fork [hexojs/hexo][]. +1. 分叉(fork) [hexojs/hexo][]。 2. 把库(repository)复制到电脑上,并安装所依赖的插件。 ```bash @@ -66,7 +66,7 @@ Hexo 文档开放源代码,您可以在 [hexojs/site][] 找到源代码。 ### 工作流 -1. Fork [hexojs/site][] +1. 分叉(fork) [hexojs/site][] 2. 把库(repository)复制到电脑上,并安装所依赖的插件。 ```bash @@ -87,16 +87,16 @@ $ hexo server ### 翻译 -#### Contribute translations +#### 贡献翻译 [![Crowdin](https://badges.crowdin.net/hexo/localized.svg)](https://crowdin.com/project/hexo) -Now we use the [Crowdin](https://crowdin.com/project/hexo) platform for translation, where anyone can contribute translations and vote for translations without manual git operations. +现在我们使用 [Crowdin](https://crowdin.com/project/hexo) 平台进行翻译,任何人都可以贡献翻译并投票支持翻译,而不需要手动git 操作。 -#### Add a new language +#### 添加新语言 -1. Submit a new issue to let us know. The members with access to the [Crowdin Project](https://crowdin.com/project/hexo) add the language in settings. -1. After adding language in Crowdin, anyone can contribute translations on it. +1. 提交一个新议题(issue)让我们知道。 拥有权限 [Crowdin 项目](https://crowdin.com/project/hexo) 的成员在设置中添加语言。 +1. 在 Crowdin 中添加语言后,任何人都可以贡献翻译。 1. 在 `source/_data/language.yml` 中新增语言。 1. 将 `en.yml` 复制到 `themes/navy/languages`中并命名为语言名称(全小写)。 diff --git a/source/zh-cn/docs/data-files.md b/source/zh-cn/docs/data-files.md index fb16e7771f..1a4e9a4f63 100644 --- a/source/zh-cn/docs/data-files.md +++ b/source/zh-cn/docs/data-files.md @@ -22,7 +22,7 @@ Archives: /archives/ <% } %> ``` -render like this : +渲染就像这样: ``` <a href="/"> Home </a> diff --git a/source/zh-cn/docs/front-matter.md b/source/zh-cn/docs/front-matter.md index cbd83b873a..4a15bc1960 100644 --- a/source/zh-cn/docs/front-matter.md +++ b/source/zh-cn/docs/front-matter.md @@ -48,7 +48,7 @@ date: 2013/7/13 20:46:25 #### 分类和标签 -只有文章支持分类和标签。 Categories apply to posts in order, resulting in a hierarchy of classifications and sub-classifications. Tags are all defined on the same hierarchical level so the order in which they appear is not important. +只有文章支持分类和标签。 分类按顺序应用于文章,从而形成分类和子分类的层次结构。 标签是在相同的层次结构上定义的,因此它们的出现顺序不重要。 **示例** @@ -62,7 +62,7 @@ tags: - Shocking ``` -If you want to apply multiple category hierarchies, use a list of names instead of a single name. If Hexo sees any categories defined this way on a post, it will treat each category for that post as its own independent hierarchy. +如果你想应用多个分类层次结构,请使用一个名称列表而不是一个单个名称。 如果 Hexo 在帖子上看到像这种方式定义的分类,它会将该帖子的每个分类视为其自己的独立层次结构。 **示例** diff --git a/source/zh-cn/docs/helpers.md b/source/zh-cn/docs/helpers.md index c77f7f0b22..1ee5ddd3fb 100644 --- a/source/zh-cn/docs/helpers.md +++ b/source/zh-cn/docs/helpers.md @@ -123,7 +123,7 @@ url: https://example.com/blog # example ### css -加载 CSS 文件。 `path` can be a string, an array, an object or an array of objects. `path` 可以是数组或字符串,如果 `path` 开头不是 `/` 或任何协议,则会自动加上根路径;如果后面没有加上 `.css` 扩展名的话,也会自动加上。 对于自定义属性请使用对象类型。 +加载 CSS 文件。 `path` 可以是一个字符串、数组、对象或对象数组。 `path` 可以是数组或字符串,如果 `path` 开头不是 `/` 或任何协议,则会自动加上根路径;如果后面没有加上 `.css` 扩展名的话,也会自动加上。 对于自定义属性请使用对象类型。 ```js <%- css(path, ...) %> @@ -149,7 +149,7 @@ url: https://example.com/blog # example ### js -加载 JavaScript 文件。 `path` can be a string, an array, an object or an array of objects. `path` 可以是数组或字符串,如果 `path` 开头不是 `/` 或任何协议,则会自动加上根路径;如果后面没有加上 `.js` 扩展名的话,也会自动加上。 对于自定义属性请使用对象类型。 +加载 JavaScript 文件。 `path` 可以是一个字符串、数组、对象或对象数组。 `path` 可以是数组或字符串,如果 `path` 开头不是 `/` 或任何协议,则会自动加上根路径;如果后面没有加上 `.js` 扩展名的话,也会自动加上。 对于自定义属性请使用对象类型。 ```js <%- js(path, ...) %> diff --git a/source/zh-cn/docs/tag-plugins.md b/source/zh-cn/docs/tag-plugins.md index 005d165fe1..e0660f78ce 100644 --- a/source/zh-cn/docs/tag-plugins.md +++ b/source/zh-cn/docs/tag-plugins.md @@ -148,7 +148,7 @@ _.compact([0, 1, false, 2, '', 3]); ## 反引号代码块 -This is identical to using a code block, but instead uses three backticks to delimit the block. +这与使用代码块相同,但使用三个反引号来分隔。 {% raw %} ``[language] [title] [url] [link text] @@ -158,7 +158,7 @@ code snippet ## Pull Quote -To add pull quotes to your posts: +将 pull quotes 添加到您的帖子: ``` {% pullquote [class] %} @@ -184,7 +184,7 @@ content 如果你正在使用 `v7.0.0+`,请使用 [hexo-tag-embed](https://github.com/hexojs/hexo-tag-embed) 替代。 {% endnote %} -To embed a Gist snippet: +在文章中嵌入 jsFiddle。 ``` {% gist gist_id [filename] %} @@ -314,7 +314,7 @@ To embed a Gist snippet: 例如,在文章中使用 `{% raw %}{% post_link how-to-bake-a-cake %}{% endraw %}` 时,只需有一个名为 `how-to-bake-a-cake.md` 的文章文件即可。 -This will work as long as the filename of the post is `how-to-bake-a-cake.md`, even if the post is located at `source/posts/2015-02-my-family-holiday` and has permalink `2018/en/how-to-bake-a-cake`. +只要帖子的文件名是 `how-to-bake-a-cake.md`,即使帖子位于 `source/posts/2015-02-my-family-holiday` 也能正常运行,并且具有固定链接 `2018/en/how-to-bake-a-cake`。 默认链接文字是文章的标题,你也可以自定义要显示的文本。 diff --git a/source/zh-cn/docs/templates.md b/source/zh-cn/docs/templates.md index de68b088fa..30df380b34 100644 --- a/source/zh-cn/docs/templates.md +++ b/source/zh-cn/docs/templates.md @@ -47,7 +47,7 @@ index ## Partials -Partials are useful for sharing components between your templates. Typical examples include headers, footers or sidebars. You may want to put your partials in separate files to make maintaining your website significantly more convenient. 例如: +Partials 对于在模板之间共享组件很有用。 典型的例子包括页眉、页脚或侧边栏。 您可能想要将您的 partials 放在单独的文件中,以使维护您的网站更加方便。 例如: ```html partial/header.ejs <h1 id="logo"><%= config.title %></h1> diff --git a/source/zh-cn/docs/troubleshooting.md b/source/zh-cn/docs/troubleshooting.md index a7b37ac457..43f0164de6 100644 --- a/source/zh-cn/docs/troubleshooting.md +++ b/source/zh-cn/docs/troubleshooting.md @@ -11,7 +11,7 @@ JS-YAML: incomplete explicit mapping pair; a key node is missed at line 18, colu last_updated: Last updated: %s ``` -Wrap the string with quotations if it contains colons. +如果字符串包含冒号,则用引号将其括起来。 ```plain JS-YAML: bad indentation of a mapping entry at line 18, column 31: @@ -69,25 +69,25 @@ DefaultLimitNOFILE=10000 3. 重启 -## Process Out of Memory +## 进程内存溢出 -如果你遇到了这个错误,有可能是你的文件名、分类或者标签的名字混淆了大写和小写,你可以尝试检查每一个标签和分类的名称,是否大小写一致来修复这一问题。 +当您在生成过程中遇到此错误时: ``` FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - process out of memory ``` -Increase Node.js heap memory size by changing the first line of `hexo-cli` (`which hexo` to look for the file). +通过更改 `hexo-cli` 的第一行来增加 Node.js 堆内存大小(`which hexo` 用于查找文件)。 ``` #!/usr/bin/env node --max_old_space_size=8192 ``` -[Out of memory while generating a huge blog · Issue #1735 · hexojs/hexo](https://github.com/hexojs/hexo/issues/1735) +[生成大型博客时内存不足 Issue hexojs/hexo#1735](https://github.com/hexojs/hexo/issues/1735) ## Git 部署问题 -### RPC failed +### RPC 失败 ```plain error: RPC failed; result=22, HTTP code = 403 @@ -99,18 +99,18 @@ fatal: 'username.github.io' does not appear to be a git repository ### Error: ENOENT: no such file or directory -If you get an error like `Error: ENOENT: no such file or directory` it's probably due to mixing uppercase and lowercase letters in your tags, categories, or filenames. Git cannot automatically merge this change, so it breaks the automatic branching. +如果您遇到像 `Error: ENOENT: no such file or directory` 之类的错误,这可能是由于您的标签、分类或文件名中混合了大写和小写字母。 Git 不能自动合并此更改,所以它会中断自动分支。 -To fix this, try +要解决这个问题,请试试 -1. Check every tag's and category's case and make sure they are the same. -1. Commit -1. Clean and build: `./node_modules/.bin/hexo clean && ./node_modules/.bin/hexo generate` -1. Manually copy the public folder to your desktop -1. Switch branch from your master branch to your deployment branch locally -1. Copy the contents of the public folder from your desktop into the deployment branch -1. Commit. You should see any merge conflicts appear that you can manually resolve. -1. Switch back to your master branch and deploy normally: `./node_modules/.bin/hexo deploy` +1. 检查每个标签和类别的大小写,并确保它们是相同的。 +1. 提交变更 +1. 清洁和构建:`./node_modules/.bin/hexo clean && ./node_modules/.bin/hexo generate` +1. 手动复制公共文件夹到桌面 +1. 将分支从主分支切换到本地部署分支 +1. 从桌面复制公共文件夹的内容到部署分支 +1. 提交。 您应该看到您可以手动解决的任何合并冲突。 +1. 切换回主分支并正常部署: `./node_modules/.bin/hexo deploy` ## 服务器问题 @@ -159,7 +159,7 @@ Hexo 使用 [Warehouse][] 存储数据。 它不是一般数组所以必须先 ## 数据没有更新 -Some data cannot be updated, or the newly generated files are identical to those of the last version. Clean the cache and try again. +有些数据无法更新,或者新生成的文件与上次版本相同。 清理缓存并重试。 ```bash $ hexo clean @@ -177,7 +177,7 @@ $ hexo clean } ``` -## Escape Contents +## 转义内容 Hexo 使用 [Nunjucks][] 来解析文章(旧版本使用 [Swig][],两者语法类似)。 内容若包含 `{{ }}` 或 `{% %}` 可能导致解析错误。 您可以使用 [`raw`](/docs/tag-plugins#Raw) 标记插件、单反引号 `` `{{ }}` `` 或三反引号对其进行包裹,从而跳过解析过程。 此外,Nunjucks 标签也可以通过渲染器的选项(如果支持的话)、[API](/zh-cn/api/renderer#禁用-Nunjucks-标签) 或 [front-matter](/zh-cn/docs/front-matter) 来禁用。 @@ -217,14 +217,14 @@ $ echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo Error: watch /path/to/hexo/theme/ EMPERM ``` -这是由于你使用的 WSL 版本不支持监听文件系统改动。 Therefore, the live updating feature of hexo's server is currently unavailable. 您也仍然可以通过先使用 `hexo g` 生成文件然后将其作为静态服务器运行来从 WSL 环境运行服务器: +这是由于你使用的 WSL 版本不支持监听文件系统改动。 因此,Hexo 服务器的实时更新功能不可用。 您也仍然可以通过先使用 `hexo g` 生成文件然后将其作为静态服务器运行来从 WSL 环境运行服务器: ```sh $ hexo generate $ hexo server -s ``` -This is [a known BashOnWindows issue](https://github.com/Microsoft/BashOnWindows/issues/216), and on 15 Aug 2016, the Windows team said they would work on it. You can get progress updates and encourage them to prioritize it on [the issue's UserVoice suggestion page](https://wpdev.uservoice.com/forums/266908-command-prompt-console-bash-on-ubuntu-on-windo/suggestions/13469097-support-for-filesystem-watchers-like-inotify). +这是 [一个已知的 BashOnWindows 问题](https://github.com/Microsoft/BashOnWindows/issues/216),2016 年 8 月 15 日,Windows 团队表示他们将解决这个问题。 您可以在 [该问题的 UserVoice 建议页面](https://wpdev.uservoice.com/forums/266908-command-prompt-console-bash-on-ubuntu-on-windo/suggestions/13469097-support-for-filesystem-watchers-like-inotify) 获取进度更新并鼓励他们优先解决这个问题。 ## 模板渲染错误 @@ -235,12 +235,12 @@ FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/do Template render error: (unknown path) ``` -Possible cause: +可能的原因: - 一种可能的原因是你的文件中存在一些不可被识别的字符,比如不可见的零宽度字符。 -- Incorrect use or limitation of [tag plugin](/docs/tag-plugins). +- 不正确使用或限制 [标签插件](/docs/tag-plugins) - - Block-style tag plugin with content is not enclosed with `{% endplugin_name %}` + - 块式标签插件的内容被包围在 `{% endplugin_name %}` 中 ``` # Incorrect @@ -258,7 +258,7 @@ Possible cause: {% endcodeblock %} ``` - - Having Nunjucks-like syntax in a tag plugin, e.g. [`{#`](https://mozilla.github.io/nunjucks/templating.html#comments). A workaround for this example is to use [triple backtick](/docs/tag-plugins#Backtick-Code-Block) instead. [Escape Contents](/docs/troubleshooting#Escape-Contents) section has more details. + - 在标签插件中有类似于 Nunjucks 的语法,例如 [`{#`](https://mozilla.github.io/nunjucks/templating.html#comments). 此示例的一个解决方法是使用 [triple backtick](/docs/tag-plugins#Backtick-Code-Block)。 [转义内容](/docs/troubleshooting#Escape-Contents) 部分有更多详细信息。 ``` {% codeblock lang:bash %} diff --git a/source/zh-cn/docs/writing.md b/source/zh-cn/docs/writing.md index 01a2d4b8eb..382926b10d 100644 --- a/source/zh-cn/docs/writing.md +++ b/source/zh-cn/docs/writing.md @@ -14,7 +14,7 @@ $ hexo new [layout] <title> ## 布局(Layout) -Hexo 有三种默认布局:`post`、`page` 和 `draft`。 Files created by each of them is saved to a different path. Newly created posts are saved to the `source/_posts` folder. +Hexo 有三种默认布局:`post`、`page` 和 `draft`。 每个布局创建的文件会被保存到不同的路径。 新创建的帖子被保存到 `source/_post` 文件夹。 | 布局 | 路径 | | ------- | ---------------- | @@ -28,28 +28,28 @@ Hexo 有三种默认布局:`post`、`page` 和 `draft`。 Files created by eac ## 文件名称 -By default, Hexo uses the post title as its filename. You can edit the `new_post_name` setting in `_config.yml` to change the default filename. For example, `:year-:month-:day-:title.md` will prefix filenames with the post creation date. 你可以使用以下占位符: +默认情况下,Hexo 使用帖子标题作为其文件名。 您可以编辑 `_config.yml` 中的 `new_post_name` 设置去更改默认文件名。 例如, `:year-:month-:day-:title.md` 将在文件名前加上创建日期。 你可以使用以下占位符: -| Placeholder | 描述 | -| ----------- | -------------------- | -| `:title` | 标题(小写,空格将会被替换为短杠) | -| `:year` | 建立的年份,比如, `2015` | -| `:month` | 建立的月份(有前导零),比如, `04` | -| `:i_month` | 建立的月份(无前导零),比如, `4` | -| `:day` | 建立的日期(有前导零),比如, `07` | -| `:i_day` | 建立的日期(无前导零),比如, `7` | +| 占位符 | 描述 | +| ---------- | -------------------- | +| `:title` | 标题(小写,空格将会被替换为短杠) | +| `:year` | 建立的年份,比如, `2015` | +| `:month` | 建立的月份(有前导零),比如, `04` | +| `:i_month` | 建立的月份(无前导零),比如, `4` | +| `:day` | 建立的日期(有前导零),比如, `07` | +| `:i_day` | 建立的日期(无前导零),比如, `7` | ## 草稿 -Previously, we mentioned a special layout in Hexo: `draft`. Posts initialized with this layout are saved to the `source/_drafts` folder. You can use the `publish` command to move drafts to the `source/_posts` folder. `publish` works in a similar way to the `new` command. +之前,我们在提到了 Hexo 中的一个特殊的布局:`draft`。 使用此布局初始化的帖子将被保存到 `source/_drafts` 文件夹中。 您可以使用 `发布` 命令将草稿移动到 `source/_posts` 文件夹。 `publish` 工作方式类似于 `new` 命令。 ```bash $ hexo publish [layout] <title> ``` -Drafts are not displayed by default. You can add the `--draft` option when running Hexo or enable the `render_drafts` setting in `_config.yml` to render drafts. +默认情况下不显示草稿 您可以在运行 Hexo 时添加 `--draft` 选项或在 `_config.yml` 启用 `render_draft` 设置来渲染草稿。 -## Scaffolds +## 脚手架 在新建文章时,Hexo 会根据 `scaffolds` 文件夹内相对应的文件来建立文件。 例如: @@ -59,11 +59,11 @@ $ hexo new photo "My Gallery" 在执行这行指令时,Hexo 会尝试在 `scaffolds` 文件夹中寻找 `photo.md`,并根据其内容建立文章。 以下是您可以在模版中使用的变量: -| Placeholder | 描述 | -| ----------- | ------ | -| `layout` | 布局 | -| `title` | 标题 | -| `date` | 文件建立日期 | +| 占位符 | 描述 | +| -------- | ------ | +| `layout` | 布局 | +| `title` | 标题 | +| `date` | 文件建立日期 | ## 支持的格式