git@vger.kernel.org mailing list mirror (one of many)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
 require 'asciidoctor/extensions'
require 'asciidoctor/converter/manpage'

module Asciidoctor
  class Converter::ManPageConverter
    alias orig_convert_inline_anchor convert_inline_anchor
    def convert_inline_anchor(node)
      case node.type
      when :xref
        return node.text if node.text
        refid = node.attributes['refid']
        'the section called &#8220;%s&#8221;' % refid.gsub('_', ' ')
      when :link
        return node.target if node.text == node.target
        doc = node.document

        footnote = doc.footnotes.find { |e| e.id == node.target }
        if !footnote
          footnote_text = "%s\n\e.RS\n\e\\%%%s\n\e.RE" % [node.text, node.target]
          index = doc.counter('footnote-number')
          footnote = Document::Footnote.new(index, node.target, footnote_text)
          doc.register(:footnotes, footnote)
        end

        "\e\\fB%s\e\\fR[%d]" % [node.text, footnote.index]
      else
        orig_convert_inline_anchor(node)
      end
    end
    alias inline_anchor convert_inline_anchor # For old versions of asciidoctor
  end
end

Asciidoctor::Extensions.register :git do

  doc = document

  # Override attributes for man pages.
  # https://github.com/asciidoctor/asciidoctor/issues/4059
  if doc.backend == 'manpage'
    doc.attributes.merge!({ 'litdd' => '\--', 'plus' => '+' })
  end

  inline_macro :linkgit do
    if doc.doctype == 'book'
      format = '<ulink url="%1$s.html">%1$s(%2$s)</ulink>'
    elsif doc.basebackend? 'html'
      prefix = doc.attr('git-relative-html-prefix')
      format = %(<a href="#{prefix}%1$s.html">%1$s(%2$s)</a>)
    elsif doc.basebackend? 'manpage'
      format = "\e\\fB%s\e\\fP(%s)"
    elsif doc.basebackend? 'docbook'
      format = <<~EOF.chomp
      <citerefentry>
      <refentrytitle>%s</refentrytitle><manvolnum>%s</manvolnum>
      </citerefentry>
      EOF
    else
      return
    end

    process do |_, target, attrs|
      format % [target, attrs[1]]
    end
  end

end