Merge branch '6.0' into add-related-content

Author: Manik-Khajuria-5

docs/_static/images-test/examples.png

@@ -61,7 +61,7 @@ minions = RelationList(
 )
 ```
 
-We can see that the [code for the behavior `IRelatedItems`](https://github.com/plone/plone.app.relationfield/blob/master/plone/app/relationfield/behavior.py) does exactly the same thing.
+We can see that the [code for the behavior `IRelatedItems`](https://github.com/plone/plone.app.relationfield/blob/master/src/plone/app/relationfield/behavior.py) does exactly the same thing.
 
 
 (relations-controlling-relation-targets-label)=

docs/_static/images-test/image-srcset.png

@@ -382,6 +382,6 @@ Here is a list of helpful references on the topic of porting Python 2 to Python
 -   https://eev.ee/blog/2016/07/31/python-faq-how-do-i-port-to-python-3/
 -   https://diveintopython3.net/
 -   https://docs.djangoproject.com/en/1.11/topics/python3/
--   https://docs.ansible.com/ansible/latest/dev_guide/developing_python_3.html
+-   https://docs.ansible.com/projects/ansible/latest/dev_guide/developing_python_3.html
 -   https://docs.python.org/2/library/doctest.html#debugging
 ```

docs/_static/images-test/images-test.png

@@ -624,7 +624,7 @@ You can set the template used by the widget with the `<z3c:widgetTemplate>` ZCML
 ### Widget frame override
 
 You can override widget templates as instructed for `z3c.form`.
