헝클어진 생각

원격 블로깅 혹은 메타웹를로그 등으로 알려진 블로그 API를 이용한 글 올리기/수정 기능은 기본적으로 원격지에 자신의 암호를 넣어야합니다. 그것도 일반 텍스트로 넣어야하지요. 현재 MetaWeblogAPI나 MovableType등의 그 뿌리가 같은 xml-rpc류에는 일회용 암호를 제공하는 기능이 없습니다. 음, BlogAPI 에서 사용될 수 있는 암호를 추가하는 것은 어떨까요?

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

출시를 위해서 태터툴즈의 교주(inureyes)님의 수많은 밤 동안 gtalk online을 보아온 저로서는 한 일이 별로 없어서 너무 미안할 따름입니다. XML-RPC가 공식으로 들어갔으니 제게도 버그 리포트가 많이 올라오겠지요.

Tatter and Friends(TnF) 일원으로서, 내부 설문조사도 있었으나, 다시 한 번 출시를 기회삼아 제가 생각하고 있는 태터툴즈에 대한 생각을 정리해보고자 합니다.

태터툴즈는 제게 있어서, 장난감입니다. 처음에는 어떻게 하면 저를 나타낼 수 있을까를 고민하다가 선택하였고, Blogger API를 만들며, 이 놈의 코드(?)에 애착이 가게 되었습니다. 사실 태터툴즈는 최적화 툴을 거쳐 나온 소스가 릴리즈 되는 것이라, 같은 함수가 여기저기에 나타납니다. 언뜻 보기에 아주 못만든 제품처럼 보이죠. 소스를 보시려면 설치된 것을 보는 것이 아니라 subversion repository를 살펴봐야합니다.

태터툴즈를 통해서 사람들을 사귈 수 있게 되었습니다. 이 동네에도 KLDP 같은 사귐이 있는 것을 보게 되었고, 철학 또한 성공한 공개 소프트웨어를 지향하고 있어서 더욱 비슷한 분위기로 코드를 만질 수 있게 되었습니다. 다음주에 있을 TnF 엠티에서 못봤던 사람들을 볼 수 있기를 희망해봅니다. 제게 주말은 시간을 내기 어려운지라, KLDP Codefest 조차 제대로 못갔었는데, TnF도 몇번 고사하고 드디어(!) 가게되었습니다.

태터툴즈는 살아 있는 프로젝트입니다. 살아 있다는 것은 사용하는 사람이 많다는 얘기입니다. 사용하는 사람이 많으면, 프로젝트 일원으로서 기분이 좋아지죠 ^^; 재미있어서 좋습니다. 어쩌다가 여기에 편승할 수 있는 기회를 얻게 되어 장난감이면서 동시에 책임감을 느끼면서 참여하게 되었습니다.

태터툴즈를 1.1로 업그레이드하기까지 수고해주신 많은 TnF/TnC 사람들께 다시 한 번 감사드립니다.

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

태터툴즈 1.1.x 를 쓰시는 분들은 아래 플러그인을 설치할 필요가 없습니다. 관리 메뉴 / 환경 설정 / 기타 설정 에서 블로그 API를 사용으로 설정해두시고, 아래 내용을 읽어 주세요. (2007-01-18)

-------

만일 BlogAPI 0.9.9 를 사용중이시라면, 분류에 "Aladdin" 이라는 것을 넣어 주어야합니다.
알라딘에서 분류를 Aladdin으로 보내주는데, 0.9.9까지는 해당 분류가 없으면 포스팅이 실패하거든요.
0.9.10 은 만약 존재하지 않는 분류로 포스팅을 해오면 분류를 "전체"로 설정하여 글을 올리도록 바꾸었습니다.

알라딘에 가입을 하신 분들은 다음과 같이 합니다. 블로그 관리 링크를 누릅니다.

