2 votos

No se puede instalar mkdocs en Monterey

Actualmente tengo Python3 como versión 3.12.4 en mi PATH. Fue instalado a través de Homebrew.

He instalado mkdocs usando

pip3 install mkdocs

mkdocs --version dice

mkdocs, versión 1.6.0 desde /Users/ronaldfischer/Library/Python/3.11/lib/python/site-packages/mkdocs (Python 3.11)

Menciona Python 3.11 porque en el momento de la instalación, mi Python3 en el PATH aún era 3.11. Mientras tanto, otra instalación de homebrew actualizó Python a 3.12, por lo que es lo que estoy ejecutando ahora.

Cuando hago un mkdocs serve, recibo el mensaje de error

no se puede encontrar el módulo 'pymdownx.superfences' (No module named 'pymdownx')

(superfences está referenciado en el archivo mkdocs.yml)

Pensé que necesitaba instalar pymdown-extensions. Mi primer enfoque

pip3 install pymdown-extensions

falló con un mensaje de error

*Este entorno está gestionado externamente. ... Si desea instalar una aplicación de Python que no esté en Homebrew, puede ser más fácil usar 'pipx install xyz'.

Así que instalé pipx a través de Homebrew y luego ejecuté

pipx --include-deps pymdown-extensions

y añadí ~/.local/bin a mi PATH. Ahora mi .local/bin contiene un enlace simbólico

markdown_py -> /Users/ronaldfischer/.local/pipx/venvs/pymdown-extensions/bin/markdown_py

Sin embargo, sigo recibiendo el mensaje de error al ejecutar mkdocs.

Cuando hago un

find ~ -name '*pymdownx*' 2>/dev/null

No obtengo ningún archivo coincidente. Esto me hace preguntarme si el paquete está correctamente instalado.

¿Qué hice mal y, más importante aún, cómo puedo solucionarlo?

ACTUALIZACIÓN

No he establecido la variable de entorno PYTHONPATH, ya que la documentación sobre mkdocs no lo menciona. Me pregunto cómo se supone que se encontrarán mis paquetes instalados sin esta variable.

1voto

teewuane Puntos 1383

Noté tu pregunta sobre cómo instalar MkDocs con pip. Como estás usando Homebrew, una solución más simple es:

brew install mkdocs

Una vez instalado, puedes crear un nuevo proyecto de documentación con:

mkdocs new 

Cambia al directorio del proyecto:

cd 

Finalmente, para servir la documentación localmente, corre:

mkdocs serve

Esto debería ayudarte a empezar con MkDocs más fácilmente.

AppleAyuda.com

AppleAyuda es una comunidad de usuarios de los productos de Apple en la que puedes resolver tus problemas y dudas.
Puedes consultar las preguntas de otros usuarios, hacer tus propias preguntas o resolver las de los demás.

Powered by:

X