语法高亮

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

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

note Web IDESnippets 使用 Monaco Editor 进行文本编辑,其中 内部使用 Monarch 库进行语法高亮。

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

note Web IDE 不支持 .gitattribute 文件。

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

  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. 提交、推送和合并您的更改到您的默认分支。