그리고 오른쪽에 선택되는 화면에서 설치형 블로그 > 태터툴즈 선택> 태터가 설치된 경로를 입력합니다. 화면 예는 "http://www.bookino.net" 인데, 이 경우 태터가 root에 설치되었으므로, 그렇게 한 것입니다. 저의 경우는 /tt 에 설치되어있으므로 "http://coolengineer.com/tt" 가 됩니다. 그리고, 원격 블로깅 설정 링크를 누릅니다.


블로그 주소는 위에서 입력한 것이 나오며, 원격 블로깅 API 주소는 그 뒤에 1.0.x의 경우 "/plugin/BlogAPI" 가 붙게 되는 꼴입니다. 그리고, 태터툴즈에 원격 로그인하기 위한 ID 즉, 관리자 Email을 넣습니다. 비밀번호도 마찬가지로 넣습니다.

태터툴즈 1.1 에서는 "/api" 라고 써주시면 됩니다.


통신 테스트!


그리고 BlogIT 정보저장을 누릅니다.



너무 성공적인것만 썼나요?? 안되는 것은 답글을 달아 주세요 사용하여주셔서 감사합니다.

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

태터툴즈 1.0.x 에 원격 블로깅을 가능하게 해주는 플러그인입니다.

http://coolengineer.com/files/blogapi/ ··· 9.10.zip

에서 받으시면 됩니다.

----

Blogger, MetaWeblog API for Tattertools.

(C) Copyright Hojin Choi, All right reserved.
You can distribute this program under GNU GPL license.

1. 먼저 환경설정의 플러그인 메뉴에서 BlogAPI를 활성화하십시오.

2. 블로깅 툴의 URL 지정위치에 다음 중 하나로 설정하십시오.

       http://YOURDOMAIN/<TT-installpath>/plugin/BlogAPI
       http://YOURDOMAIN/<TT-installpath>/plugin/blogapi

       http://YOURDOMAIN/<TT-installpath>/plugin/BlogAPI/xmlrpc
       http://YOURDOMAIN/<TT-installpath>/plugin/blogapi/xmlrpc

       다중 사용자의 경우 <TT-installpath> 에 자신의 경로를 모두 넣어 주셔야 합니다.

3. 태터툴즈 스킨을 편집하면 자동으로 api 위치를 자동으로 인식시킬 수 있습니다.
       1.0.5 이하에서는 아래 태그를 스킨에 넣으십시오.

<link rel="EditURI" type="application/rsd+xml" title="RSD" href="/<TT-installpath>/plugin/BlogAPI/rsd" />

       Zoundry에서는 Homepage만을 입력함으로 자동으로 xmlrpc 경로를 인식할 수 있습니다.

기능:
1. Blogger API
2. MetaWeblog API
3. 테스트된 클라이언트: writely.com, zoundry, performancing
4. RSD(Really Simple Discovery) 지원
5. ID 를 URL에 넣어 전달 가능
       http://YOURDOMAIN/<TT-installpath>/plugin/BlogAPI?id=your@email.com

6. Semagic의 경우 ID가 15자를 넘으면 지원하지 않습니다. 이경우 다음과 Semagic의 File/Server settings에
  Path 를 다음과 같이 사용하세요.
       /<TT-installpath>/plugin/BlogAPI?id=your@email.com
       그리고 Username 은 아무거나 넣어 주시고, API는 MetaWeblog를 사용하시면 됩니다.


Versions:
----------------------------------------------------------------------------
* Version 0.9.10 (2006-09-23):
+ Fix
       - Aladdin의 Thanks to blogger를 이용한 포스팅은 기본 카테고리를 "Aladdin"으로 설정해 오는데,
         카테고리가 없을 경우 오류가 나는 것을 카테고리 없는 것으로 동작하도록 변경

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

* 0.9.8 에서 달라진 것은 Windows Live Writer 의 카테고리가 안나오는 것만 고친 것입니다.

metaweblog api 의 getCategories를 제가 잘못 구현했더군요. T.T

Download:http://coolengineer.com/files/blogapi/BlogAPI-0.9.9.zip
README:http://coolengineer.com/files/blogapi/README-0.9.9.txt

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

