fix comments

Author: trofim24

sdkjs-plugins/content/ai/.dev/test-agent/codeDesktop.js

@@ -203,7 +203,7 @@ Available functions:\n";
 
 	function loadJSONSync(url) {
 		const xhr = new XMLHttpRequest();
-		xhr.open("GET", url, false); // false — делает запрос синхронным
+		xhr.open("GET", url, false); // false - makes the request synchronous
 		xhr.send(null);
 
 		if (xhr.status === 200) {

sdkjs-plugins/content/grammalecte/scripts/gramma.js

@@ -364,8 +364,8 @@ function checkInternetExplorer(){
 		sTextForDisplay = temp;
 	};
 
-    // tempMatches используются для выделения ошибок внутри textarea,
-    // функция нужна для того, чтобы с одинаковым началом или концом не выделялись дважды
+    // tempMatches are used to highlight errors inside textarea,
+    // this function is needed to prevent highlighting twice for matches with the same start or end
     function delExternalMatches(aMatches) {
         for (var nItem1 = 0; nItem1 < aMatches.length - 1; nItem1++) {
             var bSkipped = false;

sdkjs-plugins/content/highlightcode/scripts/highlight.js

@@ -885,7 +885,7 @@
 		$('#tab_replace_id').select2({
 			minimumResultsForSearch: Infinity
 		}).on('change', function(e) {
-			// так как парсятся не все языки, то на редактировании изменения будут только у тех, что обрабатываются через библиотеки (при вставке в документ у всех)
+			// since not all languages are parsed, on editing changes will only apply to those processed through libraries (on document insertion - to all)
 			switch (e.currentTarget.value) {
 				case "0":
 					xml_formatter_settings.indentation = "\t";

sdkjs-plugins/content/languagetool/scripts/langTool.js

@@ -362,8 +362,8 @@ function checkInternetExplorer(){
             canAddText = false;
             changeLangInSelect(oResponse.language.name);
 
-			// чтобы сервис различал параграфы необходимо разделять их двумя "\n" во время отправки,
-			// поэтому после получения ответа нужно поправить позиции, чтобы в исходном тексте верно делать исправления
+			// for the service to distinguish paragraphs, they need to be separated by two "\n" when sending,
+			// so after receiving the response we need to correct positions to make corrections in the source text correctly
             correctMistakesPosition(matches);
 
             sTextForDisplay = txt;

sdkjs-plugins/content/speechrecognition/scripts/code.js

@@ -154,12 +154,12 @@
 					});
 
 					let oMatchOption = undefined;
-					// ищем по полному совпадению
+					// search for exact match
 					oMatchOption = aOptions.find(function(item) {
 						if (item.value == documentLang)
 							return true;
 					});
-					// ищем на совпадению по осносному языку
+					// search for match by base language
 					if (!oMatchOption) {
 						oMatchOption = aOptions.find(function(item) {
 							if (item.value.search(documentLang.split('-')[0]) != -1)

sdkjs-plugins/content/zotero/src/app/index.js

@@ -50,18 +50,18 @@ import "../styles.css";
     var displayNoneClass = "hidden";
     var blurClass = "blur";
 
-    // TODO добавить ещё обработку событий (удаление линков) их не нужно удалять
-    //     из библиографии автоматически (это делать только при обновлении библиографии
-    //     или refresh), но их точно нужно удалить из formatter!
-    // TODO добавить ещё обработку события (изменения линков), предлать пользователю
-    //     обновить их или сохранить ручное форматирование (при ручном форматировании
-    //     не меняем внешний вид цитаты при refresh (да и вообще не меняем))
-    // TODO сейчас всегда делаем полный refresh при каждом действии
-    //     (обновлении, вставке линков, вставке библиографии), потому что мы не знаем
-    //     что поменялось без событий (потом добавить ещё сравнение контента)
-    // TODO ms меняет линки (если стиль с нумерацией settings._bNumFormat) делает их по порядку
-    //     как документе (для этого нужно знать где именно в документе мы вставляем цитату,
-    //     какая цитата сверху и снизу от текущего курсора)
+    // TODO add event handling for link deletion - they should not be removed
+    //     from bibliography automatically (do this only when updating bibliography
+    //     or refresh), but they definitely need to be removed from formatter!
+    // TODO add event handling for link changes, offer the user
+    //     to update them or keep manual formatting (with manual formatting
+    //     we don't change citation appearance on refresh (and don't change at all))
+    // TODO currently we always do full refresh on every action
+    //     (update, link insertion, bibliography insertion), because we don't know
+    //     what changed without events (add content comparison later)
+    // TODO ms changes links (if style with numbering settings._bNumFormat) makes them in order
+    //     as in document (for this we need to know where exactly in the document we insert citation,
+    //     which citation is above and below the current cursor)
 
     /** @type {Router} */
     var router;
@@ -349,9 +349,9 @@ import "../styles.css";
                 })
                 .then(function (keys) {
                     selectCitation.removeItems(keys);
-                    // TODO есть проблема, что в плагине мы индексы обновили, а вот в документе нет (по идее надо обновить и индексы в документе перед вставкой)
-                    // но тогда у нас уедет селект и новое поле вставится не там, поэтому пока обновлять приходится в конце
-                    // такая же проблем с вставкой библиографии (при обнолении индексов в плагине надо бы их обновлять и в документе тоже)
+                    // TODO there's a problem that we updated indexes in the plugin, but not in the document (ideally we should update indexes in document before insertion)
+                    // but then our selection will shift and new field will be inserted in wrong place, so for now we have to update at the end
+                    // same problem with bibliography insertion (when updating indexes in plugin we should also update them in document)
                     return citationService.updateCslItems(true, false);
                 })
                 .catch(function (error) {

sdkjs-plugins/content/zotero/src/app/services/citation-doc-service.js

@@ -244,7 +244,7 @@ CitationDocService.prototype._removeSuperSubTagsWithPositions = function (
  * @returns {Promise<boolean>}
  */
 CitationDocService.prototype.saveAsText = function () {
-    // TODO потом добавить ещё форматы, пока только как текст
+    // TODO add more formats later, for now only as text
     return this.getAddinZoteroFields().then(function (arrFields) {
         let count = arrFields.length;
         if (!count) {

store/plugin/scripts/code.js

@@ -123,9 +123,9 @@
 
 		switch (data.type) {
 			case 'getInstalled':
-				// данное сообщение используется только при инициализации плагина и по умолчанию идёт парсинг и отрисовка плагинов из стора
-				// добавлен флаг updateInstalled - в этом случае не загружаем плагины из стора повторно, работаем только с установленными
-				
+				// this message is used only during plugin initialization, by default plugins from the store are parsed and rendered
+				// added updateInstalled flag - in this case we don't load plugins from the store again, we only work with installed ones
+
 				window.Asc.plugin.executeMethod('GetInstalledPlugins', null, function(result) {
 					postMessage({ type: 'InstalledPlugins', data: result, updateInstalled: data.updateInstalled } );
 				});

store/scripts/code.js

@@ -228,7 +228,7 @@ window.addEventListener('message', function(message) {
 				// sortPlugins(false, true, 'name');
 			} else if (installed) {
 				if (installed.obj.backup) {
-					// нужно обновить список установленных плагинов, чтобы ссылки на ресурсы были правильными
+					// need to update the list of installed plugins so that resource links are correct
 					sendMessage({ type: 'getInstalled', updateInstalled: true }, '*');
 				}
 				else
@@ -290,7 +290,7 @@ window.addEventListener('message', function(message) {
 				} else {
 					installed.removed = true;
 
-					// нужно обновить список установленных плагинов, чтобы ссылки на ресурсы были правильными
+					// need to update the list of installed plugins so that resource links are correct
 					if (isLocal)
 						sendMessage({ type: 'getInstalled', updateInstalled: true }, '*');
 				}
@@ -708,7 +708,7 @@ function showListofPlugins(bAll, sortedArr) {
 	$('.div_item').remove();
 	let arr = (sortedArr ? sortedArr : (bAll ? allPlugins : installedPlugins));
 
-	// получаем список backup плагинов
+	// get list of backup plugins
 	if (!bAll && isLocal) {
 		var _pluginsTmp = JSON.parse(window["AscDesktopEditor"]["GetBackupPlugins"]());
 
@@ -975,9 +975,9 @@ function onClickRemove(target, event) {
 };
 
 function needBackupPlugin(guid) {
-	// проверяем установленный плагин:
-	// если плагин есть в стор ( и его версия <= ? ), то можем удалить, пользователь сможет поставить актуальную версию
-	// если плагина нет в стор, нужно его хранить у пользователя с возможностью восстановления
+	// check installed plugin:
+	// if the plugin exists in the store (and its version <= ?), we can delete it, user will be able to install the current version
+	// if the plugin is not in the store, we need to keep it for the user with the ability to restore
 
 	return isLocal ? findPlugin(true, guid) == undefined : false;
 }
@@ -1629,7 +1629,7 @@ function installPluginManually() {
 
 		let result = window["AscDesktopEditor"]["PluginInstall"](file);
 		if (result) {
-			// нужно обновить список установленных плагинов
+			// need to update the list of installed plugins
 			sendMessage({ type: 'getInstalled', updateInstalled: true }, '*');
 		} else {
 			createError(new Error('Problem with plugin installation.'), false);