Google 코드 검색 packagemap 파일 정의

개요

Google 코드 검색을 사용하면 소스 코드를 포함한 아카이브를 웹에서 검색할 수 있습니다. Google 소프트웨어는 이러한 아카이브 내 소스 코드를 찾으며 언어 및 라이센스를 감지합니다. 기본적인 Sitemap을 사용하여 사이트 페이지의 정보를 제공할 수 있는 것과 마찬가지로 packagemap 파일을 사용하여 귀하의 아카이브 파일 내 소스 코드의 언어 및 라이센스를 Google에 알릴 수 있습니다.

구문

[목차]

코드는 XML로 작성된 것입니다. 다음 예제를 참조하세요.

<?xml version="1.0" encoding="UTF-8"?>
<fileset>
<file>
   <path>source/myfile.cpp</path>
   <type>C++</type>
   <license>LGPL</icense>
</file>    

<file>     
   <path>messages/messages.tgz</path>
   <type>archive</type>     
   <license>BSD</license>     
   <packagemap>info/PackageMap.xml</packagemap>  
</file>    
</fileset>

파일 이름

코드 검색 Sitemap에서 <packagemap> 태그로 packagemap의 이름을 지정합니다. Packagemap 파일을 지정하지 않을 경우 아카이브의 최상위 디렉토리를 확인하여 다음의 파일을 찾은 다음 첫 번째로 검색된 파일을 사용합니다.

PACKAGEMAP.XML
PACKAGEMAP.xml
Packagemap.xml
packagemap.xml
PACKAGEMAP
Packagemap
packagemap

XML 태그 정의

사용 가능한 XML 태그는 아래에 설명되어 있습니다.

<fileset>	필수	파일을 캡슐화하고 현재 프로토콜 표준을 참조합니다.
<file>	필수	<fileset>의 하위
<path>	필수	<file>의 하위. 아카이브 내의 파일 경로를 설명합니다. 대소문자를 구분하며 모든 문자를 사용할 수 있습니다.
<type>	필수	<file>의 하위. 값은 언어 이름 또는 'archive'가 될 수 있습니다. 해당되는 예로는 'C', 'Python', 'C#', 'Java', 'Vim' 등이 있습니다. 대소문자는 구분되지 않습니다. 예로 'Java', 'JAVA' 및 'java'가 모두 동일합니다. 값은 ASCII 문자로 인쇄할 수 있어야 하며 공백이 없어야 합니다. 이름은 반드시 지원되는 언어 중 하나여야 합니다. 지원되는 언어로 된 파일에 대해서만 색인이 생성됩니다. 그 외의 파일은 모두 무시됩니다. 아직 지원되지 않는 언어 이름도 사용할 수 있으며 향후 해당 코드에 대한 색인을 생성할 수도 있습니다. 특수 값 'archive'는 아카이브 내의 아카이브에 사용될 수 있습니다. 참고로 해당 아카이브에 소스 코드가 포함된 경우에만 'archive'가 유용합니다. 왜냐하면 코드 검색은 소스 코드에 대해서만 색인을 생성하기 때문에 텍스트, html 등만 포함한 아카이브에 값을 추가하는 것은 소용이 없습니다.
<license>	옵션	<file>의 하위. 값은 저작권 라이센스의 이름이어야 합니다. 'GPL', 'BSD', 'Python', 'disclaimer' 등이 이에 해당하는 예입니다. 대소문자는 구분되지 않습니다. 예로 'LPGL', 'Lgpl' 및 'lgpl'가 모두 동일합니다. <type>이 'archive'이면 <license> 값은 아카이브에 있는 파일의 기본 라이센스입니다. 다른 라이센스는 특정 파일에 대해 아카이브에 있는 packagemap으로 지정될 수 있습니다. 라이센스는 반드시 지원되는 라이센스 중 하나여야 합니다. Google은 인식되지 않은 라이센스는 무시하며 해당 라이센스 값을 '알 수 없음'으로 표시합니다.
<packagemap>	옵션	<file>의 하위. 아카이브 내에 있는 packagemap 파일의 이름입니다. 권장되는 이름은 'PACKAGEMAP.xml'이며 이 이름을 사용할 경우 Google에서 packagemap 파일을 자동으로 감지하므로 여기에 포함시킬 필요가 없습니다. 대소문자를 구분합니다. 해당 태그는 <type> 값이 'archive'인 <file> 항목에 대해서만 사용될 수 있습니다.

엔티티 이스케이프

앞부분 및 뒷부분 공백은 무시됩니다. UTF-8 인코딩은 필수입니다. 모든 XML 파일과 마찬가지로 모든 데이터 값(URL 포함)은 아래 표에 나와 있는 문자에 대해 엔티티 이스케이프 코드를 사용해야 합니다.

문자		이스케이프 코드
앰퍼샌드	&	&
작은 따옴표	'	'
큰 따옴표	"	"
보다 큼	>	>
보다 작음	<	<