Writely.com 의 버그 두가지가 있습니다.

하나는, 한글로 설정한 태그가 api 쪽으로 전달될 때, 깨지는 현상이 존재하고,
또 하나는, 블로그의 제목에 한글이 들어가 있으면 올바른 블로그가 아닌것 같다는 팝업 메시지를 내면서 아무것도 하지 않습니다.

아니.. 윗 글중 두번째는 거의 추측입니다. 되었다가 안되었다가...

http://groups.google.com/group/Something-in-Writely-is-Broken/search?group=Something-in-Writely-is-Broken&q=to+be+a+valid+url&qt_g=1&searchnow=%EC%9D%B4+%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC+%EA%B2%80%EC%83%89
http://groups.google.com/group/Something-in-Writely-is-Broken/browse_frm/thread/b4ce71c111b45159

오랜전부터 있던 버그인데, 상당히 많은 블로그 시스템이 비슷한 증상을 보이고 있고, 어떤 관계자 답변에는 개발자에게 전달되고 있다고만하고 있다.

음... 맘에 안듭니다.

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

Download:http://coolengineer.com/files/blogapi/BlogAPI-0.9.8.zip
README:http://coolengineer.com/files/blogapi/README-0.9.8.txt

몇가지 버그를 고친 것을 올립니다.

사용할 수 없어서 태터툴즈 원 소스에서 가져온 함수들이 태터툴즈 설치 버전에 따라 사용가능하게 되어 같은 이름 충돌을 일으키는 상황이 생겼습니다. 이것 때문에 몇 함수의 이름을 바꿉니다.
w.bloggar 를 테스트 해보니 몇가지 반드시 넣어야할 getCategories 호출의 리턴 값이 빠져 있는 것을 보았습니다. w.bloggar 는 다른 것과 달리 디폴트 값을 쓰지 않고 없는 경우 오류를 일으키더군요. (짜아식...) 그리고, 한글이 들어간 카테고리나 글을 전혀 읽지를 못하는 것 같습니다.

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

태터툴즈의 위지윅에디터에서는 훌륭한 인터페이스로 그림등을 첨부할 수 있다. 그 절차를 잘 살펴 보면,

1. 멋있는 글 작성
2. 예쁜 그림 추가
3. 완료 버튼
4. 예쁜 그림의 소속을 멋있는 글 소속으로 DB 갱신

MetaWeblog API는 두 단계로 호출이 일어나는데,

1. 좋은 툴로 멋있는 글을 작성후 예쁜 그림 추가.
2. 포스트 버튼을 누름
3. 예쁜 그림을 전송한 뒤 그 그림에 할당되는 새로운 URL 받음
4. 멋있는 글 내부를 예쁜 그림의 새 URL로 바꾸어 전송

이러다 보니, 예쁜 그림의 소속이 어딘지 알 수 있는 방법이 없어지게 된다. 0.9.7까지에서 사용한 방법은 이러했다.

1. 좋은 툴로 멋있는 글을 작성후 예쁜 그림 추가.
2. 포스트 버튼을 누름
3. 예쁜 그림을 전송한 뒤 그 그림에 할당되는 새로운 URL 뒷 부분에 "?__preview__{주인,소속}" 을 추가.
4. 멋있는 글 내부를 예쁜 그림의 새 URL로 바꾸어 전송.
5. API에서는 "?__preview__{...}" 를 찾아서 그림의 소속을 갱신
6. 본문에서는 "?__preview__{...}"를 제거하여 DB에 넣음.

대개 "?" 앞까지만 인식하여 처리하기 때문에 안보이는 문제는 없게된다. 자, 여기까지 생각하면 문제가 없을 것 같은데, 그것이 그렇지 않다. 저 좋은 툴로 수정하여 올릴 경우, 그림이 또 전송된다. 그러면 새로운 URL이 만들어지는 작업이 일어나고, 이전 그림은 소속은 유지되지만, 문서상에서 링크를 잃게 된다.

