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.