KoreanWikiFormatting » History » Revision 42
Revision 41 (Joony Kim, 2025-02-28 12:56) → Revision 42/51 (Joony Kim, 2025-02-28 13:01)
h1. KoreanWikiFormatting
h1. 텍스트 서식(작업중:Working)
{{>TOC}}
h2. 링크 넣기
h3. 레드마인에 링크넣기
레드마인에는 어디에나 텍스트 형식의 리소스(일감, 변경내용, 위키 페이지...)에 하이퍼 링크를 사용하실 수 있습니다.
* 일감 링크: *!#124* (화면표시 #124, 링크가 취소선이 되어있는 경우는 일감이 완료되어 닫혀있는 경우입니다.)
* 일감의 댓글 링크: *!#124-6*, 또는 *!#124!#note-6*
* 변경 내용 링크: *!r758* (화면표시 r758)
* 숫자가 아닌 변경 내용 링크: *commit:c6f4d0fd* (화면표시 c6f4d0fd).
위키 링크:
* *[[Guide]]* 'Guide'라는 이름의 페이지에 대한 링크를 표시합니다.: [[Guide]]
* *[[Guide|User manual]]* 같은 페이지에 있지만 다른 텍스트 링크를 표시: [[Guide|User manual]]
* *[[Guide#User-guide|User guide]]* 다른 텍스트를 같은 페이지에 헤더로 연결되는 링크를 표시합니다.: [[Guide#User-guide|User guide]]
프로젝트 식별자를 사용하여 다른 프로젝트의 위키 페이지에 링크 할 수 있습니다.:
* *[[sandbox:some page]]* Sandbox 위키의 'Some page'라는 이름의 페이지에 대한 링크를 표시합니다.
* *[[sandbox:]]* Sandbox 위키 메인 페이지에 대한 링크를 표시합니다.
페이지가 아직 존재하지 않는 경우 위키 링크는 빨간색으로 표시됩니다. 예: [[Nonexistent page]].
다른 리소스에 대한 링크:
* 문서:
* *!document#17* (문서 ID 17에 대한 링크)
* *!document:Greetings* (제목 "Greetings"과 문서에 대한 링크)
* *!document:"Some document"* (문서 제목에 공백이 포함된 경우 큰 따옴표를 사용할 수 있습니다.)
* *!sandbox:document:"Some document"* (프로젝트 식별자 "sandbox"안에 제목 "Some document"문서에 대한 링크)
* 버전:
* *!version#3* (버전 ID 3에 대한 링크)
* *!version:1.0.0* (개정번호 "1.0.0"버전에 대한 링크)
* *!version:"1.0 beta 2"* (버전명에 공백이 포함되어 있는 경우에 큰 따옴표를 사용할 수 있습니다.)
* *!sandbox:version:1.0.0* (프로젝트 식별자 "sandbox" 내에 있는 "1.0.0" 버전에 대한 링크)
* 첨부 파일:
* *!attachment:file.zip* (file.zip 이름의 현재에 대상이되는 첨부파일 링크)
* *!attachment:"file.zip"* (파일 이름이 아닌 단어 문자가 포함되어 있는 경우에 큰 따옴표를 사용할 수 있습니다.)
* 지금은, 현재 대상이 되는 첨부파일만을 참조할 수 있습니다.(첨부가 일감에 있다면, 해당 일감에 서만 참조하는 것이 가능합니다.)
* 변경 내용(체인지셋):
* *!r758* (변경 내용에 대한 링크)
* *!commit:c6f4d0fd* (숫자가 아닌 해시로 되어있는 변경 내용에 대한 링크)
* *!svn1|r758* (다중 저장소와 특정 프로젝트 저장소에 대한 변경 내용 링크)
* *!commit:hg|c6f4d0fd* (특정 저정소에 숫자가 아닌 해시로 되어있는 변경 내용에 대한 링크)
* *!sandbox:r758* (다른 프로젝트의 변경 내용 링크)
* *!sandbox:commit:c6f4d0fd* (다른 프로젝트 식별자와 숫자가 아닌 해시로 되어있는 변경 내용에 대한 링크)
* 저장소 파일:
* *!source:some/file* -- 프로젝트 저장소 내에 /some/file 의 위치에 있는 파일을 링크
* *!source:some/file@52* -- Revision 52의 파일들을 링크
* *!source:some/file#L120* -- 파일의 120라인을 링크
* *!source:some/file@52#L120* -- Revision 53에 링크된 파일의 120라인을 링크
* *!source:"some file@52#L120"* -- URL에 공백이 포함되어 있는 경우에 큰 따옴표를 사용할 수 있습니다.
* *!source:repo_identifier|some/file* -- 프로젝트의 기본 저장소가 아닌 다른 저장소에 있는 파일을 링크할 수 있습니다.
* *!source:"repo_identifier|some file"* -- 기본 저장소가 아니고, 경로에 공백이 있는 다른 저장소에 있는 파일을 링크할 수 있습니다.
* *!export:some/file* -- 파일의 다운로드를 강제로 할 수 있습니다.
* 게시판:
* *!forum#2* (게시판 ID 2를 링크)
* *!forum:Discussion* ("Discussion"이름의 게시판을 링크)
* *!forum:"Help and more"* (게시판 이름에 공백이 있는 경우에 큰 따옴표를 사용할 수 있습니다.)
* 게시판 답글:
* *!message#1218* (게시판 답글 Id 1218의 링크)
* 뉴스:
* *!news#1* (뉴스 ID 1을 링크)
* *!news:Greetings* (이름이 "Greetings"인 뉴스 항목의 링크)
* *!news:"eCookbook first release !"* (뉴스 항목 이름에 공백이 있는 경우에 큰 따옴표를 사용할 수 있습니다.)
* 프로젝트:
* *!project#3* (프로젝트 ID3의 링크)
* *!project:someproject* (이름이 "someproject"인 프로젝트의 링크)
* *!project:"Multiple words project"* (프로젝트 이름에 공백이 있는 경우에 큰 따옴표를 사용할 수 있습니다.)
Escaping:
* 느낌표를 구문 앞에 넣어 레드마인 링크를 방지할 수 있습니다.: !
h3. 외부 링크
HTTP URL이 자동으로 클릭 가능한 링크로 설정됩니다.:
* *http://www.redmine.org* -- 레드마인 웹사이트의 외부링크: http://www.redmine.org
* *someone@foo.bar* -- 이메일 주소의 링크: someone@foo.bar
HTTP URL은 또 링크 자체보다 다른 텍스트를 사용할 수 있습니다.:
* *"레드마인 웹 사이트":http://www.redmine.org* -- 다른 텍스트를 넣은 외부링크: "레드마인 웹 사이트":http://www.redmine.org
* *!http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org* -- URL로 연결되는 제목대신 외부 이미지를 넣는 경우:
p=. !http://www.redmine.org/attachments/7069/Redmine_logo.png(Redmine web site)!:http://www.redmine.org
h3. Email 주소
Email 주소는 자동으로 클릭이 가능한 링크로 설정됩니다.:
* *"Email someone":mailto:someone@foo.bar* -- 다른 표시명으로 되어있는 Email 링크: "Email someone":mailto:someone@foo.bar
Email 링크에 더 복잡한 설명을 추가할 수 있습니다. 기본 제목, 기본 본문, 그리고 CC 정보를 정의 할 수 있습니다. Note 이 필드에서는 고백을 코드 %20 으로 대체해서 사용해야 합니다.
* *"Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar* -- Webmaster, CC admin 의 Email: "Email webmaster and admin":mailto:webmaster@foo.bar?cc=admin@foo.bar
* *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help* -- 제목 "Website Help"의 Email링크: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help
* *"Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20* -- 제목 "Website Help"와 기본 본문 Email 링크: "Email someone for help":mailto:someone@foo.bar?subject=Website%20Help&body=My%20problem%20is%20
h2. 텍스트 서식
헤드라인, 볼드, 테이블, 목록과 같은 서식에 대해 레드마인은 "Textile syntax":http://en.wikipedia.org/wiki/Textile_%28markup_language%29 를 지원합니다.
이러한 기능을 사용하는 방법에 대한 자세한 내용은 http://redcloth.org/hobix.com/textile/를 참조하십시오. 몇가지 샘플은 하기에 기술합니다만, 엔진은 더 많은 기능을 지원합니다.
h3. 머리글 이니셜
<pre>
JPL(Jean-Philippe Lang)
</pre>
Display:
JPL(Jean-Philippe Lang)
h3. 글꼴 스타일
<pre><code>보통
*굵게*
_기울임꼴_
*_굵게 기울임꼴_*
+밑줄+
-취소선-
보통 ^위 첨자^
보통 ~아래 첨자~
@inline monospace@ 인라인 고정폭은 영문만 해당함.
</code></pre>
Display:
* 보통(Plain)
* *굵게*
* _기울임꼴_
* *_굵게 기울임꼴_*
* +밑줄+
* -취소선-
* 보통 ^위 첨자^
* 보통 ~아래 첨자~
* @inline monospace@
h3. 인라인 이미지
* *!image_url!* image_url에 있는 이미지를 표시합니다.(textile syntax)
* *!>image_url!* 이미지를 오른쪽에 고정해 표시합니다.
* *!image_url(Image title)!* alt/title 속성과 함께 이미지를 표시합니다.
* *!image_url!:URL* image_url에 있는 이미지를 표시하고 해당 이미지에 URL링크를 추가합니다.
작성중인 위키 페이지에 첨부 된 이미지가 있다면 그 파일 이름을 사용하여 바로 표시할 수 있습니다: *!attached_image.png!*
또한 CSS스타일을 적용할 수 있습니다. 코드는 다음과 같이 하며 *!{width: 100%}attached_image.png!* 이미지의 폭을 조정할 수 있습니다.
h3. 제목
<pre><code>h1. 제목
h2. 소제목1
h3. 소제목2
</code></pre>
Redmine에 각 제목의 앵커 입니다. 따라서 해당 위키페이지의 링크에 "#제목", "#소제목1"을 붙이면 해당 위치에 대한 링크를 만들 수 있습니다.
h3. 단락 표현
<pre><code>p. left aligned
p(. left ident 1em
p((. left ident 2em
as well as for following lines
p>. right aligned
p)))>. right ident 3em
p=. This is centered paragraph.
</code></pre>
h3. 가로줄 넣기
<pre>
----
</pre>
표시:
----
h3. 사전정의
위키 문법에서 벗어나 표시한다.
<pre> <pre> *텍스트는 굵게 표시되지 않습니다.* </pre> </pre>
표시:
<pre> *텍스트는 굵게 표시되지 않습니다.* </pre>
h3. 블록 인용
단락을 *bq.* 로 시작합니다:
<pre><code>bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.
</code></pre>
표시:
bq. Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
To go live, all you need to add is a database and a web server.
또한 각 행의 시작 부분에 > 을 사용 또는 >> 중첩해서 사용해서 블록인용을 사용할 수 있습니다:
<pre>
>> Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
>> To go live, all you need to add is a database and a web server.
> Great!
</pre>
표시:
>> Rails is a full-stack framework for developing database-backed web applications according to the Model-View-Control pattern.
>> To go live, all you need to add is a database and a web server.
> Great!
h3. 글머리 기호
<pre>
* Item 1
* Item 2
** Item 21
** Item 22
* Item 3
</pre>
표시:
* Item 1
* Item 2
** Item 21
** Item 22
* Item 3
h3. 번호 매기기
<pre>
# Item 1
# Item 2
# Item 3
## Item 3.1
## Item 3.2
</pre>
표시:
# Item 1
# Item 2
# Item 3
## Item 3.1
## Item 3.2
h3. 표 만들기
<pre>
|_.UserID |_.Name |_.Group |_. attribute list |
|Starting with | a | simple |row |
|\3=.IT |<. align left |
|1 |Artur Pirozhkov |/2.Users |>. align right |
|2 |Vasya Rogov |=. center |
|3 |John Smith |Admin
(root) |^. valign top |
|4 |- |Nobody
(anonymous) |~. valign bottom |
</pre>
표시(다중 스페이스는 1개의 스페이스로 대체됩니다.):
|_.UserID |_.Name |_.Group |_. attribute list |
|Starting with | a | simple |row |
|\3=.IT |<. align left |
|1 |Artur Pirozhkov |/2.Users |>. align right |
|2 |Vasya Rogov |=. center |
|3 |John Smith |Admin
(root) |^. valign top |
|4 |- |Nobody
(anonymous) |~. valign bottom |
테이블 내부에 파이프 문자를 포함 할 경우(예: 위키 링크에 대한)에는 해석이 잘못되는 것을 방지하기 위해 하기와 같이 입력할 필요가 있습니다:
|_.Input |_. Output|
|*<notextile><notextile>|</notextile></notextile>*|<notextile>|</notextile>|
테이블의 너비를 지정하려면 테이블 정의 바로 앞에 table{width:100%}를 넣어야 합니다.:
<pre>
table{width:100%}.
| 이 테이블은 가로 공간을
전부 사용합니다. |
</pre>
이렇게 하면 표가 전체 페이지 너비로 확장됩니다...
table{width:100%}.
| 이 테이블은 가로 공간을
전부 사용합니다. |
... 표준 너비와 비교하:
| 이 테이블은
필요한 공간만 사용합니다. |
h3. 목차 만들기
<pre><code>{{toc}} => 왼쪽 정렬 목차
{{>toc}} => 오른쪽 정렬 목차
</code></pre>
TOC태그와 다른 텍스트 사이에 위아래로 빈 줄을 필요로 합니다.
예시:
<pre><code>
h1. headLineOne
h2. something
{{toc}}
h2. something more
</code></pre>
h3. 각주(Footnotes) 만들기
각주 표시(Marker):
<pre>
각주가 있는 첫 번째 단어[1]입니다.
각주가 있는 두 번째 단어[2]입니다.
</pre>
*참고:* 단어에 직접 붙은 마커(공백이나 점 또는 그 사이에 다른 것이 없어야 함).
정의:
<pre>
fn1. 첫 번째 단어에 대한 각주
fn2. 두 번째 단어에 대한 각주
</pre>
*참고:* 문서 내 어디에나 각 정의를 개별 줄에 표시합니다. 정의 사이에는 빈 줄이 있어야 합니다.
표현의 예:
각주가 있는 첫 번째 단어[1]입니다.
각주가 있는 두 번째 단어[2]입니다.
fn1. 첫 번째 단어에 대한 각주
fn2. 두 번째 단어에 대한 각주
h2. 매크로 (Macros)
Redmine에는 서식이 지정된 텍스트에 동적 콘텐츠를 삽입하기 위한 사용자 정의 함수를 추가할 수 있는 매크로 시스템이 포함되어 있습니다.
[[RedmineMacros]]에서 나 만의 매크로를 작성하는 방법에 대해 자세히 알아볼 수 있습니다.
Redmine에는 또한 몇 가지 기본 제공되는 매크로가 포함되어 있습니다.
{{macro_list}}
h2. 코드 강조 표시
기본 코드 강조 표시는 순수 루비(Ruby)로 작성된 구문 강조 표시 라이브러리인 "Rouge":http://rouge.jneen.net/에 의존합니다. 다음과 같이 일반적으로 사용되는 많은 언어를 지원합니다(괄호 안의 이름은 별칭입니다). *c*, *cpp* (c++), *csharp* (c#, cs), *css*, *diff* (patch, udiff), *go* (golang), *groovy*, *html*, *java*, *javascript* (js), *kotlin*, *objective_c* (objc), *perl* (pl), *php*, *python* (py), *r*, *ruby* (rb), *sass*, *scala*, *shell* (bash, zsh, ksh, sh), *sql*, *swift*, *xml* 및 *yaml* (yml). 지원되는 언어의 전체 목록은 [[RedmineCodeHighlightingLanguages]]를 참조하세요.
다음과 같은 구문을 사용하여 위키 페이지에서 코드의 내용을 강조할 수 있습니다.
<pre><code><pre><code class="ruby">
여기에 코드를 넣으세요.
</code></pre>
</code></pre>
예:
<pre><code class="ruby">
# Greeter 클래스
class Greeter
def initialize(name)
@name = name.capitalize
end
def salute
puts "Hello #{@name}!"
end
end
</code></pre>
h2. CSS를 사용하여 텍스트 스타일링
Textile은 CSS를 사용하여 텍스트 스타일을 지정할 수 있습니다. 예를 들면 다음과 같습니다.
<pre>
빛의 3가지 기본 색상은 %{color: #f00}red%, %{color: #0f0}green%, %{color: #00f}blue%입니다.
p{border: solid 1px #000; padding: 0.5em;}. 재빠른 갈색 여우가 게으른 개를 뛰어넘습니다.
table{width: 100%}.
|={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 |
</pre>
예시:
빛의 3가지 기본 색상은 %{color: #f00}red%, %{color: #0f0}green%, %{color: #00f}blue%입니다.
p{border: solid 1px #000; 패딩: 0.5em;}. 재빠른 갈색 여우가 게으른 개를 뛰어넘는다.
table{width: 100%}.
|={width: 30%; background-color: #aaf;}. column 1 |={width: 70%}. column 2 |
h3. 허용되는 CSS 속성
Redmine은 다음 속성을 허용합니다. 다른 속성은 보안상의 이유로 허용되지 않습니다(r2192 참조).
* background
* background-*
* border
* border-*
* color
* float
* font
* font-*
* height
* margin
* margin-*
* max-height
* max-width
* min-height
* min-width
* padding
* padding-*
* text
* text-*
* width
h2. 번역
다음의 번역은 최신버전이 아닐 수 있습니다. 필요에 따라 원래 영어 설명서를 참조하시기 바랍니다.
* [[RedmineWikiFormatting|영문]]