Skip to content

Commit ae565a7

Browse files
authored
Update translations
1 parent 05fb929 commit ae565a7

File tree

285 files changed

+6097
-6201
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

285 files changed

+6097
-6201
lines changed

src/content/docs/de/_roundtrip_breakpoints.txt

+17-19
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,42 @@
11
---
2+
taskInputHash: 3d8283d38a166afd
23
title: Breakpoints & Images
34
description: Why some (but not all) breakpoints are important for your images
4-
taskInputHash: 57ab72e7e951b197
5+
date_published: '2025-02-07'
6+
date_modified: '2025-02-07'
57
lang: en
6-
ignore: '/* cSpell:locale de,en*/'
7-
date_published: '2023-03-26'
8-
date_modified: '2023-03-31'
9-
date_updated: '2023-03-31'
108
---
119
### Background
1210

13-
Small screens and big monitors require different layouts. For `srcset` and `sizes`, we need to know when the layout changes.
11+
Small screens and large monitors require different layouts. For the purpose of `srcset` and `sizes`, we need to know at what point the layout changes.
1412

15-
Web developers need to decide what should be scaled down, hidden, or moved on smaller screens - or decide what should be expanded, revealed, or added on larger screens. They also have very little information available. Is the user on a tablet or phone in landscape mode or in a small browser window?
13+
Web developers need to decide what should be scaled down, hidden, or repositioned on smaller screens or more often, what should be expanded, revealed, or added on larger screens. They have very little information to base this on. Is the user on a tablet or a phone in landscape mode or in a small browser window?
1614

