El uso de Sphinx para escribir páginas web personales y blogs

Question

Sphinx es una biblioteca de Python para generar buena documentación de un conjunto de Resto archivos de texto con formato.

Me pregunto si alguien ha escrito plugins Sphinx para que sea generar sitios web personales y blogs .

Especialmente para los blogs, es necesario que haya una manera de forma automática los mensajes de la lista en orden cronológico y generar un feed RSS. Uno tiene que escribir un plugin Sphinx hacer tales generación especial de la página / xml.

¿Alguien ha intentado esto antes?

Answer 1

lo he hecho en http://reinout.vanrees.org/weblog . El truco clave es agregar un paso preprocesador. Tengo mis entradas de blog en una estructura de carpetas weblog/yyyy/mm/dd/.

Un itera a través de secuencias de comandos que la estructura de carpetas, la creación de archivos index.txt en cada directorio, se enumeran los subtemas. El proceso normal Sphinx continuación, hace que esos archivos index.txt.

He añadido un procesador Esfinge personalizada para las etiquetas. Así ".. :: etiquetas pitón, buildout" en algún lugar en la parte superior de la entrada de mi weblog genera las etiquetas. Y el preprocesador de nuevo recoge las entradas y escribe un archivo weblog/tags/TAGNAME.txt cuales Esfinge de nuevo hace normalmente.

El preprocesador también crea el weblog/index.txt raíz de las últimas 10 entradas. Y un weblog/atom.xml en el directorio de salida (hardcoded) para la alimentación de RSS.

Por lo tanto: se necesita un poco de materia costumbre, pero es más o menos texto plano, así que para mí fue un ejercicio agradable. Y usted tiene que escribir algunos scripts de ayuda a hacer la vida más fácil, por ejemplo, uno que copia un archivo de texto desde algún lugar en el directorio weblog de hoy (incluyendo la creación de directorios que faltan y un "complemento SVN").

Answer 2

A partir de ahora (febrero de 2012), hay diferentes recursos disponibles para hacer lo que desee:

Un motor de blogs sobre la base de la esfinge: http://tinkerer.me/

Reinout Van Rees blog: https://github.com/reinout/reinout.vanrees.org

La extensión contrib alimentación: https://bitbucket.org/birkenfeld/sphinx-contrib/ src / punta / alimentación / README

Answer 3

Doug Hellmann, autor del 'módulo de Python de la Semana' hace su sitio usando Sphinx.

http://www.doughellmann.com/PyMOTW/

Tiene varios puestos que cubren temas esfinge que probablemente le pueden ayudar en su camino:

http://blog.doughellmann.com

Answer 4

Si necesita escribir en reStructuredText , usted debe tratar Pelican .

Pelican es un generador de sitio estático, escrito en Python. Podrás escribir entradas de blog directamente en reStructuredText o de rebajas.

Answer 5

Vale la pena saber que hay una extensión RSS para la Esfinge en las extensiones de esfinge contrib, llamado sphinxcontrib.feed Y muchas otras cosas divertidas Sphinx viven en http://bitbucket.org/birkenfeld/sphinx-contrib/

(Negación:. Me escribió la extensión de alimentación)

Answer 6

ABlog para Sphinx

Estoy en el proceso de iniciar un blog yo usarlo.

Me tropezó con él mientras yo estaba pasando por mis feeds en Feedly. He buscado en ello y pareció interesante. También tiene la integración Disqus, y puede ge los Atom (no muy seguro de lo que es en este momento, soy nuevo en la web)

todavía no he encontrado la manera de desplegar mi blog prueba, se actualizará cuando me entero de algo.

Answer 7

No Sphinx, pero varios de los sitios en http://codespeak.net/ se hacen con scripts que texto toma el descanso, genera HTML y archivos subidos al sitio. Yo no escribo los guiones sin embargo, pero los he usado.

Es una forma razonable para generar sitios si los sitios deben contener una gran cantidad de descanso archivos de todos modos, al igual que al generar la documentación de los módulos Python, que por supuesto estos sitios se trata. También es bueno si necesita el sitio a ser la versión controlada, porque se puede mantener el código fuente en el SVN o Hg, o algo así.

Pero si comienza a escribir una gran cantidad de menús automáticos y otras extensiones, lo que va a terminar con al final es un sistema de gestión de contenidos. Y hay un montón de los que lo rodean ya, así que es posible que desee mirar a ellos en primer lugar.

Otro ejemplo es el nuevo packages.python.org. No se puede generar la documentación de cualquier manera que desee, y luego a través PyPI cargar un archivo ZIP con la documentación. Distribuir ha hecho esto con Sphinx: http://packages.python.org/distribute . Pero no se necesita ningún script en particular, que acaba de generar código HTML de la documentación de la esfinge.

Sin embargo ...

debo decir que me parece la idea de escribir un software de blogs como extensión Sphinx un poco raro, sobre todo porque no es tanto un excelente software de blogs por ahí ya. Y nada va a vencer a Wordpress todos modos, y wordpress.com ha sido una gran experiencia en los blogs para mí. Sino como un ejercicio de lo mucho que se puede abusar de Sphinx, por qué no! : -)

Answer 8

rehice mi página web personal ( http://homepage.mac.com/s_lott/steve/ ) en Sphinx. Funciona muy bien. Lamentablemente, el SO marcado mangles del _ en mi URL.

También volvió a escribir la totalidad de Introducción a la programación para los no programadores ( http://homepage.mac.com/s_lott/books/nonprog/html/index.html ) libro "noreferrer nofollow" en la Esfinge. Estoy en el proceso de reescribir Introducción a Python en Sphinx.

Yo no uso Sphinx para blogs - no es perfectamente conveniente, pero funcionaría. Yo uso blogspot De bajo gráficos / texto de alta y relativamente blogs de alta velocidad. Yo uso iWeb ( http://web.me.com/s_lott/Travel/Welcome. html ) para alta gráfico y relativamente baja velocidad de blogs.