· KLDP.org · KLDP.net · KLDP Wiki · KLDP BBS ·
KLDP위키토론


1. KLDP 운영 방안 논의

1.1. template, category 추가

howto, mini howto, translation, 창작문서 등을 위한 카테고리를 추가하고 새로운 문서 작성에 필요한 내용을 대강 담은 템플릿도 추가해 두는 것이 좋을것 같네요. 잊어버리지 않기 위해 적어 둡니다. -- 권순선

1.3. 기존 DocbookSgml, LinuxdocSgml 파일을 위키텍스트로 일괄변환

기존 문서를 위키텍스트로 일괄변환한 후 다시 Docbook xml로 export하여 모든 문서 자료를 같은 형식의 Docbook xml로 저장하고 Docbook으로 직접 제출되는 자료에 대해서는 별도로 관리(위키문서에서 제공되지 않는, Docbook의 특별한 태그들을 사용해야 하는 경우)

/DocBook토론에서 논의

1.4. 기존 문서들 중 text로 된 문서나 여러 페이지로 나뉜 문서들 처리하기

text로 된 문서와 소스가 여러개의 파일로 나뉘어 있는 문서들은 아직 이쪽으로 흡수하지 못했으므로 별도의 작업이 필요함

1.5. 전체 문서 보기

전체 문서 보기는 각 문서의 제목을 정해진 문자열로 시작하게 하여 DocbookSgml 과 같은 식으로 처리하면 될 것으로 판단됨

1.6. 공헌자 표시하기

각 문서의 필자들을 어떤 식으로 효율적으로 뽑아내어 보여줄 수 있을지에 대한 고민이 필요함
마치 공동 번역 페이지의 작업현황판 처럼 - 누구 몇퍼센트, 누구 몇퍼센트 - 문서의 전체크기(byte)에서 각 필자들이 편집한 양을 퍼센트화해서 테이블로 보여주면 어떨까 싶습니다. 매번 편집시 diff를 통해 바뀐 양을 뽑아내 필자별로 누계를 내는 식이면 어떨지. --SaNha

1.7. rdf/rss

현재 MoniWiki의 rss는 사이트 전체 페이지에 대한 변동사항을 표시함. 문서에 대한 변동사항을 별도로 표시해 주는 기능이 필요할지 검토 필요함

2. 논의

2.1. 필자 표시 방법

저자, 번역자 등을 표시하는 Docbook의 <author>, <othercredit> 등의 태그를 어떤 식으로 위키에서 처리해 주어야 할까요? 위키텍스트에서 필자와 번역자를 표시하는 방법이 혹시 이미 있나요? 만약 없다면 어떤식으로 처리하는 것이 가장 좋을지 논의해 보았으면 합니다. -- 권순선
NoSmoke:Contributors정도가 되지 않을까요? -- hey (NoSmoke:Contributors토론)

2.2. 플러그인, 확장성

MoinMoin사이트에 있는 몇몇 플러그인은 KLE를 만들면서 제가 만든 것입니다. 모인모인은 개발자가 보수적이라서 제안을 해도 거의 받아주지 않았습니다. 그것이 MoniWiki를 만들게 된 동기중에 하나지요. kldp도 KLE,GnomeKorea 등등에서 사용하는 위키엔진인 모인모인 혹은 모인모인 클론인 MoniWiki를 쓰는 것이 낫다고 생각합니다.
예, 호환성 측면이나 유연성, 사용자 로그인 기능 측면에서는 MoniWiki가 나을 것 같습니다. DbWiki도 개인적으로는 디자인이 마음에 들어서 좋습니다. 어쨌든 둘중 하나를 곧 선택해야 할텐데 WkPark님과 류광님 외에는 별다른 의견을 주시는 분이 없으니 금주 중으로 결정을 해서 연락을 드리겠습니다. -- 권순선

디자인이라면, MoniWikiTheme를 지원합니다. 기본적으로는 header.php와 footer.php를 고쳐서 디자인을 고칠 수 있고, 테마로 만들 수도 있습니다. --WkPark
제가 본 바로는 각 테마별로 header.php, footer.php가 있어서 그걸 고치는 것 같은데 그거 말고 테마에 상관없이 적용되게 할 수 있는 방법이 있나요? 예를 들어 상단에는 몇몇 사이트로의 링크를 추가하고 하단에는 copyright notice등을 추가하고자 한다든지 하는 식으로요. 제가 이해하기로는 각 테마별로 일일이 다 고쳐줘야 하는 것 같아서요. -- 권순선
메뉴는 설정을 변경해서 가능하고, 테마는 사이트에 맞게 고쳐야 합니다. 사이트 하나에 여러개의 테마를 두는 일은 없을 것입니다. 그러므로 배포에 들어있는 테마중에 필요없는 부분은 지우면 되고, 기존의 테마를 다른 이름으로 변경해서 고쳐써야 합니다.

테마를 만든 후 한 테마로 고정하는 방법도 지원합니다. $theme='blog';라고 하고, $theme_css=1;이라고 하면, 테마를 blog로 선택하고, css도 못 바꾸게 됩니다. 혹은, 테마가 작동하지 않도록 plugin/theme.php를 지우는 방법도 가능합니다. header.php와 footer.php를 고치고, theme플러그인을 비활성화 시키는 방법도 있습니다.

각 테마에 필수적인 요소는 모두 반영되게끔 (예를 들어 하단의 copyright이나 메뉴 항목들) 방안을 강구할 수도 있겠지요. --WkPark

3.1. 기존 Docbook sgml, Linuxdoc sgml의 일괄 변환 방안 (종료)

