구두점
구두점 (Punctuation)
UI에 쓰는 구두점 하나로도 문장의 의미와 톤이 달라져요. 헤딩, 인용, 버튼, 다양한 대시 등 상황별 구두점 사용 규칙을 이 문서에서 정리해 드릴게요.
출처: 문서
본문
헤딩과 제목 (Headings and titles)
헤딩과 제목은 구두점을 포함할 수 있지만, 구두점으로 끝나서는 안 돼요. 예를 들어:
| Before | After |
|---|---|
| Style, voice, and tone. | Style, voice, and tone |
| Getting started with PatternFly! | Getting started with PatternFly |
이 규칙의 예외는 문맥상 중요한 물음표예요. 예를 들어 확인 다이얼로그에서 사용자가 어떤 동작을 하려는지 이해하는 것이 중요해요. 유효한 헤딩은 "Delete service account?"처럼 물음표를 포함할 수 있어요.
UI에서 텍스트를 언급할 때 (Referring to text in the UI)
UI에서 요소나 텍스트를 언급할 때는 굵은 텍스트(bold)를 사용하세요. 인용부호나 이탤릭체는 사용하지 마세요 — 그것들은 각각 인용과 강조를 위해 남겨 두어야 해요. 예를 들어:
| Before | After |
|---|---|
| Add user to the "Group title" team | Add user to the Group title team |
병렬 구조 (Parallel structure)
목록이나 연속(series)의 모든 항목은 같은 품사여야 해요. 예를 들어:
| Before | After |
|---|---|
| Remember these important tips: Write clearly; conduct research; spelling and grammar. | Remember these important tips: Write clearly; conduct research; use correct spelling and grammar. |
앰퍼샌드 (&) (Ampersand)
명확성을 위해 앰퍼샌드(&) 사용을 피하고 "and"를 사용하세요.
버튼 (Buttons)
버튼에는 구두점을 사용하지 마세요.
버튼에 아이콘을 만들기 위해 구두점을 사용하지 마세요(예: 더하기 기호 "+"를 사용하지 마세요). 대신 버튼에 넣는 모든 아이콘은 PatternFly의 icons 페이지를 참고하세요.
콜론과 세미콜론 (Colon and semicolon)
목록이나 연속을 소개할 때는 콜론을 사용하세요. 관련 정보를 소개하기 전의 멈춤으로도 사용할 수 있어요. 예를 들어:
- "I enjoy the following hobbies: cooking, drawing, and traveling."
- "That leads me to my favorite hobby: running."
서로 밀접하게 관련된 두 개의 독립 절을 연결할 때는 세미콜론을 사용하세요. 추가 명확성을 위해 긴 목록 항목을 구분할 때 콤마 대신 세미콜론을 사용할 수도 있어요. 예를 들어:
- "I love running in the morning; it wakes me up."
- "Every morning, I enjoy eating toast, bacon, and eggs; reading a book; and relaxing on the porch."
참고: UI에서 세미콜론을 쓰고 싶다면, 대신 문장을 쪼개고 단어 수를 줄여 보세요. 그러면 더 읽기 쉽고 명확한 콘텐츠가 되는 경우가 많아요.
콤마 (Commas)
접속사가 두 독립 절을 연결할 때는 그 앞에 콤마가 와야 해요. Oxford comma라면 "and" 앞에도 콤마를 넣으세요. 예를 들어:
- "I like to run, and I like to swim" — "and"가 두 독립 절을 연결하므로 "and" 앞에 콤마가 필요해요.
- "I like to run and swim" — "and"가 두 독립 절을 연결하지 않으므로 "and" 앞에 콤마가 필요하지 않아요.
- "I like to run, swim, and hike" — "and" 앞에 Oxford comma가 포함돼 있어요.
말줄임표 (…) (Ellipses)
말줄임표(…)는 정보가 생략될 때 흔히 사용돼요. 모든 단어를 한 줄에 넣을 수 없을 때나 덜 관련성 높은 정보를 제거할 때(예: 인용문에서) 사용하세요. 예를 들어:
| Before | After |
|---|---|
| They said, "For many reasons, I think the PatternFly community is great." | They said, "...I think the PatternFly community is great." |
말줄임표는 생각하기 위한 멈춤처럼 누군가의 생각이나 말을 나타내는 더 창의적인 맥락에서도 사용할 수 있어요. 예를 들어 "But I was just trying to...never mind, forget it."
Em dash, En dash, 그리고 Hyphen
Em dash ( — )
뒤에 오는 구나 문장에 강조를 더하려면 em dash( — )를 사용하세요. 문장 중간에 추가 정보나 설명을 제공할 때도 em dash를 사용할 수 있어요. 예를 들어:
- "Good design is not about you—it’s about the user."
- "I like drinking something hot—coffee, tea, or cocoa—during my morning meetings."
En dash ( – )
연속된 숫자를 구분할 때는 en dash( – )를 사용하세요. 예를 들어 "We plan on having 100–150 attendees."
Hyphen ( - )
용어의 일부(예: "walk-through")나 누군가의 이름(예: "Mary-Jane")이라면 하이픈( - )을 사용하세요.
수식하는 명사 앞에 오는 복합 형용사에는 하이픈을 사용하고, 첫 형용사가 "-ly"로 끝나면 하이픈을 생략하세요. 예를 들어:
- "I like when my documentation is up to date."
- "I write up-to-date documentation."
- "He is a highly talented writer."
- "She is a high-quality job candidate."
대부분의 접두사에는 하이픈을 사용하지 않아야 해요. 예를 들어:
- Auto- (예: autopopulate; autoloading)
- Pre- (예: prerequisite)
- Re- (예: recreate)
- Sub- (예: submerge)
이 규칙의 예외는 "non" 같은 수식 접두사를 더할 때예요. 이 경우에는 하이픈을 사용해야 해요. 예를 들어 "non-Red Hatter."
하이픈 사용이 확실하지 않다면 Merriam-Webster 온라인 사전을 참고하세요.
느낌표 (Exclamation mark)
느낌표는 아껴서 사용하세요. 흥분을 불러일으키기 위해 느낌표를 쓰지 마세요. 사용자가 실제로 흥미로운 일을 경험할 때만 사용하세요. "Stop!"이나 "Watch out!" 같은 경고성 상황에도 느낌표를 쓸 수 있어요.
인간의 표현을 더 정확히 담으려면 긴 문장 뒤가 아니라 몇 단어 뒤에 느낌표를 사용하세요. 예를 들어:
| Before | After |
|---|---|
| Congratulations on creating an account! | Congratulations! You created an account. |
괄호 (Parentheses)
용어나 구에 더 많은 문맥을 제공하려면 괄호를 사용하세요(예: 설명이나 짧은 예시).
"account(s)"처럼 어떤 것의 가능한 복수형을 나타내는 데 괄호를 사용하지 마세요. 사용자가 한 개 또는 여러 개를 선택할 수 있을 때는 복수형을 사용하세요.
인용부호 (Quotation marks)
인용문과 기사 제목에는 쌍따옴표(“Example”)를 사용하세요. 쌍따옴표 안에 있는 인용문이나 기사 제목에는 홑따옴표(‘Example’)를 사용하세요.
쌍따옴표가 미국 영어의 표준인 반면, 홑따옴표는 보통 영국 영어의 표준이에요.
쌍따옴표와 홑따옴표는 다양한 출판물에서 때때로 서로 바꿔 쓰이기도 해요. 어떤 맥락에서는 같은 것을 의미할 수 있지만 항상 상호 교환 가능한 것은 아니에요. 예를 들어 중첩 인용부호가 필요할 때는 쌍따옴표 안에 홑따옴표를 사용해야 해요. 예를 들어:
- 대화 안의 기사 제목: Abi said, "I love the article Cat wrote. It’s called ‘Improving product design with an open source mindset,’ and it’s such a fun read."
- 대화 안의 인용문: "I like Cat’s article too, Abi. My coworker told me, ‘PatternFly has the best publication ever.’ That made me smile."