translation-gang / ru.vuejs.org

Русская версия документации VueJS.org

ru.vuejs.org

Этот репозиторий содержит официальный перевод оригинальной документации vuejs.org на русский язык.

Также переведены документации по Vue-router, Vuex, Vue-loader, Vue-server-renderer и Vue-test-utils.

This is an official Russian translation branch of original vuejs.org repository.

vuejs.org

Important: This repository is for Vue 1.x and 2.x only. Issues and pull requests related to 3.x are managed in the v3 doc repo.

This site is built with hexo. Site content is written in Markdown format located in src. Pull requests welcome!

Writing

See the Vue Docs Writing Guide for our rules and recommendations on writing and maintaining documentation.

Developing

$ npm install
$ npm start # dev server at http://localhost:4000

Deploying

The site is deployed using GitHub pages, therefore you need push access to the vuejs.org repo to run the deploy script:

$ npm run deploy

If you are working on a fork and deploying to a different URL, you need to update the following accordingly:

• url and deploy sections in _config.yml
• src/CNAME

On Translations

Translations for this documentation project are currently mantained in separate repositories forked from this original one.

Mandarin

• Translation Repo - /vuejs/cn.vuejs.org

Japanese

Japanese translation is maintained by Vue.js japan user group

• Translation Repo - /vuejs/jp.vuejs.org
• Primary maintainer - kazupon
• Secondary Maintainers:
  • re-fort
  • potato4d
  • oohira

Russian

Russian translation is maintained by Translation Gang.

• Translation Repo — /translation-gang/ru.vuejs.org
• Primary maintainer - Grigoriy Beziuk

Italian

• Translation Repo - /vuejs/it.vuejs.org

Korean

Korean translation is maintained by Vue.js Korean User group.

• Translation Repo - /vuejs-kr/kr.vuejs.org
• Primary maintainer - ChangJoo Park

Arabic

Arabic translation is maintained by Interstellar Club

• Translation Repo - /interstellarClub/ar.vuejs.org
• Primary Maintainers :
  • Ilyes Chouia
  • Ahmed Aissaoui

French

French translation is maintained by Vuejs-FR.

• Translation Repo — /vuejs-fr/vuejs.org

Spanish

• Translation Repo - /1950Labs/vuejs.org
• Spanish translation is maintained by:

1950Labs & Vue.js Montevideo:

• Leonel More | Twitter
• Sebastián Camacho | Twitter
• Diana Rodríguez | Twitter
• Alejandro Parada
• José Javier Señaris | Twitter
• Federico Kauffman | Twitter
• Fabián Larrañaga | Twitter
• Pablo Marcano | Twitter
• Nicolás Tinte | Twitter
• Diego Barreiro
• Matías Verdier | Twitter
• Pablo Kz
• Leonardo Fagundez | Twitter

Persian (Farsi)

Persian translation is maintained by VueJS-fa.

• Translation Repo - /vuejs-fa/fa.vuejs.org
• Primary maintainer - Pooya Parsa

Vietnamese

Vietnamese translation is maintained by Vue.js Vietnam User group.

• Translation Repo: /vuejs-vn/vuejs.org
• Primary maintainer - phanan

Want to help with the translation?

If you feel okay with translating quite alone, you can fork the repo, post a comment on the Community Translation Announcements issue page to inform others that you're doing the translation and go for it.

If you are more of a team player, maybe Translation Gang is for you? Then just let us know somehow that you're ready to join this international open-source translators community. Feel free to contact Grigoriy Beziuk or anybody else from the team.

And thank you in advance ;)

ru.vuejs.org's Issues

Update to 2.1.10

@Alex-Sokolov, @kojoru — вплоть до какого коммита в оригинальном репо у нас всё актуально?

Классы анимаций "-to" плохо описаны

Класс v-enter-to и v-leave-to стоит в течение всей анимации, но нужен для указания желаемого финального состояния. Нужно это описать получше

См. 071c77e#commitcomment-20407334

Не использовались подчеркнутые ключевые слова в Render-функции и JSX, Основы

перевод:
При использовании шаблонов для реализации такого интерфейса придётся написать что-то вроде кода ниже:

новый перевод
При использовании шаблонов для реализации интерфейса который генерирует только заголовок, основанный на свойстве level, вы быстро столкнетесь со следующей ситуацией:

