[Docutils-develop] [docutils:bugs] Re: #453 [DOC] generic "admonition" directive also listed as specific

[jfbu <jf...@us...>]

> About translating "admonition": We look for an umbrella term for the specific admonitions
(attention, caution , danger, error, hint, important, note, tip, warning) and similar block elements.

quick (French) thoughts:

* `annonce`: it is very different from `admonition` but conveys the idea of an announcement, which in practice is what the Docutils admonitions do.
* `encart`: this is from press media, it designates in particular advertisements ("encart publicitaire")
* `panneau`: here I take inspiration from being a member of one of the last generations allowed to drive by ourselves mobile engines; this designates indications on side of roads "panneau de signalisation", "panneau routier".  And inside such a "panneau" there can be "encarts" for example the name of a major city might be printed on top of a rectangular area in Green.
* `cartouche`: for example hieroglyphs may be written in such a `cartouche`; but the word also designates other things such as ammunition, see https://fr.wikipedia.org/wiki/Cartouche. I feel it is not too bad in fact although often in typography a `cartouche` contains not a general message but identifiers for example on subjects of a written examination at universities.

all for now.




---

** [bugs:#453] [DOC] generic "admonition" directive also listed as specific**

**Status:** open
**Created:** Wed Jul 27, 2022 09:53 AM UTC by jfbu
**Last Updated:** Thu Jul 28, 2022 05:08 PM UTC
**Owner:** nobody


I quite probably miss something obvious but [admonition directives documentation](https://docutils.sourceforge.io/docs/ref/rst/directives.html#admonitions) is not clear in so far as it lists "admonition" as a specific admonition type then describes it as being a generic type (which requires a title).


---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.