Русские Всплывающие подсказки C# для ZennoPoster и других DLL. Шаблон ZennoPoster

Складчина: Русские Всплывающие подсказки C# для ZennoPoster и других DLL. Шаблон ZennoPoster

Привет всем интересующимся.

Всплывающие подсказки - это то, что появляется, когда вы подводите мышку к написанному коду C# (или когда пишите свой, но об этом чуть ниже).


Если подсказок нет, но код при этом рабочий, то скорее всего у вас нет файла с этими подсказками, а возможно просто разработчик не позаботился об этом. Подсказки нужны для облегчения чтения/написания кода с использованием различных dll библиотек. Эти dll библиотеки используются как часть какой-либо программы (например ZennoPoster) или дополнение по расширению функционала и повышают удобство чтения/написания кода.

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


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

Теперь при выходе новой версии или обновлении Zennoposter или используемых DLL библиотек Вы не потеряете перевод и сами сможете перевести подсказки для новой версии.

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

За один запуск шаблона можно перевести все файлы подсказок рядом с выбранным файлом.
Перевод берется из локальной базы с переводом подсказок для ZennoPoster, если перевод в ней не найден, то используются онлайн сервисы для перевода и дополняется локальная база с переводами, которую можно редактировать (ведь машинный перевод через онлайн сервисы перевода, не всегда точен. О том, как это сделать есть в мануале к проекту).



Для запуска проектов требуется программа ZennoPoster. Шаблон выдается с правами на выполнение только в Zennoposter и в ProjectMaker не откроется.

Бонус

Для всех кто проходил обучение в ZennoAcademy от sibbora, скидка 30%. Для тех, кто проходил другие обучающие курсы по С# или ZennoPoster других авторов скидка 15%.

Для получения бонуса нужно выполнить простые условия:
ЧК и выше: поставить ссылку на эту тему в подпись и 1 рекламный пост (соблюдая правила)
Складчики: 3 рекламных поста (соблюдая правила)

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

 

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

При использовании методов, подсказки появляются, когда вы ставите открывающую скобку, то сразу появляется подсказка для первого параметра (он выделяется жирным шрифтом)


Конечно, лучше, когда эти подсказки на понятном языке (русском)

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

Так же удобно посмотреть какие вообще доступны действия с текущим объектом. Список этих действий появляется после того, как поставили точку после названия текущего объекта. После выбора нужного пункта в списке появляется всплывающая подсказка к выбранному действию.





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

При наведении мышки на любой из объектов, можно лучше понять какие взаимодействия с ним происходят.






Так же подсказки могут правильнее писать код, ведь иногда возникают ошибки из-за большой/маленькой буквы в названии объекта/действия и при ошибке подсказки не появляются, правильное написание можно посмотреть в выпадающем списке доступных действий.

Всплывающие подсказки доступны не только в ZennoPoster, но и для большинства других (в том числе бесплатных) dll библиотек.

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



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

P.S. В статусе Доступно, скидка по бонусу не действует.

 

А там уже есть какой то перевод, вплоть до последней версии? Или надо самому всё переводить с нуля?

 

Перевод для подсказок зеннопостер уже есть в локальной базе с ручными правками, для большей человечности. Новые (не переведенные ранее) фразы, будут переводится через сервисы онлайн перевода и добавляться в базу. Откорректировать перевод, если он Вас не устроит, можно самостоятельно, и в дальнейшем при переводе/обновлении перевода уже будет использоваться исправленный перевод. На момент выдачи, в локальной базе будет версия перевода для свежей версии зеннопостер.

 

Это дело проверять нужно ?)

 

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

 

ОТЗЫВ:

Для начала обязательно укажите свой уровень владения информацией и навыками: в данной области вы новичок, теоретик либо опытный практик?
Опытный практик.

В каком виде предоставлен материал и насколько удобно он оформлен?
Выдан шаблон ZP, необходимые библиотеки для работы, 2 файла с описанием.

Сколько времени заняло изучение и выполнение заданий данного инфопродукта?
В течении пары часов.

Насколько легко усваивается материал, вызвал ли он какие-либо затруднения при проверке?
Затруднений не возникало. Шаблон отрабатывал без ошибок.

Сколько времени заняло достижение заявленного автором результата?
Результат не заявлен.

Нужны ли специальные навыки и дополнительные материальные вложения?
Доп. навыки не требуются, необходим Zennoposter/

Оказывал ли автор должную поддержку в процессе проверки?
Поддержка не потребовалась.

Каковы в целом общие впечатления о компетентности автора?
Автор компетентен.

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

ps
Шаблон просто необходим, тем, кто на "Вы" с английским (хотя для кодера его знать просто необходимо), а для начинающих - решение, которое увеличит скорость работы с кодом.
Хочу заметить, что шаблон не только для русификации подсказок Зеннопостера, а практически любой DLL библиотеки !!!
Продумана логика по обновлению версий используемых DLL.
Автор предлагает решение не под конкретную версию зеннопостора, а под любую, т.к. используется сервис онлайн-перевода, для новых фраз.
Однажды переведенные фразы хранятся в БД SQLite, что снижает количество обращений к сервису перевода, а так же при необходимости - можно править криво переведенные фразы.

 

 

Отзыв

