diff --git a/Documentation/Advanced/GuidelinesForImages.rst b/Documentation/Advanced/GuidelinesForImages.rst index f5defcd..99db9bf 100644 --- a/Documentation/Advanced/GuidelinesForImages.rst +++ b/Documentation/Advanced/GuidelinesForImages.rst @@ -13,7 +13,7 @@ For accessibility reasons **always** provide an alt text: .. literalinclude:: /_CodeSnippets/_Figure.rts.txt -More option for embedding images into ReST: :ref:`Images `. +More optional parameters for embedding images into ReST: :ref:`Images `. .. _guidelines-for-images-formats: @@ -21,7 +21,7 @@ Image formats ============= * It is recommended to use PNG for bitmaps (for example screenshots, photographs) - and SVG for vector graphics images. In any case, you can use .png. + and SVG for vector graphics images. In any case, you can use :file:`.png`. .. _guidelines-for-images-screenshot: .. _automatic-screenshots: @@ -32,7 +32,7 @@ Guidelines for screenshots .. note:: You can use the `The example screenshot project `_. It already follows most of the rules stated below. There has been no automatic - screenshot tool since TYPO3 v11 as it proved to be to complicated to maintain. + screenshot tool since TYPO3 v11 as it proved to be too complicated to maintain. * Before adding a screenshot consider if one is necessary. Each new screenshot requires maintenance. @@ -41,15 +41,15 @@ Guidelines for screenshots * Unless you want to demonstrate features of certain system extensions use a default installation as described in Getting Started: :ref:`Installing TYPO3 with DDEV `. -* If you need an example site package use `t3docs/site-package`. -* If you need example data use :composer:`t3docs/site-package-data` +* If you need an example site package use :composer:`t3docs/site-package`. +* If you need example data use :composer:`t3docs/site-package-data`. * As personalized usernames are considered best practice always use username - "j.doe" + "j.doe". * Do not install third party extensions unless what you want to demonstrate requires one. If possible use one of the extensions from vendor `typo3` or `t3docs`. -* use PNG or AVIF format (.png or .avif file ending) -* If you take a screenshot of a full page it should have 1400 x 1050 px +* Use PNG or AVIF format (:file:`.png` or :file:`.avif` file ending). +* If you take a screenshot of a full page it should have 1400 x 1050 px. * Use only parts of a full page when possible, the flatter the screenshot the less room it takes. * When reviewing screenshots take into consideration that taking screenshots