Foro de TI tranquilo

Hola, ¡
su documentación es excelente! https://www.wapt.fr/fr/doc/
¿Podrían indicarme qué necesito para implementar una herramienta similar en las instalaciones de mi cliente?
Tengo un servidor CentOS 7 y me gustaría poder presentarle este tipo de documentación.
¡Es clara, sencilla y está muy bien hecha!

Gracias por su respuesta.

Hola,

en primer lugar, gracias en nombre de Tranquil IT Systems. Siempre es un placer recibir halagos; todo el equipo se dedica a proporcionar la documentación más completa posible.

En cuanto a la documentación en sí, la generamos utilizando reStructuredText, Docutils y Sphinx.

Si alguna vez ha editado Markdown o una wiki, la organización de los encabezados es bastante similar. La principal diferencia radica en el proceso de compilación de la documentación, que nos permite generarla en diferentes idiomas y formatos (HTML, PDF, ePub y LaTeX).

Si desea obtener más información sobre RST, Sphinx y Docutils: https://www.jujens.eu/posts/2014/Aug/13 ... st-sphinx/

La documentación oficial está disponible aquí: http://docutils.sourceforge.net/sandbox ... rt-fr.html

Alexandre

Gracias, obtuve el resultado que quería.
Ahora voy a investigar cómo hacerlo manualmente, porque ` yum install` y `pip install` no se ajustan a mis necesidades.

Prefiero tener control sobre lo que instalo, para poder instalar lo que quiera, donde quiera (empezando por los archivos tar.gz).

(¿Por casualidad no tendrás documentación sobre cómo instalar todo esto desde el código fuente en CentOS?)
((¡Mejor aún! Un paquete listo para usar y configurable, que incluya todo lo necesario sin dependencias.))
(((Oye, ¿no haces esto para tus clientes? Distribuir este tipo de wiki a través de Wapt a las máquinas cliente para su información interna. Probablemente pocos de ellos tengan intranets o wikis.)))

Para una instalación limpia, la verdad es que no hay mucha documentación, aparte del archivo setup.py del proyecto Sphinx: https://github.com/sphinx-doc/sphinx/bl ... r/setup.py.

No lo usamos en Windows; el bot de compilación de documentación del repositorio Git (Jenkins) usa comandos pip para la instalación de dependencias.

De todas formas, ¡mucha suerte con RST!