{"id":13353,"date":"2017-02-09T10:20:42","date_gmt":"2017-02-09T18:20:42","guid":{"rendered":"https:\/\/www.sapien.com\/blog\/?p=13353"},"modified":"2017-02-09T10:17:21","modified_gmt":"2017-02-09T18:17:21","slug":"powershell-helpwriter-2017-service-release-v2-1-33-plus-markdown","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2017\/02\/09\/powershell-helpwriter-2017-service-release-v2-1-33-plus-markdown\/","title":{"rendered":"PowerShell HelpWriter 2017: Service Release v2.1.33 Plus Markdown"},"content":{"rendered":"<p>Today we released a new build of PowerShell HelpWriter 2017 (v2.1.33).<\/p>\n<p>In this article, we will discuss the new features introduced in this build.<\/p>\n<p>&nbsp;<\/p>\n<h2>Exporting Help<\/h2>\n<p>We added the ability to export the help files into two useful file formats:<\/p>\n<ul>\n<li>Markdown<\/li>\n<li>HTML<\/li>\n<\/ul>\n<p>To export your help files, use the Ribbon menu:<\/p>\n<p>Ribbon-&gt;Home-&gt;Export<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/Ribbon-Export.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"Ribbon-Export\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/Ribbon-Export_thumb.png\" alt=\"Ribbon-Export\" width=\"644\" height=\"78\" border=\"0\" \/><\/a><\/p>\n<p>We introduced two ways of exporting your help:<\/p>\n<ul>\n<li>Per file<\/li>\n<li>Per cmdlet.<\/li>\n<\/ul>\n<h3>File Export<\/h3>\n<p>When exporting a whole file, the application will ask you to select the target folder.<\/p>\n<p>For projects, the default location is set to the <strong><em>Exported Files<\/em><\/strong> folder, which is located under the project\u2019s directory.<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image3.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"image[3]\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image3_thumb.png\" alt=\"image[3]\" width=\"404\" height=\"238\" border=\"0\" \/><\/a><\/p>\n<p>A new file will be generated for each cmdlet in the help file. Each file will be named after its cmdlet.<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; margin: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"image\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image_thumb.png\" alt=\"image\" width=\"644\" height=\"363\" border=\"0\" \/><\/a><\/p>\n<p>For large help files, you will be presented with a progress bar which includes the option to cancel.<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image-1.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; margin: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"image\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image_thumb-1.png\" alt=\"image\" width=\"385\" height=\"129\" border=\"0\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<h3>Cmdlet Export<\/h3>\n<p>When exporting a single cmdlet, you have the option to specify the file\u2019s name. The default will still be set to the cmdlet\u2019s name.<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image-2.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; margin: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"image\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/image_thumb-2.png\" alt=\"image\" width=\"644\" height=\"378\" border=\"0\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>Now let us take a closer look at the export formats.<\/p>\n<h2>Markdown<\/h2>\n<p>For those of you who use GitHub, you can now export your existing PowerShell help files to markdown (*.md) files and use them directly in your GitHub repositories.<\/p>\n<p>Markdown is a plain text formatting language that is used to convert text into HTML. Websites such as GitHub use markdown to display formatted help documentation.<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/Markdown-Example.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"Markdown Example\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/Markdown-Example_thumb.png\" alt=\"Markdown Example\" width=\"406\" height=\"484\" border=\"0\" \/><\/a><\/p>\n<p>PowerShell HelpWriter follows the community approved markdown schema for PowerShell help to generate the file.<\/p>\n<p>&nbsp;<\/p>\n<h2>HTML<\/h2>\n<p>You can also export your help files to HTML and use the resulting files to display your help directly on the web.<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/HTML-Example.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"HTML Example\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/HTML-Example_thumb.png\" alt=\"HTML Example\" width=\"559\" height=\"484\" border=\"0\" \/><\/a><\/p>\n<p>When distributing your html files, be sure to include the accompanying <strong>style.css<\/strong> file.<\/p>\n<p>&nbsp;<\/p>\n<h2><\/h2>\n<h2>About Files and Sub-Headers<\/h2>\n<p>In this release, we added syntax coloring support for sub-headers.<\/p>\n<p>Sub-headers are denoted when there is a single space after a new line and the text contains all capital letters:<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/About-File-Sub-Header.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"About File Sub Header\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/About-File-Sub-Header_thumb.png\" alt=\"About File Sub Header\" width=\"644\" height=\"320\" border=\"0\" \/><\/a><\/p>\n<p>And yes, you can also export your existing about files to markdown and HTML:<\/p>\n<p><a href=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/About-Markdown.png\" target=\"_blank\"><img loading=\"lazy\" decoding=\"async\" style=\"background-image: none; padding-top: 0px; padding-left: 0px; display: inline; padding-right: 0px; border-width: 0px;\" title=\"About Markdown\" src=\"https:\/\/www.sapien.com\/blog\/wp-content\/uploads\/2017\/02\/About-Markdown_thumb.png\" alt=\"About Markdown\" width=\"446\" height=\"484\" border=\"0\" \/><\/a><\/p>\n<p>As you can see, sub-headers are formatted in the exported files.<\/p>\n<p>&nbsp;<\/p>\n<h2>Generated Help File Update<\/h2>\n<p>We also updated the help files generated by the application to include extra meta-data such as:<\/p>\n<ul>\n<li>Is the command a workflow?<\/li>\n<li>Does the command use common parameters?<\/li>\n<\/ul>\n<p>This additional information will be utilized by PowerShell Studio to generate modules from help and by PowerShell HelpWriter for exporting.<\/p>\n<p>&nbsp;<\/p>\n<p>Please continue providing your feedback. Many of the new features included in the service builds are suggestions from users like you. Therefore, if you have any suggestions or feature requests, please share them with us on our <a href=\"https:\/\/www.sapien.com\/forums\/viewforum.php?f=9\">Wish List and Feature Requests<\/a> forum.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Today we released a new build of PowerShell HelpWriter 2017 (v2.1.33). In this article, we will discuss the new features introduced in this build. &nbsp; Exporting Help We added the ability to export the help files into two useful file formats: Markdown HTML To export your help files, use the Ribbon menu: Ribbon-&gt;Home-&gt;Export We introduced [&hellip;]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[1038,624,21,632],"tags":[450,103,1190,28,953,155],"class_list":["post-13353","post","type-post","status-publish","format-standard","hentry","category-powershell-helpwriter","category-service-build","category-software-news","category-whats-new-software-news","tag-help","tag-html","tag-markdown","tag-powershell","tag-powershell-help-writer","tag-service-release"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/13353","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=13353"}],"version-history":[{"count":4,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/13353\/revisions"}],"predecessor-version":[{"id":13368,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/13353\/revisions\/13368"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=13353"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=13353"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=13353"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}