マークアップ方法

Sagaceでの検索結果イメージ

Sagaceでは検索結果で表示される説明文(スニペット)の他に,説明文に構造化されたデータ(リッチスニペット)を積極的に提供したいと考え,生物種,疾患名や最終更新日などをリッチスニペットとして提供しています。

このリッチスニペットを利用するためには,データベース管理者の方にmicrodata, RDFa Lite または JSON-LDという形式で検索対象となっているページ(データベースのエントリ)でマークアップをしていただくことが必要です。マークアップをしていただくことで,他の検索結果と比べて着目されやすい検索結果を表示することができます。具体的なマークアップ方法については以下の例をご覧ください。
(尚,検索結果への反映までは少しお時間をいただきます。)

現在マークアップされているデータベースのマークアップ例や検索結果例については,こちらをご覧ください。
これまでの議論について詳しく知りたい方はこちらを参照してください。
マークアップしたhtmlは以下のリンク先からクローリングのテストを行うことが出来ます。ご活用ください。
また,こちらのツールを使ってメタデータを付与したhtmlを作成することができます。

    • Microdata Extractor

・Sagaceでの検索結果イメージ ・クローラーでの検出結果テスト

    • RDFa Lite Extractor

・Sagaceでの検索結果イメージ・クローラーでの検出結果例

    • JSON-LD Extractor

・Sagaceでの検索結果イメージ

Results Image
Results Image from pdbj

imageのマークアップ例

microdata
<div itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">
  <img itemprop="image" src="http://www.pdbj.org/emnavi/data/emdb/media/1556/images/emd1556.png" />
</div>
RDFa Lite
<div vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
 <img property="image" src="http://www.pdbj.org/emnavi/data/emdb/media/1556/images/emd1556.png" />
</div>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
  "image" : "http://www.pdbj.org/emnavi/data/emdb/media/1556/images/emd1556.png"
}
</script>


クローラーでの取得結果

@BiologicalDatabaseEntry_image=http://www.pdbj.org/emnavi/data/emdb/media/1556/images/emd1556.png

Sagaceでの検索結果

image

isEntryOfのマークアップ例

microdata
<div itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">
  <span itemprop="isEntryOf" itemscope itemtype="http://schema.org/BiologicalDatabase">
     <a itemprop="url" href="http://www.kegg.jp/kegg/disease/">
      <span itemprop="name">KEGG DISEASE (Diseases viewed as perturbed states of the molecular system)</span>
     </a>
   </span>
</div>
RDFa Lite
<div vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
  <span property="isEntryOf" typeof="BiologicalDatabase">
     <a property="url" href="http://www.kegg.jp/kegg/disease/">
      <span property="name">KEGG DISEASE (Diseases viewed as perturbed states of the molecular system)</span>
     </a>
   </span>
</div>
JSON-LD
<script type="application/ld+json">
{
   "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
    "isEntryOf" : {
    "@type" : "BiologicalDatabase",
    "name"  : "OMIM",
    "url"   : "http://omim.org/entry/154700",
    "entryID" : "154700"
    }
    }
</script>


クローラーでの取得結果
BiologicalDatabaseを使ってネストでマークアップします。

@BiologicalDatabase_url=http://www.kegg.jp/kegg/disease/
@BiologicalDatabase_name=KEGG DISEASE (Diseases viewed as perturbed states of the molecular system)

Sagaceでの検索結果

isEntryOf

entryIDのマークアップ例

microdata
<div itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">
Entry:
 <span itemprop="entryID">H00653</span>
</div>
RDFa Lite
<div vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
Entry:
 <span property="entryID">H00653</span>
</div>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
  "entryID" : "H00653"
}
</script>


クローラーでの取得結果

@BiologicalDatabaseEntry_entryID=H00653

Sagaceでの検索結果

entryID

taxonのマークアップ例

