notoma

Notoma

Escreva artigos para seu blog de geração estática no Notion.

• Site de documentação
  • Usando a CLI
  • Contribuindo
  • Tags de redução suportadas

---

Instalar

Notoma está disponível via Pip ou Homebrew:

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

Instalando com Homebrew no Mac OS.

brew install nategadzhi/notoma/notoma

---

O que você pode fazer com Notoma

Notoma fornece comandos para:

• Converta o conteúdo do banco de dados do Notion Blog em vários arquivos Markdown.
• Em breve : observe o banco de dados do Notion Blog para atualizações e gere novamente arquivos Markdown em qualquer atualização.
• Em breve : Crie um novo banco de dados Notion para o seu Blog com todos os campos obrigatórios.

Exemplo de uso básico: este comando converterá apenas postagens publicadas de um banco de dados de blog do Notion para o ./posts/ directory .

notoma convert --dest ./posts/

Este exemplo pressupõe que você tenha um arquivo de configuração .env com parâmetros de autenticação e URL do blog.

Autenticando no conceito

Notoma usa uma API Notion interna e isso, infelizmente, exige que você forneça um token de autenticação token_v2 que você pode encontrar em seus cozinheiros notion.so.

Você pode fornecer a opção token_v2 para cada chamada de linha de comando ou armazená-la em seu ambiente ou no arquivo de configuração .env .

---

Estrutura de banco de dados de noção

Notoma tem poucas expectativas sobre como seu Notion está estruturado. Aqui está um exemplo de banco de dados público.

Notoma requer que o banco de dados do seu blog Notion tenha as seguintes propriedades :

• Publicado : se o artigo está publicado ou ainda é um rascunho
• Título : será usado para criar um nome de arquivo para o arquivo equivalente Markdown desse artigo. Não será usado no próprio artigo.

Notoma tenta analisar outras propriedades e adicioná-las como matéria inicial nos artigos Markdown resultantes:

• Publicado em será utilizado como data de publicação do artigo, se presente.
• As categorias serão usadas como chave principal categories , portanto, espera-se que seja uma propriedade de múltipla escolha .