Commit 7c457e73 authored by heywon.choi's avatar heywon.choi

add sample

parent 47807e1b
site:
title: My Demo Site
url: https://swlab.bwg.co.kr/docs/
start_page: swlab-docs::Section_sample.adoc
content:
sources:
- url: https://gitlab.bwg.co.kr/test/swlab-docs-for-park.git
start_path: sample
ui:
bundle:
url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
snapshot: true
\ No newline at end of file
name: swlab-docs
title: SWLab Docs
version: 1
start_page: Section_sample.adoc
asciidoc:
attributes:
source-language: asciidoc@
table-caption: false
nav:
- modules/ROOT/nav.adoc
* xref:Blocks_sample.adoc[]
* xref:Default.adoc[]
* xref:Image_sample.adoc[]
* xref:Links_sample.adoc[]
* xref:List_sample.adoc[]
* xref:Section_sample.adoc[]
* xref:Tables_sample.adoc[]
* xref:Text_formatting.adoc[]
= Blocks Sample
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the blocks sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
include::./attributes/common_css.adoc[]
:source-highlighter: pygments
:pygments-style: manni
:pygments-linenums-mode: inline
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about the blocks.
--
.About {author}
This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
.Structural containers in AsciiDoc
[cols="15,32,18,35"]
|===
|Type |Description |Minimum delimiter |Example
|<<_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
====
=== 블록 주석 (////)
----
////
A comment block.
Notice it's a delimited block.
////
----
====
////
A comment block.
Notice it's a delimited block.
////
====
=== 목록 항목에 포함된 주석
----
. 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.
Notice it's attached to the preceding list item.
////
. second item
====
=== 테이블 내 주석
----
|===
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
* 예제 블록은 개념을 설명하거나 작업 결과를 표시하는 콘텐츠를 시각적으로 묘사하는 데 유용합니다.
* 예제에는 모든 유형의 콘텐츠와 AsciiDoc 구문이 포함될 수 있습니다.
=== 예제 블록 (pass:[====])
----
.예제 제목
====
The book hit the floor with a *thud*.
He could hear doves *cooing* in the pine trees`' branches.
====
----
* 결과
+
.예제 제목
====
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]
====
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() {
printf("Hello, World!");
return 0;
}
----
[source,console]
$ asciidoctor -v
[source,c]
----
#include <stdio.h>
int main() {
printf("Hello, World!");
return 0;
}
----
....
* 결과
+
[source]
----
#include <stdio.h>
int main() {
printf("Hello, World!");
return 0;
}
----
+
[source,console]
$ asciidoctor -v
+
[source,c]
----
#include <stdio.h>
int main() {
printf("Hello, World!");
return 0;
}
----
=== 축소 ([%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]
====
[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
----
====
=== 설명선
==== 기본 (<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]
----
require 'sinatra' <1>
get '/hi' do <2> <3>
"Hello World!"
end
----
<1> Library import
<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]
----
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.
==== 사용자 지정 ([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=%]
----
-module(hello_world).
-compile(export_all).
hello() ->
io:format("hello world~n"). % <1>
----
<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=]
----
-- <1>
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]
----
ORDERED_LIST_KEYWORDS = {
'loweralpha' => 'a',
'lowerroman' => 'i',
'upperalpha' => 'A',
'upperroman' => 'I'
#'lowergreek' => 'a'
#'arabic' => '1'
#'decimal' => '1'
}
----
==== 특정 라인 강조 ([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"]
----
#!/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" "$@"
----
== 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.
+
--
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:
====
= Document Title
====
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.
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.
****
== 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:[**]"
....
* 결과
+
Content passed directly to the output followed by normal content.
"/resources/pass:[**]"
= 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/common_css.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.
= Image Sample
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the image sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
include::./attributes/common_css.adoc[]
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
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.
====
= Links Sample
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the links sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
include::./attributes/common_css.adoc[]
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about the links.
--
.About {author}
This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
== 자동 링크
* http
* https
* 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.
// 자동 링크 피하기
Once launched, the site will be available at \https://example.org.
If you cannot access the site, email \help@example.org for assistance.
====
=== 링크 속성
* 빈 창을 대상으로 지정하도록 링크 텍스트 끝에 캐럿(^) 삽입 및 role 적용
** 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].
====
* 링크 텍스트에 쉼표나 등호가 포함된 경우 큰따옴표로 묶어준다.
** 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에 밑줄(_) 또는 캐럿(^)과 같은 문자가 포함된 경우 ++ 로 감싼다.
** pass:[link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]]
*** 결과
+
====
link:+++https://asciidoctor.org/now_this__link_works.html+++[문제 URL^]
====
* 링크를 클릭하면 이메일 클라이언트가 제목 줄에 "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]
====
== 상호 참조
=== 자동 앵커
AsciiDoc 프로세서는 모든 섹션 및 개별 제목에 대한 앵커를 자동으로 생성.
.자동 생성 규칙
* 인라인 서식 적용(제목 대체 순서).
* 모든 문자는 소문자로 변환
* 공백, 하이픈 및 마침표는 idseparator 특성의 값으로 대체(기본값)_
* 반복되는 구분 기호 문자 압축
* 필요한 경우 ID가 문서 내에서 고유할 때까지 시퀀스 번호 추가
====
== Auto Section
=> _auto_section
== 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
====
=== 내부 상호 참조
* 대상 섹션의 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.
====
=== 각주
* 문장 부호 바로 뒤에 각주 매크로(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:
. 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[]
====
= List Sample
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the list sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
include::./attributes/common_css.adoc[]
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about the list.
--
.About {author}
This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
== 순서가 있는 목록
----
.목록의 제목
. Protons
. Electrons
. Neutrons
////
새 리스트를 시작하는 방법:
두 번째 리스트 위에 블록 속성([]) 행(빈 행도 포함)을 배치하고 빈 행으로 간격띄우기
////
[]
.새 목록
. Step 1
. Step 2
.. 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
*** Level 3 list item
**** Level 4 list item
***** 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
----
* 결과
====
* [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.
Keyboard:: Used to enter text or control items on the screen.
====
=== 혼합
----
Dairy::
* Milk
* Eggs
Bakery::
* Bread
----
* 결과
====
Dairy::
* Milk
* Eggs
Bakery::
* Bread
====
=== 중첩
----
Operating Systems::
Linux:::
. Fedora
* Desktop
. Ubuntu
* Desktop
* Server
BSD:::
. FreeBSD
. NetBSD
Cloud Providers::
PaaS:::
. OpenShift
. CloudBees
IaaS:::
. Amazon EC2
. Rackspace
----
* 결과
====
Operating Systems::
Linux:::
. Fedora
* Desktop
. Ubuntu
* Desktop
* Server
BSD:::
. FreeBSD
. NetBSD
Cloud Providers::
PaaS:::
. OpenShift
. CloudBees
IaaS:::
. Amazon EC2
. Rackspace
====
= 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[]
include::./attributes/common_css.adoc[]
include::./attributes/highlighter.adoc[]
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about the section.
--
.About {author}
This is a basic AsciiDoc document by {author}.
You can contact {firstname} at {email}.
== 섹션
* HTML 출력에서 섹션 제목은 제목 태그로 표시됩니다.
* 제목 태그의 번호는 섹션 수준보다 하나 더 많습니다(예: 섹션 수준 1은 h2 태그가 됨).
* 섹션 수준 범위는 0-5입니다. 이 제한은 주로 HTML이 h1에서 h6까지의 제목 태그만 제공한다는 사실(수준 5를 상한으로 만듦)로 인해 설정되었습니다.
=== 기본
----
= Document Title (Level 0)
== Level 1 Section Title
=== Level 2 Section Title
==== Level 3 Section Title
===== Level 4 Section Title
====== Level 5 Section Title
== 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
== Another Level 1 Section Title
|===
=== 카운터 활용
* 카운터를 사용하는 경우 목록, 테이블 열 또는 산문에서 시퀀스를 만드는 것과 같은 가장 기본적인 사용 사례에만 사용
* 속성 참조를 사용하여 카운터를 선언하고 표시(pass:[{counter:name}])합니다.
CAUTION: 카운터를 사용하여 ID(즉, 참조) 또는 참조 텍스트를 작성해서는 안 됩니다.
----
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}
The sequence in this section is {seq_A}.
// 대상 섹션의 ID를 사용한 상호 참조
If you want to see <<_section_1, Section 1>>
:seq_A: {counter:seq_A}
== Section {seq_A}
The sequence in this section is {seq_A}.
----
* 결과
[cols="1a"]
|===
// To create a character sequence.
:seq_A: {counter:seq_A:A}
== Section {seq_A}
The sequence in this section is {seq_A}.
// 대상 섹션의 ID를 사용한 상호 참조
If you want to see <<_section_1, Section 1>>
:seq_A: {counter:seq_A}
== Section {seq_A}
The sequence in this section is {seq_A}.
|===
\ No newline at end of file
= Table Sample
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the table sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
include::./attributes/common_css.adoc[]
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about the table.
--
.About {author}
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 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 3
\|Cell in column 4, row 3
\|Cell in column 1, row 4
\|Cell in column 4, row 4
\|===
----
|===
* 결과
+
[%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
!===
|===
= Text Formatting
Gildong Hong <email1@bwg.com>
:description: The document's description. This document is about the table sample.
include::./attributes/common_attrs.adoc[]
include::./attributes/dir_attrs.adoc[]
include::./attributes/common_css.adoc[]
[abstract]
.문서개요
--
This document has a header that specifies the {doctitle}.
This document is about the text formatting.
--
.About {author}
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:
[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.
....
====
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 pass:[<u>underline me</u>] is underlined.
----
====
The text pass:[<u>underline me</u>] is underlined.
====
== 권고 레이블
* 레이블은 대문자여야 함.
* 단락일 경우
** 레이블 바로 뒤에 콜론(:)이 온다.
** 단락의 첫 번째 줄을 레이블에서 한 칸으로 구분
* 블록일 경우
** 속성 목록([ ])에서 레이블을 설정
** 일반적으로 예제 블록(====)에 설정
* 종류
[cols="2*"]
|===
|소스 |결과
a|
....
. {blank}
+
NOTE: 단락
note1
note2
. {blank}
+
[TIP]
.tips
====
* 블록
* tip1
* tip2
====
. {blank}
+
IMPORTANT: important
. {blank}
+
CAUTION: caution
. {blank}
+
WARNING: warning
....
a|
. {blank}
+
NOTE: 단락
note1
note2
. {blank}
+
[TIP]
.tips
====
* 블록
* tip1
* tip2
====
. {blank}
+
IMPORTANT: important
. {blank}
+
CAUTION: caution
. {blank}
+
WARNING: warning
|===
// Toggle section numbers on
:sectnums: all
// You can increase or reduce the section level limit
:sectnumlevels: 5
// Line breaks preserved throughout the document
:hardbreaks-option:
// Hide the scheme (e.g., https://)
:hide-uri-scheme:
// Enable font-based icons
:icons: font
////
+ Enable the autogenerated a table of contents(TOC)
- auto (default), left, right, preamble, macro
+ The table of contents is inserted directly below the document title, author, and revision lines when the toc attribute is set and its value is left empty or set to auto.
////
// :toc: left
:toclevels: 5
\ No newline at end of file
:stylesheet:
\ No newline at end of file
:imagesdir: ./images
:iconsdir: ./icons
:stylesdir: ./styles
:scriptsdir: ./scripts
\ No newline at end of file
:source-highlighter: pygments
:pygments-style: manni
:pygments-linenums-mode: inline
\ No newline at end of file
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