주의: 이 번역은 원문보다 오래되었습니다.

데비안 웹 페이지 HTML 사용

이 페이지는 아직 초안.

서문

이 페에지는 편집자와 번역자가 잘 태그된 페이지를 만드는 것을 돕기 위해 만들었습니다. 태그 사용 힌트 및 새 페이지를 어떻게 만들고 번역하기 쉽게하는지를 포함합니다.

일반 힌트

새 페이지 또는 번역을 위한 일반 권고 목록이 여기 있습니다.

긴 줄을 쓰지 마세요
wml 파일과 다른 파일든은 일반 터미널 윈도우에 맞아야 합니다. vi에서 편집하기 쉽고, 검색하고 번역하기 좋습니다. 그것은 중요하기도 한데 왜냐면 긴 줄에서 충돌을 해결하기 어렵기 때문입니다.
가능하면 태그를 분리하세요
Most HTML tags can be kept in separate lines. Some of them are <div>, <p>, <table>, <ul>. To make things easier for translators, you should keep all tags that can be used this way in separate lines. Otherwise translators may delete tags accidentally and forget to restore them after translating.
인라인 태그에 스페이스나 행 나누기를 하지 마세요
Some tags produce a space, if they are kept in separate lines. One of those is the <q>tag for small citations or quotes. You may only separate them as a whole with content in one line. Else there might be a space between content and tag in the HTML page afterwards. Between words in these tags you may have as many line breaks or spaces as you want.

Abbreviation 및 Acronym

For abbreviations and acronyms the HTML tag <acronym> should be used. There are two reasons why the use of the <abbr> tag is not recommended: First not all browsers do support it and second there are inconsistent definitions about what is an acronym and what is an abbreviation.

An acronym is added to the page in the following syntax: <acronym lang="language code" title="Full definition of acronym">ACRONYM</acronym>. The title contains the full spoken words. If the acronym is built from initial letters of words, those letters should be upper case in the title. The lang attribute is only needed if the acronym or abbreviation is in a foreign language.

There is already a set of common acronyms in the wml templates included to use it in your page, you have to add a line to use acronyms in the wml file. For example the wml tag for DD is <acronym_DD />.

Citation 및 Quote

There are several different rules what a citation or quote is for different languages. If you have a short inline citation you have to use the <q> tag. The rendering of the content is handled by language CSS. <q> tags must not have a space or line break between the opening and closing tag and the content.

For longer citations the tag <blockquote> is used. A <blockquote> encloses one or more paragraphs of text, which are marked with <p>. Please do not use the <blockquote> tags for centering any block of text which is not a citation. Blockquotes are exclusively for citations and will be rendered by language specific CSS code in the future.

There is also a <cite> tag in HTML. The <cite> tag is not used for the citation text itself. It is used for the source of a citation. This can be the name of the person the citation is from and is added as attribute to a <blockquote> as URL.

Program Name 및 Code

For program names and computer code there is a tag named <code>. Browsers normally know about displaying code and program names, but rendering can also be changed by CSS. It is not a good idea to use <tt> instead as this does not say anything about the content.

컴퓨터 출력 예

For computer output on the screen there is a special tag named <samp>. If you have a larger block of computer output, you should also have a look into the CSS file, if there is a special class for it.

키보드 입력

If there are examples where the user has to type something on the keyboard, the <kbd> tag is used for the user input. See also the chapter about variables for how to tag the variable input.

변수

Sometimes it is necessary to emphasize a variable input such as a special IP address or the users name which has to be given in a program call on command line. For these variable inputs the <var> tag is used.

Preformatted Content

The <pre> tag is use for preformatted text only. Line length, spaces and other things will be preserved. Naturally this tag cannot contain most of the other HTML tags.

이미지

If there are images added in the page, there is no need to add an invalid border=0 as attribute. But if possible the image size and an alt attribute should be added. The size is added by wml if not present, but that needs compile time. The alt attribute should contain something that tells users browsing with lynx and blind people what is in the image.