docs: update zh-cn translations

This commit is contained in:
Xin
2024-12-31 00:34:20 +00:00
parent 594b1f190c
commit 9632c4d05a
24 changed files with 1175 additions and 477 deletions

View File

@ -1,10 +1,10 @@
---
title: "代码高亮"
title: "语法高亮"
weight: 3
---
Hugo 使用 [Chroma](https://github.com/alecthomas/chroma)一种纯 Golang 实现的代码高亮渲染器
建议 Markdown 内容中的代码块使用反引号例如:
Hugo 使用 [Chroma](https://github.com/alecthomas/chroma)这是一个用纯 Go 编写的通用语法高亮器,用于语法高亮
建议 Markdown 内容中使用反引号来标记代码块。例如:
<!--more-->
@ -15,18 +15,18 @@ def say_hello():
```
````
呈现为:
会渲染为:
```python
def say_hello():
print("Hello!")
```
## 特性
## 功能
### 文件名
代码块添加文件名或标题,请设置 `filename`
代码块添加文件名或标题,请设置 `filename` 属性
````markdown {filename="Markdown"}
```python {filename="hello.py"}
@ -40,9 +40,27 @@ def say_hello():
print("Hello!")
```
### 文件链接
{{< new-feature version="v0.9.2" >}}
你可以使用 `base_url` 属性提供一个基础 URL它将与文件名结合生成一个链接。
如果文件名指定了文件在基础路径中的位置,则可以包含相对路径。
````markdown {filename="Markdown"}
```go {base_url="https://github.com/imfing/hextra/blob/main/",filename="exampleSite/hugo.work"}
go 1.20
```
````
```go {base_url="https://github.com/imfing/hextra/blob/main/",filename="exampleSite/hugo.work"}
go 1.20
```
### 行号
如需设置行号,将 `linenos` 设置为 `table`,并 `linenostart` 设置为起始行号:
设置行号,将 `linenos` 属性设置为 `table`,并可选地设置 `linenostart` 为起始行号:
````markdown {filename="Markdown"}
```python {linenos=table,linenostart=42}
@ -58,7 +76,7 @@ def say_hello():
### 高亮行
显示高亮行,设置 `hl_lines` 为行号:
要高亮特定行,请将 `hl_lines` 属性设置为行号列表
````markdown {filename="Markdown"}
```python {linenos=table,hl_lines=[2,4],linenostart=1,filename="hello.py"}
@ -78,12 +96,19 @@ def main():
say_hello()
```
### 复制按钮
默认情况下,代码块复制按钮已自动启用
默认情况下,代码块启用了复制按钮。可以通过修改站点配置文件来更改其行为:
```yaml {linenos=table,linenostart=42,filename="hugo.yaml"}
params:
highlight:
copy:
enable: true
# hover | always
display: hover
```
## 支持的编程语言
## 支持的语言
如需了解支持的编程语言,转至 [Chroma's documentation](https://github.com/alecthomas/chroma#supported-languages)。
有关支持的语言列表,请参阅 [Chroma 文档](https://github.com/alecthomas/chroma#supported-languages)。