Code Block Macro
- 이병욱
다음과 같은 구문 강조 표시를 통해 페이지에 소스 코드를 표시할 수 있다.
코드 블록 매크로 추가
- Confluence 편집기에서 삽입> 다른 매크로를 선택
- 필요한 매크로 찾기 및 선택
자동 완성으로 매크로 항목 속도 향상 : 추천 매크로 목록을 보려면 {및 매크로 이름의 시작 부분을 입력
기존 매크로 편집하기 : 매크로 자리 표시자를 클릭하고 편집을 선택. 매크로 대화 상자 창이 열리고 매크로 매개변수를 편집할 수 있다.
코드 블록을 편집기의 매크로 자리 표시 자에 직접 입력한다. 자리 표시 자에 포함된 공백은 코드 블록 매크로에 의해 조작되지 않는다.
이는 코드 들여 쓰기보다 융통성있게 작성자에게 제공하는 것이다.
매개변수
매크로 출력의 내용이나 형식을 제어하도록 설정할 수 있는 옵션.
Confluence 스토리지 포맷 또는 wikimarkup에서 사용되는 매개변수 이름이 매크로 브라우저에서 사용되는 레이블과 다른 경우, 아래에 대괄호(예)로 표시.
| 매개변수 | 기본값 | 설명 |
|---|---|---|
| 구문 강조(language) | Java | 구문 강조 표시의 언어(또는 환경)를 지정. 기본 언어는 Java이지만 다음 언어/환경 중 하나를 선택할 수 있다.
|
| 표제 | 없음 | 코드 블록에 제목을 추가. 지정된 경우 제목은 코드 블록의 맨 위에 있는 머리글 행에 표시. |
| 접을 수 있는(collapse) | false |
|
| 줄 번호 표시(linenumbers) | false | 선택하면 행 번호가 코드 행의 왼쪽에 표시 |
첫번째 줄 번호(firstline) | 1 | 줄 번호 표시를 선택하면 이 값은 첫번째 코드 줄 번호를 정의 |
| 테마 | Default | 코드 블록을 표시하는데 사용되는 색 구성표를 지정. 이러한 주제 중 많은 부분은 널리 사용되는 통합 개발 환경(IDE)의 기본 색상 구성표를 기반으로한다. 기본 테마는 Confluence(Default라고도 함)이다.이 배경은 일반적으로 빈 배경에 검정색 채색된 텍스트다.
|
코드 블록 매크로 구성
기본적으로 특정 언어와 테마를 사용하도록 코드 블록 매크로를 구성하고 새 언어를 업로드할 수 있다.
기본 테마와 언어를 변경하려면 Confluence Administrator 권한이, 새로운 테마를 업로드하기 위해서는 System Administrator 권한이 필요하다.
사이트에서 코드 블록의 기본 모양을 설정하려면 :
- 장부 아이콘 선택
> Confluence Administration에서 General Configuration 선택 - 코드 매크로 구성 선택
- 기본 테마 및 기본 언어 선택
- 저장 선택
별도로 지정하지 않는한 모든 새 코드 블록은 기본 테마와 언어를 사용. 기존 코드 블록은 변경되지 않는다.
추가 언어를 추가하려면 :
- 장부 아이콘 선택 > Confluence Administration에서 General Configuration 선택
- 코드 매크로 구성 선택
- 새 언어 추가 선택
- 언어 파일을 찾고 새 언어의 이름을 입력 (언어를 선택할때 나타남)
- 추가 선택
언어 파일은 올바르게 형식이 지정된 JavaScript파일이어야하며 사용자 정의 브러시 구문을 준수해야한다.
사용자가 설치한 언어를 비활성화하거나 제거하려면 :
- 장부 아이콘 선택 > Confluence Administration에서 General Configuration 선택
- 애드온 관리 선택
- 사용자가 설치한 부가 기능으로 이동하여 업로드한 언어의 부가 기능 검색. '사용자 정의 코드 매크로 강조 표시 ...'와 같이 표시.
- 제거 또는 사용 안함 선택
해당 언어는 더 이상 코드 매크로에 나타나지 않는다.