기존에 번역된 문서들을 어떻게 위키에 집어넣을지 고민해봐야 할것 같네요. 현재 크게 Docbook sgml, Linuxdoc sgml 두가지 종류의 문서 포맷이 있는데 이것들을 모두 위키텍스트 형식으로 변환하고 위키에 집어넣을 수 있는 방법이 있으면 좋을 것 같습니다. 집어넣을 때는 맨 처음 모니위키를 설치할 때 Seed들을 import하는 코드를 활용하면 될것 같고요. 단, 위키텍스트로 변환할 때 매핑이 되지 않아 손실되거나 제대로 처리되지 않는 부분이 있을 것 같은데 사용된 태그가 그다지 많지 않아 그런 문제가 심각할 것이라고는 보지 않습니다.

그렇지 않으면 Docbook sgml, Linuxdoc sgml을 그대로 위키에 집어넣는 방법도 있을 것 같은데 그건 더 문제가 많을 것 같고요. 어쨌든 꼭 짚고 넘어가야 할 부분이므로 적어 둡니다. 의견 주세요.... -- 권순선

일단은 Namespace를 구분해서 다 집어넣고, 천천히 xml기반의 최신 sgml로 수작업으로 변환하거나 하면 되겠지요.

LinuxDoc은 LinuxDoc/HelloHOWTO정도로 넣는다면, sgml은 DocBook/HelloHOWTO 정도로 넣고, 각 페이지 이름에 따라서 파일 형식이 LinuxDoc, DocBook이 되는 형태이고, DocBookSgml 밑에도 (아직 XML로 변환하지 않았을 경우) 넣고요.

일반 위키문서는 끝에 확장자가 FooBarHOWTO, FooBarMiniHOWTO, 혹은 FooBar로 할 수 있을 것입니다.

sgml소스를 집어넣을 때는 그냥 Copy를 하면 됩니다. sgml인지 linuxdoc인지에 따라서 DocBook_2fFooBar와 같은 식으로 이름을 변경해서 복사해야 겠지요. (/문자는 _2f로 변경해서 저장.) (Seed집어넣는 소스 역시 그냥 copy합니다. Copy하고 퍼미션을 777로 하거나 setgid를 설정해 놓거나..)

MoniWiki는 파일기반이므로 (DB를 필요로 하지 않아서), 저 자동으로 수작업이 가능하고 미세한 조절이 쉽지요. --WkPark
음...그렇군요. 그냥 파일 자체를 data 디렉토리에 넣으면 된다는 얘기죠? 나중에 Docbook --> 위키텍스트로의 변환 작업이 이루어진 이후에도 파일 이름만 같게 해서 Docbook소스를 해당 위키텍스트 파일로 덮어쓰면 되겠네요! -- 권순선

차후에는 위키문서 ->docbook변환-> ftp 올리기를 스크립트로 한방에 끝내는 방법을 강구할 수도 있겠지요. DocBookTest를 보시면 그걸 염두해 두고 있습니다. :) --WkPark
이 문제는 DocBook sgml, Linuxdoc sgml --> 위키텍스트 변환에서 계속 논의하도록 하겠습니다... -- 권순선

3.2. 다른 위키 사이트와 연동 (SisterWiki)

GnomeKoreaGentooKorea에서도 DocBook이 목표는 아니었지만 자체 제작이나 번역으로 문서 페이지가 존재합니다. KLDP가 그 문서를 흡수하기엔 맥락이 안 맞지만, 어떤 식으로든 연계할 필요는 있다고 생각합니다. 어떻게 생각하십니까? --kz
InterWiki 기능으로 연동하면 되지 않을까요. 예를 들어 X-Window 카테고리 아래에 gnome이나 kde등의 서브카테고리가 아마 들어가겠지요. 그러면 적당한 곳에 해당 문서를 InterWiki로 해서 링크하면 되겠지요. SisterWiki라고 하나요. 반대로 GnomeKorea나 GentooKorea등에서도 필요한 문서가 있다면 같은 방법으로 KLDPDoc의 문서를 링크할 수 있겠지요. 카테고리 정리도 처음에 어느 정도는 관리자가 하겠지만 위키 도입으로 기대하는 효과는 카테고리 정리도 자유롭게 이루어지는 것입니다. -- 권순선

SisterWiki라는 자동 링크 기능이 있습니다. 링크된 페이지가 현재 위키에 없으면서, SisterWiki로 등록된 위키에 그 페이지가 존재할 경우 자동으로 Siste Sites를 제시해서 보여줍니다. 마치 현재 위키에 있는 페이지처럼 보이게 되므로 갇혀있는 위키를 외부로 확장할 수 있는 방법이지요. OriginalWiki등에서 이 방법을 지원합니다. --WkPark

저도 SisterWiki가 적용이 되면 좋겠습니다. CAndCPlusPlus토론InterWiki로 외부 링크들을 페이지가 있는지 따로 확인하여 연결했는데, SisterWiki가 작동하면 그럴 필요도 없으니까요. --hey
SisterWiki 가 잘 작동하려면 페이지이름 짓는 룰이 어느정도 타 위키와 비슷해야 합니다. 그래야 해당 페이지에 대해 SisterWiki의 페이지들이 나올 가능성이 높으니까요. c2 나 노스모크의 예와 비슷하게 따르면 되지 않을까 생각합니다. --1002
그렇게 해서 이득이 있다면 바꿔야 한다고 봅니다. 저는 이득이 있다고 봅니다. 그리고 천천히 필요한 부분부터 바꿔도 될겁니다. 어쨌든 합시다! :] --hey





sponsored by andamiro
sponsored by cdnetworks
sponsored by HP

Valid XHTML 1.0! Valid CSS! powered by MoniWiki
last modified 2005-09-20 19:46:46
Processing time 0.0236 sec