feat: Библиотека и тесты переведены на английский язык by slaxxals · Pull Request #79 · vbondarevsky/Connector

slaxxals · 2021-09-07T14:10:22Z

Для использования библиотеки при разработке в конфигурациях с Вариантом встроенного языка = English.

BlizD · 2021-09-08T09:40:14Z

А зачем и код переводить на английский? Возможно достаточно только сообщения на английский перевести?

У нас не используется английский код, поэтому нам это не требуется и будет только мешать.

slaxxals · 2021-09-08T11:24:24Z

У нас не используется английский код, поэтому нам это не требуется и будет только мешать.

У нас используется английский вариант встроенного языка. Некоторые разработчики вообще русский язык не знают. Также мы используем БСП на английском (SSL). Я уверен, что таких, как у нас команд разработчиков, не одна, а больше. Поэтому разумным было бы портировать библиотеку полностью на английский язык. И при любом изменении в основной ветке на русском языке - дублировать их на английском. На данный момент переведен весь код и все тесты. Я начал переводить комментарии к методам, а потом и до README дело дойдет.

Если же вам это не требуется и будет мешать, то можно сделать отдельную ветку "master-en", например.

BlizD · 2021-09-08T14:39:20Z

Если же вам это не требуется и будет мешать, то можно сделать отдельную ветку "master-en", например.

Да, этот вариант нам больше подходит

slaxxals · 2021-09-08T17:52:12Z

Да, этот вариант нам больше подходит

Отлично! Попробую создать в моем форке отдельную ветку и сделать PR, в котором будут исходники конфигурации полностью на английском языке. Если не получится, то прошу вас сделать эту ветку master-en, а я в нее уже отправлю PR.

BlizD · 2021-09-08T18:17:08Z

Решение за @vbondarevsky я лишь высказал свое мнение

slaxxals · 2021-09-08T18:34:38Z

Решение за @vbondarevsky я лишь высказал свое мнение

Хорошо, тогда призываю Владимира @vbondarevsky к обсуждению.

Какой вариант существования библиотеки на английском языке наиболее приемлемый?

Одна ветка master, с исходниками одной конфигурации, в которой продублированы переведенные объекты ОМ.КоннекторHTTP и Обработка.Тесты. (этот вариант сейчас присутствует в текущем PR)
Новая ветка master-en, с исходниками одной конфигурации, в которой присутствуют только переведенные объекты. Исходных объектов из конфигурации ветки master в ней не будет.
Библиотека переведенная на английский язык не нужна в этом репозитории.

slaxxals · 2021-09-09T09:58:44Z

Нашел issue для этого PR - вот #46

vbondarevsky · 2021-09-09T11:17:45Z

Решение за @vbondarevsky я лишь высказал свое мнение

Хорошо, тогда призываю Владимира @vbondarevsky к обсуждению.

Какой вариант существования библиотеки на английском языке наиболее приемлемый?

1. Одна ветка master, с исходниками одной конфигурации, в которой продублированы переведенные объекты ОМ.КоннекторHTTP и Обработка.Тесты. (этот вариант сейчас присутствует в текущем PR)

2. Новая ветка master-en, с исходниками одной конфигурации, в которой присутствуют только переведенные объекты. Исходных объектов из конфигурации ветки master в ней не будет.

3. Библиотека переведенная на английский язык не нужна в этом репозитории.

Думаю лучше так:

в папке src сделать две подпапки ru и en. В ru переместить текущие исходники, а в en вашу версию с переводом
отдельное README для английского и в основном сделать ссылку в начале

slaxxals · 2021-09-09T11:34:51Z

@vbondarevsky Отлично!

Тогда есть еще один момент:

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

vbondarevsky · 2021-09-09T11:52:52Z

@vbondarevsky Отлично!

Тогда есть еще один момент:

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

Это уже непринципиально: один коммит сразу в 2 версии или на каждую свой отдельный. Переносить изменения лучше покоммитно, т.е. одно изменение в русской версии = одно изменение в английской

slaxxals · 2021-09-09T12:01:03Z

Понятно, тогда раскидываю исходники на 2 директории и продолжаю перевод комментариев и README

vbondarevsky · 2021-09-09T12:03:00Z

Понятно, тогда раскидываю исходники на 2 директории и продолжаю перевод комментариев и README

Только текущие файлы лучше мувнуть (git mv) чтобы не было кучи новых изменений

slaxxals · 2021-09-10T19:36:15Z

@vbondarevsky библиотека переведена на английский полностью, исходники разбиты по директориям.

Прошу рассмотреть PR.

vbondarevsky

@slaxxals
Пока волью как есть. Замечания предлагаю поправить отдельным PR.

