hextra_mirror/exampleSite/content/docs/guide/syntax-highlighting.fa.md

title, weight

title	weight
رنگ‌آمیزی نحوی	3

Hugo از Chroma، یک رنگ‌آمیزی نحوی همه‌منظوره در Go خالص، برای رنگ‌آمیزی نحوی استفاده می‌کند. توصیه می‌شود برای بلوک‌های کد در محتوای Markdown از بک‌تیک استفاده کنید. به عنوان مثال:

```python
def say_hello():
    print("Hello!")
```

به صورت زیر نمایش داده می‌شود:

def say_hello():
    print("Hello!")

ویژگی‌ها

نام فایل

برای افزودن نام فایل یا عنوان به بلوک کد، ویژگی filename را تنظیم کنید:

```python {filename="hello.py"}
def say_hello():
    print("Hello!")
```

def say_hello():
    print("Hello!")

پیوند به فایل

{{< new-feature version="v0.9.2" >}}

می‌توانید از ویژگی base_url برای ارائه یک URL پایه استفاده کنید که با نام فایل ترکیب می‌شود تا یک پیوند ایجاد کند.

نام فایل می‌تواند شامل یک مسیر نسبی باشد اگر محل فایل را در مسیر پایه مشخص کند.

```go {base_url="https://github.com/imfing/hextra/blob/main/",filename="exampleSite/hugo.work"}
go 1.20
```

go 1.20

شماره خطوط

برای تنظیم شماره خطوط، ویژگی linenos را به table تنظیم کنید و اختیاریاً linenostart را به شماره خط شروع تنظیم کنید:

```python {linenos=table,linenostart=42}
def say_hello():
    print("Hello!")
```

42
43


def say_hello():
    print("Hello!")

برجسته‌سازی خطوط

برای برجسته‌سازی خطوط، ویژگی hl_lines را به لیستی از شماره خطوط تنظیم کنید:

```python {linenos=table,hl_lines=[2,4],linenostart=1,filename="hello.py"}
def say_hello():
    print("Hello!")

def main():
    say_hello()
```

1
2
3
4
5


def say_hello():
    print("Hello!")

def main():
    say_hello()

دکمه کپی

به طور پیش‌فرض، دکمه کپی برای بلوک‌های کد فعال است. رفتار آن را می‌توان با تغییر فایل پیکربندی سایت تغییر داد:

42
43
44
45
46
47


params:
  highlight:
    copy:
      enable: true
      # hover | always
      display: hover

زبان‌های پشتیبانی شده

برای مشاهده لیست زبان‌های پشتیبانی شده، لطفاً به مستندات Chroma مراجعه کنید.