Pregunta

Sphinx tiene la capacidad de generar documentación en JSON. ¿Cuáles son estos archivos usan?

¿Fue útil?

Solución

los documentos dicen, es

  

para el uso de una aplicación web (o   personalizada herramienta de post-procesamiento) que   no utiliza el estándar HTML   plantillas.

JSON es una buena manera simple para el intercambio de datos independiente del idioma, así que, ¿por qué no? -)

Otros consejos

Asumo que estás hablando acerca de la SerializingHTMLBuilder , en cuyo caso creo que la respuesta podría ser que no es necesariamente un propósito específico en mente. Más bien muchas cosas proporcionan rutinas de conversión de varios tipos con una "carga / vertederos" convención de API, y el módulo de json (conocido como simplejson antes de que se trajo de la biblioteca estándar de 2,6) no es sino uno de los muchos paquetes.

Es de suponer que algunas personas prefieren trabajar con datos en formato JSON para sus propios fines. Si estuviera tratando de construir algún tipo de sistema de documentación Javascripty dinámico, que podía imaginar la elección de utilizar JSON como la manera de obtener la documentación desde el servidor hacia el cliente en un formato manejable, si por alguna razón HTML o XML no lo hicieron parecer como la mejor opción.

Licenciado bajo: CC-BY-SA con atribución
No afiliado a StackOverflow
scroll top