문서 링크와 이미지 참조

사용자 정의 문서는 일반 Markdown 링크와 헤더 앵커, 번들 식별자를 사용하는 내부 링크를 지원합니다. 이미지에는 독자가 내용을 알 수 있는 대체 설명을 넣습니다.

같은 페이지의 헤더

표준 Markdown 앵커로 특정 헤더에 연결할 수 있습니다.

## Connection settings

[권한 설정으로 이동](#access-settings)

### Access settings

[연결 설정으로 돌아가기](#connection-settings)

내부 문서의 링크 대상에는 @product-id/page-name을 사용합니다. Product ID는 docs 아래 번들 폴더 이름이며 page-name에는 .md 확장자를 붙이지 않습니다.

[제품 개요](@product-test/overview)
[개요의 특정 절](@product-test/overview#section-header)

실제 product ID, 페이지 이름과 헤더 앵커를 사용하면 현재 플랫폼 인스턴스에 맞는 주소로 해석합니다. 해당 플랫폼 인스턴스에 대상이 없으면 링크 대신 일반 텍스트로 표시합니다. 링크가 클릭되지 않는 경우 대상 페이지가 존재하고 게시되어 있는지 확인합니다.

외부 사이트는 일반 URL을 사용합니다. 외부 사이트로 이동한다는 사실을 독자가 알 수 있도록 다음 예시처럼 링크 문구에 표시를 붙이는 것이 권장됩니다.

[Palantir 웹사이트 ↗](https://www.palantir.com)

이미지를 Foundry 파일시스템에 업로드한 뒤 리소스의 오른쪽 클릭 메뉴에서 Copy Image Address를 선택합니다. 복사한 Blobster 주소를 Markdown 이미지 링크의 대상으로 사용합니다.

주소 형태는 https://<enrollment-host>/blobster/api/salt/<blobster-rid>입니다. 실제로 복사한 주소를 쓰며 예시의 변수 표기를 그대로 넣지 않습니다.

![화면의 설정 항목을 보여 주는 설명](https://<enrollment-host>/blobster/api/salt/ri.blobster.main.image.<RID>)

데이터셋 안의 파일을 다음 경로 형식으로 참조할 수도 있습니다. 데이터셋 RID, 뷰 이름과 파일 경로는 실제 값을 사용합니다.

![데이터 처리 구조](/foundry-data-proxy/api/web/dataproxy/datasets/ri.foundry.main.dataset.<RID>/views/master/example.png)

이 예의 master는 데이터셋 뷰 이름입니다. 문서를 게시하는 저장소 브랜치 이름과 각각의 맥락을 구분합니다.

큰 GIF나 영상은 내용을 따라가기 어렵고 문서 성능에도 영향을 줄 수 있으므로 피하는 것이 권장됩니다. 필요한 장면을 이해할 수 있는 이미지와 설명을 사용하고, 게시된 독자가 해당 이미지 리소스에도 접근할 수 있는지 확인합니다.