Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

versioning not working - versions.json not found #3164

Closed
4 of 5 tasks
hossam-houssien opened this issue Oct 30, 2021 · 1 comment
Closed
4 of 5 tasks

versioning not working - versions.json not found #3164

hossam-houssien opened this issue Oct 30, 2021 · 1 comment

Comments

@hossam-houssien
Copy link

Contribution guidelines

I've found a bug and checked that ...

  • ... the problem doesn't occur with the mkdocs or readthedocs themes
  • ... the problem persists when all overrides are removed, i.e. custom_dir, extra_javascript and extra_css
  • ... the documentation does not mention anything about my problem
  • ... there are no open or closed issues that are related to my problem

Description

with latest update mkdocs, mkdocs-material and mike, versioning is not working using them material,
when running mkdocs serve , i got warning like
WARNING - [23:50:07] "GET /versions.json HTTP/1.1" code 404
and the version link in header is not displayed, however when running mike server, it is displayed correctly

mkdocs-1.2.3
mkdocs-material-7.3.5
mike-1.1.2

Expected behaviour

to have version selector link

Actual behaviour

none and got warning when runing mkdocs
WARNING - [23:50:07] "GET /versions.json HTTP/1.1" code 404

Steps to reproduce

1- install mkdocs
2- install mkdocs-material
3- install mike
4- configure mkdocs.yml
5- configure mike as per mkdocs-material-example-versioning

  • mike list
    0.2 [latest]
    0.1

6- mkdocs serve

Package versions

  • Python: python --version
    • Python 3.6.2 :: Anaconda custom (64-bit)
  • MkDocs: mkdocs --version
    • mkdocs, version 1.2.3
  • Material: pip show mkdocs-material | grep -E ^Version
    • Version: 7.3.6
  • mike --version
    • mike 1.1.2

Configuration

----------
mkdocs.yaml
--------------
 yaml
site_name: mydoc
theme:
  name: material  
extra:
  version:
    provider: mike
    default: latest


### System information

- Operating system: ...
   - OS Name:                   Microsoft Windows 10 Pro
   - OS Version:                10.0.18362 N/A Build 18362 
- Browser: ...
   - firefox 93.0 (64-bit)
@squidfunk
Copy link
Owner

Thanks for reporting.

when running mkdocs serve , i got warning like [...] and the version link in header is not displayed, however when running mike serve, it is displayed correctly

You can't use mkdocs serve, you must use mike serve for versioning to work. That is a limitation of mike.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants