https://github.com/vuejs-translations/docs-ru

📄 Документация для Vue 3
https://github.com/vuejs-translations/docs-ru

Last synced: 5 days ago
JSON representation

📄 Документация для Vue 3

• Host: GitHub
• URL: https://github.com/vuejs-translations/docs-ru
• Owner: vuejs-translations
• License: other
• Created: 2022-10-12T10:32:39.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-06T05:39:34.000Z (8 days ago)
• Last Synced: 2024-11-06T06:28:14.868Z (8 days ago)
• Language: Vue
• Homepage: https://ru.vuejs.org/
• Size: 19.5 MB
• Stars: 56
• Watchers: 9
• Forks: 41
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: .github/contributing/oxford-comma.jpg
  • License: LICENSE

Awesome Lists containing this project

README

        
# Документация для Vue 3 на русском

## Вклад в развитие

Сайт построен на [VitePress](https://github.com/vuejs/vitepress) и основывается на [@vue/theme](https://github.com/vuejs/vue-theme). Содержимое сайта написано в формате Markdown и расположено в `src`. Простые изменения можно вносить напрямую в файл на GitHub и создавать из его интерфейса пулл-реквест.

Для локальной разработки предпочтительный менеджер пакетов [pnpm](https://pnpm.io/):

```bash

pnpm i

pnpm run dev

```

Для проекта требуется Node.js версии `v18` или выше, потому что используются новые возможности JavaScript в коде, например опциональная цепочка.

```bash

corepack enable

```

## Работа над переводом

- До переезда на VitePress уже была [документация для Vue 3 на русском языке](https://v3.ru.vuejs.org/)

- Те кто хочет помочь, но с переводом может быть сложно — можно помогать поиском одинаковых абзацев в переведённой (см. ссылку выше) документации, скорее всего будут такие же где-то на страницах новой документации.

- Те кто хочет помочь, но только изучает Vue, всегда можно вычитать уже переведённый раздел на предмет опечаток, ошибок, неправильных окончаний слов

- Те кто хочет помочь и может переводить, также можно облегчить жизнь подсматривая в переводчик [Deepl](https://www.deepl.com/translator)

- При переводе сохраняйте якоря оригинальных заголовков

```diff

- ## Original Header

+ ## Переведенный заголовок {#original-header}

```

- Чтобы не начать переводить файл, который кто-то уже переводит, создавайте Issue с указанием пути к файлу

- Если файл слишком большой или больше нет времени его закончить создавайте PR с тем что успели :)

- Если захочется что-то обсудить, в репозитории открыты Discussions. Также есть отдельный [телеграм чат](https://t.me/vuejs_docs_ru)

## Работа над содержанием

- См. документацию VitePress о поддерживаемых [расширениях Markdown](https://vitepress.dev/guide/markdown.html) и возможностями [по использованию синтаксиса Vue внутри markdown](https://vitepress.dev/guide/using-vue.html).

- См. [Руководство по написанию](https://github.com/vuejs/docs/blob/main/.github/contributing/writing-guide.md), где собраны правила и рекомендации по написанию и поддержке документации.

## Работа над темой

Если потребуется внести изменения в тему, обратитесь к [инструкциям по разработки тем](https://github.com/vuejs/vue-theme#developing-with-real-content).