Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

l10n(zh-CN): New translations from Crowdin #2304

Merged
merged 2 commits into from
Jan 2, 2025
Merged

l10n(zh-CN): New translations from Crowdin #2304

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9c1b9a9
l10n(zh-CN): New translations from Crowdin
hexo-crowdin[bot] Jan 2, 2025
8d96c44
Merge branch 'master' into l10n_master_zh-CN
uiolee Jan 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions source/zh-cn/api/console.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
{
Expand Down
10 changes: 5 additions & 5 deletions source/zh-cn/api/events.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
10 changes: 5 additions & 5 deletions source/zh-cn/api/filter.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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) 借鉴的。

## 概要

Expand Down Expand Up @@ -30,7 +30,7 @@ hexo.extend.filter.execSync(type, data, options);

| 选项 | 描述 |
| --------- | ---------- |
| `context` | Context |
| `context` | 內容 |
| `args` | 参数。 必须为数组。 |

`data` 会作为第一个参数传入每个过滤器。 而您可以在过滤器中通过返回值改变下一个过滤器中的 `data`。 如果什么都没有返回的话则会保持原本的 data。 您还可以使用 `args` 指定过滤器的其他参数。 举例来说：
Expand Down Expand Up @@ -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 () {
Expand Down Expand Up @@ -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) {
Expand All @@ -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 () {
Expand Down
12 changes: 6 additions & 6 deletions source/zh-cn/api/generator.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 会执行所有生成器并重建路由。 **请直接回传数据，不要直接访问路由。**

Expand All @@ -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) {
Expand Down
4 changes: 2 additions & 2 deletions source/zh-cn/api/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 () {
Expand All @@ -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 () {
Expand Down
6 changes: 3 additions & 3 deletions source/zh-cn/api/injector.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,9 @@ hexo.extend.injector.register(entry, value, to);

### entry `<string>`

Where the code will be injected inside the HTML.
在 HTML 中的注入代码的位置。

Support those values:
支持这些值：

- `head_begin`: 注入在 `<head>` 之后（默认）
- `head_end`: 注入在 `</head>` 之前
Expand All @@ -29,7 +29,7 @@ Support those values:

### to `<string>`

Which page will code snippets being injected.
哪些页面会被注入代码

- `default`: 注入到每个页面（默认值）
- `home`: 只注入到主页（`is_home()` 为 `true` 的页面）
Expand Down
2 changes: 1 addition & 1 deletion source/zh-cn/api/migrator.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Migrator
title: 迁移器
---

迁移器帮助开发者从其他系统迁移到 Hexo。
Expand Down
6 changes: 3 additions & 3 deletions source/zh-cn/api/posts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 | 描述 |
| -------- | ----------------------------------- |
Expand All @@ -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 | 描述 |
| -------- | ---------------------------- |
Expand All @@ -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 或其他渲染器渲染（根据扩展名而定）
Expand Down
4 changes: 2 additions & 2 deletions source/zh-cn/api/renderer.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
title: Renderer
title: 渲染器
---

A renderer is used to render content.
渲染器用于渲染内容。

## 概要

Expand Down
4 changes: 2 additions & 2 deletions source/zh-cn/api/rendering.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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) {
Expand Down Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion source/zh-cn/api/router.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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", {
Expand Down
2 changes: 1 addition & 1 deletion source/zh-cn/api/scaffolds.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Scaffolds
title: 脚手架
---

## 获得脚手架
Expand Down
12 changes: 6 additions & 6 deletions source/zh-cn/api/themes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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");
Expand All @@ -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` 或者如果它不存在，将直接返回结果。
34 changes: 17 additions & 17 deletions source/zh-cn/docs/commands.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ $ hexo init [folder]
$ hexo new [layout] <title>
```

新建一篇文章。 如果没有设置 `layout` 的话，默认使用 [\_config.yml](configuration.html) 中的 `default_layout` 参数代替。 Use the layout `draft` to create a draft. 如果标题包含空格的话，请使用引号括起来。
新建一篇文章。 如果没有设置 `layout` 的话，默认使用 [\_config.yml](configuration.html) 中的 `default_layout` 参数代替。 使用布局 `draft` 来创建草稿。 如果标题包含空格的话，请使用引号括起来。

| 选项 | 描述 |
| ----------------- | ----------------- |
Expand All @@ -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
Expand All @@ -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

Expand All @@ -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

Expand All @@ -91,9 +91,9 @@ $ hexo deploy

部署你的网站。

| 选项 | 描述 |
| ------------------ | -------------------------- |
| `-g`, `--generate` | Generate before deployment |
| 选项 | 描述 |
| ------------------ | ------ |
| `-g`, `--generate` | 在部署前生成 |

## render

Expand Down
20 changes: 10 additions & 10 deletions source/zh-cn/docs/configuration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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` |
Expand Down Expand Up @@ -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` |
Expand All @@ -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` |

### 分类 & 标签

Expand Down
Loading
Loading