mosra / m.css

A no-nonsense, no-JavaScript CSS framework, site and documentation theme for content-oriented websites
https://mcss.mosra.cz
Other
409 stars 92 forks source link

Cannot add/link mardown or rst pages in the C++ Doxygen theme #174

Closed kennychowdhary closed 2 years ago

kennychowdhary commented 4 years ago

In my config file I have

DOXYFILE = 'Doxyfile-mcss'
MAIN_PROJECT_URL: "My project"

LINKS_NAVBAR1 = [
    ("Pages", 'pages', [("About",'about.md')]) ,
    ("Namespaces", 'namespaces', [])
]

where about.md is a markdown page in the same directory as the Doxyfile-mcss file, but I get the following error when running ./doxygen.py on this conf.py file:

Traceback (
most recent call last):
  File "./doxygen.py", line 3853, in <module>
    run(state, templates=os.path.abspath(args.templates), wildcard=args.wildcard, index_pages=args.index_pages, search_merge_subtrees=not args.search_no_subtree_merging, search_add_lookahead_barriers=not args.search_no_lookahead_barriers, search_merge_prefixes=not args.search_no_prefix_merging)
  File "./doxygen.py", line 3686, in run
    postprocess_state(state)
  File "./doxygen.py", line 2346, in postprocess_state
    sublinks += [resolve_link(*i)]
  File "./doxygen.py", line 2337, in resolve_link
    found = state.compounds[id]
KeyError: 'about.md'
mosra commented 4 years ago

It should be just about I think -- this is the name that Doxygen uses as a page identifier.

or rst pages

Unfortunately Doxygen doesn't understand rst on its own, and (the Doxygen theme in particular) only consumes the XML output that Doxygen produced, so it's limited to just what Doxygen knows to parse -- Markdown and the Doxygen docblock syntax.

mosra commented 2 years ago

Closing due to lack of activity.