katef / kgt

BNF wrangling and railroad diagrams
BSD 2-Clause "Simplified" License
587 stars 30 forks source link

How can I readably display the man page - on Linux? #49

Open steveroush opened 3 years ago

steveroush commented 3 years ago

man and firefox don't display it usably

Profpatsch commented 3 years ago

See https://github.com/katef/kgt/issues/50, it’s not yet in a displayable format, you have to use xsltproc to convert it to a manpage first.

Potherca commented 1 year ago

If I, very naively, install xsltproc and run it I get errors, even when I include katef/minidocbook:

$xsltproc \
    --path /tmp/katef/minidocbook/share/dtd/  \
    --path ./share/git/kmkf/share/dtd \
    share/xsl/asciidia.xsl \
    man/kgt.1/kgt.1.xml 

man/kgt.1/kgt.1.xml:238: parser error : Entity 'css' not defined
                    <para>A &css; file to include inlined into output.
                                 ^
man/kgt.1/kgt.1.xml:239: parser error : Entity 'html' not defined
                        This is relevant for &html; format output only,
                                                   ^
compilation error: file man/kgt.1/kgt.1.xml line 42 element refentry

To get readable output I've added

    <!ENTITY html "html">
    <!ENTITY css "css">

but I assume something else is needed?