PR

Сервер русской документации заблокирован Роскомнадзором

104.18.49.43 и некоторые другие айпи серверов заблокированы ковровыми блокировками Телеграма Роскомнадзором.
Недоступны ru.vuejs.org, forum.vuejs.org, chat.vuejs.org
Пожалуйста, смените сервер

Ошибка на странице https://ru.vuejs.org/v2/guide/list.html

После абзаца, где речь идёт о вычисляемом свойстве в примере вместо computed указано methods. А в абзаце, где речь про методы в примере вместо methods указано computed

Может пора обновить README.md

Документация с публикацией на https://ru.vuejs.org/ стала считаться официальной?)

Синхронизировать стили

Хотелось бы синхронизировать стили

В английской версии табличка сравнения Vue и React в фирменых цветах смотрится гораздо приятнее
https://vuejs.org/v2/guide/comparison.html

Post и get запросы

Где описано методы post и get запросов?

Неправильная ссылка в главе "Функциональные компоненты > slots() vs children"

Актуальный url: https://ru.vuejs.org/v2/guide/render-function.html#slots (меню не реагирует на click)
Рабочий url: https://ru.vuejs.org/v2/guide/render-function.html#slots-vs-children

VuePress Migration Feedback

Hello!

My name is Ben Hong and I'm a Vue.js Community Partner that is currently working with the Vue.js Core Docs Team to help with updating the platform from Hexo to VuePress. During this time, we plan to have a content freeze in order to ensure all of the sites stay in sync with one another.

As maintainers for the Russian translation site, are there any pain points or concerns that you might have about this migration? We would love to hear from you and make sure your thoughts are taken into consideration before starting work on this.

Looking forward to your response!

Помогите разобраться с выгрузкой проекта вью на продакшн.

Проблема в том, что когда работа над проектом vue завершена, я прописываю в консоли команду npm run build, после чего, когда я пытаюсь открыть Index.html в браузере - ничего не происходит.
Как производить выгрузку в продакшн, или на гит-хаб, как другие пользователи смогут открыть мой проект, который написан на vue. Сам же я пользуюсь vue.cli

Issues in many times https://ru.vuejs.org/v2/guide/components-slots.html#%D0%94%D0%B5%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B2%D1%85%D0%BE%D0%B4%D0%BD%D1%8B%D1%85-%D0%BF%D0%B0%D1%80%D0%B0%D0%BC%D0%B5%D1%82%D1%80%D0%BE%D0%B2-%D1%81%D0%BB%D0%BE%D1%82%D0%B0

// What you destruct and why u destruct in parent but not in slot exectly
{{ user.firstName }}

слово miliseconds не переведено

было переведено на остальных языках

PR #242

Перевод Packaging Vue Components for npm

Взял

Перевод Creating Custom Scroll Directives

Взял

[TODO] Update docs to reflect 2.1.0 changes

В секции про фильтры указано, что они могут быть использованы только в выражениях в двойных фигурных скобках.

Но с релизом Vue 2.1.0 теперь можно использовать и в v-bind выражениях.

Будет ли это как-то отражено в переводе документации?

Перевести Style Guide

На оригинальном сайте появился style guide https://vuejs.org/v2/style-guide/. Кто-нибудь уже ведет работу по переводу?

Работа в консоли - push is not a function

http://ru.vuejs.org/v2/guide/

В консоли, введите app4.todos.push({ text: 'Новый элемент' }). Вы увидите, что к списку добавился новый элемент.

Выдает ошибку: VM804:1 Uncaught TypeError: app4.todos.push is not a function(…)

В английской версии все в порядке.

Что использовать: фронтенд или frontend

Дилемма. Встречаются и такие и такие варианты в документации

Не работают якоря на ссылках секций статьи

Например в Руководстве - Обработка событий, если нажать в боковой панели на "Модификаторы событий" страница не проскроллится к этой секции. Хотя вроде ID ссылки и элемента совпадают

В консоли по клику появляется ошибка:

TypeError: t is null[Подробнее]  smooth-scroll.min.js:2:1842
	f https://ru.vuejs.org/js/smooth-scroll.min.js:2:1842
	n.animateScroll https://ru.vuejs.org/js/smooth-scroll.min.js:2:2609
	p

