Skip to content

breakage in toc; and doesn't report which file is bad #146

Closed
@sandover

Description

@sandover
Traceback (most recent call last):
  File "/usr/local/bin/mkdocs", line 46, in <module>
    main(cmd, args=sys.argv[2:], options=dict(opts))
  File "/usr/local/bin/mkdocs", line 29, in main
    serve(config, options=options)
  File "/usr/local/lib/python2.7/site-packages/mkdocs/serve.py", line 81, in serve
    build(config, live_server=True)
  File "/usr/local/lib/python2.7/site-packages/mkdocs/build.py", line 179, in build
    build_pages(config)
  File "/usr/local/lib/python2.7/site-packages/mkdocs/build.py", line 149, in build_pages
    html_content, table_of_contents, meta = convert_markdown(input_content)
  File "/usr/local/lib/python2.7/site-packages/mkdocs/build.py", line 64, in convert_markdown
    table_of_contents = toc.TableOfContents(toc_html)
  File "/usr/local/lib/python2.7/site-packages/mkdocs/toc.py", line 45, in __init__
    self.items = _parse_html_table_of_contents(html)
  File "/usr/local/lib/python2.7/site-packages/mkdocs/toc.py", line 98, in _parse_html_table_of_contents
    parents.pop()
IndexError: pop from empty list

I'd love to provide more detail than this spew, but:

I'm trying to convert an existing (doxygen) documentation set to mkdocs, incrementally, but I've found that mkdocs forces you to include in the document set every document which is linked to by any document -- if there is a single dead link, mkdocs won't build or serve. (Is there a command line flag to turn this strictness off?)

It worked for one file, and now I've added every file, and it's broken. Is there another way to debug? I can't take suspect file(s) out, because then whole docset won't build.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions