Code Monkey home page Code Monkey logo

svelte3-translation-ru's Introduction

Перевод ресурсов по Svelte

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

Результат нашей работы

Запущены следующие официальные русскоязычные сайты:

Сайты собираются и деплоятся автоматически при коммитах в данный репозиторий.

Что переводим

Как внести свой вклад в перевод

  • Перевести ещё не переведённую часть какого-либо ресурса, указанного выше.
  • Улучшить существующий перевод: исправить орфографическую, пунктуационную или семантическую ошибку, перефразировать неудачно скомпонованное предложение, устранить несоответствия перевода рекомендациям и т.п. Это нужно делать через систему Pull request в данном репозитории.

Рекомендации по переводу

Данные рекомендации по большей части подсмотрены в сообществе переводчиков React

  • Оформление перевода должно соответствовать оформлению оригинала.
  • Где это к месту, лучше строить предложения в обезличенной форме(без мы и вы), но не фанатично, т.к. документация старается быть менее официальной. В любом случае Вы и его производные пишите с маленькой буквы.
  • Всегда используйте букву ё (это соблюдать с помощью данного npm-пакета).
  • Используйте знак тире — где нужно тире, и знак дефиса - — где нужен дефис. Примеры: как-будто, Svelte — это фреймворк.
  • Во всех примерах кода необходимо переводить комментарии и весь текст, который относится к UI, т.е. то, что пользователь увидит при запуске такого примера.
  • Список, с которым в порядке убывания приоритета должен быть согласован перевод лексики, терминов и прочего:
    • наш словарь терминов Svelte;
    • словарь «Веб-стандартов»;
    • аналоги в переводах документации других известных UI-фреймворков (Vue, React, Angular);
    • русскоязычная документация, доклады или статьи с использованием нужной лексики;
    • лично придуманный перевод.
  • Избегать чрезмерных англицизмов, при условии, что есть общеупотребительные русские аналоги. Пропсы, билд и подобное не годятся. Но, например, бандл не имеет лучшего русского аналога.
  • Ссылки на ресурсы (MDN, Wikipedia) должны вести на русскую версию, если есть соответствующий перевод.
  • Иностранные имена переводите с указанием оригинального имени в скобках: Рич Харрис (Rich Harris). При этом обязательно проверьте уже существующий перевод имени в словаре имён «Веб-стандартов».
  • Ссылки с названием иностранной статьи в переводе должны быть приведены на языке оригинала, после чего содержать в скобках их русскоязычный перевод.
  • Исключайте отсылки на пол читателя (см. секцию 3 на этой странице).
  • Названия статей и заголовки пишутся с одной заглавной буквы («Удаление неиспользуемых стилей», а не «Удаление Неиспользуемых Стилей»).

Чтобы избежать кальки, можно брать смысл предложения, а потом перефразировать так, как объясняли бы старшему коллеге. Если предложение звучит нелепо вслух, то его надо переписать.

Небольшие вольности в переводе допускаются, но только если они помогают передать смысл. Перевод не должен быть ни слишком официальным, ни фамильярным. Истина где-то посередине.

Запуск локальной версии сайта

В репозиторий добавлены npm скрипты, которые позволяют забрать с GitHub текущую версию необходимого сайта, применить все изменения из нашего репозитория переводов и запустить копию сайта на своём компьютере, чтобы сразу видеть перевод в естественных условиях.

git clone [email protected]:AlexxNB/svelte3-translation-ru.git svelte-translation
cd svelte-translation

# 1. Устанавливаем все зависимости
npm install

# 2. Скачиваем последнюю версию нужного сайта и применяем к нему перевод
npm run update-svelte 
#...или...
npm run update-sapper 
#...или...
npm run update-svelte-native 

# 3. Запускаем сайт на локальной машине
npm run dev-svelte
#...или...
npm run dev-sapper
#...или...
npm run dev-svelte-native

Теперь можно открыть запущенный сайт по адресу http://localhost:3000 и посмотреть на него со всеми внесёнными изменениями на текущий момент.

При изменении файлов перевода, обновите окно браузера и вы должны будете увидеть изменения.

svelte3-translation-ru's People

Contributors

aleksandr909 avatar alexxnb avatar antonfrolovsky avatar bionictlt avatar davidmz avatar denisnow avatar dtroode avatar etozhealkhipce avatar firefoxic avatar gnvcor avatar karrambol avatar kubasovp avatar lomeat avatar mindmind avatar mnvdmitry avatar nastybits avatar nexus3a avatar not-a-doctor avatar oklookat avatar paulmaly avatar qwerty123t avatar sarfex avatar t63723 avatar tadmi avatar trash-and-fire avatar vadimkorr avatar valexr avatar wacesredky avatar wh1tevs avatar yurasovm avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar

svelte3-translation-ru's Issues

Translation progress

На данный момент выполнен практически весь перевод. Но сайт и документация будет обновляться.

Если вы хотите перевести еще не переведенный ресурс, то в коментариях к этой ишью оформите свое желание по следующей форме:

Ресурс: https://github.com/sveltejs/svelte/site/content/guide/00-introduction.md
Прогресс: 0%

Далее форкаете этот репозиторий, добавляете оригинальный файл по соответствующему пути(обязательно соблюдаем пути относительно оригинальных репозиториев) и начинаете переводить с учетом наших рекомендаций.

Если перевод занимает более суток - то отредактируйте свой комментарий, указав примерный актуальный прогресс.

По окночании перевода, создайте соответствующий Pull Request и обязательно отредактирйте свой комментарий указав Прогресс:100%.

Если по каким-либо причинам вы хотите отказаться от перевода - отредактирйте или удалите свой комментарий.

[2021-07-03] New commits in sveltejs/svelte

[2021-04-23] New commits in sveltejs/svelte

List of new commits in sveltejs/svelte

[2021-04-22] Changing tutorial/example order from script-style-html to script-html-style (#6213) - BabakFP

Изменить атрибут lang у тега html

Сейчас при переходе на сайт ru.svelte.dev различные встроенные в браузер транслейторы просят перевести русский язык с английского на русский, что, разумеется, странно.

Решение простое - lang="ru" :)

Маленькое замечание, но будет приятно, если примете к сведению.

Equivalent project for another language

Could you please tell me how to use this repo as a template for another language? I'd love to translate the documentation into Chinese and would be grateful if you can tell me where to start.

Ошибка вёрстки в главах <script context="module"> и <style>, раздел "Формат компонента"

Если посмотреть сгенерированный HTML, эти обе главы обёрнуты в div с классом side-by-side, из-за чего ширина контейнера уменьшилась вдвое -- строка очень узкая по сравнению с остальной вёрсткой, текст нечитабельный.

Проблема решается удалением элемента div.side-by-side.

Ссылка на главу: https://ru.svelte.dev/docs#script_context_module.

Лишний компонент в туториале

В этапе 05/06 есть лишний CustomButton.svelte. Который кстати является оригинальном в английском варианте. Непонятно зачем сделали на его место Fancy Button.
В любом случае форкнул репозиторий, чтобы его удалить за ненужностью или вернуть исходный вариант. А оказалось, что в репозитории его нет. Но при этом в туториале он есть. Скрины ниже.

56_1
56_2
56_3

Совет о реализации переводов на другие языки

Привет! Я не нашел другого способа связаться с вами, кроме как здесь.

Я живу в Японии и хочу организовать группу по переводу документации Svelte на японский. Мне было бы интересно узнать как вам удалось опубликовать русскую версию сайта как субдомен svelte.dev. Какие мне потребуются для этого права? Похоже что команда Svelte не сильно заинтересована в официальных переводах, и я пока не нашел ответа в официальном Discord.

[2021-06-27] New commits in sveltejs/svelte

List of new commits in sveltejs/svelte

[2021-06-26] update docs for style tag in elements (#6415) - Tan Li Hau

[2021-06-26] add accessibility warnings to the docs (#5316) - Tan Li Hau

[2021-06-26] Add docs for compound :global selector (#6271) - Geoff Rich

[2021-06-26] Reorder text area and output to improve visibility (#5790) - Aswin Vayiravan

[2021-06-26] tutorial: add name attribute to inputs (#5649) - Nguyễn Đức Hào

[2021-06-26] doc: Add notes to stress call-context-during-initialisation (#5631) - Outvi V

[2021-06-26] Add tutorial for component binding (#5009) - Stephane

[2021-06-26] docs: remove type property from special elements tutorial (#4715) - Simon Scharf

[2021-06-26] Docs: Accurately name function (#4060) - The Jared Wilcurt

[2021-03-30] New commits in sveltejs/svelte

[2021-05-30] New commits in sveltejs/svelte

[2021-06-28] New commits in sveltejs/svelte

[2021-07-09] New commits in sveltejs/svelte

Overpass font cyrillization

В главной репе решили, что шрифт Overpass идеально подходит для сайта. Рич пробовал несколько мильтиязычных шрифтов, но ничто не сравнилось с Overpass, sveltejs/svelte#2276 (comment).

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

Есть два варианта для решения этой проблемы:

  1. Найти максимально похожий шрифт со свободной лицензией.
  2. Нарисовать и добавить в шрифт Overpass русские глифы.

Я уже начал идти по 2 пути - https://github.com/AlexxNB/overpass-font-cyrillic
Проблема в том, что необходимо нарисовать как минимум 4 стиля шрифта разной толщины, а опыт рисования шрифтов у меня со вчерашнего дня начался. Хотелось бы помощи (советом или делом) от более опытных людей.

[2021-06-16] New commits in sveltejs/svelte

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.