"В Vue" или "Во Vue"

И так и так встречается

Неправильно отображаются заголовки

Некорректная ссылка в API props «См. также»

https://ru.vuejs.org/v2/api/#props

«См. также: Входные параметры» ведёт на Основы компонентов, хотя логичнее и правильнее вести на Входные параметры

Translate Cookbook / Introduction

work-in-progress

Не корректый id якоря

https://ru.vuejs.org/v2/api/
Не работает переход при клике на Методы экземпляра — жизненный цикл > vm.$mount
Там указан #vm-mount-elementOrSelector вместо #vm-mount
Та же проблема и в vm.$nextTick

Route — маршрут, path — путь, router — маршрутизатор, routing — маршрутизация

subj, надо зафорсить
@kojoru ?

Ошибка в тексте

[ru.vuejs.org/src/v2/cookbook/unit-testing-vue-components.md](https://github.com/translation-gang/ru.vuejs.org/blob/master/src/v2/cookbook/unit-testing-vue-components.md)

Модульные тесты — это самые маленькие и самые простые тесты — они проверяет утверждения на маленьких единицах работы, изолируя каждую часть единственного компонента.

Пропущено слово в api/#watch

Пропущено слово в api/#watch

Объект, ключи которого — выражения для наблюдения, а значения — коллбэки, вызываемые при их изменении. Значения также могут быть? являться? строками с именами методов, или объектами, содержащими дополнительные опции. Экземпляр Vue вызовет $watch() соответствующий каждому ключу объекта при своём создании.

Ожидается слово «быть» или «являться».

https://ru.vuejs.org/v2/api/#watch
https://github.com/translation-gang/ru.vuejs.org/blob/master/src/v2/api/index.md#watch

Перевод изображений

Нужен текстовый перевод следующих изображений:

• data.png
  

• dom-tree.png (перевод не требуется)
  

• hn-architecture.png
  

• mvvm.png
  

• transition.png (перевод не требуется)

Joining translation-gang

Hey @gbezyuk
I would love to join translation-gang and I want to create Hindi translations repo for VueJS documentation translation as a primary maintainer with the people who are interested in contributing into that.

Неправильные ссылки в главе "Работа с классами и стилями"

В оригинальном руководстве [1] ссылки на "Object Syntax" и "Array Syntax" в главах "Binding HTML Classes" и "Binding Inline Styles" отличаются якорем в ссылке (#Object-Syntax и #Object-Syntax-1), а в русской — нет [2].

Английские якоря в API

Приветствую!
На страничке API (http://ruvuejsorg.surge.sh/v2/api/) в абзацах есть ссылки на страницы гайда с английскими якорями, тогда как у заголовков в гайде якоря русские.

Например: http://ruvuejsorg.surge.sh/v2/api/#slot

См. также: Именованные слоты

Ведет на components.html#Named-Slots , а должно components.html#Именованные-слоты

Постараюсь в ближайшее время проверить страницу API и прислать PR.

Vue 3 Docs are ready for translation!

Hello! Just wanted to let you know that v3 docs are ready to start translating.

https://github.com/vuejs/docs-next

If you have any questions, please feel free to file an issue so we can help however we can!

Render-функции→ Аргументы createElement → пример

https://ru.vuejs.org/v2/guide/render-function.html#Аргументы-createElement

// @returns {VNode}
createElement(
  // {String | Object | Function}
  // Название тега HTML, опции компонента, или функция,
  // их возвращающая. Обязательный параметр.
  'div',

опции компонента — это, видимо, название (name) компонента?

Перезаписывается margin

И в переводной версии, и в оригинальное такое на странице:
https://ru.vuejs.org/v2/examples/hackernews.html может быть и на других тоже.

Вместо жирного шрифта использовался другой стиль подчёркивания ключевых слов

Render-функции и JSX, Основы: render function (оригинал) - render-функции (перевод)
commit

Child - "ребенок"?

Здравствуйте!

Думаете, стоит переводить "child" как "ребенок", а не как "потомок"?

Поменять рендер на рендеринг, а перерендер на перерендеринг

Перевод страницы cookbook / Using Axios to Consume APIs

in progress

Перевод Dockerize Vue.js App

Взял на себя

search issue

@bigperson указал, что поиск по гайду указывал на англоязычные доки — разобраться