차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- c20:dossier:naming_conventions [2022/02/23 10:12] – ↷ 문서 이름이 c20:dossier:conventions에서 c20:dossier:naming_conventions(으)로 바뀌었습니다 clockoon
+++ c20:dossier:naming_conventions [2025/11/06 01:12] (현재) – 바깥 편집 127.0.0.1
@@ 줄 4: / 줄 4: @@
 ## 개요
-[[sw:dokuwiki|DokuWiki]]는 그 특성상, [[tech:mediawiki|Mediawiki]]처럼 표제어을 곧장 링크하는 것이 불가능하며, 문서명을 링크하는 식으로 작동하게 된다[^1]. 따라서 적절한 문서명 명명에 대한 규칙을 정해놓고, 이를 따르도록 하는 것이 필요하다[^2]. 이 문서는 그 규칙을 정리한다.
+[[wiki:sw:dokuwiki|DokuWiki]]는 그 특성상, [[tech:mediawiki|Mediawiki]]처럼 표제어을 곧장 링크하는 것이 불가능하며, 문서명을 링크하는 식으로 작동하게 된다[^1]. 따라서 적절한 문서명 명명에 대한 규칙을 정해놓고, 이를 따르도록 하는 것이 필요하다[^2]. 이 문서는 그 규칙을 정리한다.
 ## 네임스페이스
@@ 줄 16: / 줄 16: @@
 - journal: 일기.
 - living: 생활에 관련된 내용.
+- music: 음악에 관련된 내용.
+- record: 음반에 관련된 내용.
 ## 문서명
-문서명을 붙일 때에는 크게 두 가지 원칙을 따르도록 한다.
+문서명(id)은 쉽게 검색하거나 링크걸 수 있도록 붙여야 한다. 이는 도쿠위키의 특징이자 단점 - 전통적인 위키처럼 문서 제목과 id가 일치되지 않고 분리되며, 문서명으로 링크거는 것이 불가능함 - 에 따른 불편함을 최소화하기 위함이다. 크게 두 가지 원칙을 따른다.
-. 무리하게 alphabetize하지 않고, 가능한 원어 이름을 따른다. 다만 프랑스어 등 일반적인 알파벳이 아닌 경우에는 대응하는 영어 알파벳을 사용한다.
+. 문서 제목은 원어로 작성한다.
-. 문서명은 띄어쓰기를 하지 않는다. 어차피 띄어쓰기 등 특수문자가 밑줄로 변환되기 때문에, 불편함을 피하기 위함이다.
+) 원어 제목을 한글로 통칭하는 역제가 있다면, 제목에는 작성하지 않는 대신 본문 내에 이를 반영하여 검색이 용이하도록 한다.
-. 1과 2에 해당하지 않는, 한글이나 띄어쓰기 반영 제목 등은 redirect로 넘긴다.
+. 문서의 id는 문서명을 반영하여 알파벳으로 기재하되, 원어를 최대한 반영한다.
+) 영어로 된 제목은 영어로 기재한다.
+) 프랑스어 등 액센트가 포함된 제목의 경우 대응하는 기본 알파벳을 사용한다.
+) 도쿠위키는 띄어쓰기를 밑줄로 변환하므로 id에 사용하지 않는 것도 장점이 있지만, 문서명이 길다면 너무 난잡해지기 때문에 원어와 동일하게 띄어쓰기를 적용한다.
+) 비알파벳 제목의 경우 영어를 사용하여, 원어 발음과 유사하게, 혹은 해당 언어의 로마자 표기법을 따라 id를 만든다. [Google Translate](https://translate.google.com/) 등을 활용하면 도움이 된다.
 [^1]: 도쿠위키보다 미디어위키가 집단적/협업 위키에 더 적합한 결정적인 이유는 이러한 정책 때문이라고 생각한다. 굳이 문서의 hierarchy를 고민할 필요 없이 수평적으로 문서를 구성하고 링크거는 것이 가능하기 때문이다.

c20/dossier/naming_conventions.1645578751.txt.gz · 마지막으로 수정됨: 2025/11/06 01:13 (바깥 편집)