[홈으로] [게시판]

닥북의 요소 및 속성을 한글로 쓸 수 있도록 문서 유형 정의(DTD)를 만들려고 합니다. 이 문서 유형 정의에 따라 한글 닥북 문서를 만든 후 handoc이나 닥북 한글 스타일시트를 이용하여 영어 닥북으로 변환, 이를 다시 HTML, PDF 등의 다양한 형태로 변환할 수 있게 하는 것이 목표입니다.

제일 먼저 필요한 일은 닥북의 요소와 속성을 우리말로 번역하는 것입니다. 새 표준을 만드는 작업인 만큼 번역된 용어에 대한 동의를 구할 필요도 있으므로, 위키에서 작업하는 것이 제일 적당할 듯 싶습니다.

닥북 전체는 상당히 방대하므로 우선 Simplified DocBook으로 시작하는 것이 좋을 것 같습니다. 다음은 Simplified DocBook에서 지원하는 요소 이름입니다. 시간 나실 때 하나씩 번역해 주세요.

띄어쓰기 없이 번역하기가 어렵습니다.. -yongjoo

사실 영어도 여러 단어로 된 걸 붙여 쓰고 있으므로, 한글도 그렇게 하는 수밖에 별 도리가 없을 것 같습니다. -- 김민식


한 요소 이름이 다른 요소 이름들에도 영향을 미칠 것이므로 알파벳순 보다는 관련 요소들끼리 묶는 게 좋을 것 같아서 일단 몇 개만 해봤습니다...

그리고 논의를 위해 @// 주석을 사용하는 것은 별로인 것 같아요. 그냥 문단으로 써도 되지 않을까 해서 모두 바꿨습니다.

영문 이름 뒤에 한글 이름을 쉼표로 구분해서 나열하고, 더 낫다 싶은 것을 앞쪽으로 옮기는 식으로 고쳐나가면 좋겠습니다.

--류광


몇 가지 원칙을 제시하겠습니다:(논의, 정리해서 페이지 제일 위로 옮깁시다..)

  1. 최대한 한글화한다
  2. 최대한 짧게 - 영문 타이핑과 비슷하게.
  3. DocBook XSL의 common/ko.xml과 최대한 동기화
  4. DbWiki의 @ 옵션에 쓰이는 것과 최대한 동기화
  5. 밑줄이나 대시(-) 등 기호는 사용하지 않는다.

세 번째 것은... 여기서 논의된 것을 바탕으로 ko.xml을 수정할 수도 있겠습니다.

네 번째는... DbWiki 규칙을 바꾸면 DbWiki에 있는 문서들도 모두 바꿔야 한다는 점을 염두에 뒀으면 좋겠습니다. 다행히(?) 아직 글이 그리 많지 않아서 크게 부담스럽지는 않습니다만...

그리고 '주로 소프트웨어 문서화 작업을 염두에 둔다.'를 추가하고 싶은데 어떨까요? 비슷비슷한 후보들이 있을 때 이 한글 닥북을 주로 어떤 곳에 쓸 것인가가 좋은 기준이 될텐데, 현재 현실적으로는 그게 바로 소프트웨어 문서화인 것 같습니다. 그러나 닥북의 가능성을 제한하는 것일 수도 있다는 생각도 듭니다.

--류광

DocBook이 소프트웨어 문서화가 주목적인것은 맞습니다. 다만 Simplified DocBook은 element들 구성을 볼때 굳이 소프트웨어용이다라고 할 필요는 없을 것도 같구요. 아뭏든 가장 많이 쓰게될 곳은 결국 소프트웨어 문서화일테니까. 그렇게 해도 되겠습니다. --yongjoo


문서 종류, 정보

  • appendix: 부록
  • article: 글, 문서

제일 어려운 번역인것 같아요. 논문, 기사, 문헌..? 딱 어울릴만한 말이 어떤게 있을지..

범용적으로 쓰이는 형식이니까 '문서'나 '글'처럼 범용적인 단어를 쓰는게 좋을 것 같습니다. 다른 말들은 너무 특정 형식에만 해당하는 거라서요. -- 김민식

'글'이 좋습니다. 글에 한표! yongjoo

  • articleinfo: 글정보, 문서정보

보통 논문 같은데서는 초록이라고 하지만 의미상으로는 요약이 더 좋은것 같은데요 그래도 일단은 초록이 맞는 번역일 듯.. -yongjoo

저도 요약이 더 나은 것 같습니다. 어차피 닥북은 논문보다는 다른 용도로 더 많이 쓰이니까, 일반적인 말로 바꾸는 게 좋지 않을까요? -- 김민식

ko.xml에는 초록으로 되어있을 겁니다. 요약으로 바꾸는게 좋겠네요. yongjoo

  • revhistory : 고침내역, 고친과정, 갱신 내역
  • revision : 고침, 갱신 버전

