Textcube : Brand yourself!

텍스트큐브 1.5.1 정식 버전을 발표합니다.

안내

이번 업데이트는 1.5 사용자 분들 대상의 필수 업데이트입니다.
1.5에서 1.5.1로의 업그레이드를 위해서는 1.1.3에서 1.5로의 업그레이드 절차등을 생각하실 필요 없이 그냥 파일을 덮어 씌우시면 됩니다.

이번 업데이트에서는

• 50여가지가 넘는 버그가 해결 되었습니다.
• 1.5보다 더 빨라졌습니다.
  
• 그 외 몇몇 아직 불편하다고 건의된 부분이 개선되었습니다.

또한 1.5에서 '메타 페이지metapage'였던 기능이 '표지cover'로 이름을 바꾸면서 스킨 치환자 부분이 바뀌었습니다. 1.5에서 사용하던 메타 페이지 관련된 스킨 부분은 그 부분을 처리하는 코드가 가볍게 바뀐 관계로 1.5.1부터 지원하지 않습니다. 이 점 양해 부탁 드립니다.

메타 페이지 -> 표지 관련한 마크업 변경

• <s_cover> : 표지 영역
• <s_cover_rep> : 표지 플러그인 출력의 반복 영역
• [##_cover_content_##] : 표지 플러그인 출력 부분

아래는 예제입니다.

               <s_cover>
               <div class="coverpage">
                   <s_cover_rep>
                       <div class="coverContents">[##_cover_content_##]</div>
                   </s_cover_rep>
               </div>
               </s_cover>

자세한 변경 사항은 프로그램 내의 doc/changes_ko 파일을 참조하시거나, 변경 기록을 참조하시기 바랍니다.

관련 문서 링크

Textcube : 안녕하세요! 텍스트큐브입니다.
Textcube : 얼굴이 확 달라졌어요
Textcube : 더 나은 커뮤니케이션을 위한 연필~
Textcube : 더 빨리 달려라!


텍스트큐브 온라인 도움말 위키 (언제든 관리자 화면 오른쪽의 '도우미'를 누르세요)
설치 요구 사양
텍스트큐브 1.5 설치 및 업그레이드 시 주의사항
설치 방법
업그레이드 방법
환경 설정 가능 옵션 (전문가용)


스킨 태그 정리
에디터에서 스킨 태그를 보여주기 위한 wysiwyg.css 설명
플러그인 이벤트 정리
스킨 제작 안내


텍스트큐브 개발 및 저장소
텍스트큐브 1.5.1 로드맵
개발 참고 문서


태터 네트워크 재단 / 태터앤 프렌즈 포럼
Needlworks
Needlworks 블로그


텍스트큐브 메인 사이트는 텍스트큐브 전용 웹보드 및 기반 시스템이 완성 되는대로 곧 문을 열 예정입니다.

아래는 다운로드 링크입니다.
기본팩 (.tar.gz) / (.zip)
확장팩 (.tar.gz) / (.zip)

주말동안 Needlworks와 TNC가 토의한 몇가지 논의에 대한 회의록입니다.
원본은 포럼 공지사항에서 확인할 수 있습니다.

Needlworks / TNC 공동 토의 내용

1. ttxml 논의 관련

현재 기존의 태터툴즈에서 파생된 서비스들이 다수 존재합니다. 이 경우 1.1에 머무르고 있으며 ttml 종속성이 강한 ttxml 규약을 어떻게 확장해 나갈 것인지에 대한 논의가 필요합니다. 기술적인 부분에서 다양한 아이디어 및 시도가 이루어지고 있으며, 표준을 어떻게 정립할 것인지에 대한 절차적 확립이 필요합니다.

이를 위하여 ttxml 규약의 드래프트 및 획정을 위한 논의가 이루어지는 자리가 필요합니다. 현재 존재하고 이후 늘어날 ttxml 지원의 모든 프로그램 및 텍스트큐브 기반 프로그램들이 영향을 받게 되므로, 포럼에서의 논의와 함께 밀도 있는 논의를 할 회의의 필요성이 있습니다. 회의에 대한 구체적인 내용은 이후 포럼에서 논의를 시작하며, 논의들이 정리 된 후 오프라인 회의를 통하여 규격을 확정해 나가는 것으로 합니다.

2. 스킨 규격 관련

현재 스킨 규격은 TC 1.5 기준으로 하여 1.0대부터 상하위 호환성의 보장을 목표로 설계되어 있습니다 . 하지만 티스토리 / 태터툴즈 1.1 / 텍스트큐브 1.5의 스킨 스펙이 각 서비스 및 프로그램의 요구에 따라 약간씩 달라지는 부분이 있습니다. 이러한 부분은 스킨 제작자에게 부담을 가중시키게 됩니다. 이후 스펙이 더 달라지는 것 이전에 상호간의 스킨 스펙을 완전히 일치시켜야 하며, 새로운 규약을 제정시에 각 주체들이 통일된 스펙에 따라 구현하기 위한 절차적 방법이 필요합니다. 텍스트큐브 2.0이 드래프트 작업 중이기 때문에 이러한 부분이 빨리 정리되어야 할 필요가 있습니다. ttxml과 같은 절차를 거쳐 최종적인 논의를 하도록 합니다.

3. 이올린 관련

현재 TNC가 주관하고 있는 이올린의 포지션을 textcube 안으로 끌고 들어오는 것에 대한 논의가 있었습니다. 태터툴즈 1.0 이전의 '태터센터'와 같이 textcube center로 만들어 현재 아침놀님이 제작중인 텍스트큐브 사이트의 하위 또는 그 일부로 위치를 재정립하는 부분에 대하여 전체적인 가능성을 테스트하기로 하였습니다. 이 부분에 대하여 확정된 부분은 없습니다.

Needlworks의 내부 회의

1. 개발 관련 절차 업데이트

TNF 포럼의 크기와 함께 개발 관련 메일링 리스트가 늘어남에 따라 정리가 필요하게 되었습니다. 절차적 정리는 올해 2월에 최종 수정이 되었으며 ( http://forum.tattersite.com/ko/viewtopic.php?id=2833 ) 현재의 메일링 리스트 (dev / dev-commit / paint / i18n / doc / tester) 및 변경된 부분에 따라 위 내용의 개편이 있을 예정입니다.

2. 텍스트큐브 개발 사이트 reporter및 developer 절차 정리

현재의 텍스트큐브 개발 사이트의 reporter와 developer 등록 절차를 다음과 같이 개편합니다.

3. Needlworks의 구성원 관련

Needlworks 의 경우 자칫 흐려지기 쉬운 목표를 유지하고, 구성원의 수에 따라 영향받을 수 있는 TNF의 속도를 지속적으로 유지하기 위한 조직입니다. 목표가 명확한 조직이므로 인원이 많을 경우 최종 의사결정 과정의 속도가 영향을 받게 됩니다. 또한 방향성 부분에서 각론이 문제가 될 수 있습니다. 따라서 developer 또는 각 분야의 메일링리스트 대표분들 중에서 목표를 공유하고 여가를 희생하실 수 있는 분들에 한하여 이후 상황에 따라 삽질하실 분들이 추가됩니다. 혼란을 막기 위하여 당분간 현재 구성원의 변화는 없을 예정입니다.

4. 텍스트큐브 2

현재 티켓팅이 진행되고 있으며 이후 가지치기 과정이 있을 예정입니다. 회의에서 몇가지 근본적인 관점의 변화에 대한 논의가 있었습니다. 또한 NW/TNF가 블로그 서비스를 운영할 역량이 되는지에 관하여 논의가 있었습니다.

태터툴즈 1.1용 스킨은 텍스트큐브 1.5와 호환되며,  태터툴즈 1.1 플러그인의 대부분은 텍스트큐브 1.5와 호환됩니다.

• 동작하지 않는 플러그인의 대응을 위한 방법
• 텍스트큐브 1.5에서만 사용할 수 있는 스킨 치환자 및 개선점

의 경우, 텍스트큐브 배포판의 doc 디렉토리의 changes_ko 파일에서 설명하고 있습니다.

아래는 텍스트큐브 1.5와 함께 묶어 배포된 changes_ko의 변경사항 내역입니다. 같은 내용을 텍스트큐브 1.5의 doc/changes_ko에서 읽으실 수 있습니다.

목차

• 스킨 관련 변경점 및 추가 안내
• 플러그인 관련 변경점 및 추가 안내
• BlogAPI 관련 변경점 및 추가 안내
• 환경 설정 파일 관련 변경점 및 추가 안내

스킨 관련 변경점 및 추가 안내

metapage Part 추가

  블로그에 프롤로그 기능을 포함하여 다양한 기능을 가진 페이지를 더할 수 있는 메타페이지 플러그인이 추가 되었습니다. 이 기능을 사용하기 위하여 출력되는 영역을 지정하는 metaPage 가 스킨 문법에 추가되었습니다.

    * <s_meta> : 메타페이지 영역
      * <s_metapage> : 메타페이지 플러그인 및 구성요소 출력 반복 영역

아래는 예제입니다.

<s_meta>

    <div class="metapage">
        <s_metapage></s_metapage>
    </div>
</s_meta>

태그와 키워드의 통합

키워드 기능을 사용할 때, 같은 이름을 가진 태그가 있으면 해당 태그 페이지를 보여줄 때 키워드 설명을 먼저 보여주도록 할 수 있습니다. 이를 위하여 스킨에서

• <s_keylog_rep>
• [##_keylog_rep_title_##]
• [##_keylog_rep_desc_##]
  

치환자가 추가 되었습니다.

아래는 예제입니다.

             <s_keylog_rep>
                 <div class="entryKeylog">
                     <div class="titleWrap">
                         <h2>[##_keylog_rep_title_##]</h2>
                     </div>
                     <div class="article">
                         [##_keylog_rep_desc_##]
                     </div>
                </div>
            </s_keylog_rep>

404 에러 관련

 페이지가 없을 때 출력되는 페이지를 스킨에서 추가적으로 지정할 수 있습니다. <s_page_error>로 묶은 부분이 에러 발생시에 출력됩니다. 스킨에 해당 부분이 없을 경우에는 1.5 이전과 똑같이 동작합니다.

트랙백 검색 관련 스킨 치환자

  트랙백 검색 결과 출력을 위한

• [##_tblist_conform_##]
• [##_tblist_count_##]
• <s_tblist>
• <s_tblist_rep>
•  [##_tblist_rep_regdate_##]
• [##_tblist_rep_link_##]
• [##_tblist_rep_subject_##]
• [##_tblist_rep_body_##]

가 추가되었습니다.

아래는 예제입니다.

제목 표시 부분 추가

 제목의 모양과 표시될 때의 상태에 따라 자유롭게 변경할 수 있습니다. (더이상 :: 을 보지 않으셔도 됩니다. 이에 따라 

• 상황에 따라 제목이 변하는 영역을 의미하는 <s_page_title>
• 현재 페이지에서 보여주는 포스트 이름인 [##_page_post_title_##]

이 추가되었습니다.

아래는 예제입니다.

플러그인 관련 변경점 및 추가 안내

플러그인 이름 변수

 기존의 변수들($pluginURL, $pluginPath)에 플러그인의 이름을 가져올 수 있는 변수인

• $pluginName

이 추가되었습니다.

플러그인 설정 component 제공

 index.xml을 통한 텍스트큐브의 설정 메뉴 대신 설정 프로그램 자체를 만들 수 있습니다. 이 경우 Textcube.Model.PluginCustomConfig 컴포넌트를 사용하면 됩니다. index.xml의 manifest에서 config 바인더를 사용하지 않는 경우 컴포넌트를 사용할 수 있습니다.
 
 인터페이스는 다음과 같습니다.
 

PluginCustomConfig{
         /* public bool*/
         function load(){
        /* public string null*/
        function getValue($name){
        /* public bool*/
        function setValue($name , $value){
        /* public array null */
        function getAllValue(){
        /* public bool */
        function setMergedValue( /* array */ $configVal ){
        /* public bool */
        function setAllValue(/* array */ $configVal ){

플러그인에서 접근할 수 있는 필드명 변경

 
기존에 플러그인이 블로그를 구분하기 위하여 사용되었었던 owner 필드가 blogid (또는 경우에 따라 userid) 필드로 변경되었습니다. 기존의 태터툴즈 플러그인을 텍스트큐브에서 사용하기 위해서는 위 필드 호출 부분을 변경해야 합니다.

만약 데이터베이스 입출력이 컴포넌트의 DBQuery 클래스로 규격화되어 있다면, 호환성을 위하여 루트 디렉토리의 config.php에

• $service['useLegacySupport']

를 true로 주어서 임시로 호환성을 개선할 수 있습니다.

index.xml의 requirement 필드의 privilege 안내

 용도에 따라 전체 관리자만이 사용할 수 있는 플러그인을 지정할 수 있습니다. 전체 관리자만을 위한 플러그인이라면 <requirement> 안에 <previlege>를 지정하고, administrator를 명기하면 됩니다.
 따라서
 와 같이 지정할 수 있습니다.

 또한 플러그인에서 현재 블로그가 전체 메타 페이지인지 개인 블로그인지 구분해서 동작하기 위해서는 misc::isMetaBlog를 사용하실 수 있습니다. misc::isMetaBlog() 의 값이 true이면 전체 블로그들의 메타 페이지 입니다.

   requireComponent('Textcube.Function.misc');
   $isMetaBlog = misc::isMetaBlog();

 와 같이 사용하면 됩니다.

관리자 플러그인의 도움말 편집

 
텍스트큐브 도움말 위키를 이용하여 관리자 플러그인들의 도움말 페이지를 만들 수 있습니다. 관리자 화면의 메뉴 막대 우측의 '도우미' 링크가 이제는 관리자 플러그인 화면인 상태에서도 현재 관리자 플러그인 주소로 링크되어 동작합니다. 위키에 사용자 등록을 하신 후 도움말 페이지를 등록할 수 있습니다.
 
 

BlogAPI 관련 변경점 및 추가 안내

BlogAPI 전용 비밀번호 설정 기능

 BlogAPI를 사용하여 글을 작성하실 경우 로컬 프로그램을 사용하는 경우는 관계없지만 다른 서비스를 글 에디터로 사용하는 경우가 있습니다. 이 경우 본인의 블로그 암호를 해당 서비스에 노출하고 싶지 않은 경우를 위하여 BlogAPI에만 적용되는 비밀번호를 따로 지정할 수 있습니다. '환경설정'-'글 작성' 의 글 작성 환경 설정에서 비밀번호를 지정하시면 됩니다.

카테고리를 지원하지 않는 클라이언트에도 카테고리를 지원

 기존의 BlogAPI는

•    http://blog.example.com/api

 형태의 XMLRPC server url이 존재합니다. 클라이언트 중에서 카테고리를 지정하지 않고 글만 작성하는 경우가 있습니다. 예를 들어 me2day에서 전송해 오면 카테고리가 지정되지 않아 '분류없음' 으로 등록이 되고, 알라딘의 ttb의 경우 category가 Aladdin으로 전송되어 옵니다. 이렇게 클라이언트가 약간 기능이 부족하여 카테고리 지정으로 인한 다양한 기능을 사용하지 못하는 것을 만회하기 위해 다음과 같은 BlogAPI 주소를 사용할 수 있습니다.

1. http://blog.example.com/api?category=mycategory
   
2. http://blog.example.com/api?category=%EC%9E%A1%EC%83%9D%EA%B0%81
   
3. http://blog.example.com/api?category=2

 위와 같이 category 라는 변수 뒤에 UTF-8으로 카테고리명을 지정하면, 클라이언트가 지정하거나 혹은 지정하지 않는 경우에라도 강제로 설정하는 기능입니다. 즉, 해당 카테고리에 posting하는 BlogAPI xmlrpc service url이 되는 것입니다.

 3)의 예는 현재는 카테고리 이름만으로 구별하는데, 만약 UTF-8 문자열을 구하기 어렵거나 한글에 애로사항이 생길 경우 내부 식별자인 숫자로도 지정할 수 있습니다. 내부 식별자를 알 수 있는 방법은 "관리자>글>분류관리" 메뉴에서 미리보기의 카테고리를 눌렀을 때 주소창에 다음과 같이 나옵니다.
 http://blog.example.com/owner/entry/category/?'''id=10'''&entries=2&priority=5&name1=%ED%94%84

 이러한 부분이 어려울 수 있기 때문에 해당 기능을 간단하게 지원하기 위한 도우미가 추가 되었습니다. '환경설정' 의 '글 작성' 목록에서 카테고리를 선택하면 그에 해당하는 BlogAPI 글 보내기 링크가 자동으로 생성되어 출력되므로 그 링크를 사용하시면 됩니다.
 

환경 설정 파일 관련 변경점 및 추가 안내

config.php에서 가능한 설정 값들은 doc/config 에서 확인할 수 있습니다.

RSS 주소 기본값의 숫자 변경

 RSS로 출력되는 주소값은 관리자 모드에서 결정한 값 (문자/숫자)을 따라갑니다. 설정에 관계없이 무조건 숫자로 출력하기 위해서는 루트 디렉토리의 config.php에

$service['useNumericURLonRSS'] = true;

 를 추가하면 됩니다.

정적 페이지 캐시 기능 끄기

 1.5에서 도입된 정적 페이지 캐시 기능을 끌 수 있습니다. 루트 디렉토리의 config.php에

$service['disablePageCache'] = false;

를 추가하면 됩니다.

디버그 모드

1.5에서는 전용 디버그 모드를 가지고 있습니다.

requireComponent('Needlworks.Function.Debug');

를 설치 디렉토리에 생성된 config.php에 추가하면 디버그 모드가 동작하게 됩니다.

더 자세한 내용을 위해서는 config에서 가능한 명령 목록을 참조하시기 바랍니다.