Для начала обязательно укажите свой уровень владения информацией и навыками: в данной области вы новичок, теоретик либо опытный практик?
Практик

В каком виде предоставлен материал и насколько удобно он оформлен?
Шаблон, библиотеки и инструкция

Сколько времени заняло изучение и выполнение заданий данного инфопродукта?
Прочитать - минут 5, перевод одного файла - 12 секунд, четырех - 8 минут

Насколько легко усваивается материал, вызвал ли он какие-либо затруднения при проверке?
Из описания сначала не поняла о чем вообще речь) Потом дошло и затруднений не было

Сколько времени заняло достижение заявленного автором результата?
Несколько минут

Нужны ли специальные навыки и дополнительные материальные вложения?
Нужен зеннопостер или зеннобокс, больше ничего

Оказывал ли автор должную поддержку в процессе проверки?
Не понадобилась

Каковы в целом общие впечатления о компетентности автора?
Автор компетентен

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

Отсебятина

Все знают, что надо знать английский. Но для тех, кто Оксфордов не заканчивал, на помощь приходит этот шаблон. Описание на родном языке не заменить ничем.

Было:

Стало:

Очень хорошо, что некоторые понятия дублируются и на английском

Было:

Стало:


Если что-то не устраивает в переводе, то можно легко исправить в файле с базой, используя или рекомендуемую автором программу или свою любимую. Что я и попробовала сделать (исправить мелочь - и т.Д., остальное все по-человечески переведено) Можно в последующем обновить базу, если нужно будет обновить библиотеку. Т.е. шаблон не одноразовый, а для тех, кто постоянно пользуется зеннопостером, а это все его обладатели, наверно)) и пишет свои шаблоны. В общем, удобная вещь, спасибо!

 

А какой обучающий курс проходили? Нужна ссылка на ту тему, с вашим участием.

 

Радует, что некоторые ученики вырастают до своих проектов, используя знания полученные из "Академии". Тем кто начинает писать код использование этих подсказок очень поможет. Это сократит время на написание кода и изучение методов используемых библиотек, особенно если по ним нет документации или если есть пробелы в знании английского языка.

 

Ты когда уже что то новое сделаешь ?) Академию совсем забросил, не будешь повторять тут?

 

Отзыв.

Для начала обязательно укажите свой уровень владения информацией и навыками: в данной области вы новичок, теоретик либо опытный практик?
Начинающий практик (ZennoPoster + C# - English).

В каком виде предоставлен материал и насколько удобно он оформлен?
Шаблон ZP. Файл doc с описанием настройки шаблона. И файл pdf отвечающий на вопрос "Что такое подсказки".
Так же в комплекте библиотеки для работы шаблона и начальная база данных dictXML.db с отредактированным автором переводом более чем 7к фраз.

Сколько времени заняло изучение и выполнение заданий данного инфопродукта?
Чтение информации + настройка шаблона = 20 минут.
Перевод файлов в режиме с MyMemory:
ZennoLab.Macros.xml = 26 секунд;
ZennoLab.InterfacesLibrary.xml = 2 минуты 27 секунд;
ZennoLab.CommandCenter.xml = 7 минут 2 секунды;
HtmlAgilityPack.XML = 1 минута 53 секунды;
EPPlus.XML = 4 минуты 21 секунда;

Насколько легко усваивается материал, вызвал ли он какие-либо затруднения при проверке?
Ничего сложного нет. Закинул библиотеки в папку zp, указал файлы для перевода, и нажал старт. Затруднений не возникало.

Сколько времени заняло достижение заявленного автором результата?
Если взять всё с чтением инфы до получения первого файла перевода, то не более 30 минут.

Нужны ли специальные навыки и дополнительные материальные вложения?
Нужен только ZennoPoster. Если его нет, то затраты будут 10$ на выписку ZennoBox.

Каковы в целом общие впечатления о компетентности автора?
Компетентен.

При выполнении заданий следует полностью отказаться от теоретизирования и просто шаг за шагом выполнять все указания, приведенные в инфопродукте.
Так точно!

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

Этот шаблон необходим всем, кто на вы с английским!

Порадовала возможность редактировать не только свои переводы, но и уже заложенные в БД автором.
Описание как это сделать в описании так же есть.

Надеюсь кому-то пригодится:
После запуска библиотеки EPPlus.XML в паре с переводчиком Яндекс, у меня на перевод ушло 55 минут 28 секунд.
Как я понял это из-за моего IP, так как позже я запустил EPPlus.XML в паре с MyMemory 4 минуты 21 секунда, результат быстрее просто в разы.
Естественно чтобы был чистый результат, базу dictXML.db после Яндекс и перед MyMemory взял чистую, которая идёт в комплекте.
То есть обратите внимание, не заблокирован ли Яндекс в вашей стране/сети. Если заблокирован, то есть альтернатива MyMemory.

Предвижу вопрос: "Откуда такие точные результаты?"
Всё очень просто, во входных настройках есть возможность включить логгирование в таблицу .csv!
В ней указаны полностью все данные о каждом запросе с тайминогом.

 

Три отзыва есть. Сборы примерно через неделю (до НГ). Сделайте себе подарок на Новый год )

 

Сборы объявлены. Всех с наступающим Новым Годом !