사이트 선택기

상단 바에 알려진 모든 측정 데이터베이스를 리그 종류별로 묶어 보여주는 드롭다운입니다. 방문자가 다른 사이트로 바로 이동할 수 있습니다.

개요

크로스 사이트 검색이 “이 기기를 측정한 다른 곳은 어디인가”에 답한다면, 사이트 선택기는 “어디로 갈 수 있는가”에 답합니다. 개별 기기가 아니라 데이터베이스 자체를 나열하며, 현재 보고 있는 데이터베이스를 강조해 표시합니다.

squig.link가 아니어도 어떤 호스팅 환경에서든 동작합니다. 선택기는 몇 KB짜리 작은 디렉터리 문서 하나만 읽으므로, 방문당 캐시되는 요청 한 번으로 끝납니다.

이 문서는 GAA가 제공합니다. GAA는 GraphAggregator의 연합 인덱스와 squig.link의 사이트 레지스트리를 병합한 뒤, 기기 목록을 뺀 사이트·데이터베이스 목록만 게시합니다. modernGraphTool에 해당 URL이 내장되어 있어 따로 설정할 것은 없습니다.

목록에 등록하기

선택기는 공유 인덱스가 알고 있는 사이트만 표시합니다. 목록에 나타나려면:

• 자체 호스팅 또는 커스텀 도메인 — graphaggregator.harutohiroki.com에서 등록하세요.
• squig.link 호스팅 — squig.link 자체 레지스트리를 통해 이미 등록되어 있습니다.

등록하면 다른 모든 사이트의 크로스 사이트 검색에서도 내 데이터베이스가 검색됩니다. 기본값인 auto 설정에서 내 사이트에 선택기가 나타나게 하는 조건이기도 합니다.

설정

config.js에서 설정합니다. 이 섹션은 선택 사항이며, 생략하면 아래 기본값이 적용됩니다.

SITE_SELECTOR: {
    ENABLED: 'auto',
    INDEX_URLS: [],
}

설정 옵션

• ENABLED — 선택기를 언제 표시할지 결정합니다.
  • 'auto'(기본값) — 이 사이트가 인덱스에 등록되어 있거나 squig.link에서 호스팅될 때만 표시합니다. 등록하지 않은 독립 사이트라면, 내 데이터베이스는 하나도 없고 남의 것만 잔뜩 나열된 드롭다운 대신 아무것도 표시하지 않습니다.
  • true — 항상 표시합니다.
  • false — 표시하지 않으며, 인덱스를 받아오지도 않습니다.
• INDEX_URLS — 시도할 디렉터리 문서 목록(순서대로). 비워 두면 공식 GAA 인덱스를 사용합니다.

인덱스 직접 호스팅하기

외부 출처에 의존하고 싶지 않다면, 디렉터리 문서를 직접 게시하고 INDEX_URLS를 그쪽으로 지정하세요.

SITE_SELECTOR: {
    ENABLED: 'auto',
    INDEX_URLS: [
        'https://example.com/my-site-index.json',
        'https://backup.example.com/my-site-index.json'
    ],
}

목록의 URL을 순서대로 시도하며 먼저 유효한 문서를 반환한 쪽을 사용하므로, 미러를 백업으로 함께 지정할 수 있습니다. 문서는 GAA 스키마를 따라야 합니다. 명세와 생성 스크립트는 GAA 저장소를 참고하세요. GAA를 포크한 뒤 그 포크의 GitHub Pages URL을 지정하는 것이 가장 간단한 방법입니다.

참고

• 방문자가 보고 있는 데이터베이스는 URL로 판별해 선택된 상태로 표시합니다. 경로가 가장 길게 일치하는 항목이 이기므로, /와 /headphones/를 함께 호스팅하는 사이트도 올바르게 구분됩니다.
• 인덱스를 마지막으로 만들 때 접근할 수 없었던 데이터베이스는 목록에 남되 흐리게 표시되며, 링크가 동작하지 않을 수 있다는 툴팁이 붙습니다. 잠시 다운된 사이트가 목록에서 사라지지 않습니다.
• 항목은 새 탭에서 열립니다.