밤문화위키:문법 도움말/개발 편집현재 기준판 r2문서역사편집편집자 이름(선택)편집 요약본문> **[운영 문서]** 이 문서는 밤문화위키의 문법 처리와 렌더링 기준을 설명하는 운영 문서입니다. ## 개요 이 문서는 밤문화위키 문법을 개발·운영 관점에서 정리한 문서입니다. 일반 편집자는 [[밤문화위키:문법 도움말]]을 먼저 참고하면 됩니다. 밤문화위키는 나무위키식 전용 문법을 사용하지 않습니다. 기본 문법은 마크다운이며, 여기에 `[[위키링크]]`, 각주 `[^n]`, 취소선 `~~내용~~` 정도의 확장 문법만 허용합니다. 문법 처리의 목표는 다음과 같습니다. - 익명 IP 또는 닉네임 편집자가 쉽게 제안할 수 있을 것 - 운영자가 승인 전후 내용을 검수하기 쉬울 것 - 모든 판이 리비전 히스토리에 안정적으로 남을 것 - 업소·여행 정보 문서에서도 과도한 장식보다 정보의 명확성을 우선할 것 - 문법이 [[밤문화위키:편집지침]]과 [[밤문화위키:기본방침]]을 우회하는 수단이 되지 않을 것 ## 기본 전제 밤문화위키의 문서 원문은 승인 전 편집 제안 단계에서 저장될 수 있으며, 승인된 판만 실제 문서에 반영됩니다. 따라서 렌더러는 “작성자가 악의적이거나 실수할 수 있다”는 전제로 동작해야 합니다. 특히 다음 내용은 문법상 표현 가능하더라도 승인 대상이 아닙니다. - 성매매 알선·중개·구체적 방법·가격 흥정 표현 - 특정 여성이나 종사자를 식별하거나 성적으로 묘사하는 표현 - 개인 신상 공개, 명예훼손, 모욕성 서술 - 미성년, 강요, 불법촬영과 관련된 내용 - 방문 전 직접 확인이 필요한 업소 정보를 확정 사실처럼 단정하는 표현 취소선도 예외가 아닙니다. `~~문제 표현~~`처럼 숨기듯 남긴 내용 역시 본문에 표시되는 서술로 보며, 방침 위반이면 반려하거나 수정해야 합니다. ## 처리 순서 밤문화위키의 권장 처리 순서는 다음과 같습니다. 1. 원문 정규화 2. 코드 블록과 인라인 코드 보호 3. HTML 및 위험 속성 제거 4. `[[위키링크]]` 해석 5. 마크다운 본문 렌더링 6. 각주 해석 7. 문단 앵커 생성 8. 렌더링 결과 검수 및 정책 필터 적용 코드 블록과 인라인 코드 안에서는 위키링크, 각주, 취소선 등을 해석하지 않습니다. 예를 들어 아래 문장은 코드 예시로만 보여야 합니다. ```markdown `[[나트랑 가라오케]]` ``` ## 원문 정규화 렌더링 전에는 줄바꿈, 공백, 제어문자 등을 정리합니다. 다만 문서 내용 자체를 임의로 바꾸면 리비전 비교가 어려워지므로, 의미가 달라지는 자동 치환은 피합니다. 권장 기준은 다음과 같습니다. - 줄바꿈은 LF 기준으로 통일 - 보이지 않는 제어문자는 제거 - 과도한 빈 줄은 운영자 검수 단계에서 정리 가능 - 문서 제목과 슬러그는 별도 필드로 관리 - 원문 마크다운은 리비전 히스토리에 그대로 보존 ## HTML 처리 일반 문서 본문에서는 HTML 직접 입력을 허용하지 않는 것을 원칙으로 합니다. 마크다운 렌더러가 HTML을 지원하더라도, 밤문화위키에서는 보안과 운영 일관성을 위해 제거하거나 이스케이프 처리합니다. 특히 다음 요소는 허용하지 않습니다. - `<script>`, `<iframe>`, `<object>` 등 실행성 태그 - `onclick`, `onerror` 같은 이벤트 속성 - 추적용 픽셀, 자동 이동, 외부 스크립트 - 스타일 속성을 이용한 본문 은폐 또는 오인 유도 외부 링크가 필요한 경우 일반 마크다운 링크를 사용하되, 광고·홍보성 링크는 [[밤문화위키:문서 관리 방침]]에 따라 검수합니다. ## 위키링크 위키링크는 다음 형식을 기본으로 합니다. ```markdown `[[문서명]]` [[문서명|표시할 글자]] ``` 운영 문서 링크는 다음처럼 이름공간을 포함합니다. ```markdown [[밤문화위키:편집지침]] [[밤문화위키:기본방침/문서 관리 방침]] ``` 문서명에는 실제 문서 제목을 사용합니다. 업소 문서나 지역 문서의 명칭은 시간이 지나며 바뀔 수 있으므로, 별칭 처리는 렌더러보다 문서 관리 기능에서 처리하는 것이 좋습니다. 위키링크 안에서는 다시 위키링크를 중첩하지 않습니다. ```markdown [[나트랑 [[가라오케]]]] ``` 위와 같은 입력은 잘못된 문법으로 보거나 일반 텍스트에 가깝게 처리합니다. ## 마크다운 문단 문단 제목은 마크다운 heading을 사용합니다. ```markdown ## 개요 ### 위치 ``` 문단 제목은 목차와 앵커 생성의 기준이 됩니다. 같은 제목이 여러 번 나오면 렌더러는 충돌을 피하기 위해 뒤쪽 앵커에 번호를 붙일 수 있습니다. 운영 문서에서는 제목을 짧고 직접적으로 작성합니다. 업소 문서에서도 “개요”, “위치”, “운영 정보”, “방문 전 확인”처럼 검수하기 쉬운 제목을 권장합니다. ## 목록과 인용문 목록은 표준 마크다운을 사용합니다. ```markdown - 항목 - 항목 1. 첫째 2. 둘째 ``` 인용문은 운영 안내나 주의문에 사용할 수 있습니다. ```markdown > 방문 전 영업 여부와 가격은 직접 확인하는 것이 좋습니다. ``` 다만 인용문을 이용해 검증되지 않은 후기, 신상 정보, 불법적 안내를 강조해서는 안 됩니다. ## 각주 각주는 다음 형식을 사용합니다. ```markdown 본문 내용입니다.[^1] [^1]: 출처 또는 보충 설명입니다. ``` 각주는 출처와 보충 설명을 위해 사용합니다. 본문에서 금지되는 내용은 각주에서도 금지됩니다. 업소 정보의 경우 각주가 있어도 최신성을 보장하지 않습니다. 영업시간, 가격, 서비스 구성, 예약 방식 등은 수시로 바뀔 수 있으므로 “방문 전 직접 확인” 원칙을 유지해야 합니다. ## 취소선 취소선은 다음 형식을 사용합니다. ```markdown ~~더 이상 쓰지 않는 표현~~ ``` 취소선은 가벼운 정정이나 문맥상 필요한 표현에만 제한적으로 사용합니다. 다음 용도로 사용할 수 없습니다. - 명예훼손성 표현을 남기는 용도 - 특정 개인의 신상이나 외모 묘사를 숨기는 용도 - 불법 서비스 안내를 “농담”처럼 남기는 용도 - 운영자 검수를 피하기 위한 암시 표현 문서의 신뢰성을 위해, 운영 문서에서는 취소선 사용을 최소화합니다. ## 코드 블록 문법 설명이나 예시에는 코드 블록을 사용할 수 있습니다. ````markdown ```markdown [[다낭 마사지]] ``` ```` 코드 블록 안의 내용은 렌더링하지 않습니다. 따라서 코드 블록 안에 있는 `[[위키링크]]`나 `[^1]`은 실제 링크나 각주가 되지 않아야 합니다. ## 표 표는 표준 마크다운 표를 사용할 수 있습니다. ```markdown | 항목 | 설명 | | --- | --- | | 영업시간 | 방문 전 확인 필요 | | 위치 | 지도 또는 공식 채널 확인 | ``` 업소 문서에서 표를 사용할 때는 확정적으로 보이는 표현을 주의해야 합니다. 가격, 예약, 서비스 구성은 변경 가능성이 높으므로 최신 확인이 필요하다는 문구를 함께 두는 것이 좋습니다. ## 지원하지 않는 문법 밤문화위키에서는 다음 문법을 사용하지 않습니다. - 나무위키식 표 문법 - 나무위키식 굵게·색상·크기 문법 - 분류 매크로 - include 매크로 - 접기 매크로 - HTML 삽입 문법 - 위키 엔진 전용 매크로 이런 문법이 입력되면 자동 변환하지 않고 일반 텍스트로 보이게 하거나, 승인 과정에서 운영자가 마크다운 문법으로 고칩니다. ## 렌더링과 승인 검수 문법 렌더링은 문서 표시를 위한 기술 처리일 뿐, 편집 승인 자체를 대체하지 않습니다. 승인자는 다음을 함께 확인해야 합니다. - 문법이 깨져 문서 의미가 달라지지 않았는지 - 링크가 실제 관련 문서로 연결되는지 - 외부 링크가 광고·피싱·불법 안내로 이어지지 않는지 - 업소 정보가 단정적으로 쓰이지 않았는지 - 안전선 위반 내용이 본문, 각주, 링크 텍스트, 취소선에 포함되지 않았는지 문법적으로 올바른 문장이라도 [[밤문화위키:편집지침]]에 맞지 않으면 반려하거나 수정 후 승인합니다. ## 구현 참고 렌더러 구현 시에는 가능한 한 표준 마크다운 파서를 사용하고, 밤문화위키 고유 기능은 얇은 확장으로 유지합니다. 권장 구조는 다음과 같습니다. ```text 원문 → 코드 영역 보호 → 위험 HTML 제거 → 위키링크 토큰화 → 마크다운 렌더링 → 각주 정리 → 링크 검증 → 최종 HTML 출력 ``` 문법 확장은 운영 규모에 맞게 신중히 추가합니다. 기능이 많아질수록 편집자는 복잡한 문법을 외워야 하고, 운영자는 승인 검수에서 더 많은 예외를 처리해야 합니다. 밤문화위키의 문법은 화려한 표현보다 정확한 정보 전달과 안전한 운영을 우선합니다.제출한 내용은 바로 반영되지 않고 관리자 검토 후 반영됩니다.미리보기편집 요청 제출