SF.net SVN: docutils:[9617 ] trunk/docutils/RELEASE-NO TES.txt

Revision: 9617
          http://sourceforge.net/p/docutils/code/9617
Author:   milde
Date:     2024-04-07 17:03:41 +0000 (Sun, 07 Apr 2024)
Log Message:
-----------
Announce change to specification of image dimensions without units in HTML5.

cf. [feature-requests:#102]

Fix announcements for 0.21rc1: <video> is supported for HTML5 since Docutils 0.17
(now also for HTML 4.1 but this is no important step so the HISTORY entry should suffice).

Modified Paths:
--------------
    trunk/docutils/RELEASE-NOTES.txt

Modified: trunk/docutils/RELEASE-NOTES.txt
===================================================================
--- trunk/docutils/RELEASE-NOTES.txt	2024-04-07 13:17:23 UTC (rev 9616)
+++ trunk/docutils/RELEASE-NOTES.txt	2024-04-07 17:03:41 UTC (rev 9617)
@@ -83,6 +83,20 @@
   - Change the default value for math_output_ to "MathML"
     in Docutils 0.22.
 
+  - Unitless image_ :width: and :hight: values and dimensions
+    read from the image due to a :scale: option will be written as
+    "width" and "hight" attributes instead of "style" rules to allow
+    specification of the aspect ratio to `prevent jank when loading
+    images`__ without overwriting an image size set in a CSS stylesheet
+    in Docutils 0.22 (cf.  `feature-requests:102`__).
+    The current behaviour is kept for dimensions with value, so
+    users may specify, e.g. ``:width: 50px`` instead of ``:width: 50``
+    to override CSS stylesheet rules.
+
+    __ https://developer.mozilla.org/en-US/docs/Learn/Performance/Multimedia
+       #rendering_strategy_preventing_jank_when_loading_images
+    __ https://sourceforge.net/p/docutils/feature-requests/102/
+
   - Change the default value of the initial_header_level_ setting to None
     (<h2> if there is a document title, else <h1>) in Docutils 1.0.
 
@@ -230,8 +244,6 @@
 
     Embed SVG images as ``<svg>`` instead of data-URI.
 
-    Support video inclusion via ``<video>``.
-
   manpage:
     Use .EE/.EX macros for literal blocks.
 
@@ -1146,9 +1158,9 @@
   __ docs/ref/rst/directives.html#title
   __ docs/ref/rst/directives.html#date
 
-* Length units are now supported for image__ sizes.
+* Length units are now supported for image_ sizes.
 
-  __ docs/ref/rst/directives.html#image
+  .. _image: docs/ref/rst/directives.html#image
 
 * Added `standard definition files`__ for special characters etc.
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.



_______________________________________________
Docutils-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/docutils-checkins