Readthedocs.org: Navbar display different when hosted on readthedocs.org

Created on 10 Jan 2019  路  2Comments  路  Source: readthedocs/readthedocs.org

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)
Support

Most helpful comment

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

All 2 comments

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

That worked like a charm!

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

Thank you very much! :)

Was this page helpful?
0 / 5 - 0 ratings