initial commit

1 files changed, 144 insertions, 0 deletions

diff --git a/files/ko/archive/mozilla/firefox/using_microformats/index.html b/files/ko/archive/mozilla/firefox/using_microformats/index.html
new file mode 100644
index 0000000000..b7fcdf224f
--- /dev/null
+++ b/files/ko/archive/mozilla/firefox/using_microformats/index.html
@@ -0,0 +1,144 @@
+---
+title: Using microformats
+slug: Archive/Mozilla/Firefox/Using_microformats
+tags:
+  - Firefox 3
+  - Microformats
+translation_of: Archive/Mozilla/Firefox/Using_microformats
+---
+<p>{{ Fx_minversion_header(3) }}
+</p><p>마이크로포맷(Microformats)을 이용하면 문서 자체를 분석하는 방법을 알아야 할 필요없이 페이지의 정보에 대한 요약을 표시할 수 있도록 웹 사이트가 의미 데이터(semantic data)를 브라우저에 제공할 수 있습니다. Firefox 3는 마이크로포맷에 대한 접근을 제공하는 전역 <code>Microformats</code> 개체를 구현합니다. 이 개체와 API를 이용하면 마이크로포맷을 쉽게 찾고 읽을 수 있습니다.
+</p>
+<h2 id=".EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7_API_.EB.A1.9C.EB.93.9C.ED.95.98.EA.B8.B0" name=".EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7_API_.EB.A1.9C.EB.93.9C.ED.95.98.EA.B8.B0">마이크로포맷 API 로드하기</h2>
+<p><code>Microformats</code> 개체는 Firefox 3에 추가된 새로운 자바스크립트 로더를 이용하여 생성합니다. API를 사용하려면 먼저 개체를 로드해야 합니다:
+</p>
+<pre class="eval"><span class="nowiki">Components.utils.import("resource://gre/modules/Microformats.js");</span>
+</pre>
+<p>마이크로포맷 API를 로드하고 나면 아래에 나열한 메소드를 이용하여 마이크로포맷을 다룰 수 있습니다. 마이크로포맷을 파싱하는 방법에 대한 정보는 <a href="ko/Parsing_microformats_in_JavaScript">Parsing microformats in JavaScript</a>를 참고하십시오.
+</p>
+<h2 id=".EB.AF.B8.EB.A6.AC_.EC.A0.95.EC.9D.98.EB.90.9C_.EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7" name=".EB.AF.B8.EB.A6.AC_.EC.A0.95.EC.9D.98.EB.90.9C_.EB.A7.88.EC.9D.B4.ED.81.AC.EB.A1.9C.ED.8F.AC.EB.A7.B7">미리 정의된 마이크로포맷</h2>
+<p>Firefox 3는 몇 가지 일반적인 마이크로포맷을 구현한 정의를 제공합니다.
+</p>
+<dl><dt><code><a href="ko/The_adr_microformat">adr</a></code>
+</dt><dd>주소를 표시합니다.
+</dd><dt><code><a href="ko/The_geo_microformat">geo</a></code>
+</dt><dd>위도와 경도를 이용한 지리적 위치를 표시합니다.
+</dd><dt><code><a href="ko/The_hCard_microformat">hCard</a></code>
+</dt><dd>사람에 대한 연락 정보를 표시합니다.
+</dd><dt><code><a href="ko/The_hCalendar_microformat">hCalendar</a></code>
+</dt><dd>달력의 일정 항목을 표시합니다.
+</dd><dt><code><a href="ko/The_tag_microformat">tag</a></code>
+</dt><dd>다른 마이크로포맷에 태그를 추가하는데 사용합니다.
+</dd></dl>
+<h2 id=".EB.A9.94.EC.86.8C.EB.93.9C" name=".EB.A9.94.EC.86.8C.EB.93.9C">메소드</h2>
+<h3 id="add.28.29" name="add.28.29">add()</h3>
+<p>마이크로포맷 모듈에 새로운 마이크로포맷을 추가합니다.
+</p><p>{{ Note("지정한 이름을 가진 마이크로포맷이 이미 존재하면 새로운 것으로 바뀝니다.") }}
+</p>
+<pre class="eval">add(name, definition);
+</pre>
+<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98">매개변수</h6>
+<dl><dt>&lt;tt&gt;name&lt;/tt&gt;
+</dt><dd>마이크로포맷 모듈에 추가하려는 마이크로포맷의 이름.
+</dd><dt>&lt;tt&gt;definition&lt;/tt&gt;
+</dt><dd>마이크로포맷을 기술하는 자바스크립트 구조. 자세한 사항은 <a href="ko/Describing_microformats_in_JavaScript">Describing microformats in JavaScript</a>를 참고.
+</dd></dl>
+<h3 id="count.28.29" name="count.28.29">count()</h3>
+<p>지정한 조건을 만족하는 문서에 있는 마이크로포맷의 개수를 구합니다.
+</p>
+<pre class="eval">numMicroformats = Microformats.count(name, rootElement, recurseFrames);
+</pre>
+<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_2" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_2">매개변수</h6>
+<dl><dt>&lt;tt&gt;name&lt;/tt&gt;
+</dt><dd>검색하려는 마이크로포맷의 이름
+</dd><dt>&lt;tt&gt;rootElement&lt;/tt&gt;
+</dt><dd>검색을 시작할 DOM 요소. 전체 문서에서 검색하려면 <code>content.document</code>를 명시해야 합니다.
+</dd><dt>&lt;tt&gt;options&lt;/tt&gt;
+</dt><dd>선택사항. 아래 플래그를 포함하는 자바스크립트 개체:
+</dd></dl>
+<blockquote>
+<dl><dt>&lt;tt&gt;recurseExternalFrames&lt;/tt&gt;
+</dt><dd><code>true</code>이면 자식 프레임을 검색에 포함. 기본 값은 <code>true</code>.
+</dd><dt>&lt;tt&gt;showHidden&lt;/tt&gt;
+</dt><dd><code>true</code>이면 숨겨진 마이크로포맷을 추가하고 그렇지 않으면 생략. 기본 값은 <code>false</code>.
+</dd><dt>&lt;tt&gt;debug&lt;/tt&gt;
+</dt><dd>디버그 모드를 사용하려면 <code>true</code>로 지정하고 그렇지 않으면 <code>false</code>로 지정. 기본 값은 <code>false</code>.</dd></dl></blockquote> <h6 id=".EB.B0.98.ED.99.98_.EA.B0.92" name=".EB.B0.98.ED.99.98_.EA.B0.92">반환 값</h6>
+<p>지정한 조건을 만족하는 마이크로포맷 개수를 가리키는 정수 값.
+</p>
+<h3 id="debug.28.29" name="debug.28.29">debug()</h3>
+<p>마이크로포맷 개체를 설명하는 문자열을 반환합니다.
+</p><p>{{ Note("마이크로포맷 개체에 대해 <code>debug()</code>를 호출할 수 있습니다: 이 메소드 대신 <code>microformatObject.debug()</code>를 이용할 수도 있습니다.") }}
+</p>
+<pre class="eval">dumpString = debug(microformatObject)
+</pre>
+<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_3" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_3">매개변수</h6>
+<dl><dt>&lt;tt&gt;microformatObject&lt;/tt&gt;
+</dt><dd>정보를 표시할 마이크로포맷 개체.
+</dd></dl>
+<h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_2" name=".EB.B0.98.ED.99.98_.EA.B0.92_2">반환 값</h6>
+<p>지정한 마이크로포맷 개체의 내용을 설명하는 문자열.
+</p>
+<h3 id="get.28.29" name="get.28.29">get()</h3>
+<p>지정한 조건에 따라 검색한 마이크로포맷에 해당하는 마이크로포맷 개체의 배열을 반환합니다.
+</p>
+<pre class="eval">microformatsArray = Microformats.get(name, rootElement, options, targetArray);
+</pre>
+<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_4" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_4">매개변수</h6>
+<dl><dt>&lt;tt&gt;name&lt;/tt&gt;
+</dt><dd>검색하려는 마이크로포맷의 이름
+</dd><dt>&lt;tt&gt;rootElement&lt;/tt&gt;
+</dt><dd>검색을 시작할 DOM 요소. 전체 문서에서 검색하려면 <code>content.document</code>를 명시해야 합니다.
+</dd><dt>&lt;tt&gt;options&lt;/tt&gt;
+</dt><dd>선택사항. 아래 플래그를 포함하는 자바스크립트 개체:
+</dd></dl>
+<blockquote>
+<dl><dt>&lt;tt&gt;recurseExternalFrames&lt;/tt&gt;
+</dt><dd><code>true</code>이면 자식 프레임을 검색에 포함. 기본 값은 <code>true</code>.
+</dd><dt>&lt;tt&gt;showHidden&lt;/tt&gt;
+</dt><dd><code>true</code>이면 숨겨진 마이크로포맷을 추가하고 그렇지 않으면 생략. 기본 값은 <code>false</code>.
+</dd><dt>&lt;tt&gt;debug&lt;/tt&gt;
+</dt><dd>디버그 모드를 사용하려면 <code>true</code>로 지정하고 그렇지 않으면 <code>false</code>로 지정. 기본 값은 <code>false</code>.</dd></dl></blockquote> <dl><dt>&lt;tt&gt;targetArray&lt;/tt&gt;
+</dt><dd>선택사항. 검색 결과를 추가할 마이크로포맷 개체의 배열.
+</dd></dl> <h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_3" name=".EB.B0.98.ED.99.98_.EA.B0.92_3">반환 값</h6>
+<p>검색 조건을 만족하는 마이크로포맷 개체의 새로운 배열, 혹은 발견한 마이크로포맷 개체를 추가한 &lt;tt&gt;microformats&lt;/tt&gt;에서 지정한 배열.
+</p>
+<h3 id="getNamesFromNode.28.29" name="getNamesFromNode.28.29">getNamesFromNode()</h3>
+<p>지정한 마이크로포맷 노드에 해당하는 공백으로 구별되는 마이크로포맷 이름의 목록을 반환합니다.
+</p>
+<pre class="eval">nameList = Microformats.getNamesFromNode(node);
+</pre>
+<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_5" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_5">매개변수</h6>
+<dl><dt>&lt;tt&gt;node&lt;/tt&gt;
+</dt><dd>마이크로포맷 이름 목록을 구할 노드
+</dd></dl>
+<h6 id="Return_value" name="Return_value">Return value</h6>
+<p>지정한 노드가 마이크로포맷인 경우 노드에 해당하는 모든 마이크로포맷의 이름을 공백으로 구별하여 나열하는 문자열. 해당 노드가 마이크로포맷이 아닌 경우에는 아무것도 반환하지 않음.
+</p>
+<h3 id="getParent.28.29" name="getParent.28.29">getParent()</h3>
+<p>지정한 마이크로포맷이나 마이크로포맷 자식의 부모 노드를 반환합니다.
+</p>
+<pre class="eval">parentNode = Microformats.getParent(node);
+</pre>
+<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_6" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_6">매개변수</h6>
+<dl><dt>&lt;tt&gt;node&lt;/tt&gt;
+</dt><dd>부모 노드를 구할 노드
+</dd></dl>
+<h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_4" name=".EB.B0.98.ED.99.98_.EA.B0.92_4">반환 값</h6>
+<p>지정한 노드의 부모. 지정한 노드가 마이크로포맷이 아니거나 마이크로포맷의 자식이 아닌 경우에는 아무것도 반환하지 않음.
+</p>
+<h3 id="isMicroformat.28.29" name="isMicroformat.28.29">isMicroformat()</h3>
+<p>지정한 DOM 노드가 마이크로포맷인지 구별합니다.
+</p>
+<pre class="eval">flag = Microformats.isMicroformat(node);
+</pre>
+<h6 id=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_7" name=".EB.A7.A4.EA.B0.9C.EB.B3.80.EC.88.98_7">매개변수</h6>
+<dl><dt>&lt;tt&gt;node&lt;/tt&gt;
+</dt><dd>마이크로포맷 여부를 확인할 DOM 노드.
+</dd></dl>
+<h6 id=".EB.B0.98.ED.99.98_.EA.B0.92_5" name=".EB.B0.98.ED.99.98_.EA.B0.92_5">반환 값</h6>
+<p>노드가 마이크로포맷이면 <code>true</code>, 그렇지 않으면 <code>false</code>.
+</p><p>{{ Note("만약 노드가 마이크로포맷의 자식이면 이 메소드는 <code>true</code>를 반환하지 <i>않습니다</i>.") }}
+</p>
+<div class="noinclude">
+</div>
+{{ languages( { "en": "en/Using_microformats", "fr": "fr/Utilisation_de_microformats", "ja": "ja/Using_microformats", "pl": "pl/Zastosowanie_mikroformat\u00f3w" } ) }}