따라서, 원래 MetaWeblog api의 취지인, 같은 이름의 파일이 전송될 경우 이전 것을 대치한다는 원칙을 그대로 준수하여 그림의 md5 값을 구해서 파일 이름으로 삼고, 한 번 올라온 그림이 다시 올라오는지를 확인하고 삭제하도록 하였다. 이렇게 되면 같은 그림을 두 번 올리는 일이 발생할 경우 이전 것을 대치하므로 잃어버린 링크를 가진 그림은 없게 된다. 다만, 사용자는 같은 그림을 두 개의 글에 올릴 수는 없게 된다.

태터툴즈와 블로그 API가 가지는 차이에서 오는 고민은 여기까지.

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

0.9.7 입니다. metaWeblog api 에서 멀티미디어 자료를 추가할 수 있는 함수를 구현하였습니다.
따라서, Zoundry나 Semagic 등에서 그림 파일을 문서에 추가하면, 동일하게 업로드가 됩니다.

Tatter의 Attachment 테이블에도 적절하게 상하관계가 맺어지는 것까지 추가하였습니다.

그리고 중요한 버그하나를 여태까지 몰랐습니다. 다름아닌, html escaping이 두 번일어나고 있다는 것인데,
이로 인하여, 블로깅 툴로 포스팅을 한 뒤 받아 보면 html 태그들이 살아나는 것입니다. 여태까지 저는 이것이 정상인줄 알았는데, 자세히 보니 BlogAPI에서 한 번 escaping을 하고, XMLRPC 라이브러리쪽에서 보내기 전에 한 번 더하고 있더군요.

이제 명랑한 블로깅이 일어날 것 같습니다. ;)

그나저나, writely.com이 계속 말썽을 일으키며 blog posting이 안되는 군요. 이 것이 writely.com 문제인지, 아니면 이 API 문제인지 알 수가 없네요. 아뭏든 다른 툴에서는 다 잘되는데 writely.com에서만 안되는 상황입니다.

Download: http://coolengineer.com/files/blogapi/BlogAPI-0.9.7.zip
README: http://coolengineer.com/files/blogapi/README-0.9.7.txt

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.

Semagic은 초창기에 blogger api를 만들 때, 고려해보다가 blogger api를 지원하지 않아서 잘 사용하지 않았고, 게다가 id도 15글자 이상은 지원하지도 않아서 alias만 만들어야겠다는 생각만 하고 말았단 툴입니다. 그런데 이번에 lunamoth 님의 글을 보다 다시 보니 metaweblog를 지원하고 있었군요.

1.
.htalias에 태터의 긴 ID를 짧은 ID와 매치 시키는 기능이 0.9.3까지의 /plugins/ 방식으로만 가능했었다는 것을 알았습니다. 이 기능을 수정하였습니다.

2.
최근 writely.com 하부에서 blog api관련 프로그램 변경이 일어나면서, 한 일주일간 동작하지 않았습니다. 지금은 정상화되었는데, BlogAPI에서 blogger api 관련 버그가 하나 있더군요. 이것을 고쳤습니다.

3.
접근 URL을 소문자로도 가능하게 하였습니다.
http://<HOST>/<PATH>/plugin/blogapi
로도 접근이 가능합니다. 아울러
http://<HOST>/<PATH>/plugin/blogapi/xmlrpc
로도 가능합니다.

4.
http://<HOST>/<PATH>/plugin/BlogAPI/test
를 사용하면 브라우져에서 설정이 어떻게 되는지 테스트 해볼 수 있습니다.

Download: http://coolengineer.com/files/blogapi/BlogAPI-0.9.6.zip


-----------------------
Semagic에는 멀티미디어 파일을 올릴 수 있는 API가 구현이 되어 있더군요. 조만간 이것을 지원할 버전을 제공할 생각입니다.

크리에이티브 커먼즈 라이센스

이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.