Metadata-Version: 2.1
Name: tistory-cli
Version: 0.1.3
Summary: The simplest command line tool for Tistory, the Korean blogging platform
Home-page: https://github.com/dgkim5360/tistory-cli-python
Author: Don Kim
Author-email: dgkimdev@gmail.com
License: UNKNOWN
Description: # Tistory-CLI
        
        A simplest command line tool for Tistory, the Korean blogging platform. It conveys Markdown files to your Tistory blog.
        
        This project is currently in alpha stage and supports the minimal features: To post an article. It supports Linux only.
        
        한국 Tistory 사용자를 위한 도구이므로 앞으로 한글로 설명합니다.
        
        ## Dependencies
        
        Linux SecretStorage 기능을 위해 다음과 같은 패키지가 필요합니다.
        * libsecret
        * gnome-keyring
        
        대부분의 Linux 배포판에서 기본적으로 설치가 되어있을 것입니다. Arch Linux의 경우에는 gnome-keyring이 기본으로 설치되지 않으므로 따로 설치해야 합니다.
        
        ## Installation
        
        `pip`를 통해서 쉽게 설치 가능합니다. 시스템 환경 또는 원하는 가상 환경에서
        ```sh
        $ pip install tistory-cli
        ```
        
        또는 소스에서 직접 설치하려면 (역시나 원하는 환경에서)
        ```sh
        $ git clone https://github.com/dgkim5360/tistory-cli-python.git
        $ cd tistory-cli-python
        $ python setup.py install
        ```
        
        ## Features and Non-features
        
        * 본인의 client/secret key를 사용해서 직접 로그인하므로, 외부 서비스에 비밀 정보를 남기지 않습니다.
        * 소스코드, 환경변수 등에 credential를 저장하지 않고, [운영 체제 레벨의 비밀 저장소](https://specifications.freedesktop.org/secret-service)에 저장합니다.
        * Git commit message 스타일로 제목/내용 구분해서 Markdown 파일을 작성해서 Tistory에 비공개글로 업로드합니다.
        * 카테고리와 slug는 설정 가능합니다.
        * 공개글로 업로드 __하지 않습니다__.
        * 이미지 업로드 __하지 않습니다__.
        * 태그 추가 __하지 않습니다__.
        
        ## Oauth Setting
        
        1. Tistory --> 가이드 --> 오픈API 가이드 --> 클라이언트 등록
        2. Callback 경로를 `http://localhost:8888`(기본값, 다른 포트를 원할 시 `.redirect-uri` 파일에 해당 주소를 일치하게 써 놓으면 됨)로 설정해서 클라이언트 등록을 완료합니다.
        3. `tistory login` 실행하면 (OS 계정 비밀번호를 요구할 수도 있습니다), 로그인할 페이지를 콘솔에 띄워줍니다.
        4. 브라우저로 해당 주소로 들어가서 Tistory 로그인을 해서 API 토큰을 받아옵니다.
        5. 콘솔에 다음과 같이 나오면 로그인이 끝납니다.
        
        ## Usage
        
        ```sh
        $ tistory
        USAGE:
            tistory login
            tistory logout
            tistory purge
        
            tistory category <blog_name>
            tistory post <blog_name> <category_id> <file_path>
        ```
        
        * `tistory login`: 모든 비밀 정보가 있는 지 확인하고 없으면 로그인을 시킵니다.
        * `tistory logout`: Secret key만을 지웁니다.
        * `tistory purge`: 모든 비밀 정보를 지웁니다.
        * `tistory category`: 해당 블로그의 카테고리 아이디 정보를 받아옵니다.
        * `tistory post`: 파일을 읽어서 해당 블로그 및 카테고리에 비공개 글로 업로드합니다.
        
        ## Step-by-step Tutorial
        
        1. 로그인을 합니다 (Oauth Setting 참조).
        2. `tistory category <blog_name>`을 통해 본인 블로그의 카테고리 아이디를 확인합니다.
        3. `<slug>.md` 파일을 Git commit message처럼 작성합니다 (첫 줄 제목, 한 줄 띄우고 내용 시작). 글 내용은 Markdown 형식에 맞추어 작성합니다.
        4. `tistory post <blog_name> <category_id> <slug>.md`로 포스팅을 한 후, Tistory에서 확인합니다.
        5. 추가적으로 필요한 이미지 업로드, 태그 추가, 공개 설정은 Tistory에서 해결합니다.
        
Keywords: Command Line Tool,Tistory,Markdown,blogging
Platform: UNKNOWN
Description-Content-Type: text/markdown
