History: 링크 작성 위키문법

Source of version: 12 (current)

! 링크 위키-문법
이 페이지에서는 ((Wiki|위키)) 페이지 내부에 링크를 포함시키는 방법을 배우게 되며, 동일한 티키위키 사이트 내부의 다른 위키 페이지로 링크를 거는 법, 외부 위키 사이트로 링크를 거는 법, 및 웹(인터넷)으로 링크를 거는 법 등도 배우게 됩니다.

{ANAME()}quick{ANAME}
!! 빠른 참조 
{FANCYTABLE(head=> "__To...__ ~|~ __Default Syntax__ ~|~// __Optional Syntax{SUP()}1{SUP}__>> ~|~ ~|~''Syntax'' ~|~ ''Requires...''" )}
위키페이지로의 링크 ~|~  ~np~((Wiki Page Name|위키 페이지 이름))~/np~ ~|~ ~np~위키 페이지 이름~/np~ ~|~ WikiWords{SUP()}2{SUP}
외부 위키페이지로의 링크 ~|~ ~np~((Ext Wiki Name: Ext Wiki Page Name))~/np~ ~|~ ~np~ExtWikiName: ExtWikiPageName~/np~ ~|~ WikiWords{SUP()}2{SUP} 
웹페이지로의 링크 ~|~ ~np~[http://www.somesite.org] ~/np~ ''or'' %%%~np~[http://www.somesite.org|Some Site!]~/np~ ~|~ ~np~http://www.somesite.org~/np~ ~|~ AutoLinks{SUP()}3{SUP} 
{FANCYTABLE}

{img src="img/icons/book_open.png"} __주의:__
# 티키는 기본 링크 문법을 수정하는 2개의 선택사항을 포함합니다: __위키단어__ 와 __자동링크__.
# [Wiki+Config#Use_WikiWordsWikiWords|위키단어] 를 활성화하려면:
** ((Wiki Config|관리: 위키 페이지))에서, __기능__ 탭을 선택하십시오.
** 기능 탭에서, __위키단어__ 선택사항을 활성화하십시오.
+ [Wiki+Config#Use_WikiWordsWikiWords|위키단어] 기능이 비활성화 된 경우, 위키 페이지 링크를 만들려면 ''반드시'' 이중 괄호를 사용해야합니다.
# ((AutoLinks|자동링크))를 활성화하려면:
** From the ((Text Area|관리: 텍스트 영역 페이지))에서, __일반 설정__탭을 선택하십시오. 티키 4.x에서는 이는 ""편집 & 플러그인""으로 이름이 변경되었습니다.
** 일반 설정 탭에서, 기타 영역에서, __자동링크__ 선택사항을 활성화하십시오.
+ ((AutoLinks|자동링크)) 기능이 비활성화된 경우, 외부 페이지로 링크를 만들려면 대괄호를 사용해야만 합니다.

!! 서식적용된 툴팁
티키는 다음에 나오는 것과 같이 링크에 대하여 서식적용된 툴팁을 만드는 것을 허용하는 내장된 클래스가 있습니다 (''티키도움말 (tikihelp)''라고 불립니다):

''다음 문법:''
{CODE(wrap="1")}{HTML()} <a href="HomePage" class="tikihelp" title="홈페이지:이는 doc.tiki.org 에 대한 홈페이로 링크를 합니다">Home Page</ a>{HTML}{CODE}

''은 이 사이트에서 다음 내용을 제작하게 됩니다:''

{HTML()} <a href="HomePage" class="tikihelp" title="홈페이지:이는 doc.tiki.org 에 대한 홈페이로 링크를 합니다">Home Page</ a>{HTML}

위 링크 상으로 마우스 포인터를 가져와서 서식적용된 툴팁을 보십시오. 이렇게 툴팁이 표시되기위하여 중요한 것들은 다음과 같습니다:
* JQuery 가 반드시 활성화되어야 합니다
* class="tikihelp" 로 설정하십시오
* 콜론 앞의 제목의 첫 부분은 툴팁의 헤딩이고 콜론 뒤의 텍스트는 본분입니다.
!! 티키 사이트 내부로 링크 걸기
!!! 위키 페이지
[Wiki+Config?bl=y#Use_WikiWords|WikiWords] 선택사항을 사용할 때, 티키는 자동적으로 위키 페이지 이름을 감지하고 하이퍼링크로 올바르게 서식을 적용하게 됩니다

다음은 위키 페이지로의 링크를 생성하는 방법들입니다
* __ ~np~TheWikiWay~/np~ __
+ 2개 이상의 단어가 붙어있다 (스페이스가 없습니다, 하지만 - [[dash|대시] 와 _ [[underscore|밑줄]) 은 허용되며, 각 영단어의 첫글자는 대문자 입니다. 이 방식을 사용하려면 [Wiki+Config?bl=y#Use_WikiWords|WikiWords] 선택사항을 활성화해야만 합니다.
* __ ~np~ ((위키 방식)) ~/np~ __
+ 스페이스를 포함하는 위키 페이지 이름 혹은 [Wiki+Config?bl=y#Use_WikiWords|WikiWords] 선택사항이 활성화 되어있지 않을 때, 페이지 이름 앞뒤로 각각 두 개의 괄호를 사용합니다.
* __ ~np~ (token-name(The Wiki Way)) ~/np~ __ 
+ ((Semantic Admin|시맨틱 링크)), 한정자를 사용하여 위키 페이지로 링크를 하려면 ''token-name'' 참조를 사용하십시오. 시맨틱 링크는 ((Tiki3|티키 3.0))에서 소개되엇으며 별도로 활성화되어야만 합니다. 추가 정보는 ((Semantic Admin|시맨틱 관리)) 를 참고하십시오. 트릭: 이는 링크 상에 클래스를 놓기를 위하여서도 사용될 수 있습니다.

이 표는 위키 페이지로 링크를 만드는 부가적인 방법들을 나열합니다.

{FANCYTABLE(head="__작업...__ ~|~ __문법__ ~|~ __결과__ ~|~ __댓글__" sortable="n")}
링크 텍스트 지정 ~|~   ~np~((PluginVersions | 버전 플러그인))~/np~   ~|~ ((PluginVersions|버전 플러그인)) ~|~ 링크 텍스트로부터 페이지명을 구분하려면 수직 막대기 (__|__ [[파이프]) 사용.
\\헤딩 혹은 다른 페이지의 앵커로 링크하고 링크 텍스트 지정 ~|~   ~np~ ((Using Wiki Pages | #The_Wiki_Menu | 위키 메뉴)) ~/np~  %%%''(하지만 파이프 주위에 스페이스가 없어야함)'' ~|~ ((Using Wiki Pages|#The_Wiki_Menu|The Wiki Menu)) ~|~\\ 티키는 위키 페이지 상의 헤딩에 대하여 자동으로 앵커를 만듭니다. 헤딩 혹은 앵커에 대하여 # 문자와 스페이스를 대체하는 밑줄에 유의하여 주십시오.
  ~np~ [Wiki+Plugins#Plugin_Syntax | Plugin Syntax] ~/np~   ~|~ [Wiki+Plugins#Plugin_Syntax | Plugin Syntax]
동일한 페이지 상의 헤딩으로 링크 ~|~ ~np~ [#Related_Pages|Related Pages] ~/np~ ~|~[#Related_Pages|Related Pages]~|~# 문자와 스페이스를 대체하는 밑줄에 유의하여 주십시오.
특정 탭으로 표시하며 페지이로 링크~|~   ~np~[PluginImg&cookietab=3~/np~  %%%  ~np~#Parameters | Params Tab3]~/np~  %%% %%%''(하지만 # 앞에 줄 바꿈이 없음)'' ~|~ [PluginImg&cookietab=3#Parameters' | Params Tab3] ~|~ ((PluginTabs)) 이 사용된 페이지에서 작동하며 내장된 탭이 있는 페이지에서도 동작. 이 예제어서는 헤딩으로도 링크하고 있음
링크 텍스트에 대하여 사용자 지정 색 사용 ~|~   ~np~((Wiki-Syntax Text|~~#ff0000:Syntax for Text~~))~/np~   ~|~ ((Wiki-Syntax Text| ~~#ff0000:Syntax for Text~~)) ~|~ 기본으로 색은 티키 테카 (CSS)에 의하여 정의됩니다. 추가 정보는 ((Wiki-Syntax Text|위키 문법 텍스트))를 살펴보십시오.

{FANCYTABLE}

{REMARKSBOX(type=tip title=팁)} ''페이지 안에서 링크를 설정하는 방법과 거기에 링크하는 법은 ((PluginAlink)) 과 ((PluginAname)) 를 살펴보십시오. 이 ((Wiki Plugin|플러그인들))은 동일한 페이지 안에서 앵커로 링크할 때 사용될 수 있습니다.''{REMARKSBOX}

{img src=img/icons/help.png } __도움말!__
* 페이지를 저장하였는데 페이지명 뒤에 물음표 (__?__)가 보이지만 페이지가 확실히 존재하는 경우, 페이지명을 올바르게 입력하였는지 확인하기 위하여 ((Search|검색 모듈)) 에서 페이지를 찾아 보십시오.
* When using [Wiki+Config?bl=y#Use_WikiWords|위키단어]를 사용할 때, 티키는 이상하게 대문자가 섞여있는 단어를 위키 링크로 변환하려 시도할 것입니다. 위키 링크가 ''되어서는 안될'' 것이라는 점을 지정하려면 단어 주위에 역순의 이줄 괄호를 사용하십시오 -- 이는 [Wiki+Config?bl=y#Use_WikiWords|WikiWords] 선택사항이 활성화되었다 할지라도 적용됩니다. 예를 들면:
+__~np~))WordStar((~/np~__ 는 링크가 ''아닌 것''이 될 것입니다.

!!! 기사, 블로그, 게시판 및 다른 페이지들
티키위키 사이트 내부의 모든 다른 종류의 페이지에 대하여, 대괄호로 축약 주소가 사용될 수 있습니다. 다음의 몇몇 예제를 살펴보십시오:

{FANCYTABLE(head=> __페이지 유형__ ~|~ __문법__ ~|~ __결과__)}
\\19번 기사  ~|~ ~np~ [tiki-read_article.php?articleId=19]~/np~  ~|~ [tiki-read_article.php?articleId=19] 
~np~[tiki-read_article.php?articleId=19|News from doc.tw.o!] ~/np~ ~|~ [tiki-read_article.php?articleId=19|News from doc.tw.o!]
갤러리 ~|~ ~np~ [tiki-galleries.php|Galleries] ~/np~ ~|~ [tiki-galleries.php|Galleries]
FAQ 번호 8 번 ~|~ ~np~ [tiki-view_faq.php?faqId=8|FAQ on Images] ~/np~ ~|~ [tiki-view_faq.php?faqId=8|FAQ on Images]
음영상자 팝업 ~|~ ~np~ [http://doc.tikiwiki.org/tiki-print.php?page=Wiki-Syntax+Links|See this page|shadowbox;title=shadowbox example;] ~/np~ %%% ''음영상자 기능이 활성화되어야만 합니다'' ~|~ [http://doc.tikiwiki.org/tiki-print.php?page=Wiki-Syntax+Links|이 페이지를 보십시오|shadowbox;title=shadowbox example;]
파일 갤러리 파일 ~|~ ~np~[tiki-download_file.php?fileId=284|PDF 파일 다운로드]~/np~ ~|~ [tiki-download_file.php?fileId=284|PDF 파일 다운로드]
{FANCYTABLE}

{REMARKSBOX(type=tip title=팁)} 위는 예제 몇 개만을 나열한 것입니다 - 티키위키 내부의 그 어떤 페이지도 이 방법을 사용하여 링크될 수 있습니다, 어떤 페이지에 있을 때 경로의 마지막 부분을 확인하고 링크에 대하여 그것을 사용하십시오.{REMARKSBOX}

주의: ~np~[foo]~/np~ 를 표시하려면 ~np~[[foo]~/np~ 를 사용하십시오

!!! 첨부파일과 그림 링크
위키 페이지로 첨부된 파일에 대한 링크를 만드려면 ((PluginAttach)) 혹은 ((PluginFile)) 을 사용하십시오. 그림이 링크로서 작동하여서 그림을 클릭하면 다른 페이지로 이동하기를 원하는 경우,  ((PluginImg)) 페이지의 매개변수 아래에 [PluginImg&cookietab=2#Parameters | 링크 그림 탭]을 살펴보십시오.

!!!! 팝업 안에서 그립으로 링크
||{CODE(wrap=1)}[img/php.png|팝업 안에서 그림을 보려면 여기를 클릭|shadowbox]{CODE}|[img/php.png|팝업 안에서 그림을 보려면 여기를 클릭|shadowbox]||

!!! 탐색 링크
다음은 탐색적 링크를 제공하는 플러그인들의 일부입니다:
* ((PluginAname)) - 는 위키 페이지 상에서 앵커를 만듭니다. 
* ((PluginAlink)) - 는 위키 페이지 안의 앵커로 링크합니다. ((PluginAname)) 과 함께 사용하십시오
* ((PluginBack)) - 는 한 페이지 뒤로 이동 하는 링크를 만듭니다
* ((PluginBacklinks)) - 는 현재 페이지로 링크하는 모든 페이지를 표시합니다
* ((PluginRedirect)) - 는 현재 페이지로의 링크들이 다른 페이지로 리디렉션되게 합니다

!!!! 특정 탭 표시
((PluginTabs)) 이 페이지 상에서 사용되는 경우, 페이지를 새로 고침하지 않고 페이지 안에서 특정 탭을 표시하기 위하여 다음 문법을 사용할 수 있습니다:
{TABS(tabs="버전 7|버전 7 이전")}
{CODE(wrap=1)}{HTML()}<a href="#tab2" onclick="tikitabs(2); return false;">탭 2</a>{HTML}{CODE}
/////
{CODE(wrap=1)}{HTML()}<a href="#tab2" onclick="tikitabs(2,4,1); return false;">탭 2</a>{HTML}{CODE}
{TABS}
다음은 이 문법의 주요 부분입니다:
* {DIV(type=span class=inline_syntax)}tikitabs(2){DIV} (7.0 버전에서) 혹은 {DIV(type=span class=inline_syntax)}tikitabs(2,4,1){DIV} (7.0 이전에서):
** {DIV(type=span class=inline_syntax)}2{DIV} 는 링크가 클릭될 때 두 번째 탭이 표시될 것이라는 것을 의미합니다
** 4 는 총 4개의 탭이 있다는 것을 의미하빈다 (7.0 이전)
** 세 번째 번호에 대하여 항상 1 을 사용하십시오 (7.0 이전)
* {DIV(type=span class=inline_syntax)}href="#tab2"{DIV} - 이는 아무런 텍스트가 될 수 있습니다, 단 # 로 시작해야만 합니다
* {DIV(type=span class=inline_syntax)}Tab 2{DIV} - 이는 링크로써 표시되는 텍스트가 될 것입니다

다음의 예제를 살펴 보십시오:
{HTML()}<a href="#tab2" onclick="tikitabs(2); return false;">Tab 2</a>{HTML}

{TABS(tabs=첫 번째 탭|두 번째 탭|세 번째 탭|네 번째 탭)}
첫 번째 탭
/////
두 번재 탭
/////
세 번재 탭
/////
네 번재 탭
{TABS}
!! 다른 위키 사이트로 링크하기
사이트 관리자가 이 선택사항을 활성화한 경우, 외부 위키 속의 페이지에 대한 축약된 링크가 만들어 질 수 있습니다. 이 기능에 대하여 관리자가 설정한 짧은 이름을 알아야 합니다 - 정보는 사이트 상의 ((TikiWiki Manual of Style|티키위키 스타일 설명서)) 안에 문서화되어있거나 관리자에게 문의하셔야 합니다. 전체 설명과 이 사이트에서 정의된 외부 위키에 대한 바로 가기 링크에 대하여 ((External Wikis|외부 위키)) 를 참고하십시오. (((External Wikis|#List_external_wiki_references|외부 위키 참조 목록)) 헤딩 하의 내용).

!! 웹 페이지로 링크하기
유효한 URL을 가지고 있는 웹 상의 그 어떤 페이지로 링크할 수 있습니다. 기본으로 티키는 원격 웹 사이트가 다운되는 경우에도 페이지를 사용가능할 수 있도록 로컬 캐시를 만듭니다. 다음은 이 문법의 예제입니다:

{FANCYTABLE(head=> __설명__ ~|~ __문법__ ~|~ __결과__ )}
외부 웹페이지로 링크 ~|~ ~np~[http://www.wiki-translation.com]~/np~ ~|~ [http://www.wiki-translation.com]
링크 텍스트 지정 ~|~ ~np~[http://www.wiki-translation.com|위키 번역]~/np~ ~|~ [http://www.wiki-translation.com|위키 번역]
))자동링크(( 활성화 됨 ~|~ ~np~http://www.wiki-translation.com~/np~ ~|~ [http://www.wiki-translation.com]
색상 폰트를 사용 ~|~ ~np~[http://www.tikiwiki.org|~~#ff0000:tw~~]~/np~ ~|~ [http://www.tikiwiki.org|~~#ff0000:tw~~]
새 창에서 열기 (기능이 활성화된 경우)~|~ ~np~[http://tiki.org|hello tiki.org|target]~/np~ ~|~ [http://tiki.org|hello tiki.org|target]
{FANCYTABLE}

((AutoLinks|자동 링크)) 관리 선택사항을 어떻게 설정하는지에 대하여 위의 [#Quick_Reference|빠른 참조] 부분을 살펴보십시오. 추가로, 외부 링크와 관련된 관리 선택사항이 2개 더 있습니다:
*__새 창에서 외부 링크를 열려면:__ 
+Go to ''관리 홈 > 텍스트 영역 > 기능 섹션'' 으로 이동하여 ''새 창에서 외부 링크 열기''를 체크하고 ''기본설정 변경''을 클릭하십시오. 이 기능이 비활성화 된 경우, 외부 링크는 기존의 브라우저 창 안에 열립니다.
+ %%%
* __외부 링크 아이콘을 비활성화하려면 ({img src="img/icons/external_link.gif"}):__ 
+ ''관리 홈 > 편집과 플러그인 > 일반 설정 > 외부 링크와 그림'' 으로 이동하여 ''회부 링크 아이콘''을 체크 취소하고 ''기본설정 변경''을 클릭합니다. 이것이 비활성화되면, ({img src="img/icons/external_link.gif"}) 아이콘이 더 이상 그 어떤 외부 링크의 끝에 표시되지 않을 것입니다. 이것을 활성화된 상태로 유지하면, 사용자가 다른 사이트로 이동될 때 그 사실을 알도록 합니다.

{img src="img/smiles/icon_exclaim.gif"} __중요__: PDF파일, 멀티미디어 파일, 혹은 HTML 페이지 외의 것을 링크하는 경우, 다음 예제에서처럼 ''nocache'' 지시문을 포함하여 주십시오:
* ~np~[http://www.somesite.org/docs/chapter1.pdf |nocache]~/np~
* ~np~[http://www.somesite.org/docs/chapter1.pdf|Chapter One|nocache]~/np~

{img src=img/icons/help.png } __도움말!__
* 링크가 작동하지 않는 경우, 브라우저 창에 URL 을 복사하는 것을 시도해 보고, 엔터를 클릭하십시오. 페이지가 존재하는 경우, 뒤로 이동하여 입력 내용을 확인하십시오. 입력 오류를 범했을 가능성이 큽니다. 대괄호 두 개 다 정확히 입력하셨습니까?

!! 반투명 팝업 (색상자) 안에서 링크 열기
외부 링크의 레이블 뒤에 추가 텍스트 "__|box__" (혹은 이전 출시판에서 __box__ 가 작동하지 않는 경우 "__|shadowbox__" 를 사용하십시오) 를 더해야 합니다. 필요한 경우 외부 자원에 대한 몇몇 매개변수를 세미콜론을 뒤여 툽여서 추가할 수 있습니다.

!!! 예제1
전체 화면 크기로 반투명 팝업 (색상자) 안에서 유튜브 동영상을 표시.

{CODE(wrap=1)}[http://www.youtube.com/v/KBewVCducWw&autoplay=1|플래시 재생기 안의 유튜브 동영상|box]{CODE}

이는 다음의 결과를 낳게됩니다:
[http://www.youtube.com/v/KBewVCducWw&autoplay=1|플래시 재생기 안의 유튜브 동영상|box]

!!! 예제2
반투명 팝업 (색상자) 내부에서 유튜브 동영상을 보여주지만 전체화면이 아닌 정의된 더 작은 크기로 보여줌:

{CODE(wrap=1)}[http://www.youtube.com/v/KBewVCducWw&autoplay=1|플래시 재생기 안의 유튜브 동영상|shadowbox;width=405;height=340;]{CODE}

이는 다음의 결과를 낳게됩니다:
[http://www.youtube.com/v/KBewVCducWw&autoplay=1|플래시 재생기 안의 유튜브 동영상|shadowbox;width=405;height=340;]
!! 이메일 주소로 링크하기
이메일주소로 링크하려면, 다음 예제에서처럼 대괄호 안에 ''mailto URL''을 넣습니다:
* ''다음처럼 입력하면:'' ~np~[mailto:johndoe@someplace.com]~/np~~hs~~hs~  
+ ''다음의 결과를 얻습니다:'' [mailto:johndoe@someplace.com]

* ''다음처럼 입력하면:'' ~np~[mailto:johndoe@someplace.com | John Doe]~/np~
+ ''다음의 결과를 얻습니다:'' [mailto:johndoe@someplace.com | John Doe]

!! 시맨틱 위키
3.0 버전에서 시작된 것으로, 티키위키는 위키 링크상에 시맨틱 한정자 (semantic qualifier) 를 지원합니다. 위키 링크에 한정자를 추가하려면, 다음 문법을 사용해야만 합니다:

~np~(qualifier-name(The Wiki Way))~/np~

* 한정자는 소문자 (a-z)와 대시를 포함할 수 있습니다.
* 한정자명은 표시를 사용자 지정하기 위하여 링크 상에 CSS 클래스로써 추가될 것입니다.
* 시맨틱 관계는 ((Semantic Admin|시맨틱 관리))로부터 관리자에 의하여 관리될 수 있습니다. 관계는 ((Module semantic_links|semantic_links 모듈))에서 볼 수 있습니다.

!!팁
* 대괄호 사이에 텍스트를 입력하려면, 2개의 여는 대괄호 뒤에 텍스트를 입력한 후, 하나의 닫는 대괄호를 다음과 같이 입력하시면  ~np~[[xxxx]~/np~ 결과과 다음과 같이 됩니다  [[xxxx]
!! 관련 페이지
* ((AutoLinks|자동링크)) - 외부링크를 자동으로 링크로 인식하게 하는 선택사항을 활성화함
* ((External Wikis|외부 위키)) - 다른 위키 사이트로의 바로 가기 링크를 생성함
* ((PluginAlink)) - 위키 페이지 내부의 앵커로 연결합니다. ((PluginAname)) 과 함께 사용합니다
* ((PluginAname)) - 위키 페이지에 앵커를 만듭니다
* ((PluginAttach)) - 페이지 상에 첨부파일로의 링크를 위치하기 위한 플러그인
* ((PluginBack)) - 한 페이지 뒤로 이동하기 위한 링크를 만듭니다
* ((PluginBacklinks)) - 페이지로 링크하는 모든 페이지들을 표시
* ((PluginFile)) - ((PluginAttach))와 유사함
* ((PluginImg)) - 그림을 링크로 전환
* ((PluginRedirect)) - 페이지로의 링크가 다른 페이지로 리디렉션 되게 함