Русскоязычная справка по PowerShell

На днях закончил, в первом приближении, русскоязычную справку по PowerShell в CHM формате.
Делал для себя любимого, но подумал, может кому еще пригодится.
Поэтому написал вводную часть и решил поделиться.
Завернул CHM-файл в ZIP, так как после пересылки по сети этот файл часто становится не читаемым.

Вложения

PowerShell.chm5.zip (2.07 Мб, 207 просмотров)

8

Вообще-то я рассчитывал на аудиторию примерно своего уровня
- продвинутых пользователей, которым, время от времени, нужен
мощный инструмент скриптинга, для решения ряда повседневных задач.
Я нашел в PowerShell такой инструмент, и при этом с относительно низким порогом освоения,
(в отличие от таких "монстров" как Python, которым он со временем стал).
Отсюда, естественно, Windows + PS 5.1. Именно для этих пользователей документация на русском
и попытка разложить информацию "по полочкам" может помочь быстрее освоить продукт.
А относительно "воды", то если посмотреть процент моей "отсебятины" по отношению к переводу,
то это вполне в пределах приличий, однако снимает ряд вопросов, которые могут возникнуть.

Linux и версии 6.0 и выше, это для админов, а им русский не нужен
и потуги простых смертных возможно смешны.
MacOS - не думаю, что за пределами МКАД есть сколько нибудь значимое число пользователей.
В нашем городе я о таких точно не слышал (смартфоны не в счет).
Поэтому, на интерес такой аудитории я даже не рассчитывал.

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

2

ang_54, Уважаемый никто не умаляет ваш труд, но подумайте первая версия вышла 14 ноября 2006 года сейчас 7, добавлена кроссплатформенность, есть весьма существенные изменения в работе многих командлетов, синтаксиса и т. д. статическая справка это конечно благо для изучения конкретной версии, но даже с момента моего вхождения в тему многое и очень много поменялось. да и в PS прекрасная встроенная справочная система. Если бы вы сделали ее в виде книги, это бы смотрелось логичнее, "Вот это все работает так на момент написания".

Добавлено через 2 минуты
многие мои скрипты из второй версии не стали работать на пятой, а пятые на седьмой, учить PS даже по абсолютно верной справке на какой-то момент времени может быть неактуально.

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

0

Сообщение от ang_54 вот новая версия

чем смотреть? на стандартной Win10 Pro все темы пустые.

Миниатюры

 

0

Для belalugoci
Что-то с настройками, может быть надо дать разрешение на файл, скачанный из интернета.
(Никаких скрытых скриптов внутри документа нет.)

Что касается частых обновлений и новых версий. Да, это проблема.
Однако, версии выше 5.1 нужны только админам, работающим в гетерогенных сетях.
А им русский точно не нужен, и даже вреден
(отставание по актуальности, лишние ошибки при переводе и разночтении в терминах).
Но это не означает, что перевод совсем никому не нужен.
К сожалению, далеко не все настолько владеют английским.
Я и сам не слишком им владею, не могу одновременно переводить и вникать.
Для серьезных вещей приходится сначала перевести, а потом пользоваться этим переводом,
поэтому я хорошо представляю проблемы тех, кто владеет языком на таком же, или меньшем уровне.
Кроме того, во время работы я заметил, что командлеты для обычного скриптинга на уровне пользователя,
в основном это работа с файловой системой и строками, ну иногда реестр, в общем то устоялись.
Так что в этой области документ останется актуальным несколько лет (я надеюсь).

0

старообрядец.

смешно.


вот так же в 70-х продвинутые американские пацаны придумали обрезать 8-ой бит в транспортных протоколах;
буквы английского языка умещаются и в 7 бит, а других языков в мире нет.

Добавлено через 36 минут
если серьёзно, различий между версиями 5, 6, 7 не так уж и много,

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

Построен же язык powershell так, чтобы семантически соответствовать литературному английскому языку,
все эти verb-noun foreach where select group, то есть, англоязычный пользователь чувствует себя относительно
комфортно.

Теперь берём русскоязычного, не знающего английский.
Он читает русский 'help' и на него вываливаются все эти длинные английские выражения плюс механистическое же
русское сопровождение, украшенное плохопереводимыми на русский английскими терминами типа drive и provider.


Какой из этого выход ?

Выход только один - сделать полностью свой осмысленный русский 'help' без оглядки на английский перевод.

Трудозатраты при этом вырастут на порядок. Или два.

Можно попросить у Джеффри грант. ))

0

Сообщение от ang_54 Для belalugoci Что-то с настройками

забавно, не работает про открытии из архива (почему интересно?), при распаковке и открытии всё показывается нормально.

0

Сообщение от ang_54 А им русский точно не нужен, и даже вреден

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

Опять же мы выражаем тут свои частные мнения, для кого то появление тернарного оператора и символьных диапазонов в PS 7 осталось не особо замеченным, а для меня это поменяло многое.

Мысль о том, что PS 6 и выше лишь для задротов, и то что мне хватит 5-ой мне кажется ошибочной, язык эволюционирует и это благо. И входить в PS7 лучше чем в PS5 ИМХО конечно.

1

уточнение: для задротов с макбуками.

0

Интереса ради расскажите, что вы делаете в MacOS Vs Ubuntu-CentOs с PowerShell, если вам еще желательна справка.
Не уверен про MacOS, в LM отлично работает KchmViewer. Чуть хуже xCHM, FBReader ( многие переходы не открывает )
Здесь существенный момент в чем именно отрабатывали корректность создания справки и конечно сами переходы на страницы. В LM всё открывает KchmViewer.
Конечно, все и я в том числе используем хотя б Get-Help ... и остальное.
Тут можно сразу понять, требуется полноценная справка в варианте подключения к интернету, но более того к нужным ресурсам и что бы они были в MS не пофиксены как не поддерживаемые. Да ещё интернет.
Пользовался и продолжаю как в разы более простой справочник один из первых выпусков PowerShell.chm
Дата публикации: сентябрь 2006 г.
Автор: Алекс Ангелополус (Alex Angelopolous), MVP
Соавторы: Дин Тсалтас (Dean Tsaltas) и Джун Блендер (June Blender)
Редакторы: Рон Лой (Ron Loi) и Крейг Либендорфер (Craig Liebendorfer)
Кто переводил, не смог найти.
Несмотря на рабочий PS 5.1, справочник 2.0 отлично помогает.
Понятно, каждый имеет свои записи. У кого-то много страниц вида power_shell_book в Word, PDF. У меня также в OneNote.
Но с .chm имхо самый лучший вариант.
Авторам, которые как-то указывают на его проприетарность наверное не очень мешает слегка не бесплатная сама операционка MsWindows, после чего надо заметить платность хелпера в формате .CHM. Тут скорее в юмор, больше не отгадаю в какие аналоги.
Спасибо автору. Может мне было чуть интересные, если все темы имели примеры. Но не буду придираться, т.к. правда благодарен отличной работе.

0

Сообщение от Segera Интереса ради расскажите, что вы делаете в MacOS Vs Ubuntu-CentOs с PowerShell, если вам еще желательна справка.

я не смогу придумать рассказ на эту тему.

0

СПАСИБО

0