 |
요약 | 토픽의 테이블을 멤버들이 +로 언급할 수 있는 검색 가능한 항목으로 변환하며, 링크와 원박스 미리보기를 제공합니다. |
 |
저장소 | Discourse Mentionables |
 |
설치 가이드 | 자체 호스팅 Discourse 사이트에 플러그인 설치하기 |
 |
후원 | 이 플러그인들이 최신 Discourse 버전과 호환되도록 유지 관리될 수 있도록 지속적인 개발에 대한 후원을 고려해 주세요. |
커뮤니티가 이야기하는 주제(책, 제품, 프로젝트, 장소, 지원 자료 또는 URL이 있는 기타 항목)에 대해 공유 어휘를 제공하세요.
멤버들은 +와 이름의 일부를 입력하고, 제안을 선택하면 주소를 기억하지 않아도 읽기 쉬운 링크를 얻을 수 있습니다.
기능
- URL만으로 시작. 가져오기 도구가 이름을 검색하고 슬러그를 생성합니다. 사용자 정의 이름과 슬러그를 선택적으로 오버라이드로 추가할 수 있습니다.
- 작성 중 검색.
+를 입력하거나 작성 도구 모음 버튼 사용하여 카탈로그를 검색합니다. 마크다운 및 리치 텍스트 작성기 모두에서 작동합니다. - 읽기 쉬운 인라인 링크. 멘션은 항목의 표시 이름이 포함된 컴팩트한 필 형태로 나타나며, 게시물의 마크다운에는 안정적인 슬러그가 포함됩니다.
- 네이티브 원박스. 멘션을 단독 줄에 배치하면 Discourse의 기존 레이아웃과 지원되는 대상에 따라 원박스가 표시됩니다.
- 데스크톱 미리보기. 인라인 필에 마우스를 올리거나 포커스를 맞추면 원본 페이지 열기 링크가 포함된 플로팅 미리보기가 열립니다. 일반 클릭은 대상으로 이동합니다.
- 관리자가 Discourse에서 편집할 수 있는 카탈로그. 토픽의 첫 번째 게시물에 있는 마크다운 테이블에서 가져옵니다. Google 계정이나 API 자격 증명이 필요하지 않습니다.
- 관리자를 위한 테이블 버튼. 작성 도구 모음에서 빈 mentionables 테이블을 삽입한 후 항목을 채워 넣습니다.
원박스 모양은 대상과 Discourse의 일반적인 원박스 지원에 따라 달라집니다. 지원하지 않는 대상은 링크로 남습니다. 플로팅 카드에는 로그인이 필요하며, 게스트는 여전히 대상 링크를 따를 수 있습니다. 코드 내의 멘션은 그대로 두며, 목록과 인용문 내의 멘션은 인라인으로 유지됩니다.
기본 Mentionables 및 Pro 확장
기본 Mentionables는 기본 플러그인입니다. Pro는 이를 함께 설치하는 선택적 동반 플러그인으로, 해당 종속성을 통해 기본 기능을 포함합니다.
| 기능 | 기본 Mentionables | Pro 확장 포함 |
|---|---|---|
| 토픽의 첫 번째 게시물에서 마크다운 테이블 가져오기 | 예 | 예 |
| 소스 토픽을 제한된 카테고리에 유지 | 예 | 예 |
| 관리자 전용 테이블 스켈레톤 삽입을 위한 작성 버튼 | 예 | 예, 아이콘 컬럼 포함 |
마크다운 및 리치 텍스트 작성기에서 +로 검색 |
예 | 예 |
| 인라인 멘션 필 및 단독 네이티브 원박스 | 예 | 예 |
| 데스크톱에서 마우스 오버 또는 키보드 포커스 시 플로팅 미리보기 | 예 | 예, 기본 호버 모드에서 |
| 서비스 계정을 사용한 Google Sheets에서 가져오기 | — | 예 |
| 토픽 테이블과 Google Sheets 간 선택 | 토픽 테이블만 | 예 |
| 12시간마다 자동 동기화 | — | 선택 사항, 기본적으로 꺼짐 |
| 선택적 아이콘 이름 및 HTML 색상 가져오기 | — | 어느 소스에서든 예 |
| 클릭 또는 탭 시 플로팅 미리보기 열기 (터치 기기 포함) | — | 선택 사항 |
Pro의 icon 및 icon_colour 컬럼은 멘션 이름 앞에 색상이 입힌 아이콘을 추가합니다. 예를 들어 핸드북의 경우 book과 #2563eb을 사용할 수 있습니다.
mentionables_pro_click_to_preview가 활성화되면, 필을 클릭하거나 탭하면 미리보기가 열리며, 미리보기의 원본 페이지 열기 링크는 대상 위치로 이동합니다.
빠른 설정
-
위의 설치 가이드를 사용하여 기본 플러그인을 설치합니다. 설치 후 Discourse를 다시 빌드합니다.
-
카탈로그용 토픽을 생성합니다. 관리자로 로그인하여 작성 도구 모음의 mentionables 테이블 삽입을 사용하거나 다음 테이블을 첫 번째 게시물에 붙여넣습니다:
| name | url | slug | image_url | | ------------------ | ----------------------------------- | ------------------ | --------- | | Getting started | https://example.com/getting-started | getting-started | | | Community handbook | https://example.com/handbook | community-handbook | | | Events calendar | https://example.com/events | events-calendar | | -
예시 URL을 자신의 것으로 대체하고 게시물을 저장한 후,
mentionables_topic_id를 해당 토픽의 숫자 ID로 설정합니다.mentionables_enabled
을 활성화된 상태로 유지하세요. Pro 설치는 이 구성을 위해mentionables_source에서topic_table을 선택해야 합니다. -
관리자 → 플러그인 → Mentionables를 열고, 가져오기 시작을 클릭한 후
새로고침을 눌러 보고서를 확인합니다. 백그라운드 작업 워커가 실행 중이어야 합니다. -
브라우저를 새로 고치고 작성기를 연 다음
+를 입력하여 항목을 테스트해 보세요.
대문자 컬럼 이름을 사용하십시오. 필수 항목은 url뿐이며, http://
또는 https://로 시작해야 합니다. URL만 있는 행은 대상에서 이름을 검색하고 슬러그를 생성합니다. 이러한 기본값을 오버라이드하기 위해 name, slug 또는 둘 다를 제공할 수 있으며, 하나의 테이블 내에서 이 옵션들을 혼합할 수 있습니다. 제목이 이용 가능하지 않으면 URL이 표시 이름이 됩니다. 소스에 슬러그가 없으면 기존 URL은 슬러그를 유지합니다.
image_url 및 description은 선택 사항입니다.
가져오기 도구는 첫 번째 게시물에서 url 컬럼이 있는 첫 번째 인용되지 않은 테이블을 읽습니다. 답변, 인용된 테이블, 펜스 코드 샘플은 무시됩니다. 소스 토픽은 개인 메시지가 아닌 정규적이고 삭제되지 않은 토픽이어야 합니다.
소스 프라이버시 및 카탈로그 업데이트
신뢰할 수 있는 사람들만이 유지 관리할 수 있도록 소스 토픽을 Staff 또는 다른 제한된 카테고리에 유지할 수 있습니다. 가져온 이름, URL 및 이미지는 mentionables 사용자에게 공개됩니다. 토픽을 제한해도 가져온 카탈로그가 비공개가 되지 않습니다. 기밀 정보는 테이블에 포함시키지 마세요.
각 가져오기는 URL 기준으로 동기화됩니다: 일치하는 URL은 업데이트되고, 새 URL은 레코드를 생성하며, 소스에서 제거된 URL은 레코드를 삭제합니다. 전체 소스가 유효해야 하며; 중복된 URL 또는 슬러그, 잘못된 행, 검색 실패, 빈 데이터셋은 카탈로그를 변경하지 않습니다. 의도적인 삭제를 위해 전체 삭제를 사용하세요.
소스 토픽과 스프레드시트는 절대 수정되지 않습니다. Pro의 선택적
mentionables_pro_sync_enabled 설정은 12시간마다 동일한 가져오기를 실행합니다.
가져오기 후 브라우저를 새로 고쳐야 합니다. 기존 쿠킹된 게시물은 자동으로 다시 베이킹되지 않으며, 슬러그를 명시적으로 변경하면 이전 +slug 참조가 깨질 수 있습니다.
설정 및 추가 정보
| 설정 | 목적 |
|---|---|
mentionables_enabled |
Mentionables 활성화 또는 비활성화. |
mentionables_topic_id |
첫 번째 게시물에 소스 테이블을 포함하는 토픽. |
mentionables_autocomplete_limit |
최대 제안 수; 기본값은 5개. |
mentionables_onebox_fallback |
이름이 제공된 경우에도 누락된 이미지/설명 검색; 기본적으로 꺼짐. |
전체 설정 가이드, 가져오기 동작 및 문제 해결은 README를 참조하세요. 스크린샷은 플러그인의 테스트 픽스처에서 가져온 샘플 데이터를 사용합니다.
