Skip to content

Commit 5832d03

Browse files
delucisdelucis
authored
Merge branch 'main' into i18n-pt-br
2 parents 3c011f0 + a6d1681 commit 5832d03

69 files changed

Lines changed: 7420 additions & 659 deletions

File tree

Some content is hidden

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

‎.changeset/short-mirrors-happen.md‎

Lines changed: 0 additions & 5 deletions
This file was deleted.

.github/ISSUE_TEMPLATE/---02-feature-request.yml renamed to .github/DISCUSSION_TEMPLATE/feature-requests.yml

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,3 @@
1-
name: Feature Request
2-
description: Suggest an improvement you’d like to see added to Starlight
3-
labels: []
4-
assignees: []
51
body:
62
- type: markdown
73
attributes:
@@ -46,5 +42,5 @@ body:
4642
label: Participation
4743
description: Let us know if your interested in contributing this feature yourself.
4844
options:
49-
- label: I am willing to submit a pull request for this issue.
45+
- label: I am willing to submit a pull request for this feature.
5046
required: false

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
blank_issues_enabled: false
22
contact_links:
3+
- name: 💡 Feature Request
4+
url: https://github.com/withastro/starlight/discussions/new?category=feature-requests
5+
about: Suggest an improvement you’d like to see added to Starlight
36
- name: 👾 Chat
47
url: https://astro.build/chat
58
about: Our Discord server is active, come join us!

