notoma

Notoma

Écrivez des articles pour votre blog de génération statique dans Notion.

• Site de documentation
  • Utilisation de la CLI
  • Contribuer
  • Balises Markdown prises en charge

---

Installer

Notoma est disponible via Pip ou Homebrew :

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

Installation avec Homebrew sur Mac OS.

brew install nategadzhi/notoma/notoma

---

Que pouvez-vous faire avec Notoma

Notoma fournit des commandes pour :

• Convertissez le contenu de votre base de données Notion Blog en un tas de fichiers Markdown.
• Bientôt disponible : surveillez la base de données Notion Blog pour les mises à jour et régénérez les fichiers Markdown pour toutes les mises à jour.
• Bientôt disponible : Créez une nouvelle base de données Notion pour votre blog avec tous les champs obligatoires.

Exemple d'utilisation de base : cette commande convertira uniquement les articles publiés d'une base de données de blog Notion vers le ./posts/ directory .

notoma convert --dest ./posts/

Cet exemple suppose que vous disposez d'un fichier de configuration .env contenant les paramètres d'authentification et d'URL de blog.

Authentification dans Notion

Notoma utilise une API Notion interne, et cela nécessite malheureusement que vous fournissiez un jeton d'authentification token_v2 que vous pouvez trouver dans vos cookies notion.so.

Vous pouvez fournir l'option token_v2 à chaque appel de ligne de commande, ou la stocker dans votre environnement ou dans le fichier de configuration .env .

---

Structure de base de données de notions

Notoma a très peu d'attentes quant à la façon dont votre Notion est structurée. Voici un exemple de base de données publique.

Notoma nécessite que votre base de données de blog Notion possède les propriétés suivantes :

• Publié : si l'article est publié ou s'il s'agit encore d'un brouillon
• Titre : Sera utilisé pour créer un nom de fichier pour le fichier équivalent Markdown de cet article. Ne sera pas utilisé dans l’article lui-même.

Notoma essaie d'analyser d'autres propriétés et de les ajouter comme introduction dans les articles Markdown résultants :

• Publié à sera utilisé comme date de publication de l'article, le cas échéant.
• Les catégories seront utilisées comme clé de présentation categories , il devrait donc s'agir d'une propriété à choix multiples .