텍스트 서식 지정 지침

텍스트 요소에 대해 굵게, 기울임꼴 및 코드 스타일을 일관되고 적절하게 사용하면 가독성이 향상되고 잘못 이해하지 않도록 방지할 수 있습니다. 텍스트 서식 요소가 이 지침에서 다루지 않는 경우 Microsoft 쓰기 스타일 가이드를 참조하세요. 다음 문서에서는 텍스트 서식 지정에 대한 자세한 지침을 제공합니다.

• 일반 텍스트 요소 서식 지정

• 지침 텍스트 서식 지정

• 일반적인 개발자 요소 서식 지정

UI 요소

메뉴 항목, 대화 상자 이름 및 텍스트 상자 이름과 같은 UI 요소는 굵은 텍스트여야 합니다.

• 이: 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭한 다음새 항목>를 선택합니다.

• 적용되지 않음: 솔루션 탐색기에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 추가 > 새 항목을 차례로 선택합니다.

Git 리포지토리 및 분기 이름

지침을 선택하거나 입력할 때 Git 리포지토리 또는 분기 이름에 굵은 텍스트를 사용합니다.

• 이: 분기 메뉴에서 기본을 선택합니다.

• 이것이 아님: 분기 메뉴에서 "main"을 선택합니다.

새 용어 소개

기울임꼴 텍스트를 사용하여 정의 또는 설명과 함께 새 용어를 도입합니다. 처음 사용할 때 새 용어를 기울임꼴로 지정한 다음 정의 또는 설명에 일반 텍스트를 사용합니다.

• 적용됨: 앱은 App Service의 App Service 계획에서 실행됩니다. App Service 계획은 웹앱이 실행될 컴퓨팅 리소스 집합을 정의합니다.

• 적용되지 않음: App Service에서 앱은 “App Service 요금제”로 실행됩니다. App Service 요금제는 실행할 웹앱의 컴퓨팅 리소스 집합을 정의합니다.

코드 스타일

코드 스타일을 사용하는 항목은 다음과 같습니다.

• 메서드 이름, 속성 이름 및 언어 키워드와 같은 코드 요소
• SQL 명령
• NuGet 패키지 이름
• 명령줄 명령*
• 데이터베이스 테이블 및 열 이름
• 지역화되지 않아야 하는 리소스 이름(예: 가상 머신 이름)
• 클릭할 수 없게 하려는 URL

이유는 무엇입니까? 일부 스타일 안내선은 이러한 많은 텍스트 요소에 대해 굵게 지정합니다. 하지만 대부분의 문서는 지역화되며, 코드 스타일은 텍스트의 해당 부분을 번역하지 않도록 번역기에 지시합니다.

