• 覆盖文件类型的语法高亮显示
• 禁用文件类型的语法突出显示
• 配置高亮显示的最大文件大小

语法高亮 (BASIC ALL)

极狐GitLab 通过 Highlight.js 和 Rouge Ruby gem 为所有文件提供语法高亮显示。它试图根据文件扩展名猜测使用哪种语言，满足大多数情况下的需求。

这里的路径是 Git 内置的 .gitattributes 接口。

覆盖文件类型的语法高亮显示

要覆盖文件类型的语法高亮显示：

1. 如果您的项目根目录中不存在 .gitattributes 文件，创建一个该名称的空白文件。

2. 对于要修改的每种文件类型，在 .gitattributes 文件中添加一行，声明文件扩展名和所需的高亮显示语言：

   # This extension would normally receive Perl syntax highlighting
   # but if we also use Prolog, we may want to override highlighting for
   # files with this extension:
   *.pl gitlab-language=prolog
   

3. 提交、推送和合并您的更改到您的默认分支。

在更改合并到您的 默认分支 后，项目中的所有 *.pl 文件都会以您的首选语言高亮显示。

您还可以使用通用网关接口 (CGI) 选项扩展突出显示，例如：

# JSON file with .erb in it
/my-cool-file gitlab-language=erb?parent=json

# An entire file of highlighting errors!
/other-file gitlab-language=text?token=Error

禁用文件类型的语法突出显示

要完全禁用文件类型的高亮显示，请按照说明覆盖文件类型的高亮显示，并使用 gitlab-language=text：

# Disable syntax highlighting for this file type
*.module gitlab-language=text

配置高亮显示的最大文件大小

默认情况下，极狐GitLab 以纯文本形式呈现任何大于 512 KB 的文件。要更改此值：

1. 打开项目的 gitlab.yml 配置文件。

2. 添加此部分，将 maximum_text_highlight_size_kilobytes 替换为您想要的值。

   gitlab:
     extra:
       ## Maximum file size for syntax highlighting
       ## https://docs.gitlab.com/ee/user/project/highlighting.html
       maximum_text_highlight_size_kilobytes: 512
   

3. 提交、推送和合并您的更改到您的默认分支。