notoma

notoma

Escribe artículos para tu blog de generación estática en Notion.

• Sitio web de documentación
  • Usando la CLI
  • Contribuyendo
  • Etiquetas de rebajas admitidas

---

Instalar

Notoma está disponible a través de Pip o Homebrew:

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

Instalación con Homebrew en Mac OS.

brew install nategadzhi/notoma/notoma

---

¿Qué puedes hacer con Notoma?

Notoma proporciona comandos para:

• Convierta el contenido de su base de datos de Notion Blog en un montón de archivos Markdown.
• Próximamente : mire la base de datos de Notion Blog para obtener actualizaciones y regenerar archivos Markdown en cualquier actualización.
• Próximamente : cree una nueva base de datos de Notion para su blog con todos los campos obligatorios.

Ejemplo de uso básico: este comando convertirá solo las publicaciones publicadas desde una base de datos de blog de Notion al ./posts/ directory .

notoma convert --dest ./posts/

Este ejemplo supone que tiene un archivo de configuración .env con parámetros de autenticación y URL del blog.

Autenticación en Notion

Notoma utiliza una API interna de Notion y, desafortunadamente, requiere que proporciones un token de autenticación token_v2 que puedes encontrar en tus cookies de notion.so.

Puede proporcionar la opción token_v2 a cada llamada de línea de comando o almacenarla en su entorno o en el archivo de configuración .env .

---

Estructura de la base de datos de nociones

Notoma tiene muy pocas expectativas sobre cómo está estructurado su Notion. Aquí hay una base de datos de ejemplo pública.

Notoma requiere que la base de datos de su blog Notion tenga las siguientes propiedades :

• Publicado : si el artículo está publicado o aún es un borrador.
• Título : se utilizará para crear un nombre de archivo para el archivo equivalente a Markdown de ese artículo. No se utilizará en el artículo en sí.

Notoma intenta analizar otras propiedades y agregarlas como portada en los artículos de Markdown resultantes:

• Publicado en se utilizará como fecha de publicación del artículo, si está presente.
• Las categorías se utilizarán como clave inicial categories , por lo que se espera que sea una propiedad de opción múltiple .