단일 이미지
페이지에 이미지 하나를 삽입하기 위해서는 아래 구문을 사용해주세요.
[[image 이미지_소스 속성1="값" 속성2="값2" ...]]허용된 속성값은 다음과 같습니다.
| 속성명 | 허용값 | 값 예시 | 설명 |
|---|---|---|---|
| link | 위키 페이지명 혹은 URL | "wiki-page" "http://www.example.com" "#anchor" "#" |
이미지를 페이지나 다른 웹 주소로 링크합니다. Flickr 소스를 사용할 경우 이 속성은 무시됩니다. 링크 앞에 "*"를 붙이면 새 창으로 열립니다. 페이지의 앵커에 링크할 수도 있습니다. "#"은 이미지가 클릭됐을 때의 동작을 방지합니다. |
| alt | 문자열 아무거나 | "내 사진" | 이미지가 표시되지 않을 경우 대체되는 텍스트입니다. 스크린 리더에서 이미지를 설명할 때도 쓰입니다. |
| title | 문자열 아무거나 | "내 사진" | 이미지에 마우스를 올렸을 때 나타나는 텍스트입니다. |
| width | 픽셀수 | "200px" | 이미지가 보여졌을 때 가로폭을 지정합니다 |
| height | 픽셀수 | "200px" | 이미지가 보여졌을 때 세로폭을 지정합니다 |
| style | 유효한 CSS 스타일 정의 | "border: 1px solid red; padding: 2em;" | 이미지에 추가적인 CSS 스타일을 추가합니다 |
| class | CSS 클래스 | "mystyle" | 이미지에 CSS 클래스를 지정합니다. 사용자 정의된 테마에만 사용하는 것을 권장합니다. |
| size | "square" - 75x75 픽셀 "thumbnail" - 가장 긴 쪽을 100으로 맞춤 "small" - 가장 긴 쪽을 240으로 맞춤 "medium" - 가장 긴 쪽을 500으로 맞춤 "medium640" - 가장 긴 쪽을 640으로 맞춤 (Flickr 전용) "large" - 가장 긴 쪽을 1024으로 맞춤 (Flickr 대형 이미지 전용) "original" - 원래 이미지 (Flickr 전용) |
허용된 값 아무거나 | 리사이징시킨 이미지를 보여줍니다. 섬네일 등에 유용합니다. (링크 변수가 제공되지 않으면 투명도가 손실됩니다. 섬네일을 클릭하면 원본 이미지를 엽니다.) Flickr 소스를 사용할 경우, Flickr 서버 에서 필요한 크기를 가져옵니다. 이 설정은 로컬 이미지 및 Flickr의 이미지에만 유효합니다. |
size 속성은 로컬 파일(페이지에 첨부된 파일)에서도 잘 작동하지만, 이미지 파일뿐만 아니라, 예를 들어, PDF 및 PostScript 파일도 잘 작동합니다. 자세한 사항은 이 페이지를 참조하십시오.
이미지_소스는 다음 내용 중 하나를 선택할 수 있습니다.
| 소스 형식 | 포맷 | 값 예시 | 설명 |
|---|---|---|---|
| URL 주소 | 유효한 URL 주소 아무거나 | http://www.example.com/image.jpg | 웹 주소에서 이미지를 보여줍니다. |
| 첨부 파일 (현재 페이지) | 파일명 | exampleimage.jpg | 현재 페이지에 첨부된 이미지를 보여줍니다. |
| :first | :first | :first | 현재 페이지에 첨부된 첫번째 이미지를 보여줍니다. (혹은 아무것도 표시하지 않습니다.) |
| 첨부 파일 (다른 페이지) | /another-page-name/파일명 | /another-page/exampleimage.jpg | 다른 페이지에 첨부된 이미지를 불러옵니다. |
| flickr 이미지 | flickr:사진_아이디 | flickr:83001279 | Flickr 이미지를 보여주고 원래 Flickr 페이지로 링크합니다. |
| flickr 이미지 (비밀) | flickr:비밀_사진_아이디 | flickr:149666562_debab08866 | Flickr 이미지를 보여주고 원래 Flickr 페이지로 링크합니다. 비밀이 제공되면 비공개 표시된 이미지도 볼 수 있습니다. |
링크된 문서를 새 창에서 열려면 link 속성 앞에 '*'(예 : link = "* http : www.example.com" )를 넣거나 src 요소 앞에 '*'(예 : *flickr:149666562_debab08866, *image-file// 등)를 지정해주면 자동으로 이미지에 링크가 걸리게 됩니다.
가로 정렬을 사용하려면 아래를 참조하십시오.
- [[=image… - 이미지 가운데 정렬
- [[<image… - 이미지 왼쪽 정렬
- [[>image… - 이미지 오른쪽 정렬
- [[f<image… - 왼쪽 띄우기 정렬 (텍스트로 둘러싸입니다)
- [[f>image… - 오른쪽 띄우기 정렬 (텍스트로 둘러싸입니다)
이미지 갤러리
페이지 내용에 이미지 시리즈를 삽입하려면 [[gallery]] 요소를 사용하십시오.
[[gallery size="image-size"]]혹은
[[gallery size="image-size"]]
: 이미지_소스1 속성1="값1" 속성2="값2" ...
: 이미지_소스2 속성1="값1" 속성2="값2" ...
...
[[/gallery]]| 속성 | 허용값 | 기본값 | 설명 |
|---|---|---|---|
| size | "square", "thumbnail", "small", "medium" | "thumbnail" | 미리보기 이미지의 크기 설정 로컬 이미지 혹은 Flickr 이미지에만 이 설정이 유효합니다. |
| order | "name", "name desc", "created_at", "created_at desc" | "name" | 정렬 방식을 설정합니다. |
| viewer | "false", "no", "true", "yes" | "yes" | 라이트박스 뷰어를 비활성화합니다. |
정렬 매개변수는 "nameDesc", "dateAddedDesc", "dateAdded"의 권장값도 허용됩니다. ListPages 모듈과의 일관성을 위해 "name desc desc", "created_at desc desc"값도 취할 수 있습니다("desc desc"가 없는 것과 같은 의미입니다).
[[gallery]] 태그가 이미지 목록없이 호출될 경우, 자동적으로 현재 페이지에 첨부된 이미지 파일의 섬네일 이미지를 표시합니다(갤러리에 .pdf와 .ps 문서를 써야 기본 이미지만 표시됩니다).
[[gallery]] 태그가 이미지 목록을 가지고 호출될 경우, 이 이미지들만 표시됩니다. 이미지_소스는 이 경우 URL이 아니어야합니다. 허용되는 각 이미지 속성은 다음과 같습니다.
- link - URL 혹은 위키 페이지명 (Flickr의 조건에 따라 Flickr 이미지는 작동하지 않습니다.)
- alt - 이미지를 사용할 수 없을 때 대체되는 텍스트
새 창에서 문서를 여는 것은 단일 이미지를 여는 것과 같은 방식으로 작동합니다.
기본적으로 갤러리는 라이트박스를 사용하여 이미지를 보여줍니다. 갤러리 내 이미지를 클릭하면 새 창이나 탭을 열거나 페이지를 새로고침할 필요 없이 전/후로 이미지를 스크롤 할 수 있는 아주 멋진 팝업창이 나옵니다. 라이트박스를 비활성화하려면 다음 매개변수를 사용하십시오.
[[gallery viewer="no"]] or [[gallery viewer="false"]]
Flickr에서 사진을 가져올 때는 FlickrGallery 모듈을 참조하십시오.
[[gallery]]를 독립된 한 줄에 넣지 않으면 파서가 변환하지 않습니다.