코드 스타일은 인라인 ('으로 묶인) 또는 여러 줄에 걸쳐 있는 펜스 코드 블록(''으로 묶인)일 수 있습니다. 긴 코드 조각과 경로는 펜스를 친 코드 블록에 넣습니다.

* 명령줄 명령 내에 모든 플랫폼에서 지원되는 경우 파일 경로에 전달 슬래시를 사용합니다. 백슬래시만 지원되는 경우 Windows에 실행되는 명령을 보여 주려면 백슬래시를 사용합니다. 예를 들어 전달 슬래시는 모든 플랫폼의 .NET CLI에서 작동하므로 dotnet build foldername/filename.csproj 대신 dotnet build foldername\filename.csproj을 사용합니다.

인라인 스타일을 사용하는 예제

• 적용됨: 기본적으로 Entity Framework에서는 Id 또는 ClassnameID라는 속성을 기본 키로 해석합니다.
• 적용되지 않음: 기본적으로 Entity Framework에서는 Id 또는 ClassnameID라는 속성을 기본 키로 해석합니다.
• 적용됨: Microsoft.EntityFrameworkCore 패키지는 EF Core에 대한 런타임 지원을 제공합니다.
• 적용되지 않음: Microsoft.EntityFrameworkCore 패키지는 EF Core에 대한 런타임 지원을 제공합니다.

펜스를 친 코드 블록의 예

• 적용됨: 다음 코드와 같이 IQueryable만 변경하는 명령문으로는 어떤 명령도 데이터베이스로 보낼 수 없습니다.

      ```csharp
      var students = context.Students.Where(s => s.LastName == "Davolio")
      ```
  

• 적용되지 않음: 와 같이 >만 변경하는 명령문으로는 어떤 명령도 데이터베이스로 보낼 수 없습니다.

• 적용됨: 예를 들어 Get-ServiceLog.ps1 디렉터리에서 C:\Scripts 스크립트를 실행하려면 다음과 같이 입력합니다.

      ```powershell
      C:\Scripts\Get-ServiceLog.ps1
      ```
  

• 적용되지 않음: 예를 들어 C:\Scripts 디렉터리에서 Get-ServiceLog.ps1 스크립트를 실행하려면 "C:\Scripts\Get-ServiceLog.ps1"을 입력합니다.

• 펜싱된 코드 블록 모두에 승인된 언어 태그가 있어야 합니다. 지원 언어 태그 목록은 문서에 코드를 포함하는 방법을 참조하세요.

자리 표시자

단락 텍스트나 절차 단계에서는 사용자가 자신의 정보로 대체할 자리 표시자 텍스트를 기울임꼴로 표시하세요.

• 이: 암호 입력

• Not this: "비밀번호"를 입력하십시오

• 이: -p 암호를 입력하세요

• Not this: -p 암호를 입력하세요

사용자가 입력 문자열의 일부를 고유한 값으로 바꾸도록 하려면 꺾쇠 괄호(보다 작음 < 및 보다 큼 > 문자)로 표시된 자리 표시자 텍스트를 사용합니다.

옵션 1: 코드 스타일 지정을 사용하여 자리 표시자 단어나 포함하는 구를 둘러쌉니다. 예를 들어 단일 구의 인라인 코드 서식 지정에 단일 백틱(`)을 사용하거나 코드 펜싱된 서식 지정에 백틱 세 개(```)를 사용할 수 있습니다.

`az group delete -n <ResourceGroupName>`

다음과 같이 렌더링됩니다.

az group delete -n <ResourceGroupName>

또는

옵션 2:\ 및 \<처럼 백슬래시 문자 \>를 사용하여 Markdown에서 꺾쇠 괄호 문자를 이스케이프합니다. 왼쪽 꺾쇠 괄호의 첫 번째 이스케이프 \<만 필요하지만, 일관성을 위해 닫는 괄호 이스케이프 \>도 사용합니다. 렌더링된 HTML은 독자에게 이스케이프 문자를 표시하지 않습니다.

az group delete -n \<ResourceGroupName\>

다음과 같이 렌더링됩니다.

az group delete -n <ResourceGroupName>

개체 틀에 대해 판독기에게 알립니다. 자리 표시자 예제 앞의 텍스트에서 대괄호 안의 텍스트를 제거하고 실제 값으로 대체해야 한다고 판독기에게 설명합니다. 사용자 입력에는 기울일꼴을 사용하는 것이 좋습니다. 꺾쇠 괄호 인라인 코드 내에 기울임꼴 서식을 지정할 수 있습니다.

다음 예제에서 <ResourceGroupName> 텍스트를 고유한 리소스 그룹 이름으로 바꿉니다.

중괄호 { }는 구문 자리 표시자로 사용하지 않는 것이 좋습니다. 독자가 다음에 사용된 동일한 표기법과 중괄호 자리 표시자를 혼동할 수 있습니다.

• 대체 가능한 텍스트
• 형식 문자열
• 문자열 보간
• 텍스트 템플릿
• 유사한 프로그래밍 구문

대/소문자 표기 및 간격: 하이픈(“kebab case”) 또는 밑줄을 사용하여 자리 표시자 이름을 구분하거나 파스칼식 대/소문자를 사용하여 자리 표시자 이름을 구분할 수 있습니다. Kebab case는 구문 오류를 생성할 수 있으며, 밑줄은 밑줄 표시(underlining)와 충돌할 수 있습니다. 모든 대문자 사용은 여러 언어의 명명된 상수와 충돌할 수 있지만 자리 표시자 이름에 주의를 끌 수도 있습니다.

<Resource-Group-Name> 또는 <ResourceGroupName>

제목

제목에 기울기, 굵게 또는 인라인 코드 스타일과 같은 인라인 스타일을 적용하지 마세요.

이유는 무엇입니까? 제목에는 고유한 스타일이 있으며 다른 스타일을 혼합하면 불일치가 발생합니다.

• 이: Microsoft.NET.Sdk.Functions 패키지 가져오기

• 이 내용이 아님: Microsoft.NET.Sdk.Functions 패키지 가져오기

링크 텍스트

텍스트를 연결하려면 기울기 또는 굵게와 같은 인라인 스타일을 적용하지 마세요.

이유는 무엇입니까? 사용자는 표준 하이퍼링크 텍스트를 사용하여 텍스트 요소를 클릭 가능한 링크로 식별합니다. 예를 들어 링크를 기울임꼴로 스타일링하면 텍스트가 링크라는 사실을 모호하게 만들 수 있습니다.

• 이: NuGet 패키지 Microsoft.NET.Sdk.Functions 는 function.json 파일을 생성합니다.

그렇지 않음: NuGet 패키지 Microsoft.NET.Sdk.Functions는 function.json 파일을 생성합니다.

키 및 바로 가기 키

키 또는 키 조합을 나타내는 경우 다음 규칙을 따릅니다.

• 키 이름의 첫 글자는 대문자로 표시합니다.
• 키 이름을 <kbd> 및 </kbd> HTML 태그로 묶습니다.
• 사용자가 동시에 선택하는 키를 조인하려면 "+"를 사용합니다.

키 및 바로 가기 키 예시

• 적용됨: Alt+Ctrl+S를 선택합니다.
• 그렇지 않음: Alt+Ctrl+S를 누릅니 다.
• 적용되지 않음: ALT+CTRL+S를 누릅니다.

예외

일관된 스타일 지침은 신뢰할 수 있는 고객 환경을 만들고 제작 프로세스를 간소화합니다. 이러한 지침에 대한 예외는 신중하게 고려해야 합니다.

예외에 일반적으로 코드를 호출하는 대체 텍스트 스타일을 사용하는 경우 지역화된 버전의 아티클에서 텍스트를 번역해도 괜찮은지 확인합니다. 코드 스타일을 사용하지 않고도 지역화를 방지하려는 시나리오의 경우 지역화되지 않은 문자열을 참조하세요.