17-
We have to choose an arbitrary viewport width at which the layout changes. This is called a **breakpoint**. It can be any number of CSS pixels ([not device pixels](/en/pixels-not-pixels)). Polypane has a [great article](https://polypane.app/blog/the-breakpoints-we-tested-in-2021-and-the-ones-to-test-in-2022/#the-breakpoints-to-develop-on-in-2023) on commonly used breakpoints.
15+
We need to choose an arbitrary viewport width where the layout changes. This is called a **breakpoint**. It is an arbitrary number of CSS pixels ([not device pixels](/de/pixels-not-pixels)). Polypane has a [great article](https://polypane.app/blog/the-breakpoints-we-tested-in-2021-and-the-ones-to-test-in-2022/#the-breakpoints-to-develop-on-in-2023) about commonly used breakpoints.
1816

19-
Some images (like logos, icons, or buttons) can be immune to the layout shifts caused by these breakpoints (and are okay with [srcset density descriptors](/en/density-descriptors)).
17+
Some images (such as logos, icons, or buttons) might be immune to the layout shifts caused by these breakpoints (and do well with [srcset density descriptors](/de/density-descriptors)).
2018

21-
Main content images are limited by the size of their container. Typically, the main area of a page layout is constrained to a specific width, a `max-width`, on the largest screens, but on small screens the main content area fills the entire viewport.
19+
Main content images are constrained by the size of their container. Typically, the main content area of a page is restricted to a specific width, a `max-width`, on the largest screens, but on smaller screens, the main content area will fill the entire viewport.
2220

23-
When you have more than one column at some breakpoints, it becomes difficult to compute the effective size rules because the percentage of viewport width taken up by the image changes.
21+
If you have more than one column at certain breakpoints, it becomes harder to calculate the effective sizes rules because the percentage of the viewport width that the image occupies will change.
2422

25-
### The easy way
23+
### The Simple Method
2624

27-
That doesn't mean you should smash your head against the wall. You will likely get very far with the following approach:
25+
That said, don't overthink this. You will likely be very satisfied with the following approximation:
2826

29-
1. At what size does the main column (or the container of the image) stop growing? Until that viewport width, we can use `100vw` for the `sizes` attribute of the image to indicate that the image takes up 100% of the viewport width.
30-
2. What is the maximum width the container will ever be? We can set that as a fixed `width` for everything else.
27+
1. At what size does the main column (or the image's container) stop growing? Up to this viewport width, we can use `100vw` for the `sizes` attribute of the image to say that the image takes up 100% of the viewport width.
28+
2. What is the maximum width that this container ever reaches? We can set this as a fixed `width` for everything else.
3129

32-
If your answer to 1 is 700px and your answer to 2 is 800px, you can use the following `sizes` attribute:
30+
If your answer to 1 was 700px and your answer to 2 was 800px, you can use the following `sizes` attribute:
3331

3432
```html
3533
<!-- These are CSS pixels, not device pixels or image pixels. -->
3634
<img [...] sizes="(max-width: 700px) 100vw, 800px" />
3735
```
3836

37+
> One might think that the browser could wonderfully carry out all these calculations for us based on the CSS. Unfortunately, browsers are impressively eager to choose an image URL *before* downloading the stylesheets. Therefore, we must perform the calculations ourselves, and it's just as well if we don't get it perfect.
3938

40-
41-
> You would think that the browser could kindly do all these calculations for us based on the CSS. Unfortunately, browsers are aggressively trying to choose an image URL *before* downloading stylesheets. So we have to do the calculations ourselves. And if we're not perfect, that's their problem.
39+
{{Clumsy phrasing: "and it's just as well if we don't get it perfect." could be clearer if phrased more directly, such as "and if we don't get it perfect, it's understandable."}}
4240
=====================
4341

4442
Content prompt used:
@@ -52,7 +50,7 @@ Also carefully translate the title and description for the article; do not use &
5250
2. Why some (but not all) breakpoints matter for your images
5351

5452
Metadata returned1. Breakpoints & Bilder
55-
2. Warum manche (aber nicht alle) Breakpoints wichtig für Ihre Bilder sind
53+
2. Warum einige (aber nicht alle) Breakpoints für Ihre Bilder wichtig sind
5654

5755

5856
Roundtrip (isolated) prompt used:

src/content/docs/de/_roundtrip_browser-picks-srcset.txt

+30-25
Original file line numberDiff line numberDiff line change
@@ -1,67 +1,72 @@
11
---
2-
title: How the Browser selects
3-
description: How the browser selects between images listed in the "srcset" attribute
4-
taskInputHash: 21fa78dd27583003
2+
taskInputHash: 3cf5b3ab39ae8310
3+
title: How the Browser Chooses
4+
description: How the browser chooses between images listed in the srcset attribute
5+
date_published: '2025-02-07'
6+
date_modified: '2025-02-07'
57
lang: en
68
---
7-
How does the browser select between images listed in the "srcset" attribute? Here is a step-by-step guide with examples for both width and density descriptors and how the browser decides based on the device and viewport.
9+
How does the browser choose between the images listed in the `srcset` attribute? Here is a step-by-step guide with examples for both width and density specifications and how the browser decides based on the device and viewport.
810

9-
- When using the "srcset" attribute in HTML, the browser uses a set of rules to select the most suitable image from a list of provided sources. These rules depend on both the display characteristics of the device (resolution, pixel density) and the size of the viewport. The "srcset" attribute allows you to specify different images based on width (using the "w" descriptor) or pixel density (using the "x" descriptor). Let's go through examples for both cases.
11+
- When using the `srcset` attribute in HTML, the browser uses a set of rules to choose the most appropriate image from a list of provided sources. These rules depend on both the display characteristics of the device (resolution, pixel density) and the viewport size. The `srcset` attribute allows you to specify different images based on width (using the `w` descriptor) or pixel density (using the `x` descriptor). Let's go through each case with examples.
1012

11-
1. Width descriptor ("w"):
13+
1\. Width Descriptor (`w`):
1214

13-
Assuming we have the following "srcset" attribute:
15+
Suppose we have the following `srcset` attribute:
1416

1517
```html
1618

17-
<img src="example-small.jpg" srcset="example-small.jpg 400w, example-medium.jpg 800w, example-large.jpg 1600w" alt="Example image">
19+
<img src="example-small.jpg" srcset="example-small.jpg 400w, example-medium.jpg 800w, example-large.jpg 1600w" alt="Example Image">
1820

1921
```
2022

21-
The browser will perform the following steps:
23+
The browser follows these steps:
2224

23-
a. Determine the DPR (Device Pixel Ratio) of the device. For instance, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
25+
a. Determine the DPR (Device Pixel Ratio) of the device. For example, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
2426

25-
b. Calculate the effective width for each image in the "srcset". Multiply the width descriptor by the DPR. For a device with a DPR of 1:
27+
b. Calculate the effective width for each image in the `srcset`. Multiply the width descriptor by the DPR. For a device with a DPR of 1:
2628

27-
- example-small.jpg: 400 * 1 = 400px
29+
- example-small.jpg: 400 \* 1 = 400px
2830

29-
- example-medium.jpg: 800 * 1 = 800px
31+
- example-medium.jpg: 800 \* 1 = 800px
3032

31-
- example-large.jpg: 1600 * 1 = 1600px
33+
- example-large.jpg: 1600 \* 1 = 1600px
3234

33-
c. Compare the effective widths to the viewport width. Assuming the viewport width is 420px, the browser selects the smallest image whose effective width is greater than or equal to the viewport width. In this case, "example-medium.jpg" is selected.
35+
c. Compare the effective widths with the viewport width. Suppose the viewport width is 420px. The browser selects the smallest image with an effective width that is greater than or equal to the viewport width. In this case, it chooses `example-medium.jpg`.
3436

35-
2. Density descriptor ("x"):
37+
1\. Pixel Density Descriptor (`x`):
3638

37-
Assuming we have the following "srcset" attribute:
39+
Suppose we have the following `srcset` attribute:
3840

3941
```html
4042

41-
<img src="example-1x.jpg" srcset="example-1x.jpg 1x, example-2x.jpg 2x, example-3x.jpg 3x" alt="Example image">
43+
<img src="example-1x.jpg" srcset="example-1x.jpg 1x, example-2x.jpg 2x, example-3x.jpg 3x" alt="Example Image">
4244

4345
```
4446

45-
The browser will perform the following steps:
47+
The browser follows these steps:
4648

47-
a. Determine the DPR (Device Pixel Ratio) of the device. For instance, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
49+
a. Determine the DPR (Device Pixel Ratio) of the device. For example, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
4850

49-
b. Compare the device's DPR with the "x" descriptors in the "srcset". In this case, we have three images with the following descriptors:
51+
b. Compare the DPR of the device with the `x` descriptors in the `srcset`. In this case, we have three images with the following descriptors:
5052

5153
- example-1x.jpg: 1x
5254

5355
- example-2x.jpg: 2x
5456

5557
- example-3x.jpg: 3x
5658

57-
c. Select the image with the "x" descriptor closest to the device's DPR. For a device with a DPR of 1, the browser selects "example-1x.jpg". For a device with a DPR of 2, it selects "example-2x.jpg", and so on.
59+
c. Choose the image with the `x` descriptor that most closely matches the DPR of the device. For a device with a DPR of 1, the browser selects `example-1x.jpg`. For a device with a DPR of 2, it selects `example-2x.jpg` and so on.
5860

59-
It is important to note that you can also use the "sizes" attribute in combination with the "srcset" attribute to provide further information on how the image should display at different viewport widths. This is particularly useful when using the width descriptor ("w"). Here is an example:
61+
It is important to note that you can use the `sizes` attribute in combination with the `srcset` attribute to provide more information about how the image will be displayed at different viewport widths. This is especially useful when using the width descriptor (`w`). Here is an example:
6062

6163
```html
6264

6365
<img src="example-small.jpg" srcset="example-small.jpg 400w, example-medium.jpg 800w, example-large.jpg 1600w" sizes="(max-width: 480px) 100vw, (max-width: 960px) 50vw,
6466

67+
```
68+
69+
{{The original German text doesn't specifically mention any ambiguity or clumsy phrasing that would require corrective inputs in English. The document seems to follow logical and clear instructions in the technical language. However, there is an unfinished example in the last block of code snippets; it ends abruptly suggesting more content was intended but not provided.}}
6570
=====================
6671

6772
Content prompt used:
@@ -74,8 +79,8 @@ Also carefully translate the title and description for the article; do not use &
7479
1. How the browser chooses
7580
2. How the browser chooses between images listed in the srcset attribute
7681

77-
Metadata returned1. Wie der Browser auswählt
78-
2. Wie der Browser zwischen Bildern im "srcset"-Attribut auswählt
82+
Metadata returned1. Wie der Browser wählt
83+
2. Wie der Browser zwischen den im srcset-Attribut aufgelisteten Bildern wählt
7984

8085

8186
Roundtrip (isolated) prompt used:

src/content/docs/de/_roundtrip_density-descriptors.txt

+25-25
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,33 @@
11
---
2-
title: Density descriptors and srcset
3-
description: Examples of using density descriptors in `srcset`
4-
taskInputHash: 0a85d4f28fee785a
2+
taskInputHash: 8188e69e4133ac64
3+
title: Density Descriptions and Srcset
4+
description: Examples of using density descriptions in `srcset`
5+
date_published: '2025-02-07'
6+
date_modified: '2025-02-07'
57
lang: en
6-
ignore: '/* cSpell:locale de,en*/'
7-
date_published: '2023-03-26'
8-
date_modified: '2023-03-31'
9-
date_updated: '2023-03-31'
108
---
11-
Srcset with density descriptors provides a simple and effective method for delivering the most appropriate image for each user's device, improving performance and user experience. This guide will take you through the basics of using srcset with density descriptors and provide markup examples for your convenience.
9+
Srcset with density descriptions offers a simple and effective method to deliver the most suitable image to each user device, thereby enhancing performance and user experience. This guide will walk you through the basics of using srcset with density descriptions and provide you with markup examples.
1210

13-
## What is srcset with density descriptors?
11+
## What is Srcset with Density Descriptions?
1412

15-
Srcset is an HTML attribute that allows you to specify multiple image sources for a single `<img>` element. Density descriptors (`x`) are used in conjunction with srcset to provide images at different resolutions based on the pixel density of the user's display.
13+
Srcset is an HTML attribute that allows you to specify multiple image sources for a single `<img>` element. Density descriptions (`x`) are used along with Srcset to provide images of different resolutions based on the pixel density of the user's screen.
1614

17-
## When to use srcset with density descriptors?
15+
## When to Use Srcset with Density Descriptions?
1816

19-
Using srcset with density descriptors is especially useful when you:
20-
1. Want to provide high resolution images for high DPI displays (e.g. Retina displays) while using lower resolutions for standard displays.
21-
2. Want to improve page rendering by providing the most appropriate image size for each user's device.
17+
Using Srcset with density descriptions is particularly useful when you:
18+
1. Want to deliver high-resolution images to displays with high DPI (e.g., Retina displays) while providing standard resolution images to standard displays.
19+
2. Want to improve page performance by providing the image size that is most suitable for the user's device.
2220

23-
## Implementing srcset with density descriptors
21+
## Implementing Srcset with Density Descriptions
2422

25-
To use srcset with density descriptors, follow these steps:
23+
To use Srcset with density descriptions, follow these steps:
2624
1. Prepare your images in different resolutions.
27-
2. Add the `srcset` attribute to the `<img>` element, including the image sources and corresponding density descriptors.
28-
3. Optionally, add the `sizes` attribute to set the size of the image on the screen.
25+
2. Add the `srcset` attribute to the `<img>` element, including the image sources and the corresponding density descriptions.
26+
3. Add the `sizes` attribute (optional) to set the size of the image as it appears on screen.
2927

30-
### Markup example
28+
### Markup Example
3129

32-
Here is an example of how to implement srcset with density descriptors in your markup:
30+
Here is an example of how you can implement Srcset with density descriptions in your markup:
3331

3432
```html
3533
<img src="example-image-1x.jpg"
@@ -38,11 +36,13 @@ Here is an example of how to implement srcset with density descriptors in your m
3836
```
3937

4038
This markup example includes:
41-
- **src**: The default image source to be displayed when the browser does not support srcset.
42-
- **srcset**: The list of image sources and their density descriptors (1x, 2x, 3x). The browser chooses the most appropriate image based on the user's display.
39+
- **src**: The default image source that is displayed if the browser does not support srcset.
40+
- **srcset**: The list of image sources and their density descriptions (1x, 2x, 3x). The browser selects the most suitable image based on the user's display.
4341
- **alt**: A description of the image for accessibility purposes.
4442

45-
And that's it! You have successfully implemented srcset with density descriptors, improving the performance and user experience of your website.
43+
And that's it! You have successfully implemented Srcset with density descriptions, improving your website's performance and user experience.
44+
45+
{{No mistakes or awkward phrasing were detected in this translation.}}
4646
=====================
4747

4848
Content prompt used:
@@ -55,8 +55,8 @@ Also carefully translate the title and description for the article; do not use &
5555
1. Density descriptors & srcset
5656
2. Examples of using density descriptors in `srcset`
5757

58-
Metadata returned1. Density-Descriptoren und Srcset
59-
2. Beispiele für die Verwendung von Density-Descriptoren in `srcset`
58+
Metadata returned1. Dichtebeschreibungen und Srcset
59+
2. Beispiele für die Verwendung von Dichtebeschreibungen in `srcset`
6060

6161

6262
Roundtrip (isolated) prompt used:

0 commit comments

Comments
 (0)