fork/mons
git clone https://git.julia.blue/fork/mons
a50fa59
fixes
1from docutils import nodes 2from sphinx .application import Sphinx 3from sphinx .builders import manpage as _manbuilder 4from sphinx .writers import manpage as _manwriter 5 6 7class BetterManPageTranslator (_manwriter .ManualPageTranslator ): 8_seealso_refs :list [nodes .Element ]= [] 9 10def _append_seealso (self ): 11for ref in self ._seealso_refs : 12try : 13self .body .append (self .visit_reference (ref )) 14except nodes .SkipNode : 15pass 16self .body .append (", " ) 17self .body .pop () 18self .body .append ("\n" ) 19 20def visit_reference (self ,node :nodes .Element )-> None : 21refuri = node .get ("refuri" ,"" ) 22if refuri and "#" not in refuri : 23self .body .append (refuri ) 24raise nodes .SkipNode 25return super ().visit_reference (node ) 26 27def visit_seealso (self ,node :nodes .Element ): 28self ._seealso_refs .append (node ) 29raise nodes .SkipNode 30 31def visit_title (self ,node :nodes .Element ): 32try : 33super ().visit_title (node ) 34except nodes .SkipNode as e : 35raise e 36finally : 37if ( 38self .deunicode (node .astext ().upper ())== "SEE ALSO" 39and self ._seealso_refs 40 ): 41self ._append_seealso () 42self ._seealso_refs .clear () 43 44def depart_document (self ,node :nodes .Element ): 45if self ._seealso_refs : 46self .body .append (".SH SEE ALSO\n.nh\n.sp\n" ) 47self ._append_seealso () 48self ._seealso_refs .clear () 49super ().depart_document (node ) 50 51 52class ManBuilder (_manbuilder .ManualPageBuilder ): 53def get_target_uri (self ,docname :str ,typ = None )-> str : 54for page in self .config .man_pages : 55if docname == page [0 ]: 56return f" { page [ 1 ] } ( { page [ 4 ] } )" 57return super ().get_target_uri (docname ,typ ) 58 59 60def setup (app :Sphinx ): 61app .set_translator ("man" ,BetterManPageTranslator ,override = True ) 62app .add_builder (ManBuilder ,override = True )