BiologicalDatabaseEntry自体の入れ子となっています。
検索結果への正確な反映のために,出来るだけ,name, url, entryIDの全てのマークアップをお願いします。

microdata
<div itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">
 <span itemprop="taxon" itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">   
  Organism: <span itemprop="name">Homo sapiens</span> (human)  
  Taxonomy ID: <a itemprop="url" href="http://www.uniprot.org/taxonomy/9606"><span itemprop="entryID">9606</span></a> 
 </span>
</div>
RDFa Lite
<div vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
 <span property="taxon" vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">   
  Organism: <span property="name">Homo sapiens</span> (human)  
  Taxonomy ID: <a property="url" href="http://www.uniprot.org/taxonomy/9606"><span property="entryID">9606</span></a> 
 </span>
</div>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
 "taxon" : {
    "@type" : "BiologicalDatabaseEntry",
    "name"  : "Homo sapiens",
    "url"   : "http://www.uniprot.org/taxonomy/9606",
    "entryID" : "9606"
    }
}
</script>


クローラーでの取得結果

@ボキャブラリー_プロパティ_ボキャブラリー_プロパティで,この場合入れ子になっています。

@BiologicalDatabaseEntry_taxon_BiologicalDatabaseEntry_name=Homo sapiens
@BiologicalDatabaseEntry_taxon_BiologicalDatabaseEntry_url=http://www.uniprot.org/taxonomy/9606
@BiologicalDatabaseEntry_taxon_BiologicalDatabaseEntry_entryID=9606

Sagaceでの検索結果

taxon

disease(MedicalCondition)のマークアップ例

疾患の名前のみの場合,http://schema.org/MedicalConditionを使用してコードします。

microdata
<span itemscope itemtype="http://schema.org/MedicalCondition">
      <span itemprop="name">Marfan Syndrome</span>
 </span>
RDFa Lite
<span vocab="http://schema.org" typeof="MedicalCondition">
      <span property="name">Marfan Syndrome</span>
 </span>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "MedicalCondition",
  "name" : "Marfan Syndrome"
}
</script>


クローラーでの取得結果

@MedicalCondition_name=Marfan Syndrome

disease with code(MedicalCondition,MedicalCode)のマークアップ例

IDで疾患を特定する場合,http://schema.org/MedicalCondition, http://schema.org/MedicalCodeを使用してコードします。

microdata
<span itemscope="" itemtype="http://schema.org/MedicalCondition">
      <span itemprop="code" itemscope itemtype="http://schema.org/MedicalCode">
               <meta itemprop="codeValue" content="Q87.4"><meta itemprop="codingSystem" content="ICD-10">
      </span>
 </span>
RDFa Lite
<span vocab="http://schema.org" typeof="MedicalCondition">
      <span property="code" vocab="http://schema.org"  typeof="MedicalCode">
               <meta property="codeValue" content="Q87.4"><meta property="codingSystem" content="ICD-10">
      </span>
 </span>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "MedicalCondition",
  "code" : {
    "@type" : "MedicalCode",
    "codeValue" : "Q87.4",
    "codingSystem" : "ICD-10"
    }
}
</script>


クローラーでの取得結果

@MedicalCode_codeValue=Q87.4
@MedicalCode_codingSystem=ICD-10

Sagaceでの検索結果

disease

seeAlsoのマークアップ例

BiologicalDatabaseEntry自体の入れ子となっています。isEntryOfも使用し,データベースについての情報を記述しています。
検索結果への正確な反映のために,出来るだけ,name, url, entryIDの全てのマークアップをお願いします。

microdata
<div itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">
<span itemprop="seeAlso" itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">
  <span itemprop="isEntryOf" itemscope="" itemtype="http://schema.org/BiologicalDatabase">
   <span itemprop="name">OMIM</span> </span>: 
   <a itemprop="url" href="http://omim.org/entry/154700"><span itemprop="entryID">154700</span></a> 
 </span>
