Skip to content

Commit

Permalink
* Добавил HelpUri (#122)
Browse files Browse the repository at this point in the history
  • Loading branch information
sergey-s-betke committed Sep 22, 2013
1 parent 2f56e96 commit 883b176
Show file tree
Hide file tree
Showing 3 changed files with 83 additions and 55 deletions.
70 changes: 43 additions & 27 deletions ITG.Readme.psm1
Original file line number Diff line number Diff line change
Expand Up @@ -767,14 +767,14 @@ Function Get-Readme {
.Outputs
String.
Содержимое readme.md.
.Link
https://github.com/IT-Service/ITG.Readme#Get-Readme
.Link
[MarkDown]: <http://daringfireball.net/projects/markdown/syntax> "MarkDown (md) Syntax"
.Link
about_comment_based_help
.Link
[Написание справки для командлетов](http://go.microsoft.com/fwlink/?LinkID=123415)
.Link
https://github.com/IT-Service/ITG.Readme#Get-Readme
.Example
Get-Module 'ITG.Yandex.DnsServer' | Get-Readme | Out-File -Path 'readme.md' -Encoding 'UTF8' -Width 1024;
Генерация readme.md файла для модуля `ITG.Yandex.DnsServer`
Expand All @@ -788,7 +788,8 @@ Function Get-Readme {
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Get-Readme'
)]

param (
Expand Down Expand Up @@ -1250,6 +1251,8 @@ Function Set-Readme {
System.Management.Automation.FunctionInfo.
Описатели функций, для которых будет сгенерирован readme.md.
Получены описатели могут быть через Get-Command.
.Link
https://github.com/IT-Service/ITG.Readme#Set-Readme
.Link
Get-Readme
.Link
Expand All @@ -1258,8 +1261,6 @@ Function Set-Readme {
about_comment_based_help
.Link
[Написание справки для командлетов](http://go.microsoft.com/fwlink/?LinkID=123415)
.Link
https://github.com/IT-Service/ITG.Readme#Set-Readme
.Example
Get-Module 'ITG.Yandex.DnsServer' | Set-Readme;
Генерация readme.md файла для модуля `ITG.Yandex.DnsServer`
Expand All @@ -1277,6 +1278,7 @@ Function Set-Readme {
DefaultParametersetName = 'ModuleInfo'
, SupportsShouldProcess = $true
, ConfirmImpact = 'Low'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Set-Readme'
)]

param (
Expand Down Expand Up @@ -1420,21 +1422,22 @@ Function Get-AboutModule {
.Outputs
String.
Содержимое about.txt.
.Link
https://github.com/IT-Service/ITG.Readme#Get-AboutModule
.Link
[MarkDown]: <http://daringfireball.net/projects/markdown/syntax> "MarkDown (md) Syntax"
.Link
about_comment_based_help
.Link
[Написание справки для командлетов](http://go.microsoft.com/fwlink/?LinkID=123415)
.Link
https://github.com/IT-Service/ITG.Readme#Get-AboutModule
.Example
Get-Module 'ITG.Yandex.DnsServer' | Get-AboutModule;
Генерация содержимого about.txt файла для модуля `ITG.Yandex.DnsServer`.
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Get-AboutModule'
)]

param (
Expand Down Expand Up @@ -1495,6 +1498,8 @@ Function Set-AboutModule {
System.Management.Automation.PSModuleInfo.
Описатели модулей, для которых будет сгенерирован readme.md.
Получены описатели могут быть через Get-Module.
.Link
https://github.com/IT-Service/ITG.Readme#Set-AboutModule
.Link
Get-AboutModule
.Link
Expand All @@ -1503,8 +1508,6 @@ Function Set-AboutModule {
about_comment_based_help
.Link
[Написание справки для командлетов](http://go.microsoft.com/fwlink/?LinkID=123415)
.Link
https://github.com/IT-Service/ITG.Readme#Set-AboutModule
.Example
Get-Module 'ITG.Yandex.DnsServer' | Set-AboutModule;
Генерация `about_ITG.Yandex.DnsServer.txt` файла для модуля `ITG.Yandex.DnsServer`
Expand All @@ -1515,6 +1518,7 @@ Function Set-AboutModule {
DefaultParametersetName='ModuleInfo'
, SupportsShouldProcess = $true
, ConfirmImpact = 'Low'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Set-AboutModule'
)]

param (
Expand Down Expand Up @@ -1747,21 +1751,22 @@ Function New-HelpXML {
.Outputs
System.Xml.XmlDocument
Содержимое XML справки.
.Link
https://github.com/IT-Service/ITG.Readme#New-HelpXML
.Link
about_Comment_Based_Help
.Link
about_Updatable_Help
.Link
[Creating the Cmdlet Help File](http://msdn.microsoft.com/en-us/library/bb525433.aspx)
.Link
https://github.com/IT-Service/ITG.Readme#New-HelpXML
.Example
Get-Module 'ITG.Yandex.DnsServer' | New-HelpXML;
Генерация xml справки для модуля `ITG.Yandex.DnsServer`.
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#New-HelpXML'
)]

param (
Expand Down Expand Up @@ -2027,20 +2032,21 @@ Function Get-HelpXML {
.Outputs
System.Xml.XmlDocument
Содержимое XML справки.
.Link
https://github.com/IT-Service/ITG.Readme#Get-HelpXML
.Link
about_Updatable_Help
.Link
[Creating the Cmdlet Help File](http://msdn.microsoft.com/en-us/library/bb525433.aspx)
.Link
https://github.com/IT-Service/ITG.Readme#Get-HelpXML
.Example
Get-Module 'ITG.Yandex.DnsServer' | Get-HelpXML;
Возвращает содержимое xml файла справки для модуля `ITG.Yandex.DnsServer`
в виде XML документа.
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Get-HelpXML'
)]

param (
Expand Down Expand Up @@ -2140,22 +2146,25 @@ Function Set-HelpXML {
System.Management.Automation.CmdletInfo
Описатели командлет. Именно для них и будет сгенерирована XML справка.
Получены описатели могут быть через `Get-Command`.
.Link
https://github.com/IT-Service/ITG.Readme#Set-HelpXML
.Link
Get-HelpXML
.Link
about_Updatable_Help
.Link
[Creating the Cmdlet Help File](http://msdn.microsoft.com/en-us/library/bb525433.aspx)
.Link
https://github.com/IT-Service/ITG.Readme#Set-HelpXML
.Example
Get-Module 'ITG.Yandex.DnsServer' | Set-HelpXML;
Генерация xml файла справки для модуля `ITG.Yandex.DnsServer`
в каталоге модуля.
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, SupportsShouldProcess = $true
, ConfirmImpact = 'Low'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Set-HelpXML'
)]

param (
Expand Down Expand Up @@ -2350,12 +2359,12 @@ Function New-HelpInfo {
.Outputs
System.Xml.XmlDocument
Содержимое XML манифеста (HelpInfo.xml) справки.
.Link
https://github.com/IT-Service/ITG.Readme#New-HelpInfo
.Link
about_Updatable_Help
.Link
Set-HelpInfo
.Link
https://github.com/IT-Service/ITG.Readme#New-HelpInfo
.Link
[HelpInfo XML Sample File](http://msdn.microsoft.com/en-us/library/windows/desktop/hh852750.aspx)
.Example
Expand All @@ -2364,7 +2373,8 @@ Function New-HelpInfo {
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#New-HelpInfo'
)]

param (
Expand Down Expand Up @@ -2443,14 +2453,14 @@ Function Get-HelpInfo {
.Outputs
System.Xml.XmlDocument
Содержимое XML манифеста (HelpInfo.xml) справки.
.Link
https://github.com/IT-Service/ITG.Readme#Get-HelpInfo
.Link
about_Updatable_Help
.Link
Set-HelpInfo
.Link
New-HelpInfo
.Link
https://github.com/IT-Service/ITG.Readme#Get-HelpInfo
.Link
[How to Name a HelpInfo XML File](http://msdn.microsoft.com/en-us/library/windows/desktop/hh852748.aspx)
.Link
Expand All @@ -2461,7 +2471,8 @@ Function Get-HelpInfo {
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Get-HelpInfo'
)]

param (
Expand Down Expand Up @@ -2521,10 +2532,14 @@ Function Set-HelpInfo {
Получены описатели могут быть через `Get-Module`.
.Outputs
None.
.Link
https://github.com/IT-Service/ITG.Readme#Set-HelpInfo
.Link
about_Updatable_Help
.Link
https://github.com/IT-Service/ITG.Readme#Set-HelpInfo
Get-HelpInfo
.Link
New-HelpInfo
.Link
[HelpInfo XML Sample File](http://msdn.microsoft.com/en-us/library/windows/desktop/hh852750.aspx)
.Example
Expand All @@ -2533,9 +2548,10 @@ Function Set-HelpInfo {
#>

[CmdletBinding(
DefaultParametersetName='ModuleInfo'
DefaultParametersetName = 'ModuleInfo'
, SupportsShouldProcess = $true
, ConfirmImpact = 'Medium'
, HelpUri = 'https://github.com/IT-Service/ITG.Readme#Set-HelpInfo'
)]

param (
Expand Down
3 changes: 3 additions & 0 deletions readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -559,6 +559,8 @@ HelpInfo.xml в каталоге модуля, либо создаёт новы

- [Online версия справки](https://github.com/IT-Service/ITG.Readme#Set-HelpInfo)
- [about_Updatable_Help][]
- [Get-HelpInfo][]
- [New-HelpInfo][]
- [HelpInfo XML Sample File](http://msdn.microsoft.com/en-us/library/windows/desktop/hh852750.aspx)

#### Get-HelpXML
Expand Down Expand Up @@ -856,6 +858,7 @@ HelpInfo.xml в каталоге модуля, либо создаёт новы
##### См. также

- [Online версия справки](https://github.com/IT-Service/ITG.Readme#Set-HelpXML)
- [Get-HelpXML][]
- [about_Updatable_Help][]
- [Creating the Cmdlet Help File](http://msdn.microsoft.com/en-us/library/bb525433.aspx)

Expand Down
Loading

0 comments on commit 883b176

Please sign in to comment.