[mdtistory] 사용 매뉴얼

작성일 Edited on In , 댓글: Views:

mdtistory 사용 매뉴얼

1. 프로그램 소개

마크다운을 이용하여 작성된 문서를 티스토리로 배포한다.

2. 사용환경

  • OS
    • 현재 linux 에서의 환경에서만 테스트되었습니다.
    • windows 환경에서의 동작은 보장하지 못합니다.
  • python version
    • python3 에서만 테스트되었습니다.
    • python2 환경에서의 동작은 보장하지 못합니다.

3. 설치하기

아직 setup.py 를 설정하지 않았습니다. 수동으로 설치 바랍니다.

3.1. python module install

각종 파이썬 모듈을 설치합니다.

1
2
3
4
sudo pip3 install pytistory
sudo pip3 install markdown
sudo pip3 install markdown-captions
sudo pip3 install click

3.2. pandoc install

티스토리의 웹페이지를 저장할때 pandoc 을 이용합니다.

1
sudo apt-get install pandoc

4. tistory api 등록하기

작성중…

5. 마크다운

5.1. asset folder 지정

작성중…

5.2. markdown meta 정보 (yaml)

작성중…

6. cli 사용

기본적으로 cli 를 이용하여 동작을 시킵니다.

6.1. config 파일

cli 명령어를 사용하기위해서는 config 파일이 필요합니다. (기본정보 포함)

1
2
3
4
[tistory]
apikey=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
blog_name=blog_name
base_folder=target_folder
  • apikey : tistory api key
  • blog_name : 블로그의 이름 (글을 작성할 블로그이름)
  • base_folder : 동작기준이되는 local folder path

6.2. 블로그 정보 획득 (카테고리정보획득)

6.3. 블로그 게시글 백업

6.4. 블로그 게시글 업로드(스캔)

7. meta file

각 [파일명].assets 폴더 혹은 각 폴더의 최상단에 json 형식의 meta file 이 있습니다. 각각의 메타파일은 파일의 정보 혹은 폴더 정보들이 작성되며 프로그램동작시 자동으로 생성, 삭제, 업데이트 됩니다.

메타파일을 확인하여 해당 파일들의 업데이트 상태나, 웹경로 등등 정보를 확인할 수있습니다.

7.1. post meta

작성중…

7.2. folder meta

작성중…

7.3. attach meta

작성중…

8. 개선예정사항

0%