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.
>>
>
|
