notoma

노토마

Notion에서 정적 생성 블로그에 대한 기사를 작성하세요.

• 문서 웹사이트
  • CLI 사용
  • 기여
  • 지원되는 마크다운 태그

---

설치하다

Notoma는 Pip 또는 Homebrew를 통해 사용할 수 있습니다.

 # Installing with pip, use this if you plan using Notoma as a python library.
pip install notoma

Mac OS에서 Homebrew를 사용하여 설치.

brew install nategadzhi/notoma/notoma

---

노토마로 무엇을 할 수 있나요?

Notoma는 다음과 같은 명령을 제공합니다.

• Notion Blog 데이터베이스의 콘텐츠를 Markdown 파일 묶음으로 변환하세요.
• 출시 예정 : Notion Blog 데이터베이스에서 업데이트를 확인하고 업데이트 시 Markdown 파일을 재생성하세요.
• 출시 예정 : 모든 필수 필드를 포함하여 블로그용 새 Notion 데이터베이스를 생성하세요.

기본 사용 예: 이 명령은 Notion 블로그 데이터베이스에서 게시된 게시물만 ./posts/ directory 로 변환합니다.

notoma convert --dest ./posts/

이 예에서는 인증 및 블로그 URL 매개변수가 포함된 .env 구성 파일이 있다고 가정합니다.

Notion에서 인증하기

Notoma는 내부 Notion API를 사용하며, 안타깝게도 notion.so 요리에서 찾을 수 있는 인증 토큰 token_v2 제공해야 합니다.

모든 명령줄 호출에 token_v2 옵션을 제공하거나 이를 환경 또는 .env 구성 파일에 저장할 수 있습니다.

---

노션 데이터베이스 구조

Notoma는 Notion의 구조에 대해 거의 기대하지 않습니다. 다음은 공개 예제 데이터베이스입니다.

Notoma에서는 Notion 블로그 데이터베이스에 다음 속성이 필요합니다.

• 게시됨 : 기사가 게시되었는지 또는 아직 초안인지 여부
• 제목 : 해당 기사의 Markdown 해당 파일에 대한 파일 이름을 만드는 데 사용됩니다. 기사 자체에서는 사용되지 않습니다.

Notoma는 다른 속성을 구문 분석하여 결과 Markdown 기사의 머리말로 추가하려고 합니다.

• 게시 날짜는 해당 기사의 게시 날짜로 사용됩니다(있는 경우).
• 카테고리는 categories 서문 키로 사용되므로 객관식 속성이 될 것으로 예상됩니다.