Merge-MarkdownHelp
동일한 cmdlet의 여러 markdown 버전을 단일 markdown 파일에 병합합니다.
구문
Merge-MarkdownHelp
[-Path] <String[]>
[-OutputPath] <String>
[-Encoding <Encoding>]
[-ExplicitApplicableIfAll]
[-Force]
[[-MergeMarker] <String>]
[<CommonParameters>]
Description
유사한 모듈 또는 동일한 모듈의 다른 버전에는 종종 중복 콘텐츠가 포함됩니다.
Merge-MarkdownHelp 여러 markdown 파일을 단일 markdown 파일에 병합합니다.
applicable:
yaml 메타데이터 필드를 사용하여 적용 가능한 버전 또는 태그를 식별합니다.
전체 cmdlet 및 개별 매개 변수의 두 가지 수준에서 작동합니다.
결과 markdown에는 원래 markdown 파일의 모든 콘텐츠뿐만 아니라 applicable:
태그가 포함됩니다.
중복 콘텐츠는 무시됩니다.
각 파일에 고유한 콘텐츠는 병합 표식을 사용하여 병합된 다음 해당 태그의 쉼표로 구분된 목록을 만듭니다.
병합 표식 병합된 콘텐츠를 설명하는 표식 역할을 하는 텍스트 문자열입니다.
기본 병합 표식 텍스트는 !! 세 가지 느낌표로 구성됩니다. 그러나 -MergeMarker 플래그를 사용하여 관련 텍스트로 변경할 수 있습니다.
예제
예제 1
Test-CsPhoneBootstrap.md cmdlet은 Lync Server 2010 및 Lync Server 2013 모두에 포함되어 있습니다. 대부분의 콘텐츠가 중복되므로 각 개별 파일에서 고유한 콘텐츠가 병합된 cmdlet에 대한 단일 파일을 포함하려고 합니다.
Merge-MarkdownHelp -Path @('Lync Server 2010\Test-CsPhoneBootstrap.md', 'Lync Server 2013\Test-CsPhoneBootstrap.md') -OutputPath lync
결과 파일은 lync\Test-CsPhoneBootstrap.md
.
매개 변수
-Encoding
외부 도움말 파일의 문자 인코딩을 지정합니다. System.Text.Encoding 개체를 지정합니다. 자세한 내용은 about_Character_Encoding참조하세요.
형식: | Encoding |
Position: | Named |
Default value: | UTF8 without BOM |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ExplicitApplicableIfAll
항상 적용 가능한 태그의 전체 목록을 작성합니다. 기본적으로 모든 변형에 있는 cmdlet 및 매개 변수는 애플리케이션 태그를 얻지 못합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Force
이 cmdlet은 이름이 같은 기존 파일을 덮어씁니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-MergeMarker
병합 텍스트 표시기로 사용할 문자열입니다. 해당 태그 목록은 표식 후에 포함됩니다.
형식: | String |
Position: | 3 |
Default value: | '!!! ' |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-OutputPath
이 cmdlet이 결합된 markdown 도움말 파일을 만드는 폴더의 경로를 지정합니다.
형식: | String |
Position: | 1 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Path
markdown 파일 또는 폴더의 경로 배열을 지정합니다. 이 cmdlet은 이러한 파일 및 폴더를 기반으로 결합된 markdown 도움말을 만듭니다.
형식: | String[] |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
입력
String[]
출력
FileInfo[]