11
> **[운영 문서]** 이 문서는 밤문화위키의 문법 처리와 렌더링 기준을 설명하는 운영 문서입니다.22
33
## 개요44
55
이 문서는 밤문화위키 문법을 개발·운영 관점에서 정리한 문서입니다. 일반 편집자는 [[밤문화위키:문법 도움말]]을 먼저 참고하면 됩니다.66
77
밤문화위키는 나무위키식 전용 문법을 사용하지 않습니다. 기본 문법은 마크다운이며, 여기에 `[[위키링크]]`, 각주 `[^n]`, 취소선 `~~내용~~` 정도의 확장 문법만 허용합니다.88
99
문법 처리의 목표는 다음과 같습니다.1010
1111
- 익명 IP 또는 닉네임 편집자가 쉽게 제안할 수 있을 것1212
- 운영자가 승인 전후 내용을 검수하기 쉬울 것1313
- 모든 판이 리비전 히스토리에 안정적으로 남을 것1414
- 업소·여행 정보 문서에서도 과도한 장식보다 정보의 명확성을 우선할 것1515
- 문법이 [[밤문화위키:편집지침]]과 [[밤문화위키:기본방침]]을 우회하는 수단이 되지 않을 것1616
1717
## 기본 전제1818
1919
밤문화위키의 문서 원문은 승인 전 편집 제안 단계에서 저장될 수 있으며, 승인된 판만 실제 문서에 반영됩니다. 따라서 렌더러는 “작성자가 악의적이거나 실수할 수 있다”는 전제로 동작해야 합니다.2020
2121
특히 다음 내용은 문법상 표현 가능하더라도 승인 대상이 아닙니다.2222
2323
- 성매매 알선·중개·구체적 방법·가격 흥정 표현2424
- 특정 여성이나 종사자를 식별하거나 성적으로 묘사하는 표현2525
- 개인 신상 공개, 명예훼손, 모욕성 서술2626
- 미성년, 강요, 불법촬영과 관련된 내용2727
- 방문 전 직접 확인이 필요한 업소 정보를 확정 사실처럼 단정하는 표현2828
2929
취소선도 예외가 아닙니다. `~~문제 표현~~`처럼 숨기듯 남긴 내용 역시 본문에 표시되는 서술로 보며, 방침 위반이면 반려하거나 수정해야 합니다.3030
3131
## 처리 순서3232
3333
밤문화위키의 권장 처리 순서는 다음과 같습니다.3434
3535
1. 원문 정규화3636
2. 코드 블록과 인라인 코드 보호3737
3. HTML 및 위험 속성 제거3838
4. `[[위키링크]]` 해석3939
5. 마크다운 본문 렌더링4040
6. 각주 해석4141
7. 문단 앵커 생성4242
8. 렌더링 결과 검수 및 정책 필터 적용4343
4444
코드 블록과 인라인 코드 안에서는 위키링크, 각주, 취소선 등을 해석하지 않습니다. 예를 들어 아래 문장은 코드 예시로만 보여야 합니다.4545
4646
```markdown4747
`[[나트랑 가라오케]]`4848
```4949
5050
## 원문 정규화5151
5252
렌더링 전에는 줄바꿈, 공백, 제어문자 등을 정리합니다. 다만 문서 내용 자체를 임의로 바꾸면 리비전 비교가 어려워지므로, 의미가 달라지는 자동 치환은 피합니다.5353
5454
권장 기준은 다음과 같습니다.5555
5656
- 줄바꿈은 LF 기준으로 통일5757
- 보이지 않는 제어문자는 제거5858
- 과도한 빈 줄은 운영자 검수 단계에서 정리 가능5959
- 문서 제목과 슬러그는 별도 필드로 관리6060
- 원문 마크다운은 리비전 히스토리에 그대로 보존6161
6262
## HTML 처리6363
6464
일반 문서 본문에서는 HTML 직접 입력을 허용하지 않는 것을 원칙으로 합니다. 마크다운 렌더러가 HTML을 지원하더라도, 밤문화위키에서는 보안과 운영 일관성을 위해 제거하거나 이스케이프 처리합니다.6565
6666
특히 다음 요소는 허용하지 않습니다.6767
6868
- `<script>`, `<iframe>`, `<object>` 등 실행성 태그6969
- `onclick`, `onerror` 같은 이벤트 속성7070
- 추적용 픽셀, 자동 이동, 외부 스크립트7171
- 스타일 속성을 이용한 본문 은폐 또는 오인 유도7272
7373
외부 링크가 필요한 경우 일반 마크다운 링크를 사용하되, 광고·홍보성 링크는 [[밤문화위키:문서 관리 방침]]에 따라 검수합니다.7474
7575
## 위키링크7676
7777
위키링크는 다음 형식을 기본으로 합니다.7878
7979
```markdown80-
[[문서명]]80+
`[[문서명]]`8181
[[문서명|표시할 글자]]8282
```8383
8484
운영 문서 링크는 다음처럼 이름공간을 포함합니다.8585
8686
```markdown8787
[[밤문화위키:편집지침]]8888
[[밤문화위키:기본방침/문서 관리 방침]]8989
```9090
9191
문서명에는 실제 문서 제목을 사용합니다. 업소 문서나 지역 문서의 명칭은 시간이 지나며 바뀔 수 있으므로, 별칭 처리는 렌더러보다 문서 관리 기능에서 처리하는 것이 좋습니다.9292
9393
위키링크 안에서는 다시 위키링크를 중첩하지 않습니다.9494
9595
```markdown9696
[[나트랑 [[가라오케]]]]9797
```9898
9999
위와 같은 입력은 잘못된 문법으로 보거나 일반 텍스트에 가깝게 처리합니다.100100
101101
## 마크다운 문단102102
103103
문단 제목은 마크다운 heading을 사용합니다.104104
105105
```markdown106106
## 개요107107
### 위치108108
```109109
110110
문단 제목은 목차와 앵커 생성의 기준이 됩니다. 같은 제목이 여러 번 나오면 렌더러는 충돌을 피하기 위해 뒤쪽 앵커에 번호를 붙일 수 있습니다.111111
112112
운영 문서에서는 제목을 짧고 직접적으로 작성합니다. 업소 문서에서도 “개요”, “위치”, “운영 정보”, “방문 전 확인”처럼 검수하기 쉬운 제목을 권장합니다.113113
114114
## 목록과 인용문115115
116116
목록은 표준 마크다운을 사용합니다.117117
118118
```markdown119119
- 항목120120
- 항목121121
122122
1. 첫째123123
2. 둘째124124
```125125
126126
인용문은 운영 안내나 주의문에 사용할 수 있습니다.127127
128128
```markdown129129
> 방문 전 영업 여부와 가격은 직접 확인하는 것이 좋습니다.130130
```131131
132132
다만 인용문을 이용해 검증되지 않은 후기, 신상 정보, 불법적 안내를 강조해서는 안 됩니다.133133
134134
## 각주135135
136136
각주는 다음 형식을 사용합니다.137137
138138
```markdown139139
본문 내용입니다.[^1]140140
141141
[^1]: 출처 또는 보충 설명입니다.142142
```143143
144144
각주는 출처와 보충 설명을 위해 사용합니다. 본문에서 금지되는 내용은 각주에서도 금지됩니다.145145
146146
업소 정보의 경우 각주가 있어도 최신성을 보장하지 않습니다. 영업시간, 가격, 서비스 구성, 예약 방식 등은 수시로 바뀔 수 있으므로 “방문 전 직접 확인” 원칙을 유지해야 합니다.147147
148148
## 취소선149149
150150
취소선은 다음 형식을 사용합니다.151151
152152
```markdown153153
~~더 이상 쓰지 않는 표현~~154154
```155155
156156
취소선은 가벼운 정정이나 문맥상 필요한 표현에만 제한적으로 사용합니다. 다음 용도로 사용할 수 없습니다.157157
158158
- 명예훼손성 표현을 남기는 용도159159
- 특정 개인의 신상이나 외모 묘사를 숨기는 용도160160
- 불법 서비스 안내를 “농담”처럼 남기는 용도161161
- 운영자 검수를 피하기 위한 암시 표현162162
163163
문서의 신뢰성을 위해, 운영 문서에서는 취소선 사용을 최소화합니다.164164
165165
## 코드 블록166166
167167
문법 설명이나 예시에는 코드 블록을 사용할 수 있습니다.168168
169169
````markdown170170
```markdown171171
[[다낭 마사지]]172172
```173173
````174174
175175
코드 블록 안의 내용은 렌더링하지 않습니다. 따라서 코드 블록 안에 있는 `[[위키링크]]`나 `[^1]`은 실제 링크나 각주가 되지 않아야 합니다.176176
177177
## 표178178
179179
표는 표준 마크다운 표를 사용할 수 있습니다.180180
181181
```markdown182182
| 항목 | 설명 |183183
| --- | --- |184184
| 영업시간 | 방문 전 확인 필요 |185185
| 위치 | 지도 또는 공식 채널 확인 |186186
```187187
188188
업소 문서에서 표를 사용할 때는 확정적으로 보이는 표현을 주의해야 합니다. 가격, 예약, 서비스 구성은 변경 가능성이 높으므로 최신 확인이 필요하다는 문구를 함께 두는 것이 좋습니다.189189
190190
## 지원하지 않는 문법191191
192192
밤문화위키에서는 다음 문법을 사용하지 않습니다.193193
194194
- 나무위키식 표 문법195195
- 나무위키식 굵게·색상·크기 문법196196
- 분류 매크로197197
- include 매크로198198
- 접기 매크로199199
- HTML 삽입 문법200200
- 위키 엔진 전용 매크로201201
202202
이런 문법이 입력되면 자동 변환하지 않고 일반 텍스트로 보이게 하거나, 승인 과정에서 운영자가 마크다운 문법으로 고칩니다.203203
204204
## 렌더링과 승인 검수205205
206206
문법 렌더링은 문서 표시를 위한 기술 처리일 뿐, 편집 승인 자체를 대체하지 않습니다. 승인자는 다음을 함께 확인해야 합니다.207207
208208
- 문법이 깨져 문서 의미가 달라지지 않았는지209209
- 링크가 실제 관련 문서로 연결되는지210210
- 외부 링크가 광고·피싱·불법 안내로 이어지지 않는지211211
- 업소 정보가 단정적으로 쓰이지 않았는지212212
- 안전선 위반 내용이 본문, 각주, 링크 텍스트, 취소선에 포함되지 않았는지213213
214214
문법적으로 올바른 문장이라도 [[밤문화위키:편집지침]]에 맞지 않으면 반려하거나 수정 후 승인합니다.215215
216216
## 구현 참고217217
218218
렌더러 구현 시에는 가능한 한 표준 마크다운 파서를 사용하고, 밤문화위키 고유 기능은 얇은 확장으로 유지합니다.219219
220220
권장 구조는 다음과 같습니다.221221
222222
```text223223
원문224224
→ 코드 영역 보호225225
→ 위험 HTML 제거226226
→ 위키링크 토큰화227227
→ 마크다운 렌더링228228
→ 각주 정리229229
→ 링크 검증230230
→ 최종 HTML 출력231231
```232232
233233
문법 확장은 운영 규모에 맞게 신중히 추가합니다. 기능이 많아질수록 편집자는 복잡한 문법을 외워야 하고, 운영자는 승인 검수에서 더 많은 예외를 처리해야 합니다.234234
235235
밤문화위키의 문법은 화려한 표현보다 정확한 정보 전달과 안전한 운영을 우선합니다.