aproxacs님의 노트

cscope 사용하기

Mon, 06 Oct 2008 17:24:32 +0900

한 일년 사용하지 않았을 뿐인데.. 다 잊어버렸다. 이름조차 생각 안난다.

cscope 설치

cscope db만들기

소스가 있는 디렉토리로 이동해서

cscope.files를 생성

find $PWD -name "*.[hc]" > cscope.files

cscope.out 생성

cscope -b -i cscope.files

cscope.out 이 생성된다.

vim에서 cscope 사용할 수 있도록 하기

cscope_maps.vim 를 ~/.vim/plugin 디렉토리에 복사

vi 실행한 후 cscope db를 연결

:cs add cscope.out

vi가 실행될 때 자동으로 cscope db에 연결되도록 하기 위해서는

$CSCOPE_DB 환경변수 설정

vim 에서 사용하기

ctrl + \ + s : 커서가 위치하고 있는 단어 검색

ctrl + 5 : 커서가 위치한 함수의 선언으로 이동

ctrl + t : 전에 위치했던 페이지로 이동.

http://wiki.kldp.org/wiki.php/VimCscopeTutorial 참조

linux 관련

Mon, 22 Sep 2008 12:12:08 +0900

- cscope 사용하기

[mysql] 원격으로 db에 접속하기

Thu, 18 Sep 2008 18:00:01 +0900

remote 에서 mysql 에 접속하고 싶다면 다음과 같은 일을 해 주자.

사용자가 필요하다면 추가한다.

