Menu
▾
▴
Re: [Docutils-develop] suggestion for better manpage image handling
|
From: engelbert g. <eng...@gm...> - 2024-10-20 10:46:45
|
sorry i was to quick günter answered everything On Sun, 20 Oct 2024 at 12:45, engelbert gruber <eng...@gm...> wrote: > fair enough > > 1. change waring to info > 2. reformat > 3. what if there is no alt-text ? if the image-filename is not in output, > no one knows there could be something > > this could be a feature or annoying > > cheers > > > On Fri, 18 Oct 2024 at 00:32, Guenter Milde via Docutils-develop < > doc...@li...> wrote: > >> Dear Engelbert, dear Docutils developers, >> >> with man pages usually presented on a terminal, it is no surprise that >> the "manpage" writer does not support images. However, the current >> behavior around this limitation may, IMO, be iproved. >> >> If the image has an "alt" attribute, use its value *instead of* the >> filename. >> Example:: >> >> text >> >> .. image:: gibsnich.png >> :alt: an image of something >> >> more text >> >> With ``rst2man foo.rst > foo.roff`` I get a :: >> >> (WARNING/2) "image" not supported >> >> and `man ./foo.roff` shows:: >> >> >> () >> () >> >> Name >> - text [image: an image of something/gibsnich.png] >> >> more text >> >> I would prefer an (INFO/1) instead of a warning and :: >> >> () >> () >> >> Name >> text >> >> an image of something >> >> more text >> >> >> >> For images without an :alt: attribute, the warning should be kept >> but amended with something in the line of >> >> (WARNING/2) "image" not supported by "manpage" writer. >> Please provide an "alt" attribute with textual replacement. >> >> >> Thanks, >> >> Günter >> >> >> >> _______________________________________________ >> Docutils-develop mailing list >> Doc...@li... >> https://lists.sourceforge.net/lists/listinfo/docutils-develop >> >> Please use "Reply All" to reply to the list. >> > |
