notoma

Нотома

Пишите статьи для своего статического блога в Notion.

• Сайт документации
  • Использование интерфейса командной строки
  • Содействие
  • Поддерживаемые теги Markdown

---

Установить

Notoma доступна через Pip или Homebrew:

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

Установка с помощью Homebrew на Mac OS.

brew install nategadzhi/notoma/notoma

---

Что вы можете сделать с Notoma

Notoma предоставляет команды для:

• Преобразуйте содержимое вашей базы данных Notion Blog в набор файлов Markdown.
• Скоро : следите за обновлениями в базе данных Notion Blog и восстанавливайте файлы Markdown при любых обновлениях.
• Скоро : создайте новую базу данных Notion для своего блога со всеми необходимыми полями.

Базовый пример использования: эта команда преобразует только опубликованные сообщения из базы данных блога Notion в ./posts/ directory .

notoma convert --dest ./posts/

В этом примере предполагается, что у вас есть файл конфигурации .env с параметрами аутентификации и URL-адреса блога.

Аутентификация в понятии

Notoma использует внутренний API Notion, и это, к сожалению, требует от вас предоставления токена аутентификации token_v2 , который вы можете найти в файлах cookie notion.so.

Вы можете предоставить параметр token_v2 для каждого вызова командной строки или сохранить его в своей среде или в файле конфигурации .env .

---

Структура базы данных понятий

У Notoma очень мало ожиданий относительно структуры вашего Notion. Вот общедоступный пример базы данных.

Notoma требует, чтобы ваша база данных блога Notion имела следующие свойства :

• Опубликовано : опубликована ли статья или она все еще является черновиком.
• Заголовок : будет использоваться для создания имени файла, эквивалентного файлу Markdown этой статьи. В самой статье использоваться не будет.

Notoma пытается проанализировать другие свойства и добавить их в качестве заголовка в полученные статьи Markdown:

• Дата публикации будет использоваться в качестве даты публикации статьи, если таковая имеется.
• Категории будут использоваться в качестве основного ключа categories , поэтому ожидается, что это будет свойство с множественным выбором .