insert into user (host, user, password)
values ('%', 'icehan', password('123456'))
insert into db
values ('%', 'table', 'icehan', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y', 'Y')
flush privileges

/etc/mysql/my.cnf 에서 bind-address 수정

bind-address = IP_address

사용자에 ip 접근 권한 부여 :
1. mysql> grant all privileges on myapp.* to myid@접근할아이피혹은도메인
2. mysql> flush privileges

사용자 비밀번호 변경

mysql> update user set password=password('1111') where user='myid';

jsspec 사용하기

Thu, 18 Sep 2008 13:47:58 +0900

javascript를 이용해서 storyq에 Open API를 사용하는 라이브러리를 만들어 봐야지

jsspec을 사용해 보자.

일년 전에 루비 세미나 갔다가 처음 봤는데, 무슨 말인지 몰랐다. 신기하기만 했다.

설치 및 사용환경 만들기

http://jania.pe.kr/aw/moin.cgi/JSSpec/UserGuide

간단하네.

사용해보기

http://jania.pe.kr/aw/moin.cgi/JSSpec/Manual

문서가 잘 되어 있네.

시작해보자.

하고자 하는 것들

storyq = new Storyq({consumer_key: "aaa", ...})

storyq.set_config({consumer_key:"aaa", ...})

storyq.oauth.get_request_token({on_success: func, on_error: func});

storyq.oauth.get_access_token({on_success: func, on_error: func});

storyq.is_authorized();

token = storyq.oauth.get_token({key:"aaa", value:"bbb"});

token..authorize_url();

storyq.boxes.get({scope: "all", page:1, type:"slide", on_success: func});

storyq.boxes.get({scope: "best", page:1, type:"slide", on_success: func});

storyq.boxes.get(12);

boxes = storyq.boxes.get([12, 13]);

boxes.page

storyq.slide_boxes.get(...)

box = storqy.slide_boxes.create({file:"file.pdf"})

box.title = "hey"

box.save

box.destroy

음.. 복잡하군.

일단 보류. binary file upload를 mozilla를 사용하지 않고 어떻게 할 수 있는가?

jsspec 코드를 먼저 읽어보자.

javascript

typeof 로는 number, string, function, object 확인할 수 있다.

instanceOf로 Array인지 확인할 수 있다.

javascript function 호출 방법

func = function(args) {}

func(1);

func.call(1)

func.apply([1] // hmm

기타 다른 tip들

Wed, 17 Sep 2008 13:26:37 +0900

스토리큐에서 OAuth 인증하기

Wed, 17 Sep 2008 13:20:53 +0900

우선 스토리큐에 접속해서 매시업 애플리케이션을 등록합니다. 그러면 Request URL, User Authorization URL, Access Token URL을 얻을 수 있습니다.(스토리큐 Open API 를 이용해 매시업 애플리케이션 만들기 참조)

스토리큐는 OAuth를 사용해서 사용자 인증을 합니다. OAuth에 대해서 알고 싶으시면 OAuth 인증 참조.

스토리큐는 인증을 위해서 HMAC-SHA1 만을 사용합니다.^^

스토리큐는 OAuth 파라미터의 전송을 위해 Authorization 헤더를 이용합니다. 즉, 컨슈머는 OAuth 파라미터들을 HTTP Authorization 헤더에 넣어서 보내야 합니다.

문서에 잘못된 내용이나 오해의 여지가 있으면 aproxacs@gmail.com 으로 알려주세요.

1. 요청토큰(Request Token) 얻기

요청토큰을 얻기 위한 요청의 예

POST /oauth/request_token HTTP/1.1
Connection: close
Accept: */*
Authorization: OAuth realm="", oauth_nonce="QqrM4Yl6IHhJE6HnDELvYhWn7XGHjkgcLbr08mLaH8", oauth_signature_method="HMAC-SHA1", oauth_token="", oauth_timestamp="1217493796", oauth_consumer_key="8PEzPnu0I6fKnSJ0JoOCsQ", oauth_signature="e0pEYsvpdTXa8sbGjiDWtBonitU%3D%0A", oauth_version="1.0"
Host: www.storyq.net
Content-Length: 0

POST 요청을 사용하기를 권장합니다.
Autorization 헤더에 OAuth 파라미터들이 있습니다.
- oauth_nonce : 임의로 생성된 문자열입니다.
- oauth_signature_method : HMAC-SHA1 만 지원합니다.
- oauth_token 은 없습니다.
- oauth_timestamp : 요청이 발생한 시간, 1970년 1월 1일 0시 0분 0초 GMT 부터의 초
- oauth_cosumer_key : 컨슈머 키
- oauth_signature : 서명
- oauth_version : 1.0

oauth_signature를 구하는 방법

Signature Base String을 우선 구합니다. Signature Base String의 형식은 다음과 같습니다.
HTTP Request Method&Request URL&파라미터 문자열
각 항목들은 [RFC3986] 의 percent-encoding(%xx) 방법에 의해서 이스케이프(escaped) 됩니다. javascript 에서 escape을 하는 방법은 여기를 참조하세요.
파라미터 문자열의 파라미터들은 파라미터의 이름순서로 정렬됩니다.
그래서 위 요청의 Signature Base String은 다음과 같습니다.
POST&http%3A%2F%2Fwww.storyq.net%2Foauth%2Frequest_token&oauth_consumer_key%3D8PEzPnu0I6fKnSJ0JoOCsQ%26oauth_nonce%3DQqrM4Yl6IHhJE6HnDELvYhWn7XGHjkgcLbr08mLaH8%26oauth_signature_method%3DHMAC-SHA1%26oauth_timestamp%3D1217493796%26oauth_token%3D%26oauth_version%3D1.0
그리고 Secret을 만듦니다. Secret의 형식은 다음과 같습니다.
ConsumerSecret&TokenSecret
컨슈머 비밀번호(consumer secret)가 kLs1KsFJp9F5l7kEuF2HKRWe8Y14eGLZZxFELFRg 라고 가정하면 다음과 같습니다. 현재 토큰 비밀번호(Token Secret)는 없습니다.
kLs1KsFJp9F5l7kEuF2HKRWe8Y14eGLZZxFELFRg&
이제 key 와 text를 알았으니 이것을 이용해서 digest를 만듦니다. 알고리즘은 [RFC2104] 에 정의된 HMAC-SHA1 서명 알고리즘을 사용합니다.
예를 들어 ruby의 경우에는 HMAC::SHA1 클래스를 이용합니다.

digest = HMAC::SHA1.digest(Secret, SignatureBaseString)

이제 이 digest를 Base64-encoding하고 URL-encoding하면 oauth_signature값이 됩니다.
ruby를 사용한다면 다음과 같습니다.

CGI.escape(Base64.encode64(digest))

이에 대한 응답은 다음과 같습니다.

HTTP/1.1 200 OK
...
Content-Length: 93

oauth_token=oe9H1mZQLbF9jLhzQ0eDQ&oauth_token_secret=yvo8iqyYNPLHUF4DtwBwx3V20GjGpWom1qZUhM2I

oauth_token 과 oauth_token_secret이 HTTP body 에 포함되어 있습니다. 이것이 요청 토큰이 됩니다.

2. 요청토큰에 대해 사용자 인증을 얻기

컨슈머는 사용자를 Authorize URL로 리다이렉트 시킵니다. 자동으로 리다이렉트 시킬수 없는 상황에서는 사용자에게 접속할 URL과 인증을 마치고 돌아올 것을 알려줍니다.

Authorize URL은 다음과 같은 형식입니다.

http://www.storyq.net/oauth/authorize?oauth_token=oe9H1mZQLbF9jLhzQ0eDQ

이때 컨슈머는 oauth_callback을 파라미터로 붙일 수도 있습니다. 그 경우 스토리큐는 사용자 인증을 마친 후 oauth_callback URL로 사용자를 리다이렉트 시킵니다. 특별히 지정하지 않는 경우 스토리큐는 디폴트 값(애플리케이션을 등록하면서 설정한 값)을 사용하거나 없는 경우에는 사용자에게 컨슈머로 돌아갈 것을 공지합니다.

3. 요청토큰을 접근토큰으로 교환하기

사용자가 인증을 마치고 돌아오면 컨슈머는 인증된 요청토큰을 접근토큰으로 교환할 것을 요청합니다.

한 예는 다음과 같습니다.

POST /oauth/access_token HTTP/1.1
Connection: close
Accept: */*
Authorization: OAuth realm="", oauth_nonce="xCtZ8sRNy707SsHORMJESvusDF3DBUuSW4qaIXO4fY", oauth_signature_method="HMAC-SHA1", oauth_token="oe9H1mZQLbF9jLhzQ0eDQ", oauth_timestamp="1217496659", oauth_consumer_key="8PEzPnu0I6fKnSJ0JoOCsQ", oauth_signature="Fp3gxxQiUHwNRD2Fwqj7lMmPtFI%3D", oauth_version="1.0"
Host: www.storyq.net
Content-Length: 0

역시 OAuth 파라미터들은HTTP Authorization 헤더에 포함됩니다.

Signature Base String은 요청토큰을 얻을 때와 같은 방법으로 구해집니다.

Secret 역시 같은 방법으로 구해집니다. 그래서 지금은 요청토큰의 비밀번호도 포함됩니다.

kLs1KsFJp9F5l7kEuF2HKRWe8Y14eGLZZxFELFRg&yvo8iqyYNPLHUF4DtwBwx3V20GjGpWom1qZUhM2I

그리고 다음과 같은 응답을 받습니다.

HTTP/1.1 200 OK
...
Content-Length: 93

oauth_token=GNI8aT7Y5kQoGlQVH4RJ5A&oauth_token_secret=WeEG07n38qcUvoCu61uHu2SgsgRcwnejcoDEXrPTjHc

이번에 받은 토큰이 접근 토큰이 됩니다.

4. 접근토큰을 이용해서 사용자의 큐 목록 가져오기

사용자가 업로드한 큐 목록을 가져오는 API URL은 /boxes/mine 입니다.

두번째 페이지를 요청하기 위해 파라미터로 page=2 를 사용하는 경우 HTTP 요청은 다음과 같습니다.

GET /boxes/mine?page=2 HTTP/1.1
Connection: close
Accept: application/xml
Authorization: OAuth realm="", oauth_nonce="9OawOkHb7Qa1ktux8691UkUk6mRslP5LtZ4EHAaXrs", oauth_signature_method="HMAC-SHA1", oauth_token="GNI8aT7Y5kQoGlQVH4RJ5A", oauth_timestamp="1217502250", oauth_consumer_key="8PEzPnu0I6fKnSJ0JoOCsQ", oauth_signature="AhEzBzPt5tNZ1OuJCamb9GiC4kM%3D%0A", oauth_version="1.0"
Host: www.storyq.net

이 경우 Signature Base String에는 page=2 가 포함됩니다. 쿼리 스트링에 포함된 파라미터와 content-type 이 application/x-www-form-urlencode인 POST 요청의 파라미터들은 Signature Base String에 포함됩니다. 자세한 내용은 OAuth 인증 의 9. 서명하기를 참조

POST&http%3A%2F%2Fwww.storyq.net%2Fboxes%2Fmine&oauth_consumer_key%8PEzPnu0I6fKnSJ0JoOCsQ%26oauth_nonce%3D9OawOkHb7Qa1ktux8691UkUk6mRslP5LtZ4EHAaXrs%26oauth_signature_method%3DHMAC-SHA1%26oauth_timestamp%3D1217502250%26oauth_token%3GNI8aT7Y5kQoGlQVH4RJ5A
%26oauth_version%3D1.0%26page%3D2

Secret은 컨슈머 비밀번호와 접근 토큰의 비밀번호입니다.

kLs1KsFJp9F5l7kEuF2HKRWe8Y14eGLZZxFELFRg&WeEG07n38qcUvoCu61uHu2SgsgRcwnejcoDEXrPTjHc

응답은 다음과 같습니다. Open API에 대한 자세한 내용은 스토리큐 Open API 를 참조.

HTTP/1.1 200 OK
...
Content-Length: 5366
Connection: close
Content-Type: application/xml; charset=utf-8

<?xml version="1.0" encoding="UTF-8"?>
<boxes type="array">
<total_boxes type="integer">45</total_boxes>
<total_pages type="integer">9</total_pages>
<current_page type="integer">2</current_page>
<per_page type="integer">5</per_page>
<box>...</box>
</boxes>

5. 접근토큰을 이용해서 사용자의 큐 생성하기

스토리큐에 큐를 생성하기 위한 요청은 POST /slide_boxes 입니다.
Content-type은 multipart/form-data 이어야 합니다. boundary는 임의로 생성한 문자열입니다.
body에는 파라미터로 업로드 하려는 파일과 파일의 제목, 파일의 설명 등을 넣을 수 있습니다. 파라미터에 대한 자세한 내용은 스토리큐 Open API 를 참조.

그래서 요청은 다음과 같습니다.

POST /slide_boxes HTTP/1.1
Connection: close
Accept: application/xml
Content-Type: multipart/form-data; boundary=STORYQ25108725560
Authorization: OAuth realm="", oauth_nonce="5lNPDwJiO8nZpwZjYXKZaBbPzJ5dxh1SqZio7Noc4", oauth_signature_method="HMAC-SHA1", oauth_token="GNI8aT7Y5kQoGlQVH4RJ5A", oauth_timestamp="1217504044", oauth_consumer_key="8PEzPnu0I6fKnSJ0JoOCsQ", oauth_signature="U9UPIyjaiHvJqKh%2FP2flPpGKVqw%3D%0A", oauth_version="1.0"
Host: www.storyq.net
Content-Length: 173470

--STORYQ25108725560
Content-Disposition: form-data; name="slide_box[uploaded_data]"; filename="test.pdf"
Content-Type: application/octet-stream
# File Conetent
--STORYQ25108725560
Content-Disposition: form-data; name="slide_box[title]"

test
--STORYQ25108725560--

이 때 Sginature Base String은 POST 요청의 파라미터들을 포함하지 않습니다. 그래서 다음과 같습니다.

POST&http%3A%2F%2Fwww.storyq.net%2Fslide_boxes&oauth_consumer_key%8PEzPnu0I6fKnSJ0JoOCsQ%26oauth_nonce%3D5lNPDwJiO8nZpwZjYXKZaBbPzJ5dxh1SqZio7Noc4%26oauth_signature_method%3DHMAC-SHA1%26oauth_timestamp%3D1217504044%26oauth_token%3GNI8aT7Y5kQoGlQVH4RJ5A
%26oauth_version%3D1.0

주의할점

한 part는 다음과 같은 형식입니다.

--boundary
header part # Content-Disposition: form-data; name="slide_box[title]"
# new line
body part # test

각 part의 시작은 --boundary 를 사용합니다.(앞에 '--'가 붙습니다.) boundary는 header 의 Content-Type에 넣어 줍니다.
header 항목들의 구분은 ';' 혹은 new line을 이용합니다.
header part 의 마지막은 new line 2개 입니다.
마지막 part 뒤에는 --boundary-- 를 사용합니다.
new line은 "\r\n"입니다.
자세한 내용은 RFC 1867 혹은 여기 를 보세요.

그래서 javascript로 위내용을 표현하면 다음과 같습니다.

var boundaryString =     "STORYQ25108725560";
var boundary = '--' + boundaryString;
var body = boundary + "\r\n" +
       'Content-Disposition: form-data; name="slide_box[uploaded_data]"\r\n' +
       '\r\n' +
       BINARY_FILE_CONTENT + '\r\n' +
       boundary + "\r\n" +
       'Content-Disposition: form-data; name="slide_box[title]"\r\n' +
       '\r\n' +
       'test\r\n' +
       boundary + "--\r\n";

스토리큐 Open API

Wed, 17 Sep 2008 10:39:46 +0900

다음 문서는 스토리큐에서 제공하는 Open API에 대해서 설명합니다.

Open API를 통해서 스토리큐의 큐를 생성, 수정 및 삭제할 수 있습니다.

스토리큐는 사용자 인증을 위해 OAuth를 사용합니다.

스토리큐 Open API 를 이용해 매시업 애플리케이션 만들기

문서에 잘못된 내용이나 오해의 여지가 있으면 aproxacs@gmail.com 으로 알려주세요.

용어

큐 : 하나의 슬라이드를 큐라고 한다.

박스(box) : 하나의 슬라이드를 박스라고도 한다. 개발중에는 박스라고 이름지어 줬는데, 이것이 나중에 사이트 이름을 짓다가 큐로 바뀌는 바람에..

포토 큐 : 사진으로 구성된 큐

슬라이드 큐 : ppt, pdf 같은 문서를 슬라이드로 변환한 큐

알아둘 것

파라미터 중 진한 색으로 표시된 것은 필수 항목이다.

API의 요청은 URL을 통해서 합니다.

응답의 형식은 다음과 같은 방법 중 하나로 지정할 수 있습니다.

HTTP Accept 헤더를 "application/xml"로 지정합니다.
URL의 마지막(? 이전)에 .xml 확장자를 붙입니다. 이 문서에서는 이방법을 사용해서 표현했습니다.

Public API

누구나 접근할 수 있는 API. 인증을 필요로하지 않습니다.

공개된 큐의 목록 가져오기

GET /boxes.xml

파라미터

page : 페이지 수. 기본값은 1

per_page : 한 페이지에 포함되는 큐의 수, 기본값은 20

type : 큐의 종류

[photo, slide]

sort : 정렬되는 순서

[bookmark, view, comment, recent]

응답 :

아래와 같은 형식의 큐의 목록

<boxes type="array">
<total type="integer">121</total>
<total_pages type="integer">7</total_pages>
<page type="integer">1</page>
<per_page type="integer">3</per_page>
<box>...</box>
<box>...</box>
<box>...</box>
</boxes>

<box>...</box> 에 대해서는 큐의 xml 참조

기타

아래와 같은 요청을 사용할 수도 있다. 아래 요청을 사용할 경우 type을 파라미터로 지정할 필요가 없다는 것만 빼고 모두 동일하다.

GET /slide_boxes.xml

GET /photo_boxes.xml

베스트 큐들의 목록을 가져오기

GET /boxes.xml

파라미터

page : 페이지 수. 기본값은 1

per_page : 한 페이지에 포함되는 큐의 수, 기본값은 20

type : 큐의 종류

[photo, slide]

filter : 베스트 목록을 구하기 위해 적용되는 기간.

[day, week, month]

응답 :

아래와 같은 형식의 큐의 목록

<boxes type="array">
<total type="integer">121</total>
<total_pages type="integer">7</total_pages>
<page type="integer">1</page>
<per_page type="integer">3</per_page>
<box>...</box>
<box>...</box>
<box>...</box>
</boxes>

<box>...</box> 에 대해서는 큐의 xml 참조

큐의 상세 정보 가져오기

GET /boxes/ID.xml

ID의 큐를 리턴한다.

파라미터

없음

응답

성공시 큐의 xml

실패시 에러 xml

기타

단, 비공개로 되어 있는 큐는 인증을 마친 사용자만 접근 가능하다.

Private API

인증된 사용자만 사용할 수 있는 API이다. 아래 API를 사용하기 위해서는 OAuth를 통한 인증이 필요하다.

인증이 실패한 경우 HTTP Response Code는 401 Unauthorized가 리턴된다.

슬라이드 큐의 생성

POST /slide_boxes.xml

Content-Type은 multipart/form-data

파라미터

slide_box[uploaded_data] : 업로드 하려는 파일

slide_box[title] : 큐의 제목

slide_box[category] : 큐의 카테고리

slide_box[description] : 큐의 설명

slide_box[tags] : 큐의 태그, 태그와 태그는 "," 로 분리됨.

slide_box[permission] : 이 큐를 공개할 것인가?

public => 공개, private => 비공개

응답

성공시 생성한 큐의 xml

실패시 에러 xml

슬라이드 큐의 수정

PUT /slide_boxes/ID.xml

파라미터

slide_box[title] : 큐의 제목

slide_box[category] : 큐의 카테고리

slide_box[description] : 큐의 설명

slide_box[tag_list] : 큐의 태그, 태그와 태그는 "," 로 분리됨.

slide_box[permission] : 이 큐를 공개할 것인가?

응답

성공시 큐의 xml

실패시 에러 xml

로그인한 사용자의 큐 목록 가져오기

GET /boxes/mine.xml

이 요청을 한 사용자의 큐 목록을 가져온다. 비공개 및 변환중인 것들까지 모두 가져온다.

파라미터

page : 페이지 수, 기본 값은 1

per_page : 한 페이지에 포함되는 큐의 수, 기본값은 5

type : 큐의 종류

[photo, slide]

sort : 정렬되는 순서

[bookmark, view, comment, recent]

응답

큐의 목록, 공개된 큐의 목록 가져오기와 동일한 형식

기타

아래 요청을 사용할 수도 있다.

GET /slide_boxes/mine.xml

GET /photo_boxes/mine.xml

포토 슬라이드 만들기

포토 슬라이드는 다음과 같은 순서를 거쳐서 만들어 진다.

포토큐 생성
포토큐 안에 포함될 포토의 생성

포토큐의 생성

POST /photo_boxes.xml

포토큐를 생성한다.

파라미터

photo_box[title] : 포토큐의 제목

photo_box[description] : 포토큐의 설명

photo_box[category] : 포토큐의 카테고리

photo_box[tags] : 포토큐의 태그, 태그와 태그는 "," 로 분리됨.

photo_box[permission] : 이 포토큐를 공개할 것인가?

응답

성공시 생성한 포토큐의 xml

실패시 에러 xml

포토큐의 수정

PUT /photo_boxes/ID.xml

파라미터

photo_box[title] : 포토큐의 제목

photo_box[description] : 포토큐의 설명

photo_box[category] : 포토큐의 카테고리

photo_box[tags] : 포토큐의 태그, 태그와 태그는 "," 로 분리됨.

photo_box[permission] : 이 포토큐를 공개할 것인가?

photo_box[photo_array] : 슬라이드에서 사진들의 순서, ',' 로 분리된다.

예) photo_box[photo_array] = "30,31,32"

photo_box[bgm_url] : 배경음악 URL

photo_box[play_interval] : 사진과 사진의 전환 간격, 초

photo_box[play_effect] : 사진과 사진의 전환 효과, 전환효과를 주지 않기 위해서는 play_effect 를 manual로 한다.

응답

성공시 포토큐의 xml

실패시 에러 xml

포토의 생성

POST /photo_boxes/PHOTO_BOX_ID/photos.xml

포토큐에 포토(사진)을 하나 생성한다.

생성된 사진은 아직 슬라이드에 포함되지 않는다. 슬라이드에 포함되기 위해서는 포토큐의 수정을 이용해 슬라이드에 포함될 사진들을 지정해 주어야 한다.

이미지의 종류는 jpg, png, gif 만 가능하다.

파라미터

photo[uploaded_data] : 업로드할 사진

photo[title] : 사진의 제목

photo[note] : 사진의 설명, 슬라이드의 note에 포함된다.

응답

성공시 생성된 포토의 xml

실패시 에러 xml

포토의 수정

PUT /photo_boxes/PHOTO_BOX_ID/photos/PHOTO_ID.xml

포토큐의 포토를 수정한다.

파라미터

photo[title] : 사진의 제목

photo[note] : 사진의 설명, 슬라이드의 note에 포함된다.

응답

성공시 포토의 xml

실패시 에러 xml

포토의 삭제

DELETE /photo_boxes/PHOTO_BOX_ID/photos/PHOTO_ID.xml

포토큐에서 포토를 삭제한다.

파라미터

없음

응답

성공시 삭제된 포토의 xml

실패시 에러 xml

포토큐의 포토 목록 조회

GET /photo_boxes/PHOTO_BOX_ID/photos.xml

PHOTO_BOX_ID 에 등록된 사진 목록을 가져온다.

파라미터

없음.

응답

포토의 목록

큐의 삭제

DELETE /boxes/ID.xml

큐를 삭제한다.

파라미터

없음.

응답

성공시 삭제한 큐의 xml

실패시 에러 xml

기타

다음을 사용할 수도 있다.

DELETE /slide_boxes/ID.xml

DELETE /photo_boxes/ID.xml

상식이 통하는 웹사이트가 성공한다.

Tue, 09 Sep 2008 17:30:41 +0900

한 웹 페이지에 포함되어야 하는 내용

사이트 아이디
페이지 이름
현재 위치
섹션
로컬 메뉴
검색

홈페이지는

사이트의 핵심을 알기 쉽게 설명해야 한다.
어디서 시작해야 하는지 바로 알 수 있어야 한다.

일반적으로 많이 사용되는 단어를 사용해라.

익숙하지 않은 단어 사용을 자제하고, 사용할 때는 충분한 설명을 덧붙여라.

빠른 검색이 아닌 검색

가능한 구체적인 단어를 사용해라.

버튼을 버튼처럼 만들어라.

링크는 티를 내라.(보기에도, 마우스를 갖다 댈 때에도)

계층구조를 만들어라

신문처럼 헤드라인은 크게.
시각적으로 표현하기

혼란스럽지 않게 해라.

복잡한 구성을 하지 마라. 전문용어를 자제하라.

긴 설명은 하지 말도록.

미사여구 제거. 뻔히 아는 내용 제거, 꼭 필요한 말만.

페이지를 명확히 구분된 영역으로 나눠라

사용자는 사이트를 대강 본다.

탭은 좋은 것.

탭과 페이지를 연결시킬것. (같은 색, 같은 공간느낌, 선택된 것을 돋보이게 )

Fireq : 스토리큐를 위한 파이어폭스 확장기능

Tue, 09 Sep 2008 16:57:21 +0900

파이어큐는 파이어폭스에서 스토리큐를 사용할 수 있는 파이어폭스 확장기능입니다.

파이어큐를 이용해서 할 수 있는 일들은 다음과 같습니다.

스토리큐의 최신 큐들을 조회
스토리큐의 베스트 큐들을 조회 : 아직 구현 안됬습니다.
내가 올린 큐들을 조회
큐를 업로드 하기

파이어큐 사용방법

파이어큐는 여기 에서 다운받을 수 있습니다. 현재 테스트중이기 때문에 다운로드를 위해서는 로그인이 필요합니다. 사용해 보신분은 평가를 부탁드립니다.

파이어큐를 설치하고 파이어폭스를 재시작하면 하단에 파이어큐 아이콘이 보입니다.

이 아이콘을 클릭하면 사이드바에 파이어큐가 보입니다.

파이어큐 아이콘은 도구모음에도 있습니다. 도구모음은 메뉴바에서 마우스 오른쪽 버튼을 클릭한 후 사용자 지정을 눌러서 확인할 수 있습니다. 도구모음에서 파이어큐 아이콘을 꺼내서 툴바 상단에 아이콘을 위치시킬 수도 있습니다.(드래그앤 드롭)

큐 목록 조회

인증을 하지 않고도 최근 탭과 인기 탭은 사용할 수 있습니다.

최근 탭은 최근 등록된 큐들의 목록을 보여줍니다.

인기 탭은 가장 인기가 많은 큐들의 목록을 보여줍니다.

큐의 이미지 혹은 제목을 클릭하면 큐의 상세보기 페이지로 이동합니다.

상단의 최근 등록된 큐들 에 마우스를 올리면 새로고침 으로 글이 바뀝니다. 새로고침을 눌러서 목록들을 다시 가져올 수 있습니다.

인증하기

큐를 업로드하기 위해서는 인증이 필요합니다.

인증하기를 누릅니다. 그러면 파이어폭스의 탭이 하나 열리면서 스토리큐의 로그인 페이지가 보입니다. 로그인합시다. 버튼은 인증완료 로 바뀝니다.
로그인을 마치면 파이어큐를 스토리큐에서 사용허가할 것인지 물어봅니다. 허가해 줍시다.
허가를 마친 후 파이어큐의 인증완료를 누릅니다. 이제 인증이 완료되었습니다.

혹 어떤 이유에서든지 다음과 같은 창이 나온다면 인증을 다시시작해야 합니다. 일단 창의 내용은 무시해 줍니다. 그리고 위 방법에 따라 인증을 수행합니다.

인증 완료 버튼을 눌렀을 때 다음과 같은 알림창이 나온다면 알림창에서 지시하는 대로 http://www.storyq.net/oauth/... 페이지에 접속합니다. 그리고 인증하기 2번의 과정으로~.

파일 업로드

선택하기를 눌러서 파일을 선택할 수 있습니다. 혹은 업로드 하고자 하는 파일을 드래그 앤 드롭으로 파이어큐에 어딘가에 놓아도 됩니다.

제목과 설명, 태그를 넣고 확인을 눌러서 업로드를 할 수 있습니다.

앞으로 해야 할일 및 버그들

버그 혹은 개선해야 할 점을 발견하면 댓글 혹은 aproxacs@gmail.com으로 알려 주세요.

인증완료 버튼이 혼란스럽다. : 좀 더 자세한 설명 필요함.
인증 토큰을 해지해도 로그인 된 것처럼 동작할 때가 있음.
파일 형식에 pptx 추가해야 함.
큐를 누를 때 새창으로 열리지 않도록 할 수 있을까? 이미 열려 있는 창이 있다면 그것을 이용하도록.
새로고침이 너무 숨겨져 있음.
업로드 파일이 선택될 때 제목이 파일이름으로 채워지는데, 확장자는 없애도 좋다.
스토리큐 인증 페이지 : 글씨가 짤리기도 하고, link 가 이상하고.. 왜 이렇게 됬지?
스토리큐 로그인 페이지에 어떤 매시업 애플리케이션 때문에 로그인 하려 한다고 알려주기.
10 MB 이상 파일 업로드 안됨
인기 탭 구현
업로드 중 프로그레스(%)
검색

firefox 의 확장기능(extention) 만들기

Fri, 05 Sep 2008 16:29:55 +0900

파이어 폭스의 확장기능을 개발하면서 참조할만한 것들, 알게 된 것들을 모아 놓았다. 개발자를 위한 문서들의 한글화가 잘 되어 있어서 좋았다.

시작하기

파이어폭스 확장기능 만들기 에는 개괄적인 설명이 있다.

XUL로 만드는 firefox Extention 도 많은 도움이 된다.

이 슬라이드도 좋은 시작점이 될 것이다.

firefox 확장기능은 .xpi 확장자를 갖는 zip 압축 파일이다. MyExt.zip 를 다운 받아서 압축을 풀어보자. 이 디렉토리 구조가 확장기능의 구조이다.

install.rdf 파일

파이어폭스 확장기능을 설명하는 파일이다. 버젼, 개발자, 이름과 같은 여러 정보들이 포함된다. 자세한 내용은 intall.rdf 를 참조한다.

chrome.manifest 파일

확장기능이 사용하는 chrome과 overlay 에 대한 설정이 있는 파일이다. 자세한 내용은 Manifest files 를 참조.

Chrome 에 대해서

Chrome 에 대한 설명이다. 한글로 설명하기 애매해서 영문 버젼을 인용한다.

Chrome is the user interface parts of the application window that are outside of a window's content area.

Toolbars, menu bars, progress bars, and window title bars are all examples of elements that are typically part of the chrome.

UI 관련한 파일들(xul, css, js, dtd, ...)이 들어 있는 공간(디렉토리)
예를 들면 확장기능에서는 UI 관련 파일들이 있는 디렉토리를 chrome package라고 할 수 있음. 이 디렉토리를 chrome으로 이용하기 위해서는 chrome.manifest에 다음 같은 방식으로 선언이 필요함.

content sample chrome/chromeFiles/content/

종류는 conent, locale, skin 이렇게 세가지가 있다.
파이어폭스는 Chrome들을 관리하는 Chrome Manager 라는 컴포넌트를 가지고 있다. Chrome Manager는 등록된 Chrome들의 정보를 이용해 사용자 인터페이스를 설치하고 만들어낸다.

파이어폭스에서 Chrome 의 파일에 접근하기 위해서는 Chrome URL를 사용한다. (예: chrome://sample/content/browser.xul)
Chrome URL는 다음과 같이 구성된다.
- "URI_scheme://package_name/parts/path_to_file"
- chrome://sample/content/browser.xul

locale 사용하기

locale을 사용해서 다양한 언어를 지원하도록 할 수 있다. 자세한 내용은 http://developer.mozilla.org/index.php?title=Ko/Localization 참조.

다음은 한국어와 영어를 지원하는 확장기능을 만드는 과정이다.

ROOT/chrome/locale/en-US/sample.dtd,

ROOT/chrome/locale/ko-KR/sample.dtd 파일을 생성한다.

그리고 chrome.manifest에 등록한다.

locale sample en-US chrome/locale/en-US/
locale sample ko-KR chrome/locale/ko-KR/

이제 Chrome URL(chrome://sample/locale/sample.dtd)를 통해서 dtd 파일에 접근할 수 있다.

locale을 사용하는 XUL 파일, sample.xul에 다음과 같이 선언을 해 준다.

<!DOCTYPE window SYSTEM "chrome://sample/locale/sample.dtd">

sample.dtd에 필요한 locale 정보를 작성한다.

<!ENTITY registerLabel "등록">

sample.xul에서는 이렇게 사용할 수 있다.

<caption label="&registerLabel;"/>

xul에 대해서

XUL Tutorial 을 살펴보면 기본적인 것들에 대해서 알 수 있을 것이다.

더 자세한 것을 원한다면 http://developer.mozilla.org/ko/XUL 를 보자.

XUL을 이용해서 간단한 테스트를 하고 싶다면 live XUL editor 를 이용해 보자.

overlays

overlay를 이용하면 이미 존재하고 있는 파이어폭스 UI를 변경할 수 있다. 예를 들면 파이어폭스의 상태바에 확장기능의 아이콘을 추가 및 삭제할 수 있다.

overlay의 예

다음은 help메뉴에 'online' 이라는 항목을 추가하는 overlay

<overlay id="sample_overlay" xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
<menu id="help-menu">
<menupopup id="help-popup">
<menuitem id="help-online" label="online"/>
</menupopup>
</menu>
</overlay>

'help-menu' 이라는 id를 갖는 메뉴에 online 이라는 menuitem을 추한다. 만약 'help-menu'라는 id가 없으면 아무것도 하지 않는다.

toolbar 에 넣을 수 있는 아이콘을 추가하고 싶은 경우

<toolbarpalette id="BrowserToolbarPalette">
<toolbarbutton id="sample-button" image="chrome://sample/content/icons/toolbar-button.png" >
</toolbarbutton>
</toolbarpalette>

statusbar에 아이콘을 추가하고 싶은 경우

<statusbar id="status-bar">
<statusbarpanel class="statusbarpanel-iconic" id="sample-status" src="chrome://sample/content/icons/toolbar-button.png" />
</statusbar>

도구 메뉴에 추가하고 싶은 경우

<menupopup id="menu_ToolsPopup">
<menuitem label="sample" insertafter="devToolsSeparator" oncommand="alert('why?');" />
</menupopup>

사이드바 만들기

http://developer.mozilla.org/index.php?title=En/Creating_a_Firefox_sidebar

http://developer.mozilla.org/en/Code_snippets/Sidebar

broadcaster 와 observe는 무엇인가?

http://developer.mozilla.org/En/XUL_Tutorial/Broadcasters_and_Observers

browser.js 에 있는 toggleSidebar() 함수를 이용해서 사이드바를 보이고 사라지게 할 수 있다.

Tips

firefox 의 주소창에 about:config을 치면 firefox의 환경설정(preference)를 볼 수 있음.

xpath 사용하기 : http://developer.mozilla.org/Ko/Using_XPath

DOM inspector를 이용하면 XUL 의 DOM 구조를 쉽게 확인할 수 있다.

개발중 테스트하기

기본 프로파일 디렉토리로 이동한다. 윈도우에서는 아마도 "C:\Documents and Settings\...\Application Data\Mozilla\Firefox\Profiles\xxxxx.default" 일 것임.

extentions 폴더로 이동해서 파일을 하나 생성한다. 파일 이름은 확장기능의 id로 한다. 파일의 내용은 확장기능이 위치하고 있는 디렉토리 이름이다.
예) c:\sample\
firefox를 재시작하면 개발중인 확장기능을 도구>부가기능 메뉴을 통해서 볼 수 있다.
chrome URI를 통해서 개발중인 xul파일에 접근할 수 있다. chrome URI를 이용할 수도 있지만, xul 파일을 드래그 앤 드롭으로 파이어폭스에 가져다 놓아도 된다. chrome URI 보다 드래그 드롭으로 하는 것이 더 좋은데, 왜냐하면 변경된 내용이 새로고침했을 때 바로 적용되기 때문이다.

프로파일에 대해서는 [firefox] profile 이용하기 참조.

배포하기

zip 으로 압축한 후 확장자를 xpi로 바꾼다. 압축할 때는 알집을 사용하지 말고 마우스 오른 버튼 클릭해서 나오는 메뉴의 보내기 > 압축폴더 를 이용하도록 하자. 알집으로 하면 안된다.

.xpi 파일을 부가기능 목록에 드래그 앤 드랍 하면 확장기능이 설치된다. 이렇게 테스트가 마쳐졌으면 http://addons.mozilla.org/developers/ 페이지에 확장기능을 등록한다. 정식으로 공개되기까지는 테스트가 필요하다.

[firefox] profile 이용하기

Thu, 04 Sep 2008 23:40:26 +0900

파이어폭스에서 프로파일(Profile)은 무엇인가?

북마크, 환경설정, 플러그인(부가기능) 같은 모든 정보를 모아 놓은 곳이다.
프로파일은 특정 디렉토리에 위치하고 있는데 윈도우에서는 아마도 "C:\Documents and Settings\...\Application Data\Mozilla\Firefox\Profiles" 일 것이다.
파이어폭스가 설치되면 프로파일 디렉토리에 xxx.default 와 같은 기본 프로파일 디렉토리가 생성된다. 그리고 이곳에 추가하는 플러그인, 비밀번호, 북마크 등등이 기록된다.
보통의 경우에는 파이어폭스는 기본프로파일로 구동된다. 즉 사용자는 프로파일이 무엇인지 알 필요가 없다.
프로파일을 여러 개 생성하고 관리할 수 있는데, 그럼으로써 몇가지 장점을 얻을 수 있다.
- 파이어폭스를 처음 설치한 상태로 돌아가고 싶을 때 새 프로파일을 생성하고 파아이폭스를 생성한 새 프로파일로 구동하면 된다.
- 여러가지 환경으로 파이어폭스를 구동시킬 수 있다. 예를 들어 플러그인을 개발중인 경우에는 개발 전용 프로파일을 사용한다면, 개발에 특화된 환경으로 파이어폭스를 구동시킬 수 있고, 개발도중 중요한 프로파일 데이터를 삭제하는 실수를 저질러도 기본 프로파일에는 아무 문제 없다.
- 프로파일을 다른 곳에 복사함으로써 파이어폭스의 환경을 백업할 수 있다.

프로파일 생성하기

파이어 폭스를 모두 닫은 상태에서 "시작 > 실행(Run)"을 실행시킨 후 다음 명령을 입력한다.

firefox -ProfileManager

그러면 프로파일 관리자가 등장하고, 이를 이용해 프로파일을 생성/수정/삭제할 수 있다.

위와 같이 chang이라는 프로파일을 생성하면 프로파일 디렉토리 밑에 xxxx.chang이라는 프로파일 디렉토리가 생기는 것을 확인할 수 있다. xxxx는 파이어폭스가 임의로 생성된 8자리 문자이다. 생성한 프로파일을 선택하고 firefox 시작하기를 누르면 생성한 프로파일로 파이어폭스가 구동된다.

참조

firefox profile tutorial