kgt icon indicating copy to clipboard operation
kgt copied to clipboard

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

Open steveroush opened this issue 5 years ago • 2 comments

man and firefox don't display it usably

steveroush avatar Apr 26 '21 00:04 steveroush

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.

Profpatsch avatar Apr 26 '21 22:04 Profpatsch

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?

Potherca avatar Jul 02 '23 12:07 Potherca