gitlab markdown 支持TOC解决办法

最新推荐文章于 2024-08-19 10:52:47 发布

renfengmei

最新推荐文章于 2024-08-19 10:52:47 发布

阅读量1.6w

点赞数 1

分类专栏：文章 git gitlab markdown 文章标签： markdown toc

本文链接：https://blog.csdn.net/renfengmei/article/details/51207769

版权

本文分析了GitLab中Markdown标题锚点的问题及其不支持自动TOC的现状，并提供了解决方案，包括修改源码以处理中文问题以及自定义生成TOC的功能。

摘要由CSDN通过智能技术生成

问题分析

1. 标题的锚点会被替换

中文替换为''

空格等非正常字符替换为'-'

这给自己手动写toc也带来了麻烦,不能直接复制标题作为链接

2. 不能自动生成TOC

目前gitlab不支持TOC功能

解决方法

1. 解决中文问题

直接找到源码 `

embedded/service/gitlab-rails/lib/redcarpet/render/gitlab_html.rb

修改生成id的部分,注意规则

     47   def header(text, level)
     48     if @options[:no_header_anchors]
     49       "<h#{level}>#{text}</h#{level}>"
     50     else
     51       #id = ActionController::Base.helpers.strip_tags(h.gfm(text)).downcase() \
     52       #    .gsub(/[^a-z0-9_-]/, '-').gsub(/-+/, '-').gsub(/^-/, '').gsub(/-$/, '')
     53       # edit by renfeng, 让锚点支持中文
     54       id = ActionController::Base.helpers.strip_tags(h.gfm(text)).downcase() \
     55