Английский вариант особо подробно не смотрел, но в целом выглядит ОК

vbondarevsky · 2021-09-10T20:04:44Z


 **Коннектор** - это "Requests" для мира 1С.

+Бибилиотека полностью переведена на английский язык ([см. здесь](./README-EN.md)).


Думаю эту фразу лучше написать на английском для тех кто не знает русский

vbondarevsky · 2021-09-10T20:11:12Z

+[![Stars](https://img.shields.io/github/stars/vbondarevsky/Connector.svg?label=Github%20%E2%98%85&a)](https://github.com/vbondarevsky/Connector/stargazers)
+[![Release](https://img.shields.io/github/tag/vbondarevsky/Connector.svg?label=Last%20release&a)](https://github.com/vbondarevsky/Connector/releases)
+
+# Connector: handy HTTP-client for 1C Enterprise 8 platform


1C:Enterprise

vbondarevsky · 2021-09-10T20:11:51Z

@@ -0,0 +1,3083 @@
+// Коннектор: удобный HTTP-клиент для 1С:Предприятие 8


Connector: handy HTTP-client for 1C:Enterprise 8 platform

vbondarevsky · 2021-09-10T20:12:02Z

+// e-mail: vbondarevsky@gmail.com
+// Версия: 2.3.1
+//
+// Требования: платформа 1С версии 8.3.10 и выше


vbondarevsky · 2021-09-10T20:12:17Z

+
+#Region CommonUseMethods
+
+// Отправляет GET запрос


Описание функций тоже потом?

Да, в ближайшем комите

vbondarevsky · 2021-09-10T20:17:18Z

+- `Basic`, `Digest` and `AWS4-HMAC-SHA256` authentification
+- Auto resolution of redirections
+- Cookies setting and getting
+- Session with state persistance across requests (cookies, authentification и пр.)


vbondarevsky · 2021-09-10T20:18:35Z

+- And much more
+
+## Requirements
+- 1C Enterprise platform version **8.3.10** and higher.


1C Enterprise -> 1C:Enterprise
здесь и в других местах

slaxxals changed the title ~~feat: Перевести библиотеку на английский язык для использования при р…~~ feat: Перевести библиотеку на английский язык Sep 7, 2021

slaxxals changed the title ~~feat: Перевести библиотеку на английский язык~~ feat: Библиотека и тесты переведены на английский язык Sep 8, 2021

slaxxals closed this Sep 9, 2021

slaxxals force-pushed the master branch from 0c1a441 to 4e3b7dc Compare September 9, 2021 12:56

slaxxals added 2 commits September 9, 2021 18:42

feat: Библиотека перемещена в директорию ru

d5d14f8

feat: Add english version

80a2147

slaxxals reopened this Sep 9, 2021

slaxxals added 2 commits September 10, 2021 22:30

doc: Add English readme

43d93d8

doc: Исправлены опечатки

a78a5e9

vbondarevsky approved these changes Sep 10, 2021

View reviewed changes

vbondarevsky merged commit 242e937 into vbondarevsky:master Sep 10, 2021

vbondarevsky linked an issue Sep 13, 2021 that may be closed by this pull request

Есть ли версия библиотеки в англоязычном синтаксисе? #46

Closed

Dmitriy83 mentioned this pull request Apr 26, 2026

Синхронизация английского перевода с актуальным русским источником #164

Open


		Коннектор - это "Requests" для мира 1С.

		Бибилиотека полностью переведена на английский язык ([см. здесь](./README-EN.md)).

		@@ -0,0 +1,3083 @@
		// Коннектор: удобный HTTP-клиент для 1С:Предприятие 8


		#Region CommonUseMethods

		// Отправляет GET запрос

Conversation

slaxxals commented Sep 7, 2021 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

BlizD commented Sep 8, 2021 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

slaxxals commented Sep 8, 2021 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

BlizD commented Sep 8, 2021

Uh oh!

slaxxals commented Sep 8, 2021

Uh oh!

BlizD commented Sep 8, 2021

Uh oh!

slaxxals commented Sep 8, 2021

Uh oh!

slaxxals commented Sep 9, 2021

Uh oh!

vbondarevsky commented Sep 9, 2021

Uh oh!

slaxxals commented Sep 9, 2021

Uh oh!

vbondarevsky commented Sep 9, 2021

Uh oh!

slaxxals commented Sep 9, 2021

Uh oh!

vbondarevsky commented Sep 9, 2021

Uh oh!

slaxxals commented Sep 10, 2021

Uh oh!

vbondarevsky left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

slaxxals commented Sep 7, 2021 •

edited

Loading

BlizD commented Sep 8, 2021 •

edited

Loading

slaxxals commented Sep 8, 2021 •

edited

Loading