Skip to content

S
SWLab Docs for Choi
Commit 34cbb880 authored by heywon.choi's avatar heywon.choi
Browse files
Options

Modify and add samples

parent 30af4a54
Hide whitespace changes
Inline Side-by-side
Showing with 1251 additions and 116 deletions
sample/Blocks_sample.adoc
View file @ 34cbb880
......@@ -20,60 +20,183 @@ This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
.Structural containers in AsciiDoc
[,cols="15%,32%,18%,35%",options="header",]
[cols="15,32,18,35"]
|===
|Type |Description |Minimum delimiter |Example
|comment |출력에 표시되지 않는 개인 메모 |//// |
|<<_comment>>
|출력에 표시되지 않는 개인 메모
|////
|////
This is a comment.
////
|<<_example>>
|예시 내용을 지정하거나 훈계 블록을 정의합니다.
|====
|====
This is an example.
====
|<<_listing>>
|소스 코드 또는 키보드 입력이 입력된 대로 표시됩니다.
|----
|----
This is a listing.
----
|<<_literal>>
|출력 텍스트는 입력한 대로 정확하게 표시됩니다.
|....
|....
This is a literal.
....
|<<_open>>
|통과 또는 테이블 블록을 제외한 모든 블록으로 작동할 수 있는 익명 블록
|\--
|\--
This is an open.
\--
|<<_sidebar>>
|문서의 흐름 외부에 표시되는 텍스트와 콘텐츠
|pass:[****]
|pass:[****]
This is a sidebar.
pass:[****]
|xref:Tables_sample.adoc#tables_sample[Table]
|표 형식 콘텐츠를 표시합니다.
|\|===
,===
:===
!===
|\|===
\|This is a table.
\|===
|<<_pass>>
|출력으로 직접 전송되는 처리되지 않은 콘텐츠
|pass:[++++]
|pass:[++++]
This is a pass.
pass:[++++]
|quote
|선택적 저작자 표시가 있는 견적
|pass:[____]
|pass:[____]
This is a quote.
pass:[____]
|===
== Comment
=== 한 줄 주석 (//)
----
// A single-line comment.
----
====
// A single-line comment.
====
=== 두 목록 구분
----
. first list
//
. second list
----
====
. first list
//
. second list
====
=== 블록 주석 (////)
----
////
This is a comment.
A comment block.
Notice it's a delimited block.
////
|<<_example>> |예시 내용을 지정하거나 훈계 블록을 정의합니다. |==== |
----
====
This is an example.
////
A comment block.
Notice it's a delimited block.
////
====
|<<_listing>> |소스 코드 또는 키보드 입력이 입력된 대로 표시됩니다. |---- |
=== 목록 항목에 포함된 주석
----
This is a listing.
. first item
+
////
A comment block in a list.
Notice it's attached to the preceding list item.
////
. second item
----
====
. first item
+
////
A comment block in a list.
|literal |출력 텍스트는 입력한 대로 정확하게 표시됩니다. |.... |
....
This is a literal.
....
Notice it's attached to the preceding list item.
////
. second item
====
|<<_open>> |통과 또는 테이블 블록을 제외한 모든 블록으로 작동할 수 있는 익명 블록 |\-- |
\--
This is an open.
\--
|<<_sidebar>> |문서의 흐름 외부에 표시되는 텍스트와 콘텐츠 |pass:[****] |
pass:[****]
This is a sidebar.
pass:[****]
|xref:Tables_sample.adoc#tables_sample[Table] |표 형식 콘텐츠를 표시합니다. |\|===
,===
:===
!=== |
|<<_pass>> |출력으로 직접 전송되는 처리되지 않은 콘텐츠 |pass:[++++] |
pass:[++++]
This is a pass.
pass:[++++]
|quote |선택적 저작자 표시가 있는 견적 |pass:[____] |
pass:[____]
This is a quote.
pass:[____]
=== 테이블 내 주석
----
|===
a|
cell text
////
A comment block in a table.
Notice the cell has the "a" (AsciiDoc) style.
////
|===
----
====
|===
a|
cell text
////
A comment block in a table.
Notice the cell has the "a" (AsciiDoc) style.
////
|===
====
== Example
* 예제 블록
+
.Optional title
[example]
This is an example of an example block.
* 예제 블록은 개념을 설명하거나 작업 결과를 표시하는 콘텐츠를 시각적으로 묘사하는 데 유용합니다.
* 예제에는 모든 유형의 콘텐츠와 AsciiDoc 구문이 포함될 수 있습니다.
=== 예제 블록 (pass:[====])
----
.예제 제목
====
The book hit the floor with a *thud*.
He could hear doves *cooing* in the pine trees`' branches.
====
----
* 결과
+
.예제 제목
====
......@@ -82,7 +205,15 @@ The book hit the floor with a *thud*.
He could hear doves *cooing* in the pine trees`' branches.
====
* 축소
=== 축소 ([%collapsible])
----
[%collapsible]
====
This content is only revealed when the user clicks the block title.
====
----
* 결과
+
[%collapsible]
====
......@@ -90,7 +221,33 @@ This content is only revealed when the user clicks the block title.
====
== Listing
=== 기본 코드 블록
* 서식이 지정된 블록과 단락은 소스에 표시된 대로 렌더링된 내용을 정확하게 표시합니다.
* 목록 콘텐츠는 미리 서식이 지정된 텍스트로 변환됩니다.
* 콘텐츠는 고정 너비 글꼴로 표시되며 개행은 유지됩니다.
* 문서가 변환될 때 특수 문자와 설명선만 바뀝니다.
=== 기본 블록 (pass:[----])
....
----
This is a _delimited listing block_.
The content inside is displayed as <pre> text.
----
....
* 결과
+
----
This is a _delimited listing block_.
The content inside is displayed as <pre> text.
----
** HTML 요소는 이스케이프됩니다, 즉 해석되지 않고 그대로 표시됩니다.
** 밑줄 서식(_) 표시가 있음에도 불구하고 기울임꼴로 표시되지 않습니다.
=== 소스 코드 블록 ([source])
....
[source]
----
#include <stdio.h>
int main() {
......@@ -99,8 +256,10 @@ int main() {
}
----
=== 소스 코드 블록
[source]
[source,console]
$ asciidoctor -v
[source,c]
----
#include <stdio.h>
int main() {
......@@ -108,10 +267,22 @@ int main() {
return 0;
}
----
....
* 결과
+
[source]
----
#include <stdio.h>
int main() {
printf("Hello, World!");
return 0;
}
----
+
[source,console]
$ asciidoctor -v
+
[source,c]
----
#include <stdio.h>
......@@ -121,7 +292,24 @@ int main() {
}
----
* 축소
=== 축소 ([%collapsible])
....
.Show stacktrace
[%collapsible]
====
[source]
----
Error: Content repository not found (url: https://git.example.org/repo.git)
at transformGitCloneError
at git.clone.then.then.catch
Caused by: HttpError: HTTP Error: 401 HTTP Basic: Access Denied
at GitCredentialManagerStore.rejected
at fill.then
----
====
....
* 결과
+
.Show stacktrace
[%collapsible]
......@@ -137,8 +325,23 @@ Caused by: HttpError: HTTP Error: 401 HTTP Basic: Access Denied
----
====
* 설명선
** 기본
=== 설명선
==== 기본 (<n>)
....
[source,ruby]
----
require 'sinatra' \<1>
get '/hi' do \<2> \<3>
"Hello World!"
end
----
<1> Library import
<2> URL mapping
<3> Response block
....
* 결과
+
[source,ruby]
----
......@@ -152,7 +355,22 @@ end
<2> URL mapping
<3> Response block
** 주석 뒤
==== 주석 뒤
....
[source]
----
line of code // \<1>
line of code # \<2>
line of code ;; \<3>
line of code \<!--4-->
----
<1> A callout behind a line comment for C-style languages.
<2> A callout behind a line comment for Ruby, Python, Perl, etc.
<3> A callout behind a line comment for Clojure.
<4> A callout behind a line comment for XML or SGML languages like HTML.
....
* 결과
+
[source]
----
......@@ -166,7 +384,20 @@ line of code <!--4-->
<3> A callout behind a line comment for Clojure.
<4> A callout behind a line comment for XML or SGML languages like HTML.
** 사용자 지정
==== 사용자 지정 ([line-comment=])
....
[source,erlang,line-comment=%]
----
-module(hello_world).
-compile(export_all).
hello() ->
io:format("hello world~n"). % \<1>
----
<1> A callout behind a custom line comment prefix.
....
* 결과
+
[source,erlang,line-comment=%]
----
......@@ -178,7 +409,18 @@ hello() ->
----
<1> A callout behind a custom line comment prefix.
** 줄 주석
==== 줄 주석
....
[source,asciidoc,line-comment=]
----
-- \<1>
A paragraph in an open block.
--
----
<1> An open block delimiter.
....
* 결과
+
[source,asciidoc,line-comment=]
----
......@@ -188,8 +430,24 @@ A paragraph in an open block.
----
<1> An open block delimiter.
* 추가 속성
** 라인 번호 추가
=== 추가 속성
==== 라인 번호 추가 ([linenums])
....
[source,ruby,linenums]
----
ORDERED_LIST_KEYWORDS = {
'loweralpha' => 'a',
'lowerroman' => 'i',
'upperalpha' => 'A',
'upperroman' => 'I'
#'lowergreek' => 'a'
#'arabic' => '1'
#'decimal' => '1'
}
----
....
* 결과
+
[source,ruby,linenums]
----
......@@ -204,7 +462,27 @@ ORDERED_LIST_KEYWORDS = {
}
----
** 특정 라인 강조
==== 특정 라인 강조 ([highlight=""])
....
[source,shell,highlight="3,4"]
----
#!/bin/sh
fail () {
echo
echo "$*"
echo
exit 1
} >&2
JAVACMD=java
which java >/dev/null 2>&1 || fail "ERROR: no 'java' command could be found in your PATH."
exec "$JAVACMD" "$@"
----
....
* 결과
+
[source,shell,highlight="3,4"]
----
......@@ -223,8 +501,62 @@ which java >/dev/null 2>&1 || fail "ERROR: no 'java' command could be found in y
exec "$JAVACMD" "$@"
----
== Literal
* 리터럴 블록(....)은 소스에서 보는 그대로 작성한 텍스트를 표시합니다.
* 리터럴 텍스트는 서식이 미리 지정된 텍스트로 처리됩니다.
* 텍스트는 고정 너비 글꼴로 표시되며 개행은 유지됩니다.
* 문서가 변환될 때 특수 문자와 설명선만 바뀝니다.
----
....
Kismet: Where is the *defensive operations manual*?
Computer: Calculating ...
Can not locate object.
You are not authorized to know it exists.
Kismet: Did the werewolves tell you to say that?
Computer: Calculating ...
....
----
* 결과
+
....
Kismet: Where is the *defensive operations manual*?
Computer: Calculating ...
Can not locate object.
You are not authorized to know it exists.
Kismet: Did the werewolves tell you to say that?
Computer: Calculating ...
....
** 출력에서 굵은 텍스트(*) 서식이 텍스트에 적용되지 않았습니다.
** 세 개의 연속된 마침표가 줄임표 유니코드 문자로 대체되지 않습니다.
== Open
* The header in AsciiDoc must start with a document title.
* 열린 블록(--)은 콘텐츠를 묶기 위한 일반적인 구조적 컨테이너를 제공합니다.
* 열린 블록이 다른 열린 블록 안에 중첩될 수 없다.
....
** The header in AsciiDoc must start with a document title.
+
--
Here's an example of a document title:
====
= Document Title
====
NOTE: The header is optional.
--
....
* 결과
** The header in AsciiDoc must start with a document title.
+
--
Here's an example of a document title:
......@@ -237,8 +569,36 @@ NOTE: The header is optional.
--
== Sidebar
사이드바에는 인용문, 방정식 및 이미지와 같은 모든 유형의 콘텐츠가 포함될 수 있습니다.
* 사이드바(pass:[****])에는 인용문, 방정식 및 이미지와 같은 모든 유형의 콘텐츠가 포함될 수 있습니다.
....
.Optional Title
****
Sidebars are used to visually separate auxiliary bits of content that supplement the main text.
TIP: They can contain any type of content.
.Source code block in a sidebar
[source,js]
----
const { expect, expectCalledWith, heredoc } = require('../test/test-utils')
----
////
+ 개별 제목은 섹션 제목과 유사한 방식으로 선언되고 스타일 지정됨
- 섹션 계층 구조의 일부가 아닙니다.
- 다른 블록에 중첩 될 수 있습니다.
- 자식 블록을 가질 수 없습니다.
- 목차에 포함되어 있지 않습니다.
////
[discrete]
== Discrete Heading
Discrete headings are useful for making headings inside of other blocks, like this sidebar.
Discrete headings can be used where sections are not permitted.
****
....
* 결과
+
.Optional Title
****
Sidebars are used to visually separate auxiliary bits of content that supplement the main text.
......@@ -265,14 +625,34 @@ Discrete headings can be used where sections are not permitted.
****
== Pass
--
* 패스 블록(pass:[++++])은 AsciiDoc이 아닌 콘텐츠를 출력에 직접 전달하는 것입니다.
* 예를 들어, 패스 블록을 사용하여 원시 HTML을 HTML 출력으로 전달할 수 있습니다.
=== 패스 블록 (pass:[++++])
....
++++
image:tiger.png[]
link:Tables_sample.adoc#tables_sample[Table]
++++
....
* 결과
+
++++
image:tiger.png[]
link:Tables_sample.adoc#tables_sample[Table]
++++
{blank}
** AsciiDoc에는 이미지와 링크 매크로가 있으나 변환되지 않습니다.
** 패스 블록의 내용은 단락에 줄 바꿈되지 않습니다.
=== 인라인 (pass:[pass:[ ]])
....
Content passed directly to the output followed by normal content.
"/resources/pass:[**]"
....
* 인라인 (pass:[+++])
* 결과
+
Content passed directly to the output followed by normal content.
"/resources/+++**+++"
--
\ No newline at end of file
"/resources/pass:[**]"
sample/Default.adoc 0 → 100644
View file @ 34cbb880
= Document Title: Subtitle
Gildong Hong <email1@bwg.com>; Kyun Heo <email2@bwg.com>
:description: The document's description. This document is about the section sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
include::./attributes/highlighter.adoc[]
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about ...
--
.About {author}
This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
.About {author_2}
Mr. {lastname_2} is the author.
sample/Image_sample.adoc
View file @ 34cbb880
......@@ -14,3 +14,65 @@ This document is about the image.
.About {author}
This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
== 블록 이미지
* 문서에서 개별 요소, 즉 한 줄에 표시됩니다.
* 매크로 이름으로 지정되며 그 뒤에 두 개의 콜론(::)이 옵니다.
* 대괄호([]) 안에는 대체 텍스트를 입력합니다.
* 앞에는 빈 줄이 오고, 한 줄에 단독으로 입력, 그 뒤에 빈 줄이 옵니다.
----
Content in document.
.이미지 제목
image::logo.png["Logo"]
Content in document
----
* 결과
+
====
Content in document.
.이미지 제목
image::logo.png["Logo"]
Content in document
====
=== 추가 속성
* 제목 설정: .A logo
* ID 설정: #img-logo
* 링크 설정: link=https://bankwareglobal.com
* 빈 창 대상 지정: window=_blank
* 검색 인덱서가 링크를 따르지 않도록 설정: opts=nofollow
* 크기 설정: 200,100 -> 너비=200, 높이=100
----
.A logo
[#img-logo,link=https://bankwareglobal.com,window=_blank,opts=nofollow]
image::logo.png["Logo",200,100]
----
* 결과
+
====
.A logo
[#img-logo,link=https://bankwareglobal.com,window=_blank,opts=nofollow]
image::logo.png["Logo",200,100]
====
== 인라인 이미지
* 단락 또는 사이드바 블록과 같은 다른 요소의 흐름에 표시됩니다.
* 매크로 이름 뒤에 콜론(:)이 하나 붙습니다.
----
Click image:play.png["Play"] to get the party started.
Click image:pause.png["Pause"] when you need a break.
----
* 결과
+
====
Click image:play.png["Play"] to get the party started.
Click image:pause.png["Pause"] when you need a break.
====
sample/Links_sample.adoc
View file @ 34cbb880
......@@ -21,6 +21,17 @@ You can contact {firstname} at {email}.
* ftp
* irc
* mailto
----
The homepage for the Asciidoctor Project is https://www.asciidoctor.org.
Email us at hello@example.com to say hello.
// 자동 링크 피하기
Once launched, the site will be available at \https://example.org.
If you cannot access the site, email \help@example.org for assistance.
----
* 결과
+
====
The homepage for the Asciidoctor Project is https://www.asciidoctor.org.
Email us at hello@example.com to say hello.
......@@ -29,20 +40,51 @@ Email us at hello@example.com to say hello.
Once launched, the site will be available at \https://example.org.
If you cannot access the site, email \help@example.org for assistance.
====
=== 링크 속성
* 빈 창을 대상으로 지정하도록 링크 텍스트 끝에 캐럿(^) 삽입 및 role 적용
** Chat with other AsciiDoc users in the https://chat.asciidoc.org[*project chat*^,role=green].
** pass:[Chat with other AsciiDoc users in the https://chat.asciidoc.org[*project chat*^,role=green].]
*** 결과
+
====
Chat with other AsciiDoc users in the https://chat.asciidoc.org[*project chat*^,role=green].
====
* 링크 텍스트에 쉼표나 등호가 포함된 경우 큰따옴표로 묶어준다.
** https://example.org["Google, DuckDuckGo, Ecosia"^,role=teal]
** https://example.org["1=2 posits the problem of inequality"^]
* 링크 텍스트에 쉼표나 등호가 포함된 경우 큰따옴표로 묶어준다.
** pass:[https://example.org["Google, DuckDuckGo, Ecosia"^,role=teal]]
*** 결과
+
====
https://example.org["Google, DuckDuckGo, Ecosia"^,role=teal]
====
** pass:[https://example.org["1=2 posits the problem of inequality"^]]
*** 결과
+
====
https://example.org["1=2 posits the problem of inequality"^]
====
* URL에 밑줄(_) 또는 캐럿(^)과 같은 문자가 포함된 경우 ++ 로 감싼다.
** link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]
** pass:[link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]]
*** 결과
+
====
link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]
====
* 링크를 클릭하면 이메일 클라이언트가 제목 줄에 "Subscribe me"를 입력한다.
** mailto:join@discuss.example.org[Subscribe,Subscribe me]
** mailto:join@discuss.example.org[,Subscribe me]
** pass:[mailto:join@discuss.example.org[Subscribe,Subscribe me]]
*** 결과
+
====
mailto:join@discuss.example.org[Subscribe,Subscribe me]
====
** pass:[mailto:join@discuss.example.org[,Subscribe me]]
*** 결과
+
====
mailto:join@discuss.example.org[,Subscribe me]
====
== 상호 참조
=== 자동 앵커
......@@ -61,12 +103,28 @@ AsciiDoc 프로세서는 모든 섹션 및 개별 제목에 대한 앵커를 자
== Wiley & Sons, Inc.
=> _wiley_sons_inc
====
* 자동 섹션 ID 생성 비활성화
+
----
:!sectids:
== ID generation off
:sectids:
== ID generation on again
----
=== 수동 앵커
* 첫 번째 문자는 문자, 콜론 또는 밑줄
* 선택적 다음 문자는 문자, 콜론, 밑줄, 하이픈, 마침표 또는 숫자
* ID에 공백 문자를 사용 불가
* 가능하면 소문자를 사용
----
[#manual_id]
Manually set id
----
** 결과
+
====
[#manual_id]
Manually set id
......@@ -74,19 +132,51 @@ Manually set id
=== 내부 상호 참조
* 대상 섹션의 ID를 사용한 상호 참조
+
----
The section <<_자동_앵커,Auto>> describes how automatic anchors work.
The section <<manual_id,Manual>> describes how manual anchors work.
----
** 결과
+
====
The section <<_자동_앵커,Auto>> describes how automatic anchors work.
The section <<manual_id,Manual>> describes how manual anchors work.
====
=== 문서간 상호 참조
문서 간 상호 참조에 대한 링크 텍스트는 (현재) 필수
----
Refer to xref:Section_sample.adoc#section_A[Section A] for more information.
----
* Refer to xref:Section_sample.adoc#section_A[Section A] for more information.
* 결과
+
====
Refer to xref:Section_sample.adoc#section_A[Section A] for more information.
====
=== 각주
* 문장 부호 바로 뒤에 각주 매크로를 삽입합니다. 각주 매크로는 단일 콜론(:)만 사용
* 대괄호([]) 안에 각주의 내용 입력. 멀티라인 가능
* 문장 부호 바로 뒤에 각주 매크로(pass:[footnote:[text]])를 삽입합니다.
** 각주 매크로는 단일 콜론(:)만 사용
** 대괄호([]) 안에 각주의 내용 입력. 멀티라인 가능
* 각주를 재사용하려는 경우 대상 위치에 고유 ID 지정
** pass:[footnote:id[text]]
* 기존 각주를 참조하려면 대상 슬롯에 각주의 ID만 지정하고 빈대괄호 사용
** pass:[footnote:id[]]
----
The hail-and-rainbow protocol can be initiated at five levels:
. doublefootnote:[The double hail-and-rainbow level makes my toes tingle.]
. tertiary
. supernumerary
A bold statement!footnote:disclaimer[Opinions are my own.]
Another outrageous statement.footnote:disclaimer[]
----
* 결과
+
====
The hail-and-rainbow protocol can be initiated at five levels:
......
sample/List_sample.adoc
View file @ 34cbb880
......@@ -17,12 +17,17 @@ This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
== 순서가 있는 목록
----
.목록의 제목
. Protons
. Electrons
. Neutrons
////
새 리스트를 시작하는 방법:
두 번째 리스트 위에 블록 속성([]) 행(빈 행도 포함)을 배치하고 빈 행으로 간격띄우기
////
[]
.새 목록
. Step 1
......@@ -30,8 +35,27 @@ You can contact {firstname} at {email}.
.. Step 2a
.. Step 2b
. Step 3
----
* 결과
====
.목록의 제목
. Protons
. Electrons
. Neutrons
[]
.새 목록 제목
. Step 1
. Step 2
.. Step 2a
.. Step 2b
. Step 3
====
== 순서가 없는 목록
----
.제목
* Level 1 list item
** Level 2 list item
......@@ -40,22 +64,45 @@ You can contact {firstname} at {email}.
***** Level 5 list item
****** etc.
* Level 1 list item
----
* 결과
====
.제목
* Level 1 list item
** Level 2 list item
*** Level 3 list item
**** Level 4 list item
***** Level 5 list item
****** etc.
* Level 1 list item
====
== 체크리스트
=== 일반
----
* [x] checked
* [ ] not checked
* normal list item
----
* 결과
=== 대화형 확인란 (삭제)
[%interactive]
====
* [x] checked
* [ ] not checked
* normal list item
====
== 설명 목록
=== 기본
----
[horizontal]
RAM:: Temporarily stores information the CPU uses during operation.
Keyboard:: Used to enter text or control items on the screen.
----
* 결과
====
[horizontal]
RAM:: Temporarily stores information the CPU uses during operation.
......@@ -63,6 +110,16 @@ Keyboard:: Used to enter text or control items on the screen.
====
=== 혼합
----
Dairy::
* Milk
* Eggs
Bakery::
* Bread
----
* 결과
====
Dairy::
* Milk
......@@ -72,6 +129,29 @@ Bakery::
====
=== 중첩
----
Operating Systems::
Linux:::
. Fedora
* Desktop
. Ubuntu
* Desktop
* Server
BSD:::
. FreeBSD
. NetBSD
Cloud Providers::
PaaS:::
. OpenShift
. CloudBees
IaaS:::
. Amazon EC2
. Rackspace
----
* 결과
====
Operating Systems::
Linux:::
......
sample/Section_sample.adoc
View file @ 34cbb880
= Document Title: Section sample: Subtitle
Gildong Hong <email1@bwg.com>; Kyun Heo <email2@bwg.com>
= Section sample
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the section sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
......@@ -17,35 +17,89 @@ This document is about the section.
This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
.About {author_2}
Mr. {lastname_2} is the author.
== 섹션
* HTML 출력에서 섹션 제목은 제목 태그로 표시됩니다.
* 제목 태그의 번호는 섹션 수준보다 하나 더 많습니다(예: 섹션 수준 1은 h2 태그가 됨).
* 섹션 수준 범위는 0-5입니다. 이 제한은 주로 HTML이 h1에서 h6까지의 제목 태그만 제공한다는 사실(수준 5를 상한으로 만듦)로 인해 설정되었습니다.
// The default start value of a counter is 1.
:seq1: {counter:seq1}
== Section {seq1}
=== 기본
----
= Document Title (Level 0)
The sequence in this section is {seq1}.
== Level 1 Section Title
=== Level 2 Section Title
Contents
==== Level 3 Section Title
Contents
===== Level 4 Section Title
Contents
====== Level 5 Section Title
Contents
== Another Level 1 Section Title
----
* 결과
[cols="1a"]
|===
= Document Title (Level 0)
== Level 1 Section Title
=== Level 2 Section Title
==== Level 3 Section Title
===== Level 4 Section Title
====== Level 5 Section Title
Contents
== Another Level 1 Section Title
|===
=== 카운터 활용
* 카운터를 사용하는 경우 목록, 테이블 열 또는 산문에서 시퀀스를 만드는 것과 같은 가장 기본적인 사용 사례에만 사용
* 카운터를 사용하여 ID(즉, 참조) 또는 참조 텍스트를 작성해서는 안 됩니다.
* 속성 참조를 사용하여 카운터를 선언하고 표시(pass:[{counter:name}])합니다.
----
The salad calls for {counter:seq1}) apples, {counter:seq1}) oranges and {counter:seq1}) pears.
----
* 결과
====
The salad calls for {counter:seq1}) apples, {counter:seq1}) oranges and {counter:seq1}) pears.
====
==== 섹션 제목에 카운터 값을 사용
먼저 속성 참조를 사용하여 카운터 값을 정의해야 합니다.
----
:seq1: {counter:seq1}
== Section {seq1}
The sequence in this section is {seq1}.
:seq1: {counter:seq1}
== Section {seq1}
The sequence in this section is {seq1}.
----
* 결과
[cols="1a"]
|===
:seq1: {counter:seq1}
== Section {seq1}
The sequence in this section is {seq1}.
:seq1: {counter:seq1}
== Section {seq1}
The sequence in this section is {seq1}.
|===
==== 문자 시퀀스 사용
----
// To create a character sequence.
:seq_A: {counter:seq_A:A}
== Section {seq_A}
......@@ -59,15 +113,23 @@ If you want to see <<_section_1, Section 1>>
== Section {seq_A}
The sequence in this section is {seq_A}.
----
* 결과
. Linux
[cols="1a"]
|===
// To create a character sequence.
:seq_A: {counter:seq_A:A}
== Section {seq_A}
* Fedora
* Ubuntu
* Slackware
The sequence in this section is {seq_A}.
// 대상 섹션의 ID를 사용한 상호 참조
If you want to see <<_section_1, Section 1>>
. BSD
* FreeBSD
* NetBSD
:seq_A: {counter:seq_A}
== Section {seq_A}
The sequence in this section is {seq_A}.
|===
\ No newline at end of file
sample/Tables_sample.adoc
View file @ 34cbb880
......@@ -16,19 +16,381 @@ This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
== 기본
[cols="1a"]
|===
----
.테이블 제목
[cols=""]
\|===
\|헤더1열 \|헤더2열
\|1행1열
\|1행2열
\|2행1열
\|2행2열
\|===
----
|===
* 결과
+
.테이블 제목
[cols=""]
|===
|헤더1열 |헤더2열
|1행 1열
|1행 2열
|2행 1열
|2행 2열
|===
== 열
=== 열 너비
[cols="1,9a"]
|===
|[cols="1,1,1,1"]
\|===
|
* 새 줄에서 속성 목록을 만듭니다. 열 속성 [cols=""]
* 열은 쉼표로 구분하고 목록의 각 항목을 열 지정자라고 합니다.
* 열 지정자는 열과 해당 열에 할당된 너비, 맞춤 및 스타일 속성을 나타냅니다.
* 각 열 지정자가 동일한 숫자(이 경우 정수)인 경우 모든 열의 너비가 동일합니다.
|[cols="4*"]
\|===
|
* 동일한 너비, 가로 맞춤, 세로 맞춤 및 내용 스타일을 표의 여러 연속 열에 적용할 땐 **열 승수**를 사용합니다.
* 승수는 정수(n)와 별표(*)로 구성됩니다.
** 정수(n): 테이블에 추가될 연속 열의 수
** 별표(*): 승수 연산자라고 하며 정수 바로 뒤에 배치
** ex) [cols="5,1,1,1"] => [cols="5,3*"]
|[cols="25,25,25,25"]
\|===
|
* 열 너비는 1%와 100%사이의 백분율을 사용하여 할당할 수도 있습니다.
백분율 기호(%)는 생략합니다.
** ex) [cols="15%,30%,55%"] => [cols="15,30,55"]
|===
=== 열 정렬
정렬 연산자는 열 지정자에 적용되고 cols 속성에 할당됩니다.
.가로 정렬
[cols="^1,1,3a"]
|===
|<
|왼쪽 정렬
(기본)
.3+|
* 가로 정렬 연산자는 세로 정렬 연산자(있는 경우) 앞과 열 너비(있는 경우) 앞에 입력됩니다.
** [cols="2,##^##1"] : 두번째 열 가로 가운데 정렬
** [cols="##>##.^1,2"] : 첫번째 열 가로 오른쪽 정렬, 세로 가운데 정렬
* 승수(*)를 사용 시 가로 정렬 연산자가 승수 연산자 바로 뒤에 배치됩니다.
** [cols="3*##>##"] : 모든 열 가로 오른쪽 정렬
|>
|오른쪽 정렬
|^
|가운데 정렬
|===
.세로 정렬
[cols="^1,1,3a"]
|===
|.<
|위쪽 정렬
(기본)
.3+|
* 세로 정렬 연산자는 가로 정렬 연산자(있는 경우) 바로 뒤와 열 너비(있는 경우) 앞에 입력됩니다.
** [cols="2,##.^##1"] : 두번째 열 세로 가운데 정렬
** [cols=">##.^##1,2"] : 첫번째 열 가로 오른쪽 정렬, 세로 가운데 정렬
* 승수(*)를 사용 시 세로 정렬 연산자가 승수 연산자 바로 뒤에 배치됩니다.
** [cols="3*##.>##"] : 모든 열 세로 아래쪽 정렬
|.>
|아래쪽 정렬
|.^
|가운데 정렬
|===
=== 열 서식
[cols="2,^2,5"]
|===
|서식 |연산자 |설명
|AsciiDoc
|a
a|* 블록 요소(목록, 구분된 블록 및 블록 매크로) 지원
|Default(기본)
|d
d|단락에서 허용되는 모든 태그(예: 인라인 서식, 인라인 매크로) 지원
|Header
|h
h|머리글 의미와 스타일을 텍스트와 셀 테두리에 적용
|Literal
|l
l|리터럴 블록 안에 있는 것처럼 처리
|Monospace
|m
m|텍스트 고정 폭 글꼴을 사용하여 렌더링
|기울임
|e
e|텍스트 기울임꼴로 표시
|굵게
|s
s|텍스트 굵게 표시
|===
* 서식 연산자는 항상 열의 지정자 또는 승수의 마지막 위치에 배치
** [cols=">1##e##,.^3##s##"]
** [cols="3*.>##m##"]
* 특정 셀에만 서식을 지정할 때는 셀 구분자 세로 막대(|) 앞에 서식 연산자 지정
** a| : 블록 요소 지원
** e| : 텍스트 기울임꼴
== 행
[cols="1a"]
|===
----
.A table with a title
[cols="1,1"]
\|===
\|Cell in column 1, header row \|Cell in column 2, header row <1>
<2>
\|Cell in column 1, row 1 <3>
\|Cell in column 2, row 1 <4>
<5>
\|Cell in column 1, row 2
\|Cell in column 2, row 2
\|===
----
|===
<1> 여는 구분 기호(|===) 바로 뒤의 줄에서 첫 번째 행의 모든 셀을 한 줄에 입력합니다.
+
** 첫 번째 행을 머리글 행으로 처리하지 않으려는 경우 여는 구분 기호(|===) 바로 뒤에 빈 줄을 삽입합니다.
<2> 머리글 행 바로 뒤의 줄은 비워 둡니다.
<3> 새 셀을 만들려면 Shift+|. 세로 막대(|) 뒤에 해당 셀에 표시할 내용을 입력합니다.
<4> 새 줄에서 다른 셀을 입력합니다.
<5> 행은 하나 이상의 빈 줄로 구분됩니다.
* 결과
+
.A table with a title
[cols="1,1"]
|===
|Cell in column 1, header row |Cell in column 2, header row
|Cell in column 1, row 1 |Cell in column 2, row 1
|Cell in column 1, row 2
|Cell in column 2, row 2
|Cell in column 1, row 3
|Cell in column 2, row 3
|===
== 셀
* 셀 지정자 순서
|===
<factor><span(+) 또는 중복(*)연산자><가로정렬연산자><세로정렬연산자><서식연산자>\|<셀내용>
|===
=== 셀 병합
* 열 병합
열 범위 인수(`n`)와 범위 연산자(`+`)를 입력합니다. 예) 2+
* 행 병합
행 범위 인수(`.n`)와 범위 연산자(`+`)를 입력합니다. 예) .2+
[cols="1a"]
|===
----
[%header,cols="4*"]
\|===
\|Column 1,
header row
\|Column 2,
header row
\|Column 3,
header row
\|Column 4,
header row
\|Cell in column 1, row 2
2.3+\|This cell spans columns 2 and 3 and rows 2, 3, and 4 because its specifier contains a span of `2.3+`
\|Cell in column 4, row 2
|Cell in column 1, row 2 |Cell in column 2, row 2
\|Cell in column 1, row 3
\|Cell in column 4, row 3
|Cell in column 1, row 3 |Cell in column 2, row 3
\|Cell in column 1, row 4
\|Cell in column 4, row 4
\|===
----
|===
[%header%footer%autowidth]
* 결과
+
[%header,cols="4*"]
|===
|Column 1,
header row
|Column 2,
header row
|Column 3,
header row
|Column 4,
header row
|Cell in column 1, row 2
2.3+|This cell spans columns 2 and 3 and rows 2, 3, and 4 because its specifier contains a span of `2.3+`
|Cell in column 4, row 2
|Cell in column 1, row 3
|Cell in column 4, row 3
|Cell in column 1, row 4
|Cell in column 4, row 4
|===
=== 셀 정렬
셀의 내용을 가로로 가운데에 맞추려면 셀의 구분 기호(|) 앞에 연산자를 배치합니다.
[cols="1a"]
|===
----
\|===
\|column 1 \|column 2
.2+>.>\|This cell spans two rows(`.2+`), and its content is aligned to the right(`>`) and the bottom(`.>`).
2+^\|This cell spans two columns(`2+`), and its content is horizontally centered(`^`).
2*\|This content is duplicated in two adjacent columns(`2*`). It's content is aligned to the left of the cell by default.
\|===
----
|===
* 결과
+
|===
|column 1 |column 2 |column 3
.2+>.>|This cell spans two rows(`.2+`), and its content is aligned to the right (`>`) and the bottom(`.>`).
2+^|This cell spans two columns(`2+`), and its content is horizontally centered(`^`).
2*|This content is duplicated in two adjacent columns(`2*`). It's content is aligned to the left of the cell by default.
|===
=== 셀 서식
서식 연산자는 항상 셀 지정자의 마지막에 입력됩니다.
셀의 구분 기호(|)와 연산자 사이에 공백을 삽입하지 마세요.
[cols="1a"]
|===
----
\|===
\|Column 1 \|Column 2
.4+^.>s\|This cell spans 3 rows (`3+`).
The content is centered horizontally (`+^+`), vertically aligned to the bottom of the cell (`.>`), and styled as strong (`s`).
e\|This content is italicized (`e`).
m\|This content is rendered using a monospace font (`m`).
s\|This content is bold (`s`).
a\|This cell supports block elements (`a`).
* List item 1
* List item 2
[source,python]
----
import os
print "%s" %(os.uname())
----
\|===
----
|===
* 결과
+
|===
|Column 1 |Column 2
.4+^.>s|This cell spans 3 rows (`3+`).
The content is centered horizontally (`+^+`), vertically aligned to the bottom of the cell (`.>`), and styled as strong (`s`).
e|This content is italicized (`e`).
m|This content is rendered using a monospace font (`m`).
s|This content is bold (`s`).
a|This cell supports block elements (`a`).
* List item 1
* List item 2
[source,python]
----
import os
print "%s" %(os.uname())
----
|===
== 중첩
AsciiDoc 표 서식(a)로 표시된 표 셀은 일반 블록 내용 외에도 중첩 표를 지원합니다.
중첩 표의 기본 셀 구분 기호는 !===, ! 입니다.
[cols="1a"]
|===
----
[cols="1,2a"]
\|===
\| Col 1 \| Col 2
\| Cell 1.1
\| Cell 1.2
\| Cell 2.1
\| Cell 2.2
[cols="2,1"]
!===
! Col1 ! Col2
! C11
! C12
!===
\|===
----
|===
* 결과
+
[cols="1,2a"]
|===
| Col 1 | Col 2
| Cell 1.1
| Cell 1.2
| Cell 2.1
| Cell 2.2
[cols="2,1"]
!===
! Col1 ! Col2
! C11
! C12
!===
|===
|Header A |Header B
|Footer A |Footer B
|===
\ No newline at end of file
sample/Text_formatting.adoc
View file @ 34cbb880
......@@ -18,27 +18,61 @@ This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
== 굵게 (*)
----
A bold *word*, and a bold *phrase of text*.
Bold c**hara**cter**s** within a word.
----
====
A bold *word*, and a bold *phrase of text*.
Bold c**hara**cter**s** within a word.
====
== 기울임체 (_)
----
An italic _word_, and an italic _phrase of text_.
Italic c__hara__cter__s__ within a word.
----
====
An italic _word_, and an italic _phrase of text_.
Italic c__hara__cter__s__ within a word.
====
== 고정 폭 (`)
----
"`Wait!`" Indigo plucked a small vial from her desk's top drawer
and held it toward us.
The vial's label read: `E=mc^2^`; the `E` represents _energy_,
but also pure _genius!_
----
====
"`Wait!`" Indigo plucked a small vial from her desk's top drawer
and held it toward us.
The vial's label read: `E=mc^2^`; the `E` represents _energy_,
but also pure _genius!_
====
== 강조 표시 (#)
----
Mark my words, #automation is essential#.
Mark my words, auto##ma##tion is essential.
----
====
Mark my words, #automation is essential#.
Mark my words, auto##ma##tion is essential.
====
== 스타일 구문 ([.]#)
----
Do werewolves believe in [.small]#small print#?
[.big]##O##nce upon an infinite loop.
----
====
Do werewolves believe in [.small]#small print#?
[.big]##O##nce upon an infinite loop.
====
=== Text with custom role
....
This sentence contains [.userinput]*bold inline content* that's assigned a role.
=> HTML:
......@@ -48,14 +82,38 @@ This sentence contains [.userinput]*bold inline content* that's assigned a role.
----
** See the link:Blocks_sample.adoc#blocks_sample[Blocks sample] for more details about the block usage.
** See the link:Links_sample.adoc#links_sample[Links sample] for more details about the link usage.
....
====
This sentence contains [.userinput]*bold inline content* that's assigned a role.
=> HTML:
[source,html]
----
<p>This sentence contains <strong class="userinput">bold inline content</strong> that&#8217;s assigned a role.</p>
----
** See the link:Blocks_sample.adoc#blocks_sample[Blocks sample] for more details about the block usage.
** See the link:Links_sample.adoc#links_sample[Links sample] for more details about the link usage.
====
== 아래 첨자 (~), 위 첨자 (^)
----
"`Well the H~2~O formula written on their whiteboard could be part
of a shopping list, but I don't think the local bodega sells
E=mc^2^,`" Lazarus replied.
----
====
"`Well the H~2~O formula written on their whiteboard could be part
of a shopping list, but I don't think the local bodega sells
E=mc^2^,`" Lazarus replied.
====
== 밑줄
The text +++<u>underline me</u>+++ is underlined.
----
The text pass:[<u>underline me</u>] is underlined.
----
====
The text pass:[<u>underline me</u>] is underlined.
====
== 권고 레이블
* 레이블은 대문자여야 함.
......@@ -66,6 +124,12 @@ The text +++<u>underline me</u>+++ is underlined.
** 속성 목록([ ])에서 레이블을 설정
** 일반적으로 예제 블록(====)에 설정
* 종류
[cols="2*"]
|===
|소스 |결과
a|
....
. {blank}
+
NOTE: 단락
......@@ -93,21 +157,35 @@ CAUTION: caution
. {blank}
+
WARNING: warning
....
////
+ "#": ID
- 첫 번째 문자는 문자, 콜론 또는 밑줄
- 선택적 다음 문자는 문자, 콜론, 밑줄, 하이픈, 마침표 또는 숫자
- ID에 공백 문자를 사용 불가
- 가능하면 소문자를 사용
a|
. {blank}
+
NOTE: 단락
note1
note2
+ ".": Role
- HTML의 CSS 클래스 이름으로 변환됨
- 단락 정렬
left, center, right 또는 justify
. {blank}
+
[TIP]
.tips
====
* 블록
* tip1
* tip2
====
+ "%": Option
. {blank}
+
IMPORTANT: important
. {blank}
+
CAUTION: caution
. {blank}
+
WARNING: warning
|===
+ 속성 순서는 무관하나 id-role-option 순으로 배치
////
[#rules.text-center%incremental]
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment