search

foliant-docs / foliant

Comprehensive markdown-based documentation toolkit
https://foliant-docs.github.io/docs/
MIT License
160 stars 9 forks source link

foliant init not found #70

Closed kkaiser closed 1 year ago

kkaiser commented 1 year ago

Hello,

Your documentation quickstart mentions foliant init to create the initial structure but installing foliant from PyPI results in this error for Python 3.11.2

foliant init
usage: foliant [-h] [-v] {clean-registry,make,meta} ...
foliant: error: argument {clean-registry,make,meta}: invalid choice: 'init' (choose from 'clean-registry', 'make', 'meta')

The installed version is Foliant v.1.0.12 which is weird because it says version 1.0.13 from PyPI.

$ pip install foliant==1.0.13
Requirement already satisfied: foliant==1.0.13 in ./.venv/lib/python3.11/site-packages (1.0.13)
[...]
$ foliant -v
Foliant v.1.0.12
$ which foliant
.venv/bin/foliant

Is this project still maintained?

moigagoo commented 1 year ago

@kkaiser

Hi! The project is maintained.

Did you install init command?

$ pip3 install foliantcontrib.init

Learn more about installation options at https://foliant-docs.github.io/docs/installation/

kkaiser commented 1 year ago

Thanks for the reply. I missed the sentence, sorry about that

For the Quickstart, you'll need the MkDocs backend and init CLI extension:

Do you have an explanation for the version mismatch?

moigagoo commented 1 year ago

@kkaiser it's hard to tell, Python is famous for those type of issues. I'd remove the venv folder and start from scratch and see if it works. Maybe you have 1.0.12 installed previously and it still exposes its binary.