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

Navbar display different when hosted on readthedocs.org #5090

Closed
thomthom opened this issue Jan 10, 2019 · 2 comments
Closed

Navbar display different when hosted on readthedocs.org #5090

thomthom opened this issue Jan 10, 2019 · 2 comments
Labels
Support Support question

Comments

@thomthom
Copy link

Details

Expected Result

My mkdocs.yml:

site_name: "RuboCop SketchUp: SketchUp Extension Best Practices"
repo_url: https://github.com/sketchup/rubocop-sketchup
edit_uri: edit/master/manual/
copyright: "Copyright © 2017-2018 Trimble Inc. SketchUp and contributors"
docs_dir: manual
nav:
- Home: index.md
- Installation: installation.md
- Basic Usage: basic_usage.md
- Cops: cops.md
- Formatters: formatters.md
- Configuration: configuration.md
- Integration with other tools: integration_with_other_tools.md
- Contributing: contributing.md
- Development: development.md
- Cops Documentation:
    - Requirements Cops: cops_requirements.md
    - Deprecations Cops: cops_deprecations.md
    - Performance Cops: cops_performance.md
    - Suggestions Cops: cops_suggestions.md
extra_css:
  - css/extra.css
markdown_extensions:
  - admonition
theme: readthedocs

Here's what I see when I build manually:

2019-01-10_14h50_25

The navbar layout matches my config file.

Actual Result

However, when I view the docs on readthedocs.ord the navbar is flattened and appear out of order:

2019-01-10_14h50_34

Is this a config issue? Or version mismatch?

PS C:\Users\Thomas\SourceTree\rubocop-sketchup> mkdocs -V
mkdocs, version 1.0.4 from c:\users\thomas\appdata\local\programs\python\python36-32\lib\site-packages\mkdocs (Python 3.6)
@stsewd
Copy link
Member

stsewd commented Jan 10, 2019

I'm guessing a version mismatch, we are using mkdocs==0.17.3. You can specify another version of mkdocs with https://docs.readthedocs.io/en/latest/guides/specifying-dependencies.html

@thomthom
Copy link
Author

That worked like a charm!

https://rubocop-sketchup.readthedocs.io/en/latest/

Thank you very much! :)

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

No branches or pull requests

2 participants