MDC:Writer's guide

MDC

이 작성자 가이드는 Mozilla 개발자 센터를 위해 우리가 정한 "독자 스타일"입니다. 엄격한 규칙 집합보다는 친근한 지침 집합으로 만들 생각입니다. 그래서 여기서 무엇이든 자유로이 무시할 수 있습니다. 그러나, 혹시 부지런한 자원봉사자가 나중에 함께 하여 여러분의 작업을 더 엄밀히 이 가이드를 따라 편집하더라도 실망하거나 놀라지 마세요.

자연히, 이 가이드는 영어 MDC 위키를 우선 적용합니다. 다른 언어 위키는 그들만의 작성자 가이드가 있고 만드는 것을 환영할지도 모릅니다.

[편집] 선호하는 스타일 가이드

여기서 다루지 않는 쓰임과 스타일에 관한 질문이 있다면, Economist style guide나 거기서 실패할 경우 Chicago Manual of Style를 참조하기를 권합니다.

[편집] 선호하는 사전

철자 질문은, Answers.com을 참조하세요. 변형(variant) 철자는 쓰지 마세요(예를 들면 변형 honour보다는 honor를 쓰세요).

우리는 시간이 흐르면서 가이드를 확장할 겁니다. 그래서 혹시 이 문서에서 다루지 않는 특정 질문이 있다면, 우리가 무엇을 추가하면 좋을 지 알 수 있도록 MDC mailing list나 project lead에 보내 주세요.

[편집] 페이지 이름과 표제 대문자 사용

• 페이지 이름과 절 표제는 큰 표제(headline) 스타일 대문자 사용보다는 문장 스타일 대문자 사용(오직 첫 단어와 고유 명사만 대문자 사용)을 쓰면 좋습니다.
  • 정확: "A new method for creating JavaScript rollovers"
  • 부정확: "A New Method for Creating JavaScript Rollovers"

[편집] 라틴어 약어

[편집] 노트와 소괄호에서

• 일반 라틴어 약어(etc., i.e., e.g.)가 소괄호로 싼 식과 노트에 쓰일지도 모릅니다. 이 약어에 생략점을 쓰세요.
  • 정확: Web browsers (e.g. Firefox) can be used ...
  • 부정확: Web browsers e.g. Firefox can be used ...
  • 부정확: Web browsers, e.g. Firefox, can be used ...
  • 부정확: Web browsers, (eg: Firefox) can be used ...

[편집] 실린 텍스트에서

• 정규 텍스트(즉, 노트나 소괄호 밖 텍스트)에는, 약어와 같은 뜻인 영어를 쓰세요.
  • 정확: ... web browsers, and so on.
  • 부정확: ... web browsers, etc.
  • 정확: Web browsers such as Firefox can be used ...
  • 부정확: Web browsers e.g. Firefox can be used ...

[편집] 라틴어 약어의 뜻과 같은 뜻인 영어

N.B. "e.g."를 "i.e."와 혼동하지 않도록 주의하세요.

[편집] 두문자어와 약어

[편집] 대문자 사용과 생략점

• "US"와 "UN" 같은 기구를 포함하여 모든 두문자어와 약어에 전부 대문자로 쓰고 생략점은 지우세요.
  • 정확: XUL
  • 부정확: X.U.L.; Xul

[편집] 본딧말 확장

• 페이지 상에 용어를 처음 언급하는 경우, 소괄호 안에 본딧말을 소개하세요.
  • 정확: "XUL (XML User Interface Language) is Mozilla's XML-based language..."
  • 부정확: "XUL is Mozilla's XML-based language..."

[편집] 예외

• 사용자에게 낯선 것 같은 두문자어는 늘리세요. 의심이 나면, 줄이지 마세요.

[편집] 두문자어와 약어의 복수형

• 두문자어와 약어의 복수형에는, "s"를 붙이세요'.
  • 정확: CD-ROMs
  • 부정확: CD-ROM's

[편집] 단축어

• 원하신다면 단축어(예를 들면 "don't", "can't", "shouldn't")를 쓰는 걸 환영합니다.

[편집] 복수형

• 라틴어나 그리스어에 영향 받은 형태가 아닌 영어 스타일의 복수형을 쓰세요.
  • 정확: syllabuses, octopusses
  • 부정확: syllabi, octopi

[편집] 하이픈 연결어

• 모음으로 끝나는 접두사의 끝 글자가 어근의 첫 글자와 같은 경우에 복합어를 하이픈으로 이으세요.
  • 정확: email, re-elect, co-op
  • 부정확: e-mail, reelect, coop

[편집] 숫자와 수 표기

[편집] 날짜

• 날짜(코드 샘플에 날짜를 포함하지 않는)에 January 1, 1990 형식을 쓰세요.
  • 정확: February 24, 2006
  • 부정확: February 24th, 2006; 24 February, 2006; 24/02/2006

• 교대로, 년(4자리)/월(2자리)/일(2자리) 형식을 쓸 수 있습니다.
  • 정확: 2006/02/24
  • 부정확: 02/24/2006; 24/02/2006; 02/24/06

[편집] 10년 단위

• 10년 단위에, 1990s 형식을 쓰세요.
  • 정확: 1990s
  • 부정확: 1990's

[편집] 수 표기 복수형

• 수 표기 복수형에 s를 붙이세요.
  • 정확: 486s
  • 부정확: 486's

[편집] 쉼표

• 실린 텍스트에는, 다섯 자리 이상의 수에만 쉼표를 쓰세요.
  • 정확: 4000; 54,000
  • 부정확: 4,000; 54000

[편집] 문장부호

[편집] 연속 쉼표

• 연속 쉼표를 쓰세요. 연속 ("Oxford"로도 알려진) 쉼표는 연이은 셋 이상의 항목에 "and" 앞에 나오는 쉼표입니다.
  • 정확: I will travel on trains, planes, and automobiles.
  • 부정확: I will travel on trains, planes and automobiles.

[편집] 철자

• 변형 철자가 있는 단어는, 항상 Answers.com의 첫 표제어를 쓰세요. 변형 철자는 쓰지 마세요.
  • 정확: localize, honor
  • 부정확: localise, honour

[편집] 그 밖의 자료

혹시 작성과 편집 기술 향상에 관심이 있으면, 다음 자료에서 도움이 될 만한 것을 찾을지도 모르겠습니다

• On Writing Well, by William Zinsser (Amazon 링크)
• Elements of Style, by Strunk and White
• American Heritage Book of English Usage
• Common Errors in English
• English Grammar FAQ (alt.usage.english)
• Bob's quick guide to the apostrophe, you idiots (재밌음)