</div>
RDFa Lite
<div vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
<span property="seeAlso" vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
  <span property="isEntryOf" vocab="http://schema.org/" typeof="BiologicalDatabase">
   <span property="name">OMIM</span> </span>: 
   <a property="url" href="http://omim.org/entry/154700"><span property="entryID">154700</span></a> 
 </span>
</div>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
  "seeAlso" : {
    "@type" : "BiologicalDatabaseEntry",
    "entryID" : "154700",
    "url" : "http://omim.org/entry/154700",
    "isEntryOf" : {
    "@type" : "BiologicalDatabase",
    "name"  : "OMIM"
    }
    }
}
</script>


クローラーでの取得結果

@ボキャブラリー_プロパティ_ボキャブラリー_プロパティで,この場合入れ子になっています。

@BiologicalDatabaseEntry_seeAlso_BiologicalDatabase_name=OMIM
@BiologicalDatabaseEntry_seeAlso_BiologicalDatabaseEntry_url=http://omim.org/entry/154700
@BiologicalDatabaseEntry_seeAlso_BiologicalDatabaseEntry_entryID=154700

Sagaceでの検索結果

seeAlso

dateModifiedのマークアップ例

microdata
<div itemscope="" itemtype="http://schema.org/BiologicalDatabaseEntry">
<span itemprop="dateModified">2012-10-24</span>
</div>
RDFa Lite
<div vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
<span property="dateModified">2012-10-24</span>
</div>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
  "dateModified" : "2012-10-24"
}
</script>


クローラーでの取得結果

@dateModifiedはLast Modified(最終更新日)として表示されます。

@BiologicalDatabaseEntry_dateModified=2012-10-24

Sagaceでの検索結果

lastModified

referenceのマークアップ例

microdata
<ul itemscope itemtype="http://schema.org/BiologicalDatabaseEntry">
  <li>Morita M., Igarashi Y., Ito M., Chen YA., Nagao C., Sakaguchi Y., Sakate R., Masui T., Mizuguchi K.,  Sagace: a web-based search engine for biomedical databases in Japan., BMC Res Notes, 2012 Oct 31, 5:604, 
   <span itemprop='reference' content='pmid:23110816' >
    <a href="http://www.ncbi.nlm.nih.gov/pubmed/23110816" target="_blank">pmid:23110816</a>
   </span>
  </li>
</ul>
RDFa Lite
<ul vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
  <li>Morita M., Igarashi Y., Ito M., Chen YA., Nagao C., Sakaguchi Y., Sakate R., Masui T., Mizuguchi K.,  Sagace: a web-based search engine for biomedical databases in Japan., BMC Res Notes, 2012 Oct 31, 5:604, 
   <span property='reference' content='pmid:23110816' >
    <a href="http://www.ncbi.nlm.nih.gov/pubmed/23110816" target="_blank">pmid:23110816</a>
   </span>
  </li>
</ul>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
  "reference" : "pmid:23110816"
}
</script>


Metadata read by our microdata crawler

@dateModified is shown as Last Modified.

@BiologicalDatabaseEntry_reference=pmid:23110816

Sagaceでの検索結果

reference

これらを組み合わせたマークアップ例

