Compartir tecnología

한어Русский языкEnglishFrançaisIndonesianSanskrit日本語DeutschPortuguêsΕλληνικάespañolItalianoSuomalainenLatina

Markdown Sphinx Read_the_Docs se puede utilizar para crear una página de inicio personal o un tutorial de conocimientos. Hay muchos métodos de creación en Internet. Puede consultar los de este experto.artículo . Este artículo habla principalmente sobre algunas técnicas que pueden hacer que el proyecto sea más perfecto.

Mi entorno de ejecución es WSL2 Ubuntu 22.04 y la versión de Sphinx es 7.3.7

---

Construcción de un solo proyecto.

Después de instalar Sphinx, ejecútelo en la terminalsphinx-quickstart, luego aparecerá una opción: ¿Necesita separar el directorio de origen y el directorio de compilación?

Seleccione sí aquí, ingrese y y presione Enter. La ventaja de la separación es que la estructura del proyecto es más clara.

Simplemente complételo de manera informal. El último es el idioma del proyecto. Aquí, elija chino simplificado.es_CN

En este punto, el proyecto está completo.

---

2. Instale el complemento

1. Complemento de soporte de Markdown: MyST-Parser

Sphinx admite reStructuredText de forma predeterminada, pero la mayoría de la gente usa Markdown para escribir artículos, por lo que debe instalar el complemento MyST-Parser que admite Markdown. Su dirección de sitio web oficial es.https://myst-parser.readthedocs.io/es/latest/, el comando de instalación es el siguiente,

pip install -U myst-parser

                    上一篇
                    下一篇