이 부분을 자세히 파악하는 데 시간이 좀 걸렸으니, 어떻게 하면 이 기능이 작동하는지 간단히 설정 방법을 공유합니다. 아이디어는 커스텀 사이드바 섹션에서 Docs 페이지로 연결되는 여러 가지 단축키를 제공하는 것입니다. 예를 들어 여기서는 세 가지 태그 필터(issue, resource, manual)를 사용했고, 기본 카테고리인 General과 Site Feedback에 두 가지 카테고리 필터를 추가했습니다:
이 링크들의 일반 URL은 다음과 같이 보입니다:
/docs?tags=issue
/docs?tags=resource
/docs?tags=manual
/docs?category=4
/docs?category=2
이렇게 링크를 설정하면 혼란스럽고 심지어는 아무 결과도 나오지 않는 효과가 발생할 수 있습니다:
- 링크는 태그를 태그로, 카테고리를 카테고리로 대체합니다. 하지만 태그와 카테고리는 교차(intersect)합니다.
- 교차할 수 없는 필터들이 교차하게 됩니다. 그러면 "No Docs topics yet"라고 표시되는 빈 Docs 페이지에 도달하게 됩니다.
- 태그와 카테고리가 모두 선택된 후에는 교차를 초기화하는 방법이 없습니다.
그렇다면 Docs 페이지로 연결되는 여러 직접 링크를 어떻게 작동하게 할까요?
모든 링크에 교차 조건이 포함된 URL을 제공해야 합니다. 실제로 교차하지 않아야 하는 링크라면, 이를 명시적으로 지정해야 합니다. 예를 들어:
docs?category=&tags=issue
docs?category=&tags=resource
docs?category=&tags=manual
docs?category=4&tags=
docs?category=2&tags=