microdata
<div itemscope itemtype="http://schema.org/BiologicalDatabaseEntry">
Name: <span itemscope itemtype="http://schema.org/MedicalCondition">
             <span itemprop="code" itemscope itemtype="http://schema.org/MedicalCode">
                          <meta itemprop="codeValue" content="Q87.4"><meta itemprop="codingSystem" content="ICD-10">
      </span>
             </span>

     <span itemprop="seeAlso" itemscope itemtype="http://schema.org/BiologicalDatabaseEntry">
           <span itemprop="isEntryOf" itemscope itemtype="http://schema.org/BiologicalDatabase">
           :       <span itemprop="name">ICD-10</span>
           <a itemprop="url" href="http://www.kegg.jp/kegg-bin/get_htext?br08403+H00653"><span itemprop="entryID">Q87.4</span></a>
      </span>
           </span>: 
      Species:
      <span itemprop="taxon" itemscope itemtype="http://schema.org/BiologicalDatabaseEntry">
        <span itemprop="name">Human</span>
        Taxonomy ID: <a itemprop="url" href="http://www.uniprot.org/taxonomy/9606"><span itemprop="entryID">9606</span></a>
      </span>
     References:
     PMID:<meta itemprop='reference' content='pmid:11706995'/><a href="http://www.ncbi.nlm.nih.gov/pubmed/11706995">11706995</a>
      <span itemprop="dateModified">2012-10-24</span>
      <span itemprop="isEntryOf" itemscope itemtype="http://schema.org/BiologicalDatabase">
     <a itemprop="url" href="http://www.kegg.jp/kegg/disease/"><span itemprop="name">KEGG DISEASE (Diseases viewed as perturbed states of the molecular system)</span></a>
       </span>
</div>
RDFa Lite
<div vocab="http://schema.org/" typeof="BiologicalDatabaseEntry">
Name: <span  typeof="MedicalCondition">
             <span property="code" typeof="MedicalCode">
                          <meta property="codeValue" content="Q87.4"><meta property="codingSystem" content="ICD-10">
      </span>
             </span>

     <span property="seeAlso" typeof="BiologicalDatabaseEntry">
           <span property="isEntryOf" typeof="BiologicalDatabase">
           :       <span property="name">ICD-10</span>
           <a property="url" href="http://www.kegg.jp/kegg-bin/get_htext?br08403+H00653"><span property="entryID">Q87.4</span></a>
      </span>
           </span>: 
      Species:
      <span property="taxon" typeof="BiologicalDatabaseEntry">
        <span property="name">Human</span>
        Taxonomy ID: <a property="url" href="http://www.uniprot.org/taxonomy/9606"><span property="entryID">9606</span></a>
      </span>
     References:
     PMID:<meta property='reference' content='pmid:11706995'/><a href="http://www.ncbi.nlm.nih.gov/pubmed/11706995">11706995</a>
      <span property="dateModified">2012-10-24</span>
      <span property="isEntryOf" typeof="BiologicalDatabase">
     <a property="url" href="http://www.kegg.jp/kegg/disease/"><span property="name">KEGG DISEASE (Diseases viewed as perturbed states of the molecular system)</span></a>
       </span>
</div>
JSON-LD
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "BiologicalDatabaseEntry",
  "image" : "http://www.pdbj.org/emnavi/data/emdb/media/1556/images/emd1556.png",
  "dateModified" : "2012-10-24",
  "reference" : "pmid:23110816",
  "entryID" : "H00653",
    "isEntryOf" : {
    "@type" : "BiologicalDatabase",
    "name"  : "OMIM",
    "url"   : "http://omim.org/entry/154700",
    "entryID" : "154700"
    },
   "taxon" : {
    "@type" : "BiologicalDatabaseEntry",
    "name"  : "Homo sapiens",
    "url"   : "http://www.uniprot.org/taxonomy/9606",
    "entryID" : "9606"
    },
    "seeAlso" : {
    "@type" : "BiologicalDatabaseEntry",
    "entryID" : "154700",
    "url" : "http://omim.org/entry/154700",
    "isEntryOf" : {
    "@type" : "BiologicalDatabase",
    "name"  : "OMIM"
    }
    }
}
</script>
 
<script type="application/ld+json">
{
  "@context": "http://schema.org",
  "@type": "MedicalCondition",
  "name" : "Marfan Syndrome",
  "code" : {
    "@type" : "MedicalCode",
    "codeValue" : "Q87.4",
    "codingSystem" : "ICD-10"
    }
}
</script>

Sagaceでの検索結果

seeAlso

Leave a Reply