비공식 Discourse 사용자 참조 가이드

Discourse라는 포럼/커뮤니티 소프트웨어를 사용하기 위한 “빠른” 사용 가이드입니다. 사용자/콘텐츠 편집기가 사용 할 수 있는 대부분의 공통 기능을 포함하고 있지만, 모든 기능 세트들 전체에 대해 다루지는 않습니다. 누구든 추가 또는 수정할 사항이 있다면 언제든 댓글을 달아 주시기 바랍니다. Discourse 편집기의 문법에 대해 보다 자세히 배우고 싶다면 CommonMark(Markdown의 한 flavor) 문서를 한번 보시기 바랍니다.

목차

대부분의 경우 편집기 툴바 버튼image 또는 단축키 crtl+k를 사용하려 하시겠지만, 기본 형식은 [link text]( https://www.digikey.kr)으로 이를 사용하면 다음과 같은 링크를 예제로 보여줄 것입니다:
link text

참고 - 링크를 사용한 보다 쉬운 편집
편집기에 긴 URL이 섞여 있으면 읽기가 어려워지므로 아래 예제의 구문을 사용하여 링크를 따로 둘 수도 있습니다. 참조 위에 빈 줄이 반드시 있어야 하며 참조 ID는 아무 숫자, 문자 또는 구두점이 될 수 있습니다.

입력:

문단의 글자 아래 또는 페이지 하단에 [링크][Digi-Key 링크]를 포함시킬 수 있기 때문에
이 문단은 [편집기][1]에서 읽기가 훨씬 용이합니다.

[1]: https://github.com/digikey/digikey-kicad-library
[Digi-Key 링크]: https://www.digikey.kr

결과:
문단의 글자 아래 또는 페이지 하단에 링크를 포함시킬 수 있기 때문에 이 문단은 편집기에서 읽기가 훨씬 용이합니다.

이미지

이미지를 추가하는 것은 꽤 쉽습니다. 클립보드에 이미지가 있는 경우 그냥 붙여 넣으면, 포럼이 이미지를 자동으로 업로드하고 이미지가 보여지도록 적절한 문법으로 채울 것입니다. 웹에 이미 있는 이미지를 링크하려 한다면 다음 문법을 사용하십시오:
![image](https://url/a.png)
– 여기서는 Digi-Key의 logo 이미지(https://www.digikey.kr/-/media/Images/Header/logo_dk.png?la=ko-KR&ts=1a773fa3-b656-418a-8e50-67fff895081a)를 예제로 사용.
결과:
Digi-Key logo

이미지 크기 조절

큰 이미지를 작은 이미지로 조정하려면 다음 문법을 사용하십시오.
입력:

원본: ![원본|233x125](upload://1mRIY7WnRnx1FNrlCu48TbAdk41.png)
백분율(50%): ![백분율(50%)|233x125, 50%](upload://1mRIY7WnRnx1FNrlCu48TbAdk41.png)
화소 크기 78X42: ![화소 크기 78X42|78x42](upload://1mRIY7WnRnx1FNrlCu48TbAdk41.png)

결과:
원본: 원본
백분율(50%): 백분율(50%)
화소 크기 78X42: 화소 크기 78X42

텍스트 서식

굵게, 기울임꼴 그리고 취소선의 경우 툴바 버튼image을 사용하거나 Markdown을 직접 입력합니다:
입력:

**굵은 단어** 또는 __굵은 단어__
*기울임꼴 단어* or _기울임꼴 단어_
_**굵게** 와 **기울임꼴**의 조합_
~~취소선 단어~~

결과:
굵은 단어 또는 굵은 단어
기울임꼴 단어 or 기울임꼴 단어
굵게기울임꼴의 조합
취소선 단어

혹은 BBCode 문법을 사용할 수도 있습니다.
[b]이렇게[/b] 이렇게
[i]또는 이렇게[/i] 또는 이렇게
[u]밑줄[/u] 밑줄

글꼴 색은 기본적으로 지원되지 않지만 글꼴 색을 변경할 수 있는 BBCode 플러그인이 있습니다.
또한 이 가이드의 MathJax 섹션에서 다루게 될 LaTex 기반의 MathJax 플러그인을 사용해서 글꼴이나 색을 변경할 수도 있습니다:
$\color{red}{붉은 텍스트}$ \color{red}{붉은 텍스트}

머리말

입력:

# H1
## H2
### H3
#### H4
##### H5
###### H6
수평선은 3개의 별표(*)입니다.
***

결과:

H1

H2

H3

H4

H5
H6

수평선


목록

툴바 버튼인 번호 매기기image 또는 글머리 기호image를 사용할 수 있습니다.

입력:

1. 1번 목록
2. 2번 목록
   * 하위 목록은 스페이스 3개로 들여 쓸 수 있습니다.
1. 특정 숫자라도
1. 상관없이 자동으로 증가됩니다.
1. 자동 증가

* 글머리 기호 목록
* 또한 가능합니다

결과:

  1. 1번 목록
  2. 2번 목록
    • 하위 목록은 스페이스 3개로 들여 쓸 수 있습니다.
  3. 특정 숫자라도
  4. 상관없이 자동으로 증가됩니다.
  5. 자동 증가
  • 글머리 기호 목록
  • 또한 가능합니다

코드 서식

한 줄 코드 서식

코드 부분을 역따옴표(`) 한 줄 코드 서식으로 둘러쌉니다.
입력:
`var x = 10;`
결과:
var x = 10;
이 작업은 var x = 10; 처럼 한 줄에서 같이 표현할 수도 있습니다.

스페이스 4개를 앞에 붙임으로써 전체 라인을 코드로 표시합니다.(이전에 새 라인 하나 추가 필요)
입력:

     var this = “is a line”;
결과:

var this = "is a line";

여러 줄의 코드 블록

코드를 세 개의 역따옴표 ```로 둘러싸면 코드를 여러 줄로 확장할 수 있습니다.
입력:
```
function foo(bar){
     return bar+1;
}
```
결과:

function foo(bar){
    return bar+1;
}

문법 강조하기
코드 블록은 자동으로 코드 스타일을 선택하려 하겠지만, 원하는 서식으로 명확하게 호출할 수도 있습니다.
입력:
```javascript
function foo(bar){
     return bar+1;
}
```
결과:

function foo(bar){
    return bar+1;
}

표는 Discourse에서 이급 시민(second class citizen)이며, 일부 서식 기능과 세부 사항들은 동작하지만 일부는 그렇지 않습니다.

꿀팁 - Discourse에 표를 넣는 가장 쉬운 방법은 스프레드시트에서 표를 시작하는 것입니다. 그런 다음 그 표를 편집기 윈도우에 복사하여 붙여 넣으면 됩니다. Discourse가 기본적으로 포맷 변경을 처리해서 표를 훨씬 쉽게 만들 수 있습니다. 이 방법에는 엑셀과 구글 시트가 효과적입니다.

Discourse의 Markdown 표에서는 적어도 아래 첫 두 줄은 있어야 합니다:
입력:

|색깔|무게|높이|
|-|-|-|
|빨간색|12|160|
|녹색|4|100|

결과:

색깔 무게 높이
빨간색 12 160
녹색 4 100

HTML을 사용하여 표를 만들 수도 있습니다:
입력:

<table>
  <tr>
    <th>색깔</th>
    <th>무게</th>
    <th>높이</th>
  </tr>
  <tr>
    <td>빨간색</td>
    <td>12</td>
    <td>160</td>
  </tr>
  <tr>
    <td>녹색</td>
    <td>4</td>
    <td>100</td>
  </tr>
</table>

결과:

색깔 무게 높이
빨간색 12 160
녹색 4 100

인용(Blockquote)

편집기 툴바 버튼image이 인용 입니다.
보다 큼 기호인 >를 앞에 두면 해당 줄을 인용으로 만들 수 있습니다.
입력:
> 이 줄은 인용 텍스트 예제입니다.
> 이 줄은 인용 텍스트 다른 줄입니다.

이 줄은 인용이 아닙니다.
> 이 줄은 또 다른 예제입니다.
결과:

이 줄은 인용 텍스트 예제입니다.
이 줄은 인용 텍스트 다른 줄입니다.

이 줄은 인용이 아닙니다.

이 줄은 또 다른 예제입니다.

목차

목차는 Discourse의 기본 기능은 아니지만, ## heading 문법 대신 적절한 ID를 가지는 HTML heading을 사용해서 목차를 수동으로 만들 수 있습니다. ID 앞에 heading--이 꼭 있어야 하며, Discourse의 자바스크립트 앱 기반 아키텍쳐 때문에 이 작업이 필요합니다. 아래는 간단한 예제 입니다:
입력:

- [첫 번째 제목으로 링크](#heading--first-header)
- [두 번째 제목으로 링크](#heading--second-header)
- [세 번째 제목으로 링크](#heading--third-header)
- [네 번째 제목으로 링크](#heading--fourth-header)
<h3 id="heading--first-header">첫 번째</h3>
some text
<h3 id="heading--second-header">두 번째</h3>
내용
<h3 id="heading--third-header">세 번째</h3>
내용
<h3 id="heading--fourth-header">네 번째</h3>
내용

결과:

첫 번째

내용

두 번째

내용

세 번째

내용

네 번째

내용

수학 서식에 LaTex를 사용하기

LaTex는 Discourse의 공식 플러그인으로 Mathjax을 사용하여 LaTex 기반 서식이 가능하도록 합니다. LaTex 문법은 이 자체로 하나의 주제가 될 수 있어, 여기서는 몇 가지 예제만 짚고 넘어가겠습니다. 자세한 내용은 Stack Exchange의 빠른 참조 가이드를 살펴보시길 바랍니다. 기본적인 용법은 $ \ 한 줄 LaTex 표현 $ 또는 $$로 LaTeX를 둘러싸서 여러 줄을 표현하는 것입니다.
입력:

$$
H(z)&=\sum_{k=0}^{\infty}{(k+1)z^{-k}}\\
&=\frac{z^2}{(z-1)^{2}}
\end{align}
$$

결과:

\begin{align} H(z)&=\sum_{k=0}^{\infty}{(k+1)z^{-k}}\\ &=\frac{z^2}{(z-1)^{2}} \end{align}

\color{red}{글꼴\ 색} 과 여러 심볼들(\alpha \omega \gamma \beta \Omega \Gamma), 사용 가능한 폰트들(\mathscr{HELLO WORLD}) 그리고 표현의 다른 방법들 \Biggl(\biggl(\Bigl(\bigl((x)\bigr)\Bigr)\biggr)\Biggr) 도 있습니다.

HTML 사용하기

기타

다른 사람들이 어떻게 게시물을 만들었는지 확인하고 싶은 적이 있었다면 https://forum.example.com/raw/{topicid}/{postid}의 URL 형식을 사용하여 Markdown을 원본 그대로 볼 수 있습니다. 예를 들어 현재 게시물을 한 번 확인해 보시기 바랍니다.

항목 정렬하기

이미지를 정렬하거나 자동 줄 바꿈을 하려 할 경우, 두 가지 모두에 적합한 도구는 없습니다. 커스텀 플러그인으로는 할 수 있지만, 기본 Discourse에서는 아직 지원되지 않습니다.




영문 원본: An Unofficial Discourse User Reference Guide