Anchor Macro

페이지의 특정 부분에 연결할 수 있다.

위키 마크 업 예제
편집기 외부에 매크로를 추가하려는 경우 (예 : 스페이스의 세로 막대, 머리글 또는 바닥 글에 사용자 지정 내용으로 유용 할 때 유용)
매크로 이름 : Anchor
매크로 본문 : 없음

 

{anchor:here}

 

Anchors
앵커를 사용하여 페이지의 특정 위치에 링크 할 수 있으며 특히 긴 문서의 특정 부분을 탐색 할 수 있게하는데 유용.
앵커는 페이지가 표시 될 때 볼 수 없다.

1 단계 : 앵커 만들기
앵커 매크로를 추가하여 연결할 위치를 표시.

  1. Confluence 편집기에서 다음 중 하나를 수행 :
    • 삽입> 기타 매크로를 선택한 다음 앵커 매크로를 찾아 선택
    • { + 매크로 이름의 시작 부분을 입력한 다음 [앵커 매크로] 선택
  2. 앵커 이름 입력 (예 : '하단'또는 '중요 정보')
  3. 삽입 선택

매크로 옵션 (매개 변수)
매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션.
Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개 변수 이름이 매크로 브라우저에서 사용되는 레이블과 다른 경우, 아래에 대괄호 (예)로 표시.

ParameterDefaultDescription
앵커 이름없음링크를 만들 때 사용할 앵커 이름
  • 앵커 이름에는 공백이 포함될 수 있다. 앵커를 가리키는 URL을 생성 할 때 공백을 자동으로 제거
  • 앵커 이름은 대소 문자를 구분. 앵커 매크로를 만들 때 사용한 것과 같은 링크를 만들 때 대문자와 소문자의 동일한 패턴을 사용해야 한다.

 

2 단계 : 앵커에 대한 링크 만들기
다음 위치에서 앵커에 연결할 수 있다.

  • 같은 Confluence 사이트에있는 페이지. 링크는 앵커와 동일한 페이지, 같은 공간에 있는 다른 페이지 또는 같은 Confluence 사이트의 다른 공간에 있는 페이지에 있을 수 있다.
  • 특정 형식의 URL을 사용하는 다른 웹 페이지 또는 다른 Confluence 사이트.

같은 Confluence 사이트상의 엥커에의 링크 :

  1. 텍스트를 선택하거나 링크를 삽입 할 위치에 커서를 놓는다.
  2. 툴바에서 링크를 선택하거나 Ctrl + K를 클릭
  3. 고급을 선택하고 아래 양식에 따라 링크 필드에 앵커 이름을 입력

    앵커 위치앵커 링크 구문예제
    같은 페이지#anchor이름#바닥
    #중요한정보
    같은 공간의 페이지페이지이름#anchor이름내페이지#하단
    내페이지#중요한정보
    다른 공간의 페이지spacekey:페이지이름#anchor이름DOC:내페이지#하단
    DOC:내페이지#중요한정보
  4. 링크 텍스트를 입력하거나 수정 (이 텍스트는 페이지에 표시.이 필드를 비워두면 페이지 이름 또는 URL이 링크 텍스트로 사용)
  5. 저장 선택

앵커 이름은 대소 문자를 구분
같은 Confluence 사이트에서 페이지와 앵커 이름을 링크 할때 공백으로 페이지 이름과 앵커 이름을 입력
이름에 특수 문자가있는 다른 페이지의 앵커에 링크하는 경우 URL에 이름 대신 페이지 ID가 표시되므로 링크 할 때 페이지 이름을 입력

 

다른 웹 페이지 또는 다른 Confluence 사이트의 앵커 링크 :
다음과 같은 형식의 전체 URL을 사용


전체 URL에 대한 참고 사항 :

  • 페이지 이름은 URL에서 # 기호 다음에 반복. 페이지 이름의 두 번째 어커런스는 모든 공백이 제거 된 단일 단어로 연결
  • 연결된 페이지 이름과 앵커 이름 사이에는 대시 (하이픈)가 위치
  • 전체 URL의 앵커 이름은 하나의 단어로 연결되며 모든 공백은 제거
  • 앵커 이름은 대소 문자를 구분
  • 페이지 이름에 특수 문자가 포함되어 있는 경우 URL에 이름 대신 페이지 ID 표시. 이 경우 앵커에 대한 링크는 다음과 같이 표시됨
    http://myconfluence.com/pages/viewpage.action?pageId=54689987#Test-page1!-anchor
    이 예문에서 페이지 제목은 Test-page1! 앵커 이름은 anchor

 

Notes

  • 페이지의 목차 : 목차 매크로를 사용하여 페이지의 제목을 가리키는 링크 목록을 생성하는 것을 고려할 것.
    링크 목록이 페이지에 나타나며 누군가 제목을 변경할 때마다 자동으로 업데이트된다.
  • 제목 링크하기 : 페이지의 제목에 직접 연결할 수 있다. 그러나 누군가 제목을 변경하면 직접 링크가 끊어진다. 
    Anchor 매크로를 사용하여 페이지 본문 내에서 지속적인 링크를 보장.
  • 사이트 시작 메시지 : 사이트 환영 메시지에서 사용중인 페이지에 앵커를 추가하는 경우 다른 페이지의 해당 앵커에만 연결할 수 있다. 
    해당 페이지 내의 내부 링크는 작동하지 않는다.
  • 템플릿 : 템플릿 미리보기 시 앵커에 대한 링크가 '깨진'링크로 표시. 그러나 템플릿을 사용하여 페이지를 만들면 결과 페이지에 올바른 링크가 표시된다.