갱신이란 말이 싫어서 고침이라 했던 것인데요. 잘된 것인지 모르겠습니다. ko.xml에는 고친과정이라고 되어있을겁니다. yongjoo

작성자 관련

  • affiliation: 인적사항
  • author: 지은이, 글쓴이
  • authorblurb: 글쓴이소개, 지은이소개
  • authorgroup: 지은이들, 글쓴이들, 함께지은이, 지은이모임
  • authorinitials: 글쓴이이니셜, 지은이 이니셜
  • editor : 엮은이, 편집자

author를 '지은이'로 한다면 이것도 '엮은이'로 하는게 일관성 측면에서 좋을 것 같습니다. 아니면 author를 '저자'로 하던가... -- 김민식

DbWiki는 글쓴이, 엮은이를 사용합니다. 글쓴이, 엮은이는 SGML-DSSSL 시절에서부터 쓰여온 것으로 알고 있습니다... -- 류광

'지은이'가 좋다고 생각합니다. '지은이' '엮은이' '펴낸이' 예전부터 이렇게 번역되는걸 많이 본것 같습니다. 아마 dsssl 에는 지금 '글쓴이'로 되어 있나요? 아마 메일보내기 귀찮아서 그냥 내비둔거 같습니다 -_- ko.xml에는 '지은이'일겁니다. yongjoo

authorgroup은 '함께지은이' 어떻습니까? 너무 무리인가.. -_- yongjoo

저는 ~들을 지지합니다. authorgroup 요소는 하나 이상의 author 요소들을 감싸는 용도로 쓰이니까요... --류광

~들이 좋네요. element 간의 문맥?에 잘 맞으니 좋습니다. -- yongjoo

  • copyright: 저작권
  • corpauthor : 공동저자, 단체저자, 글쓴곳, 지은곳

'공동저자'라고 하면 어쩐지 여러 사람 이름을 나열해야 할 것 같지 않나요? 오히려 authorgroup이 '공동저자'에 더 가까운 것 같은데요. 회사나 기관 등이 저자인 경우니까 '단체저자'는 어떨까요? -- 김민식

'단체지은이'? '떼로지은이'? 너무 무리한가요 -_- 항상 용어번역에서 너무 한자어를 배제하려는 욕심을 내면 안된다고 생각하지만 -_- yongjoo

'지은곳' 어떻습니까? --yongjoo

  • email : 이메일
  • jobtitle: 직책
  • pubdate : 펴낸날,출판일
  • publishername : 펴낸이,출판인, 발행인, 출판자.

출판 쪽에서는 발행인이 더 많이 쓰입니다. 그런데 publishername이 사람이 아니라 출판사를 가리키는 것이라면 출판사 가 낫겠습니다. 출판자는 두리뭉실 사람과 회사를 합한 것입니다:) --류광

'글쓴이', '엮은이'와 어울리는 말로는 '펴낸이'가 적당하지 않을까요? -- 김민식

'펴낸날' '펴낸이'가 좋습니다. ko.xml도 이렇게 되있는듯.. yongjoo

  • honorific: 존칭?

문서 내용 - 블럭

  • blockquote : 인용블럭
  • figure: 그림
  • caption: 캡션
  • para : 문단
  • note: 참고, 노트

미분류

  • abbrev: 약어, 줄임말, 약자

'약어'가 낫지 않을까요? -- 김민식

이것을 약어라 하고 acronym을 약자라고 하면 어떨까요? yongjoo

'줄임말' 어떨까요? '줄인말'인가? --yongjoo

표준어는 '준말'입니다만, 우리말로 '준말'이라고 하면 온전한 단어를 가리키므로 Mrs.나 Mr.처럼 끝에 점찍는 약어를 나타낸다는 abbrev의 본래 의미와는 잘 안 맞는 것 같습니다. -- 김민식

  • acronym: 두문자, 약자, 첫머리_약자, 첫자줄임

abbrev 하고 다른점이 무엇인지.. -yongjoo

Association -> Assn. 처럼 줄여 쓰는게 abbrev이고, NASA처럼 앞글자 따서 쓰는게 acronym입니다. -- 김민식

'첫자줄임' 어떻습니까? -- yongjoo

  • attribution: 출처
  • audiodata: 소리자료
  • audioobject: 소리개체
  • bibliodiv: ~구역 (biblio가 어떻게 결정되냐에 따라)
  • bibliography : 서지사항, 참고문헌, 문헌목록

뜻은 서지사항이 맞는데, 문서들을 보면 참고문헌을 적는데 이 것을 쓰더군요. 그래서 서지사항이란 번역이 무척 어색하게 보였었는데.. 하지만 참고문헌은 reference 아닌가요? 어떻게 해야할지.. ko.xml에는 서지사항이라 되어 있습니다. -yongjoo

