Sphinx est une bibliothèque Python pour générer de la belle documentation à partir d'un ensemble de Repos format des fichiers texte.
Je me demande si l'on a écrit Sphinx plugins pour faire de générer des sites personnels et les blogs.
Surtout pour les blogs, il doit y avoir un moyen de automatiquement de la liste de messages par ordre chronologique et de générer un flux RSS. Il faut écrire un Sphinx plugin pour faire ce genre de page spéciale/xml génération.
Quelqu'un a déjà essayé cela avant?
Je l'ai fait à http://reinout.vanrees.org/weblog. La clé astuce consiste à ajouter un préprocesseur étape. J'ai mes entrées de blog dans un weblog/yyyy/mm/dd/ le dossier de la structure.
Un script parcourt que la structure des dossiers, la création d' index.txt fichiers dans chaque répertoire, la liste des sous-éléments. La normale Sphinx processus rend alors ceux - index.txt fichiers.
J'ai ajouté une coutume Sphinx processeur pour les balises. Donc ".. balises:: python, buildout" quelque part en haut de mon blog génère les balises. Et le préprocesseur de nouveau recueille les entrées et écrit un weblog/tags/TAGNAME.txt le fichier de Sphinx qui rend de nouveau normalement.
Le préprocesseur crée également la racine weblog/index.txt avec les 10 dernières entrées. Et un weblog/atom.xml dans (codé en dur) le répertoire de sortie pour le flux rss.
Donc: vous avez besoin de quelques choses, mais c'est à peu près en texte brut, donc pour moi c'était un bel exercice. Et vous vous mettez à écrire des scripts d'assistance pour rendre la vie facile, par exemple celui qui copie un fichier texte à partir de quelque part aujourd'hui à un blog répertoire (y compris la création de répertoires manquants et un "svn add").
Dès maintenant (février 2012), il existe des ressources disponibles pour faire ce que vous voulez:
Un moteur de blog basé sur sphinx: http://tinkerer.me/
Joueur de synthétiseur reinout Van Rees blog: https://github.com/reinout/reinout.vanrees.org
L'alimentation contrib extension: https://bitbucket.org/birkenfeld/sphinx-contrib/src/tip/feed/README
Doug hellmann, auteur du "Module Python de la semaine" fait son site en utilisant Sphinx.
http://www.doughellmann.com/PyMOTW/
Il a plusieurs articles qui couvrent des sujets de sphinx qui peuvent probablement vous aider sur votre chemin:
Si vous avez besoin d'écrire dans reStructuredText , vous devriez essayer Pelican .
Pelican est un générateur de site statique, écrit en Python. Vous pourrez écrire vos entrées de blog directement dans reStructuredText ou Markdown.
Cela vaut la peine de savoir qu’il existe une extension RSS pour sphinx dans les extensions sphinx-contrib, appelée sphinxcontrib.feed It et beaucoup d’autres choses amusantes relatives au Sphinx en direct sur http://bitbucket.org/birkenfeld/sphinx-contrib/
(Avertissement: j'ai écrit l'extension du flux.)
Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.