-`plone.app.z3cform` renders [a frame around each widget](https://github.com/plone/plone.app.z3cform/blob/master/plone/app/z3cform/templates/widget.pt), which usually consists of:
+`plone.app.z3cform` renders [a frame around each widget](https://github.com/plone/plone.app.z3cform/blob/master/src/plone/app/z3cform/templates/widget.pt), which usually consists of:
 
 -   Label
 -   Required marker
@@ -633,7 +633,7 @@ You can override widget templates as instructed for `z3c.form`.
 You might want to customize this widget frame for your own form.
 Below is an example of how to do it.
 
-Copy [`widget.pt`](https://github.com/plone/plone.app.z3cform/blob/master/plone/app/z3cform/templates/widget.pt) to your own package, rename it as `demo-widget.pt`, and edit it.
+Copy [`widget.pt`](https://github.com/plone/plone.app.z3cform/blob/master/src/plone/app/z3cform/templates/widget.pt) to your own package, rename it as `demo-widget.pt`, and edit it.
 
 Then add the following code to `configure.zcml`.
 Remember to fix the path of the template according to your own paths.

docs/_static/images-test/picture-tags.png

@@ -174,7 +174,7 @@ In the template, you can use the following variables:
 Dexterity content types come with default add and edit forms.
 You can build custom add and edit forms to adjust their behavior.
 
-The implementation of the default edit and add forms is in [`plone.dexterity.browser.edit.py`](https://github.com/plone/plone.dexterity/blob/master/plone/dexterity/browser/edit.py) and [`plone.dexterity.browser.add.py`](https://github.com/plone/plone.dexterity/blob/master/plone/dexterity/browser/add.py).
+The implementation of the default edit and add forms is in [`plone.dexterity.browser.edit.py`](https://github.com/plone/plone.dexterity/blob/master/src/plone/dexterity/browser/edit.py) and [`plone.dexterity.browser.add.py`](https://github.com/plone/plone.dexterity/blob/master/src/plone/dexterity/browser/add.py).
 
 ```{todo}
 Describe Add/Edit forms here and how to customize them.

docs/backend/relations.md

@@ -248,7 +248,7 @@ To scale an image, you can use the `mode` parameter to control the scaling outpu
 You must use either `width` or `height`, or both.
 
 Three different scaling options are supported.
-They correspond to the CSS [`background-size`](https://developer.mozilla.org/en-US/docs/Web/CSS/background-size) values.
+They correspond to the CSS [`background-size`](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/background-size) values.
 
 The possible options for `mode` are listed below, where the default option is `scale`.
 
@@ -272,6 +272,92 @@ The possible options for `mode` are listed below, where the default option is `s
 
     Deprecated option names: `scale-crop-to-fill`, `up`.
 
+### Images test rendering
+
+Plone's Classic UI includes special demonstration views that render ready-made examples of image handling and responsive image components using your site's active theme.
+These views help developers verify image scaling, `srcset` generation, and explore available image optimization patterns.
+These views work on image content types, including images and documents with images.
+
+Append the view name `/@@images-test` to an image URL, optionally followed by an anchor, such as `#srcset`, for specific sections.
+You must be authenticated as a site admin to view this demo.
+
+For example, on the Classic UI demo site, the URL would be https://classic.demo.plone.org/en/demo/an-image.jpg/@@images-test#srcset.
+
+````{card}
+```{image} /_static/images-test/images-test.png
+:alt: Images test view
+:target: /_static/images-test/images-test.png
+```
++++
+_Images test view_
+````
+
+The view displays the following examples, all rendered with the current settings in `/@@imaging-controlpanel`.
+
+Standard image scales
+:   Shows the Classic UI Plone scales with different modes:
+    -   Mini
+    -   Mini mode=cover
+    -   Mini mode=contain
+
+    ````{card}
+    ```{image} /_static/images-test/examples.png
+    :alt: Example standard image scales
+    :target: /_static/images-test/examples.png
+    ```
+    +++
+    _Example standard image scales_
+    ````
+
+Picture tags
+:   Demonstrates the use of `<picture>` elements with configured picture variants.
+    If the site runs on Plone 5.2 or earlier, a regular `<img>` tag is rendered instead.
+
+    Picture Tag Large
+    :   uses the configured `large` picture variant
+
+    Picture Tag Medium
+    :   uses the `medium` variant with multiple `<source>` elements and media queries for art direction
+
+    Picture Tag Small
+    :   uses the `small` variant
+
+    Picture Tag Small with title/alt
+    :   same as the previous, but with `title` and `alt` attributes explicitly set
+
+````{card}
+```{image} /_static/images-test/picture-tags.png
+:alt: Picture tags
+:target: /_static/images-test/picture-tags.png
+```
++++
+_Picture tags_
+````
+
+`img` with `srcset` attributes
+:   Shows how to use Plone’s `@@images` view to generate a full responsive `<img>` tag with a complete `srcset`.
+    The browser automatically selects the most appropriate scale based on the available space and device pixel ratio.
+    The example includes the required `sizes` attribute and demonstrates the resulting HTML output.
+    
+    ```{seealso}
+    {ref}`classic-ui-images-responsive-image-support`
+    ```
+
+````{card}
+```{image} /_static/images-test/image-srcset.png
+:alt: img with srcset attributes
+:target: /_static/images-test/image-srcset.png
+```
++++
+_img with srcset attributes_
+````
+
+```{seealso}
+{ref}`classic-ui-images-responsive-image-support`
+```
+
+This view is especially valuable for theme developers who need to verify that responsive images, picture variants, and `srcset` functionality are correctly styled and behave as expected across devices and Plone versions.
+
 
 (classic-ui-images-permissions-label)=
 
@@ -286,7 +372,7 @@ To access image scales, which are normally not accessible to the current user, o
 ## Responsive image support
 
 Plone supports the generation of [`picture`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/picture) tags with `srcset`s for image optimization.
-Additionally, you can define [media queries](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_media_queries/Using_media_queries) for [art direction](classic-ui-images-responsive-image-support-art-direction) and further optimization.
+Additionally, you can define [media queries](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Media_queries/Using) for [art direction](classic-ui-images-responsive-image-support-art-direction) and further optimization.
 
 The configuration allows you to define different `picture` variants, such as `Large`, `Medium`, or `Small`.
 Users can choose from them in editors, such as TinyMCE, and developers can use them in templates.

docs/backend/upgrading/version-specific-migration/upgrade-to-python3.md

@@ -11,7 +11,7 @@ myst:
 
 # CSS custom properties
 
-This chapter describes the [CSS custom properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_cascading_variables/Using_CSS_custom_properties) used in Bootstrap and customized by Classic UI themes.
+This chapter describes the [CSS custom properties](https://developer.mozilla.org/en-US/docs/Web/CSS/Guides/Cascading_variables/Using_custom_properties) used in Bootstrap and customized by Classic UI themes.
 Custom properties (sometimes referred to as CSS variables or cascading variables) are entities defined by CSS authors that represent specific values to be reused throughout a document.