'문헌목록'도 괜찮을듯.. --yongjoo

  • bibliomisc: ~기타
  • bibliomixed: ~혼합
  • bibliomset
  • citetitle
  • colspec
  • command: 명령
  • computeroutput: 컴퓨터출력
  • date: 날짜
  • edition : -판
  • emphasis : 강조
  • entry: 항목
  • epigraph
  • example: 예
  • filename: 파일이름
  • firstname: 이름

surname이 성이고 firstname이 이름이니까.. yongjoo

  • footnote: 주석,각주

원래 각주가 맞는 말인데요. 이것이 미주로 달릴때도 있어서(예전 dsssl로 ps 출력할때) 그냥 주석이 무난한것 같습니다. yongjoo

  • holder: 소유권?, 소유자?, 가진이?
  • imagedata: 그림정보
  • imageobject: 그림개체
  • informaltable: 표
  • inlinemediaobject: 간략한표
  • issuenum: 호수
  • itemizedlist: 항목목록
  • keyword: 키워드, 핵심어
  • keywordset: 키워드모음
  • legalnotice: 법적공지
  • lineage
  • lineannotation
  • link: 연결, 링크
  • listitem: 목록항목
  • literal
  • literallayout
  • mediaobject: 매체객체
  • objectinfo: 개체정보
  • option: 선택, 옵션
  • orderedlist: 순서목록
  • orgname: 조직이름
  • othercredit: 도운이
  • othername: 다른이름, 별명
  • phrase: 구절, 문장

phrase는 para보다 작은 어떤 것도 가능합니다. 꼭 문장일 필요는 없습니다. -- 김민식

  • programlisting: 프로그램내용, 프로그램코드
  • quote: 인용
  • releaseinfo: 릴리즈정보
  • replaceable: 대체가능
  • revdescription: 고침설명
  • revnumber: 고침번호
  • revremark:
  • row: 열
  • section: 절
  • sectioninfo: 절정보
  • sidebar
  • subject : 주제
  • subjectset: 제목모음
  • subjectterm
  • subtitle: 부제목
  • surname: 성
  • systemitem
  • table: 표
  • tbody: 표몸통
  • term: 용어
  • textobject: 텍스트개체
  • tgroup: 표그룹
  • thead: 표머리
  • title: 제목
  • titleabbrev: 제목요약
  • trademark: 상표
  • ulink: url링크
  • userinput: 직접입력, 사용자입력
  • variablelist :변수목록
  • varlistentry: 변수항목
  • videodata: 시각정보,비디오정보
  • videoobject: 시각개체,비디오개체
  • volumenum: 권수
  • xref: 상호참조
  • year: 연도

이하는 Simplified DocBook에서 쓰이는 속성입니다. 계속 추가중입니다.

  • align: 정렬
    • center: 가운데
    • char
    • justify
    • left: 왼쪽
    • right: 오른쪽
  • char
  • charoff
  • class
    • command
    • constant
    • copyright: 저작권
    • devicefile
    • directory
    • faq
    • function: 함수
    • groupname
    • headerfile
    • journalarticle: 저널기사
    • library
    • libraryfile
    • macro
    • monospaced
    • normal
    • option
    • osname
    • parameter
    • productsheet
    • registered
    • resource
    • service
    • specification
    • symlink
    • systemname: 시스템이름
    • techreport
    • trade
    • username: 사용자이름
    • whitepaper: 백서
  • colname: 열이름
  • colnum: 열수
  • cols
  • colsep
  • colwidth: 열폭
  • continuation
    • continues
    • restarts
  • depth
  • endterm
  • entityref
  • fileref: 파일참조
  • float
  • format
    • linespecific
  • frame
    • all
    • bottom
    • none
    • sides
    • top
    • topbot
  • inheritnum
    • ignore
    • inherit
  • label
  • linenumbering
    • numbered
    • unnumbered
  • linkend
  • mark
  • moreinfo
    • none
    • refentry
  • morerows
  • nameend
  • namest
  • numeration
    • arabic
    • loweralpha
    • lowerroman
    • upperalpha
    • upperroman
  • orient
    • land: 가로
    • port: 세로
  • override
  • pagenum
  • parentbook
  • path
  • pgwide
  • pubwork
  • relation
  • rotate
  • rowsep
  • scale
  • scalefit
  • scheme
  • shortentry
  • spacing
    • compact
    • normal
  • spanname
  • srccredit
  • status: 상태
  • tabstyle
  • termlength
  • tgroupstyle
  • tocentry
  • type
  • url
  • weight: 가중치
  • width: 폭
  • valign: 세로정렬
    • bottom: 아래
    • middle
    • top: 위
제일 위로
최종 수정 일시: 06월 24일(2004년) 04:31 PM 편집 | 정보 | 차이 | 비슷한페이지 | DebugInfo
유용한 페이지들: 분류 분류 | 자유로운 연습장 SandBox | 무작위 페이지들 RandomPages | 인기있는 페이지들 MostPopular