Contents
MoinMoin 1.7 쓰기
공동작업환경에서 Wiki는 꼭 필요한 도구입니다. 그동안 MoinMoin 1.5x 판을 써왔는데, 2009년 3월 직지 server의 HardDisk가 사망하면서 새로 FreeBSD 설치하기를 하게 되었습니다.
직지지기가 FreeBSD에서 제일 좋아하는 것이 ports에서 한 줄 명령어로 필요한 연장들을 설치해서 쓸 수 있다는 것입니다. Ports 아닌 다른 방법으로 설치하는 방법도 알고는 있지만, 보통의 경우 ports가 훨씬 간단하지요.
이번에 보니 FreeBSD port에 MoinMoin 1.7x판이 올라와 있었습니다. 그동안, MoinMoin에서 사용자 등록이나, 기타 잡다하게 불편해하던 것들이 좀 있어오던 차에, 기능이 더 좋아진 것 같아서 1.5x판에서 1.7x판으로 판수를 올리기로 하고 바로 port에서 설치를 했습니다.
설치할 때 예전 wiki자료를 복구하는 것이 제일 큰 걱정이었는데, 별 문제 없이 잘 진행되어 지금 보시는 것처럼 다시 wiki로 직지를 돌리고 있습니다.
하지만, 변화에는 늘 그 댓가가 있기 나름이지요. 참 많은 변화가 있더군요. 아이들 넷 키우느라 강호에 칩거 내지는 은둔하고 사는 것 같습니다... 
이 글월에서는 MoinMoin 1.7x에서 쓰는 문법을 좀 공부해볼까 합니다. 더 정확하게 하려면 1.5x도 설치하고 비교를 해봐야 겠지만, 그러기는 싫고해서 1.5x관련해서는 오로지 기억에만 의존하여 씁니다.
문법, 기본적인 사용법
가장 큰 변화: WikiName, 확장 WikiName, HTML Mark Up Language, 그리고 Macro
예전에는 WikiName 처럼 대문자를 썩어어 단어, 또는 문장을 쓰면 자동으로 연결고리를 달 수 있게끔 해주었습니다. 이해하시겠지만, 한국어같이 교착어인 경우, 그리고 영어를 한글과 섞어쓰는 경우 WikiName하면 한글까지로 연결고리가 확장되어 원하지 않는 글월 제목을 만들 수 있었습니다. 이제는 영어권글자와 비영어권 글자를 구별하는지 WikiName이라고 해도 한글을 포함시키지 않습니다.
그보다 더 좋은 변화는 확장 WikiName과 HTML Markup Language를 나타내는 방식이 하나스러워진 점입니다.
1.5x ["한글 WikiLink"] --> 1.7x [[한글 WikiLink]]
1.5x [http://www.jikji.org/ 직지 Porject] --> 1.7x [[http://www.jikji.org/ | 직지 Project]]
그리고 예전에는 Macro를 써서 나타냈던 ImageLink가 확장 WikiName으로 나타낼 수 있게 되었습니다.
1.5x [[ImageLink(target, source, alt=text, width=xxx, height=yyy)]] --> 1.7x [[target|{{source|alt text|width=xxx, height=yyy}}]]
이처럼 겹괄호가 WikiName, 확장 WikiNmae, 그리고 HTML Markup까지 나타내는 기호로 쓰이게 되자, Macro를 나타내는 기호가 바뀌게 되었습니다.
1.5x [[MacroName(인자}]] --> <<MacroName(인자)>>
또한, 그림을 나타내는 방법이 많이 바뀌었습니다.
1.5x ??? --> 1.7x {{image location}}
Frame Parser
직지 Project는 Frame이라는 parser를 써서 그림과 글씨를 나란히 배치하는 꽁수를 썼습니다. 이미 만들어진 문서들과의 호환성 때문에 다시 설치는 했습니다만, 다음과 같은 내용이 있어서 이제는 이렇게 하면 되겠구나 싶습니다만서도 복잡한 꼴을 보니 그래도 종종 쓰게 될 것 같습니다.
- Because of adding an html parser to 1.6 which can do everything the frame parser does and the posibility to use styles for the wiki parser I do think this parser becomes obsolete. -- ReimarBauer 2008-02-16 09:19:00
{{{#!html <div style="float: right;"> }}} {{http://code.google.com/opensource/ghop/2007-8/images/ghoplogo.jpg}} {{{#!html </div> }}}{{{#!wiki blue/dotted Example text }}}
직지에서 Frame Parser를 쓰는 대표적인 예는 MinsooKim에 있으며, 다음과 같이 쓰여졌습니다.
{{{#!Frame align=float:left,thick=0,width=10%,margin=0em 1em 0em 0em <<Image(MinsooKim/Album/minsookim.jpg, alt=Minsoo Kim's photo)>> }}}
그리고 다음과 같이 해서 글월 제일 끝에 마침표를 찍기도 합니다.
{{{ #!Frame align=float:right,thick=0 {{http://images.jikji.org/wikiimages/JikjiEnd.png}} }}}
이렇게 보입니다.
|
Anchor
Internet에서 글을 쓰고 읽다보면, 지금 있는 위치에서 다른 위치로 가야할 필요가 종종 생깁니다. 책을 읽다가는 책 몇 쪽 앞으로, 또는 위로 넘기면 되겠지만, Wiki에서는 다음과 같이 해야합니다.
<<Anchor(닻이름)>>, 여기에서 "닻이름" 한 문서에서는 하나뿐인 이름으로, 정박할 위치를 알려주는 표식입니다.
이 "닻이름"으로 이동하려면, 다음과 같이 하면 됩니다.
같은 Wiki문서 안에서: [[#닻이름]] or [[#닻이름|아까 봤던 항구로 가자!]] 로 씁니다.
어느 Wiki문서에서 닻을 내린 다른 Wiki문서로: [[다른 Wiki문서#닻이름]] or [[다른 Wiki문서#닻이름|아까 봤던 항구로 가자!]]
그리고 몇 가지 벌레가 있다고 보고가 되었습니다. 이중에 대표적인 것들 입니다.
각주 달기
각주는 <<FootNote(각주 내용)>>과 같이 하면 달 수 있습니다. 보기1는 <<FootNote(각주를 보인 보기입니다)>> 해서 만든 각주입니다.
ISBN
김창준님이 예전에 만드신 ISBN.py는 Amazon과 Aladdin에서 책겉장 그림을 가져가다 보여줄 수 있었습니다. 이번에 MoinMoin 1.7로 올리고 나서 그 macro가 잘 돌아가지 않게 되었습니다. 그래서 오류를 쫒아가며 고쳐서 새 ISBN.py를 만들어서 이제 제대로 작동합니다. 사용법은 다음과 같습니다.
<<ISBN(number, k[e], {noimg)>>
여기에서 k는 Aladdin으로 연결고리를 달아주며, e는 Amazon으로 연결고리를 달아줍니다.
![/!\](/wiki/modern/img/alert.png "/!\")
이 k, 또는 e는 반드시 달아주어야 합니다. - 여기에서, noimg는 책겉장 그림 없이 ISBN 번호만 보여주고, 서점으로 향하는 연결고리만 달아줍니다. 이 noimg는 꼭 안써주어도 됩니다. 아무런 내용이 없으면 기본값은 책겉장 그림을 보여주게 되어 있습니다. 그러므로, 책겉장 그림을 보여주고 싶지 않을 때 noimg라고 쓰십시오.
첨부 문서(Attachment)
그림을 첨부문서로 올려서 화면에 보이려고 하다가 고생을 좀 했습니다. 다음 처럼 하면 화면에 그림이 보입니다.
{{attachment:그림첨부문서|설명|width=xxx, height=yyy}}
그냥 [[attachment:그림첨부문서]]하면 연결고리로 보이게 됩니다.
그림문서 보이게하기
직지에서는 첨부문서를 올려서 그림을 보여주는 방식을 권장하지 않습니다. 그림이 여러 Wiki문서들에 흩어지게 되어 관리하기가 쉽지 않아지기 때문입니다. 그래서 다음과 같은 꽁수를 씁니다. 어차피 아직은 저 혼자서 쓰는 것이므로 크게 불편이 없습니다.
http://images.jikji.org/wikiimages/가 Wiki에 사용할 그림을 저장하는 창고입니다.
- FTP접속을 통해서 그림문서를 이 저장창고에 올려줍니다.
- 저는 그냥 NFS를 통해서 저장합니다.
{{http://images.jikji.org/wikiimages/file.jpg}}와 같이 해서 Wiki 문서에 적어줍니다. 어느 문서에서나 사용이 가능합니다.
기능을 직지쓰임에 맞게 바꾸어 봅시다
옛한글꼴 보이게 하기
직지 Project Wiki는 /home/www/wiki에 깔려 있으며, CSS 문서가 있는 곳은 /home/www/wiki/htdocs/modern/css입니다. 그 곳간 안에는 common.css, msie.css, print.css, projection.css, 그리고 screen.css, 이렇게 다섯 문서가 들어있습니다. 이 문서에서, font-family가 있는 곳에는 무조건 "nGulim, nBatang, 새굴림, 새바탕", 이렇게 네 가지 글꼴 이름을 더합니다.
다음은 common.css, print.css, screen.css의 바뀐 내용은 보여주는 diff 결과 입니다.
/home/www/wiki/htdocs/modern/css> diff ../css.dist/common.css common.css 11c11 < font-family: Arial, Lucida Grande, sans-serif; --- > font-family: nGulim, nBatang, 새굴림, 새바탕, Arial, Lucida Grande, sans-serif; 69c69 < font-family: courier, monospace; --- > font-family: nGulim, nBatang, 새굴림, 새바탕, courier, monospace;
/home/www/wiki/htdocs/modern/css> diff ../css.dist/print.css print.css 9c9 < font-family: Times, serif; --- > font-family: nGulim, nBatang, 새굴림, 새바탕, Times, serif;
/home/www/wiki/htdocs/modern/css> diff ../css.dist/screen.css screen.css 41c41 < font-family: monospace; --- > font-family: nGulim, nBatang, 새굴림, 새바탕, monospace; 364c364 < font-family: monospace; --- > font-family: nGulim, nBatang, 새굴림, 새바탕, monospace;
이 설정으로 인해 훈민졍이 제대로 보이는 것입니다. 만약 훈민졍에 있는 옛한글이 제대로 안 보이시면, 옛한글 나타내기를 참고하십시오.
moin-www.png 숨기기
옛날에 
을 숨기기 위해 몇 개의 source file을 고쳤던 기억이 납니다만, 이제는 어디에서 어떻게 시작해야 할지 모르겠네요. 
그래서 http://www.moinmo.in/MoinMoinQuestions/Themes에 다음과 같은 질문을 올렸습니다.
Hello, thanks for this info, but I'm looking for other ways, probably more flexible ways to hide moin-www.png. Is there a way to selectively hide moin-www.png icon? For instance, 1) based on server domain name, i.e., if a MoinMoin Wiki resides on http://www.yyy.zzz, do not show moin-www.png on any link that has yyy.zzz domain name. 2) based on list of server domain names either defined by list in a configuration file, or provided by a simple textfile file, like intermap.txt (kind of). - MinsooKim
어차피 연결고리는 색깔이 달라서 쉽게 알 수 있으므로, 가 들어가는 common.css, msie.css에서 moin-www.png가 들어가는 줄은 모두 주석처리해서 안보이게 했습니다. 직지가 대부문 화면에서 읽는 글월자료을 다루다 보니, 중간에 이런 그림이 들어가는 것이 읽는 것을 좀 방해하는 경향이 있어서 말이죠.
각주를 보인 보기입니다 (1)