Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/microsoft/PSDocs below:

microsoft/PSDocs: Generate documentation from Infrastructure as Code (IaC).

A PowerShell module with commands to generate markdown from objects using PowerShell syntax.

This project uses GitHub Issues to track bugs and feature requests. Please search the existing issues before filing new issues to avoid duplicates.

• For new issues, file your bug or feature request as a new issue.
• For help, discussion, and support questions about using this project, join or start a discussion.

Support for this project/ product is limited to the resources listed above.

You can download and install the PSDocs module from the PowerShell Gallery.

For integration modules see related projects.

The following example shows basic PSDocs usage. For specific use cases see scenarios.

A document provides instructions on how PSDocs should render an object into documentation. To define a document, create the Document script block saved to a file with the .Doc.ps1 extension.

For example:

# File: Sample.Doc.ps1

# Define a document called Sample
Document Sample {
    # Define content here
}

Within the document body provide one or more instructions.

For example:

# File: Sample.Doc.ps1

# Define a document called Sample
Document Sample {

    # Add an introduction section
    Section Introduction {
        # Add a comment
        "This is a sample file list from $TargetObject"

        # Generate a table
        Get-ChildItem -Path $TargetObject | Table -Property Name,PSIsContainer
    }
}

To execute the document use Invoke-PSDocument.

For example:

Invoke-PSDocument -InputObject 'C:\';

An example of the output generated is available here.

• Azure Resource Manager template example
• Integration with DocFX

PSDocs extends PowerShell with domain specific language (DSL) keywords and cmdlets.

The following language keywords are used by the PSDocs module:

• Document - Defines a named documentation block
• Section - Creates a named section
• Title - Sets the document title
• Code - Inserts a block of code
• BlockQuote - Inserts a block quote
• Note - Inserts a note using DocFx formatted markdown (DFM)
• Warning - Inserts a warning using DocFx formatted markdown (DFM)
• Metadata - Inserts a yaml header
• Table - Inserts a table from pipeline objects
• Include - Insert content from an external file

The following commands exist in the PSDocs module:

• Invoke-PSDocument
• Get-PSDocument
• Get-PSDocumentHeader
• New-PSDocumentOption

The following commands exist in the PSDocs.Dsc module:

• Get-DscMofDocument
• Invoke-DscNodeDocument

The following conceptual topics exist in the PSDocs module:

• Configuration
• Conventions
• Options
  • Configuration
  • Execution.LanguageMode
  • Markdown.ColumnPadding
  • Markdown.Encoding
  • Markdown.SkipEmptySections
  • Markdown.UseEdgePipes
  • Markdown.WrapSeparator
  • Output.Culture
  • Output.Path
• Selectors
  • AllOf
  • AnyOf
  • Contains
  • Equals
  • EndsWith
  • Exists
  • Field
  • Greater
  • GreaterOrEquals
  • HasValue
  • In
  • IsLower
  • IsString
  • IsUpper
  • Less
  • LessOrEquals
  • Match
  • Not
  • NotEquals
  • NotIn
  • NotMatch
  • StartsWith
• Variables
  • $Culture
  • $Document
  • $InstanceName
  • $LocalizedData
  • $PSDocs
  • $TargetObject
  • $Section

The following projects use or integrate with PSDocs.

Modules in this repository will use the semantic versioning model to declare breaking changes from v1.0.0. Prior to v1.0.0, breaking changes may be introduced in minor (0.x.0) version increments. For a list of module changes please see the change log.

Pre-release module versions are created on major commits and can be installed from the PowerShell Gallery. Pre-release versions should be considered experimental. Modules and change log details for pre-releases will be removed as standard releases are made available.

This project welcomes contributions and suggestions. If you are ready to contribute, please visit the contribution guide.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

• Bernie White
• Vic Perdana

This project is licensed under the MIT License.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4