InterpreterQuery
#!Query 는 InterpreterSchema 로 적어 둔 속성으로 페이지를 골라 표나 목록으로 보여 줍니다. 노션의 데이터베이스 뷰, 옵시디언의 Bases 와 같은 쓰임인데, 따로 입력할 것이 없습니다 — 위키가 이미 쌓아 둔 #!Schema 값을 읽을 뿐입니다.
1. 기본 문법
인자는 schema.org class 이름이고(공백으로 여러 개), 본문은 탭으로 구분한 줄입니다. 빈 줄과 # 로 시작하는 줄은 무시합니다. #!Schema 와 같은 모양입니다.
| Raw | Preview |
|---|---|
[[[#!Query Person where birthDate has show birthDate birthPlace sort birthDate ]]] |
No pages match. |
2. 줄의 종류
줄 | 뜻 |
|---|---|
| 조건. 여러 줄이면 모두 만족해야 합니다 |
| 이름 칸 뒤에 보일 속성들. 여러 줄이면 이어 붙입니다 |
| 정렬. 기본은 이름순 |
| 그 속성의 값별로 묶어 보입니다. 없는 페이지는 맨 뒤 |
| 최대 N 쪽(기본 100, 상한 500) |
| 표(기본) 또는 목록 |
3. 조건 (where)
속성은 값을 여럿 가질 수 있으므로(sameAs 처럼), 조건은 값들의 집합에 대해 묻습니다. = 는 어느 한 값이라도 같으면, != 는 어느 값도 같지 않으면 참입니다. 그래야 값이 하나 더 생겼다고 답이 바뀌지 않습니다.
연산 | 뜻 |
|---|---|
| 같다 / 다르다. 대소문자를 가리지 않습니다 |
| 포함한다 / 포함하지 않는다. 대소문자를 가리지 않습니다 |
| 크기 비교. 둘 다 숫자면 숫자로, 아니면 글자로 비교합니다(ISO 날짜 |
| 속성이 있다 / 없다. 값이 필요 없습니다 |
| 같은 월·일. |
값 자리에 today 를 쓰면 오늘 날짜입니다. md 와 쓰면 오늘의 월·일(--MM-DD)이 됩니다 — 오늘 생일인 사람은 이렇게 구합니다.
| Raw | Preview |
|---|---|
[[[#!Query Person where birthDate md today show birthDate ]]] |
No pages match. |
4. 정한 것과 그 이유
- 모르는 줄은 오류입니다.
shwo로 잘못 적은 줄이 조용히 무시되면, 아무것도 안 보이는 것이 «조건에 맞는 페이지가 없다» 와 구별되지 않습니다. 오류 상자가 어느 줄이 문제인지 말합니다. - class 도
where도 없는 질의는 거부합니다. 위키의 모든 페이지가 되기 때문입니다. - 속성이 없는 페이지는 정렬에서 맨 뒤입니다, 오름차순이든 내림차순이든. 없는 것이지 가장 작은 것이 아닙니다. 값이 같으면 이름순이라 렌더링마다 순서가 바뀌지 않습니다.
- 읽을 수 없는 페이지는 목록에도, 개수에도 나오지 않습니다.
- 그릴 때 읽습니다. 어떤 페이지가
#!Schema를 저장하는 즉시 이 목록에 나타납니다. 이 인터프리터가 따로 저장하는 것은 없습니다. - 값은 InterpreterSchema 가 그리는 것과 같이 위키 링크로 나옵니다.
- 연월만 있는 값은 감춥니다.
#!Schema는 날짜를 그 자체(1972-10-17)와 연월(1972-10)로 함께 저장하므로(월로 찾으려는 것), 그대로 보이면 생일이 둘인 것처럼 읽힙니다. 같은 속성에 그 연월로 시작하는 더 긴 값이 있으면 짧은 쪽을 보이지 않게 합니다 — 데이터에서는 지우지 않으니where는 둘 다 봅니다.
5. 아직 없는 것
- 카드·보드·달력 보기. 노션과 옵시디언 Bases 는 갖고 있습니다. 표와 목록으로 시작한 것은 나머지가 «데이터를 어떻게 고르는가» 가 아니라 «어떻게 그리는가» 의 문제라서, 고르는 쪽을 먼저 굳히려는 것입니다.
- 계산 열(노션의 formula·rollup)과 페이지 간 관계 따라가기.
- 여러 값 중 어느 것으로 정렬할지 고르기 — 지금은 첫 값(글자순으로 가장 앞)입니다.
- 속성을
#!Schema가 아니라 본문에서 읽기.
6. 구현
QueryEngine— 순수 함수: 줄을 읽고(parse), 조건을 평가하고, 정렬·묶기·자르기를 합니다. 데이터베이스도 HTML 도 모릅니다.QueryEngineSpec이 확인합니다.InterpreterQuery—CalculatedSchemaOrg에서 필요한 속성만(selectFacts) 읽어 엔진에 주고 그립니다. 한 번에 읽는 행은 2만으로 막아 두었습니다 — 거의 모든 페이지가 가진 속성으로 물으면 «앞의 행들» 로 줄어들 뿐 테이블을 통째로 읽지는 않습니다.- 같은 데이터 위에 MacroOnThisDay 가 먼저 있었습니다. 그것은 «이 날짜에 걸린 페이지» 한 가지를 고정해 둔 질의입니다.
8. See Also
8.2. Similar Pages
Similar pages by cosine similarity. Words after page name are term frequency.