HTML Include Macro

Confluence 페이지에 외부 HTML파일(웹 페이지)의 내용을 포함

HTML Include Macro 사용

HTML Include Macro를 페이지에 삽입하려면 :

1. Confluence 편집기에서 삽입 > 다른 매크로 선택
2. 필요한 매크로 찾기 및 선택

자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력.

기존 매크로 편집 : 매크로 자리 표시자를 클릭하고 편집 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.

매개 변수

매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션. 

Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개변수 이름이 매크로 브라우저에서 사용된 레이블과 다른 경우, 아래에 대괄호 ( example) 로 표시된다 .

HTML Include 매크로 사용

HTML Include 매크로는 기본적으로 비활성화 되어 있다. 이 매크로를 사용하려면 Confluence 관리자 또는 시스템 관리자 권한이 필요하다.

 이러한 매크로를 사용하면 Confluence 사이트가 사이트 간 스크립팅 공격에 취약해질 수 있다. 

모든 사용자가 해당 매크로를 악용하지 않도록 신뢰하는 경우에만 이 매크로를 켜야한다.

자체 서명 또는 익명 사용자가 콘텐츠를 만들 수 있도록 허용하는 경우 이 매크로를 사용하지 않는것이 좋다.

HTML Include 매크로를 활성화하려면 :

1.  > 부가 기능으로 이동  
2. 드롭 다운 메뉴에서 시스템을 선택 하고 Confluence HTML 매크로 추가 기능 검색
3. 부가 기능을 확장하고 html-include(html-include-xhtml) 모듈을 사용하도록 설정

관리자는 화이트리스트를 사용하여 HTML Include 매크로에 표시할 수 있는 URL을 제한하도록 선택할 수도 있다 .

문제 해결

• 관리자는 신뢰할 수 있는 URL의 화이트리스트를 정의 할 수 있다. URL이 화이트리스트에 없으면 HTML Include 매크로에 오류 메시지가 표시된다.

• 절대 링크가있는 페이지에만 HTML Include 매크로를 사용할 수 있다. 매크로를 사용하여 상대 링크가있는 HTML 페이지를 포함하면 '페이지를 찾을 수 없음'오류가 표시된다. 

  CONFSERVER-6567 참조하여 HTML Include 매크로가 원격 사이트를 가리키도록 상대 링크를 다시 작성해야한다.

위키 마크 업 예제

이 예제는 편집기 외부에 매크로를 추가하려는 경우(예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로) 유용

매크로 이름 : html-include

매크로 본문 : 없음

{html-include:url=http://www.example.com}