• Johannes Schindelin's avatar
    giteveryday: unbreak rendering with AsciiDoctor · 9574901c
    Johannes Schindelin authored
    The "giteveryday" document has a callout list that contains a code
    block. This is not a problem for AsciiDoc, but AsciiDoctor sadly was
    explicitly designed *not* to render this correctly [*1*]. The symptom is
    an unhelpful
    
    	line 322: callout list item index: expected 1 got 12
    	line 325: no callouts refer to list item 1
    	line 325: callout list item index: expected 2 got 13
    	line 327: no callouts refer to list item 2
    
    In Git for Windows, we rely on the speed improvement of AsciiDoctor (on
    this developer's machine, `make -j15 html` takes roughly 30 seconds with
    AsciiDoctor, 70 seconds with AsciiDoc), therefore we need a way to
    render this correctly.
    
    The easiest way out is to simplify the callout list, as suggested by
    AsciiDoctor's author, even while one may very well disagree with him
    that a code block hath no place in a callout list.
    
    *1*: https://github.com/asciidoctor/asciidoctor/issues/1478Signed-off-by: Johannes Schindelin's avatarJohannes Schindelin <johannes.schindelin@gmx.de>
    Signed-off-by: default avatarJunio C Hamano <gitster@pobox.com>
    9574901c
giteveryday.txt 14.2 KB