AsciiDoc uses a configuration file to implement macros like linkgit, while Asciidoctor uses Ruby extensions. Implement a Ruby extension that implements the linkgit macro for Asciidoctor in the same way that asciidoc.conf does for AsciiDoc. Signed-off-by: brian m. carlson <sandals@xxxxxxxxxxxxxxxxxxxx> --- Documentation/extensions.rb | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 Documentation/extensions.rb diff --git a/Documentation/extensions.rb b/Documentation/extensions.rb new file mode 100644 index 0000000..c33a50d --- /dev/null +++ b/Documentation/extensions.rb @@ -0,0 +1,39 @@ +require 'asciidoctor' +require 'asciidoctor/extensions' + +module Git + module Documentation + class LinkGitProcessor < Asciidoctor::Extensions::InlineMacroProcessor + use_dsl + + named :chrome + + def process(parent, target, attrs) + if parent.document.basebackend? 'html' + generate_html(parent, target, attrs) + elsif parent.document.basebackend? 'docbook' + generate_docbook(parent, target, attrs) + end + end + + private + + def generate_html(parent, target, attrs) + section = attrs.has_key?(1) ? "(#{attrs[1]})" : '' + prefix = parent.document.attr('git-relative-html-prefix') || '' + %(<a href="#{prefix}#{target}.html">#{target}#{section}</a>\n) + end + + def generate_docbook(parent, target, attrs) + %(<citerefentry> +<refentrytitle>#{target}</refentrytitle><manvolnum>#{attrs[1]}</manvolnum> +</citerefentry> +) + end + end + end +end + +Asciidoctor::Extensions.register do + inline_macro Git::Documentation::LinkGitProcessor, :linkgit +end -- 2.1.1 -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html