‎docs-i18n-tracker/lib/translation-status/builder.ts‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -253,10 +253,13 @@ export class TranslationStatusBuilder {
253253
subpath: string;
254254
query?: string;
255255
}) {
256+
// this is a hack to get the correct URL for the docs repo
257+
// like zh-CN -> zh-cn pt-BR -> pt-br
258+
const lowerLang = lang.toLowerCase();
256259
const noDotSrcDir = this.pageSourceDir.replace(/^\.+\//, '');
257260
const isSrcLang = lang === this.sourceLanguage;
258261
return `https://github.com/${this.githubRepo}/${type}/${refName}/${noDotSrcDir}${
259-
isSrcLang ? '' : `/${lang}`
262+
isSrcLang ? '' : `/${lowerLang}`
260263
}/${subpath}${query}`;
261264
}
262265

‎docs/astro.config.mjs‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -110,7 +110,7 @@ export default defineConfig({
110110
label: 'Environmental Impact',
111111
link: 'environmental-impact',
112112
translations: {
113-
// de: '',
113+
de: 'Umweltbelastung',
114114
es: 'Documentación ecológica',
115115
ja: '環境への負荷',
116116
fr: 'Impact environnemental',
@@ -127,7 +127,7 @@ export default defineConfig({
127127
label: 'Showcase',
128128
link: 'showcase',
129129
translations: {
130-
// de: '',
130+
de: 'Schaufenster',
131131
// es: '',
132132
ja: 'ショーケース',
133133
fr: 'Vitrine',
@@ -148,7 +148,7 @@ export default defineConfig({
148148
ja: 'ガイド',
149149
fr: 'Guides',
150150
it: 'Guide',
151-
id: 'Petunjuk Penggunaan',
151+
id: 'Panduan',
152152
'zh-CN': '指南',
153153
'pt-BR': 'Guias',
154154
ko: '가이드',

‎docs/src/assets/showcase/folksrouter.io.png‎

23.1 KB
Loading

‎docs/src/components/showcase-sites.astro‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,4 +64,5 @@ import FluidGrid from './fluid-grid.astro';
6464
href="https://ai-prompt-snippets.vercel.app/"
6565
thumbnail="ai-prompt-snippets.png"
6666
/>
67+
<Card title="Folks Router" href="https://folksrouter.io/" thumbnail="folksrouter.io.png" />
6768
</FluidGrid>

‎docs/src/components/theme-designer/preview.astro‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ const codeBg = light ? '--sl-color-gray-6' : '--sl-color-gray-5';
2121
<div class="preview-card" {...attrs}>
2222
<h4>{light ? labels.lightMode : labels.darkMode}</h4>
2323
<p>
24-
{labels.bodyText}
25-
<span class="link" style={`color:var(${linkColor})`}>{labels.linkText}</span>
26-
<span class="dim">{labels.dimText}</span>
24+
{labels.bodyText}{' '}
25+
<span class="link" style={`color:var(${linkColor})`}>{labels.linkText}</span>{' '}
26+
<span class="dim">{labels.dimText}</span>{' '}
2727
<code style={`--sl-color-bg-inline-code:var(${codeBg})`}>{labels.inlineCode}</code>
2828
</p>
2929
<Palette {light} />

‎docs/src/content/docs/de/environmental-impact.md‎

Lines changed: 140 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,140 @@
1+
---
2+
title: Umweltfreundliche Dokumente
3+
description: Erfahre, wie Starlight dir helfen kann, umweltfreundlichere Dokumentationen zu erstellen und deinen ökologischen Fußabdruck zu verringern.
4+
---
5+
6+
Schätzungen über die Auswirkungen der Webindustrie auf das Klima liegen zwischen [2 %][sf] und [4 % der weltweiten Kohlenstoffemissionen][bbc], was in etwa den Emissionen der Luftfahrtindustrie entspricht.
7+
Es gibt viele komplexe Faktoren bei der Berechnung der ökologischen Auswirkungen einer Website, aber dieser Leitfaden enthält einige Tipps, wie du den ökologischen Fußabdruck deiner Docs-Website verringern kannst.
8+
9+
Die gute Nachricht ist, dass die Wahl von Starlight ein guter Anfang ist.
10+
Laut dem Website Carbon Calculator ist diese Website [sauberer als 99 % der getesteten Websiten][sl-carbon] und erzeugt 0,01g CO₂ pro Seitenbesuch.
11+
12+
## Seitengewicht
13+
14+
Je mehr Daten eine Website überträgt, desto mehr Energieressourcen benötigt sie.
15+
Im April 2023 musste ein Nutzer laut [Daten aus dem HTTP-Archiv][http] für die durchschnittliche Website mehr als 2.000 KB herunterladen.
16+
17+
Starlight erstellt Seiten, die so leicht wie möglich sind.
18+
So lädt ein Benutzer beim ersten Besuch weniger als 50 KB an komprimierten Daten herunter - nur 2,5 % des Medianwerts des HTTP-Archivs.
19+
Mit einer guten Caching-Strategie können nachfolgende Besuche sogar nur 10 KB herunterladen.
20+
21+
### Bilder
22+
23+
Während Starlight eine gute Grundlage bietet, können Bilder, die du deinen Dokumentseiten hinzufügst, das Seitengewicht schnell erhöhen.
24+
Starlight nutzt die [optimierte Asset-Unterstützung][Assets] von Astro, um lokale Bilder in deinen Markdown- und MDX-Dateien zu optimieren.
25+
26+
### UI-Komponenten
27+
28+
Komponenten, die mit UI-Frameworks wie React oder Vue erstellt wurden, können leicht große Mengen an JavaScript zu einer Seite hinzufügen.
29+
Da Starlight auf Astro aufbaut, laden Komponenten wie diese dank [Astro Islands][islands] standardmäßig **kein clientseitiges JavaScript**.
30+
31+
### Caching
32+
33+
Caching wird verwendet, um zu kontrollieren, wie lange ein Browser Daten speichert und wiederverwendet, die er bereits heruntergeladen hat.
34+
Eine gute Caching-Strategie stellt sicher, dass ein Benutzer neue Inhalte so schnell wie möglich erhält, wenn sich diese ändern, vermeidet aber auch, dass derselbe Inhalt unnötigerweise immer wieder heruntergeladen wird, wenn er sich nicht geändert hat.
35+
36+
Die gebräuchlichste Art, das Zwischenspeichern zu konfigurieren, ist der [`Cache-Control` HTTP-Header][cache].
37+
Wenn du Starlight verwendest, kannst du eine lange Cache-Zeit für alles im Verzeichnis `/_astro/` einstellen.
38+
Dieses Verzeichnis enthält CSS, JavaScript und andere gebündelte Inhalte, die sicher für immer zwischengespeichert werden können, wodurch unnötige Downloads vermieden werden:
39+
40+
```
41+
Cache-Control: public, max-age=604800, immutable
42+
```
43+
44+
Wie du das Caching konfigurierst, hängt von deinem Webhost ab. Zum Beispiel wendet Vercel diese Caching-Strategie für dich an, ohne dass eine Konfiguration erforderlich ist, während du [benutzerdefinierte Header für Netlify][ntl-headers] einstellen kannst, indem du eine `public/_headers`-Datei zu deinem Projekt hinzufügst:
45+
46+
```
47+
/_astro/*
48+
Cache-Control: public
49+
Cache-Control: max-age=604800
50+
Cache-Control: immutable
51+
```
52+
53+
[cache]: https://csswizardry.com/2019/03/cache-control-for-civilians/
54+
[ntl-headers]: https://docs.netlify.com/routing/headers/
55+
56+
## Stromverbrauch
57+
58+
Die Art und Weise, wie eine Website aufgebaut ist, kann sich auf den Stromverbrauch auswirken, den sie auf dem Gerät des Benutzers benötigt.
59+
Durch die Verwendung von minimalem JavaScript reduziert Starlight die Rechenleistung, die das Telefon, Tablet oder der Computer eines Nutzers zum Laden und Rendern von Seiten benötigt.
60+
61+
Sei jedoch vorsichtig, wenn du Funktionen wie analytische Tracking-Skripte oder JavaScript-lastige Inhalte wie Videoeinbettungen hinzufügst, da diese den Stromverbrauch der Seite erhöhen können.
62+
Wenn du Analysen benötigst, solltest du eine schlanke Option wie [Cabin][cabin], [Fathom][fathom] oder [Plausible][plausible] wählen.
63+
Einbettungen wie YouTube- und Vimeo-Videos können verbessert werden, indem man auf [Laden des Videos bei Benutzerinteraktion][lazy-video] wartet.
64+
Pakete wie [`astro-embed`][embed] können bei gängigen Diensten helfen.
65+
66+
:::tip[Wusstest du schon?]
67+
Das Parsen und Kompilieren von JavaScript ist eine der aufwändigsten Aufgaben, die ein Browser zu erledigen hat.
68+
Verglichen mit dem Rendern eines JPEG-Bildes derselben Größe kann die [Verarbeitung von JavaScript mehr als 30 Mal so lange dauern][cost-of-js].
69+
:::
70+
71+
[cabin]: https://withcabin.com/
72+
[fathom]: https://usefathom.com/
73+
[plausible]: https://plausible.io/
74+
[lazy-video]: https://web.dev/iframe-lazy-loading/
75+
[embed]: https://www.npmjs.com/package/astro-embed
76+
[cost-of-js]: https://medium.com/dev-channel/the-cost-of-javascript-84009f51e99e
77+
78+
## Hosting
79+
80+
Wo eine Website gehostet wird, kann einen großen Einfluss darauf haben, wie umweltfreundlich deine Dokumentationsseite ist.
81+
Rechenzentren und Serveranlagen können große ökologische Auswirkungen haben, einschließlich eines hohen Stromverbrauchs und eines intensiven Wasserverbrauchs.
82+
83+
Wenn du dich für einen Hoster entscheidest, der erneuerbare Energien einsetzt, wird deine Website weniger Kohlenstoffemissionen verursachen. Das [Green Web Directory][gwb] ist ein Tool, das dir helfen kann, Hosting-Unternehmen zu finden.
84+
85+
[gwb]: https://www.thegreenwebfoundation.org/directory/
86+
87+
## Vergleiche
88+
89+
Bist du neugierig, wie andere Docs-Frameworks im Vergleich abschneiden?
90+
Diese Tests mit dem [Website Carbon Calculator][wcc] vergleichen ähnliche Seiten, die mit verschiedenen Tools erstellt wurden.
91+
92+
| Framework | CO₂ pro Seitenaufruf |
93+
| --------------------------- | -------------------- |
94+
| [Starlight][sl-carbon] | 0.01g |
95+
| [VitePress][vp-carbon] | 0.05g |
96+
| [Docus][dc-carbon] | 0.05g |
97+
| [Sphinx][sx-carbon] | 0.07g |
98+
| [MkDocs][mk-carbon] | 0.10g |
99+
| [Nextra][nx-carbon] | 0.11g |
100+
| [docsify][dy-carbon] | 0.11g |
101+
| [Docusaurus][ds-carbon] | 0.24g |
102+
| [Read the Docs][rtd-carbon] | 0.24g |
103+
| [GitBook][gb-carbon] | 0.71g |
104+
105+
<small>Daten erhoben am 14. Mai 2023. Klicke auf einen Link, um aktuelle Zahlen zu sehen.</small>
106+
107+
[sl-carbon]: https://www.websitecarbon.com/website/starlight-astro-build-getting-started/
108+
[vp-carbon]: https://www.websitecarbon.com/website/vitepress-dev-guide-what-is-vitepress/
109+
[dc-carbon]: https://www.websitecarbon.com/website/docus-dev-introduction-getting-started/
110+
[sx-carbon]: https://www.websitecarbon.com/website/sphinx-doc-org-en-master-usage-quickstart-html/
111+
[mk-carbon]: https://www.websitecarbon.com/website/mkdocs-org-getting-started/
112+
[nx-carbon]: https://www.websitecarbon.com/website/nextra-site-docs-docs-theme-start/
113+
[dy-carbon]: https://www.websitecarbon.com/website/docsify-js-org/
114+
[ds-carbon]: https://www.websitecarbon.com/website/docusaurus-io-docs/
115+
[rtd-carbon]: https://www.websitecarbon.com/website/docs-readthedocs-io-en-stable-index-html/
116+
[gb-carbon]: https://www.websitecarbon.com/website/docs-gitbook-com/
117+
118+
## Weitere Ressourcen
119+
120+
### Werkzeuge
121+
122+
- [Website Carbon Calculator][wcc]
123+
- [GreenFrame](https://greenframe.io/)
124+
- [Ecograder](https://ecograder.com/)
125+
- [WebPageTest Kohlenstoffkontrolle](https://www.webpagetest.org/carbon-control/)
126+
- [Ecoping](https://ecoping.earth/)
127+
128+
### Artikel und Vorträge
129+
130+
- ["Building a greener web"](https://youtu.be/EfPoOt7T5lg), Vortrag von Michelle Barker
131+
- ["Sustainable Web Development Strategies Within An Organization"](https://www.smashingmagazine.com/2022/10/sustainable-web-development-strategies-organization/), Artikel von Michelle Barker
132+
- ["A sustainable web for everyone"](https://2021.stateofthebrowser.com/speakers/tom-greenwood/), Vortrag von Tom Greenwood
133+
- ["How Web Content Can Affect Power Usage"](https://webkit.org/blog/8970/how-web-content-can-affect-power-usage/), Artikel von Benjamin Poulain und Simon Fraser
134+
135+
[sf]: https://www.sciencefocus.com/science/what-is-the-carbon-footprint-of-the-internet/
136+
[bbc]: https://www.bbc.com/future/article/20200305-why-your-internet-habits-are-not-as-clean-as-you-think
137+
[http]: https://httparchive.org/reports/state-of-the-web
138+
[assets]: https://docs.astro.build/en/guides/assets/
139+
[islands]: https://docs.astro.build/en/concepts/islands/
140+
[wcc]: https://www.websitecarbon.com/

‎docs/src/content/docs/de/getting-started.mdx‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,7 @@ yarn create astro --template starlight
3838
</TabItem>
3939
</Tabs>
4040

41-
Damit wird ein neues [Projektverzeichnis](/de/guides/project-structure/) mit allen erforderlichen Dateien und Konfigurationen für deine Webseite erstellt.
41+
Damit wird ein neues [Projektverzeichnis](/de/guides/project-structure/) mit allen erforderlichen Dateien und Konfigurationen für deine Website erstellt.
4242

4343
:::tip[In Aktion sehen]
4444
Probiere Starlight in deinem Browser aus:
@@ -55,7 +55,7 @@ Starlight unterstützt das Erstellen von Inhalten in Markdown und MDX. (Du kanns
5555

5656
### Seiten hinzufügen
5757

58-
Füge neue Seiten zu deiner Webseite automatisch hinzu, indem du `.md` oder `.mdx` Dateien in `src/content/docs/` erstellst. Erstelle Unterordner, um deine Dateien zu organisieren und mehrere Pfadsegmente zu erstellen:
58+
Füge neue Seiten zu deiner Website automatisch hinzu, indem du `.md` oder `.mdx` Dateien in `src/content/docs/` erstellst. Erstelle Unterordner, um deine Dateien zu organisieren und mehrere Pfadsegmente zu erstellen:
5959

6060
```
6161
src/content/docs/hello-world.md => your-site.com/hello-world
@@ -75,15 +75,15 @@ description: This is a page in my Starlight-powered site
7575

7676
Wenn du etwas Wichtiges vergisst, wird Starlight dich daran erinnern.
7777

78-
## Veröffentlichung deiner Starlight Webseite
78+
## Veröffentlichung deiner Starlight-Website
7979

80-
Sobald du deine Starlight Webseite erstellt und angepasst hast, kannst du sie auf einen Webserver oder Hosting-Plattform deiner Wahl veröffentlichen, einschließlich Netlify, Vercel, GitHub Pages und vielen mehr.
80+
Sobald du deine Starlight Website erstellt und angepasst hast, kannst du sie auf einen Webserver oder Hosting-Plattform deiner Wahl veröffentlichen, einschließlich Netlify, Vercel, GitHub Pages und vielen mehr.
8181

82-
[Lerne mehr über die Veröffentlichung einer Astro Webseite in der Astro Dokumentation.](https://docs.astro.build/de/guides/deploy/)
82+
[Lerne mehr über die Veröffentlichung einer Astro-Website in der Astro-Dokumentation.](https://docs.astro.build/de/guides/deploy/)
8383

8484
## Starlight aktualisieren
8585

86-
:::tip
86+
:::tip[Tipp]
8787
Da es sich bei Starlight um eine Beta-Software handelt, wird es regelmäßig Updates und Verbesserungen geben. Achte darauf Starlight regelmäßig zu aktualisieren!
8888
:::
8989

@@ -124,6 +124,6 @@ Sowohl die Starlight [Projektkonfiguration](/reference/configuration/) als auch
124124

125125
In der wachsenden Liste der Anleitungen in der Seitenleiste findest du Hilfe beim Hinzufügen von Inhalten und beim Anpassen deiner Starlight-Website.
126126

127-
Wenn du keine Antwort in dieser Dokumentation finden kannst, besuche bitte die [Astro Docs](https://docs.astro.build) für die vollständige Astro-Dokumentation. Deine Frage kann vielleicht beantwortet werden, wenn du verstehst, wie Astro im Allgemeinen funktioniert.
127+
Wenn du keine Antwort in dieser Dokumentation finden kannst, besuche bitte die [Astro Docs](https://docs.astro.build/de/) für die vollständige Astro-Dokumentation. Deine Frage kann vielleicht beantwortet werden, wenn du verstehst, wie Astro im Allgemeinen funktioniert.
128128

129-
Du kannst auch im [Astro Discord](https://astro.build/chat/) Hilfe von unserer aktiven, freundlichen Community bekommen. Du kannst Fragen in unserem `#Support`-Forum stellen oder unseren speziellen `#starlight`-Channel besuchen, um aktuelle Entwicklungen und mehr zu diskutieren.
129+
Du kannst auch nach bekannten [Starlight-Problemen auf GitHub](https://github.com/withastro/starlight/issues) suchen und im [Astro Discord](https://astro.build/chat/) Hilfe von unserer aktiven, freundlichen Community erhalten! Du kannst Fragen in unserem `#Support`-Forum stellen oder unseren speziellen `#starlight`-Channel besuchen, um aktuelle Entwicklungen und mehr zu diskutieren.

0 commit comments

Comments
 (0)