Skip to content

Commit e74ca1f

Browse files
authored
i18n(ru): update some files (#2258)
1 parent 6df2f34 commit e74ca1f

File tree

3 files changed

+27
-35
lines changed

3 files changed

+27
-35
lines changed

docs/src/content/docs/ru/environmental-impact.md

Lines changed: 25 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -3,14 +3,11 @@ title: Экологичная документация
33
description: Узнайте, как Starlight может помочь создавать экологически сайты с документацией и снижать ваш углеродный след.
44
---
55

6-
Оценки влияния интернет-индустрии на климат варьируются от [2%][sf] до [4% глобальных выбросов углерода][bbc],
7-
что близко к выбросам авиационной индустрии.
8-
Расчет экологического воздействия веб-сайта включает в себя множество сложных факторов,
9-
но в данном руководстве перечислены несколько советов по снижению экологического следа вашего сайта с документацией.
6+
Оценки влияния интернет-индустрии на климат варьируются от [2%][sf] до [4% глобальных выбросов углерода][bbc], что близко к выбросам авиационной индустрии.
7+
Расчет экологического воздействия веб-сайта включает в себя множество сложных факторов, но в данном руководстве перечислены несколько советов по снижению экологического следа вашего сайта с документацией.
108

119
Хорошая новость в том, что выбор Starlight — отличное начало.
12-
Согласно Website Carbon Calculator, этот сайт [чище, чем 99% протестированных веб-страниц][sl-carbon],
13-
производя 0,01 г CO₂ за каждое посещение страницы.
10+
Согласно Website Carbon Calculator, этот сайт [чище, чем 99% протестированных веб-страниц][sl-carbon], производя 0,01 г CO₂ за каждое посещение страницы.
1411

1512
## Вес страницы
1613

@@ -34,8 +31,7 @@ Starlight использует [оптимизировацию ресурсов]
3431
### Кэширование
3532

3633
Кэширование управляет тем, как долго браузер хранит и повторно использует данные, которые он уже загрузил.
37-
Хорошая стратегия кэширования гарантирует, что пользователь получает новое содержание как можно быстрее,
38-
когда оно меняется, но также избегает бесполезной повторной загрузки одного и того же содержания снова и снова, когда оно не изменилось.
34+
Хорошая стратегия кэширования гарантирует, что пользователь получает новое содержание как можно быстрее, когда оно меняется, но также избегает бесполезной повторной загрузки одного и того же содержания снова и снова, когда оно не изменилось.
3935

4036
Самым распространённым способом настройки кэширования является использование [HTTP-заголовка `Cache-Control`][cache].
4137
При использовании Starlight вы можете установить длительное время кэширования для всего, что находится в каталоге `/_astro/`.
@@ -45,8 +41,7 @@ Starlight использует [оптимизировацию ресурсов]
4541
Cache-Control: public, max-age=604800, immutable
4642
```
4743

48-
Как настроить кэширование зависит от вашего веб-хоста. Например, Vercel автоматически применяет эту стратегию кэширования без необходимости настройки,
49-
в то же время вы можете установить [заголовки для Netlify][ntl-headers], добавив файл `public/_headers` в ваш проект:
44+
Как настроить кэширование зависит от вашего веб-хоста. Например, Vercel автоматически применяет эту стратегию кэширования без необходимости настройки, в то же время вы можете установить [заголовки для Netlify][ntl-headers], добавив файл `public/_headers` в ваш проект:
5045

5146
```
5247
/_astro/*
@@ -61,13 +56,10 @@ Cache-Control: public, max-age=604800, immutable
6156
## Потребление энергии
6257

6358
То, как реализована веб-страница может влиять на потребление энергии при её запуске на устройстве пользователя.
64-
За счет минимального использования JavaScript, Starlight снижает объем вычислительных ресурсов, необходимых телефону,
65-
планшету или компьютеру пользователя для загрузки и отображения страниц.
59+
За счет минимального использования JavaScript, Starlight снижает объем вычислительных ресурсов, необходимых телефону, планшету или компьютеру пользователя для загрузки и отображения страниц.
6660

67-
Будьте внимательны при добавлении функций, таких как скрипты отслеживания аналитики или контент, зависящий от JavaScript,
68-
например, встроенные видео, так как они могут увеличить энергопотребление страницы.
69-
Если вам необходима аналитика, рассмотрите выбор легковесного варианта,
70-
такого как [Cabin][cabin], [Fathom][fathom] или [Plausible][plausible].
61+
Будьте внимательны при добавлении функций, таких как скрипты отслеживания аналитики или контент, зависящий от JavaScript, например, встроенные видео, так как они могут увеличить энергопотребление страницы.
62+
Если вам необходима аналитика, рассмотрите выбор легковесного варианта, такого как [Cabin][cabin], [Fathom][fathom] или [Plausible][plausible].
7163
Встроенные видео, такие как YouTube и Vimeo, можно улучшить, ожидая [взаимодействие пользователя для загрузки видео][lazy-video].
7264
Пакеты, такие как [`astro-embed`][embed], могут помочь с часто используемыми сервисами.
7365

@@ -88,8 +80,7 @@ Cache-Control: public, max-age=604800, immutable
8880
Место, где размещена веб-страница, может иметь большое влияние на то, насколько экологичен ваш сайт с документацией.
8981
Дата-центры и серверные фермы могут оказывать значительное экологическое воздействие, включая высокий энергопотребление и интенсивное использование воды.
9082

91-
Выбор хостинга, использующего возобновляемую энергию, снизит выбросы углерода для вашего сайта.
92-
[Справочник Green Web][gwb] - один из инструментов, который может помочь вам найти хостинговые компании, работающие с экологически чистой энергией.
83+
Выбор хостинга, использующего возобновляемую энергию, снизит выбросы углерода для вашего сайта. [Справочник Green Web][gwb] — один из инструментов, который может помочь вам найти хостинговые компании, работающие с экологически чистой энергией.
9384

9485
[gwb]: https://www.thegreenwebfoundation.org/directory/
9586

@@ -98,20 +89,21 @@ Cache-Control: public, max-age=604800, immutable
9889
Хотите сравнивить другие фреймворки для документации?
9990
Эти тесты с использованием [Website Carbon Calculator][wcc] сравнивают аналогичные страницы, созданные с помощью разных инструментов.
10091

101-
| Фреймворк | CO₂ на каждое посещение стр. |
102-
| --------------------------- | ---------------------------- |
103-
| [Starlight][sl-carbon] | 0.01g |
104-
| [VitePress][vp-carbon] | 0.05g |
105-
| [Docus][dc-carbon] | 0.05g |
106-
| [Sphinx][sx-carbon] | 0.07g |
107-
| [MkDocs][mk-carbon] | 0.10g |
108-
| [Nextra][nx-carbon] | 0.11g |
109-
| [docsify][dy-carbon] | 0.11g |
110-
| [Docusaurus][ds-carbon] | 0.24g |
111-
| [Read the Docs][rtd-carbon] | 0.24g |
112-
| [GitBook][gb-carbon] | 0.71g |
113-
114-
<small>Данные собраны 14 мая 2023 года. Чтобы увидеть актуальные цифры, перейдите по ссылке.</small>
92+
| Фреймворк | CO₂ на каждое посещение стр. | Рейтинг |
93+
| --------------------------- | ------------------ | :----: |
94+
| [Starlight][sl-carbon] | 0.01g | A+ |
95+
| [Read the Docs][rtd-carbon] | 0.05g | A+ |
96+
| [Sphinx][sx-carbon] | 0.06g | A+ |
97+
| [VitePress][vp-carbon] | 0.07g | A+ |
98+
| [Docus][dc-carbon] | 0.09g | A+ |
99+
| [docsify][dy-carbon] | 0.10g | A |
100+
| [Nextra][nx-carbon] | 0.11g | A |
101+
| [MkDocs][mk-carbon] | 0.19g | B |
102+
| [Docusaurus][ds-carbon] | 0.21g | B |
103+
| [GitBook][gb-carbon] | 0.43g | C |
104+
| [Mintlify][mt-carbon] | 1.22g | F |
105+
106+
<small>Данные собраны 22 июля 2024 года. Нажмите на ссылку для просмотра актуальной информации.</small>
115107

116108
[sl-carbon]: https://www.websitecarbon.com/website/starlight-astro-build-getting-started/
117109
[vp-carbon]: https://www.websitecarbon.com/website/vitepress-dev-guide-what-is-vitepress/
@@ -123,6 +115,7 @@ Cache-Control: public, max-age=604800, immutable
123115
[ds-carbon]: https://www.websitecarbon.com/website/docusaurus-io-docs/
124116
[rtd-carbon]: https://www.websitecarbon.com/website/docs-readthedocs-io-en-stable-index-html/
125117
[gb-carbon]: https://www.websitecarbon.com/website/docs-gitbook-com/
118+
[mt-carbon]: https://www.websitecarbon.com/website/mintlify-com-docs-quickstart/
126119

127120
## Дополнительные ресурсы
128121

docs/src/content/docs/ru/index.mdx

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,7 @@ import Testimonial from '~/components/testimonial.astro';
3939
</Card>
4040
<Card title="Markdown, Markdoc и MDX" icon="document">
4141
Используйте свой любимый язык разметки. Starlight предоставляет встроенную
42-
проверку метаданных с поддержкой TypeScript для обеспечения
43-
типобезопасности.
42+
проверку метаданных с поддержкой TypeScript для обеспечения типобезопасности.
4443
</Card>
4544
<Card title="Используйте свои UI компоненты" icon="puzzle">
4645
Starlight не зависим от других фреймворков. Используйте с ним React, Vue,

docs/src/content/docs/ru/manual-setup.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ import { Tabs, TabItem } from '@astrojs/starlight/components';
1818
Starlight является [интеграцией Astro](https://docs.astro.build/ru/guides/integrations-guide/).
1919
Добавьте её на ваш сайт, запустив команду `astro add` в корневой директории вашего проекта:
2020

21-
<Tabs>
21+
<Tabs syncKey="pkg">
2222
<TabItem label="npm">
2323
```sh
2424
npx astro add starlight

0 commit comments

Comments
 (0)