{"action":"created","issue":{"url":"https://api.github.com/repos/ryan-roemer/sphinx-bootstrap-theme/issues/178","repository_url":"https://api.github.com/repos/ryan-roemer/sphinx-bootstrap-theme","labels_url":"https://api.github.com/repos/ryan-roemer/sphinx-bootstrap-theme/issues/178/labels{/name}","comments_url":"https://api.github.com/repos/ryan-roemer/sphinx-bootstrap-theme/issues/178/comments","events_url":"https://api.github.com/repos/ryan-roemer/sphinx-bootstrap-theme/issues/178/events","html_url":"https://github.com/ryan-roemer/sphinx-bootstrap-theme/issues/178","id":306691990,"number":178,"title":"Can navbar_links support menus and submenus","user":{"login":"sdayers","id":6796064,"avatar_url":"https://avatars0.githubusercontent.com/u/6796064?v=4","gravatar_id":"","url":"https://api.github.com/users/sdayers","html_url":"https://github.com/sdayers","followers_url":"https://api.github.com/users/sdayers/followers","following_url":"https://api.github.com/users/sdayers/following{/other_user}","gists_url":"https://api.github.com/users/sdayers/gists{/gist_id}","starred_url":"https://api.github.com/users/sdayers/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sdayers/subscriptions","organizations_url":"https://api.github.com/users/sdayers/orgs","repos_url":"https://api.github.com/users/sdayers/repos","events_url":"https://api.github.com/users/sdayers/events{/privacy}","received_events_url":"https://api.github.com/users/sdayers/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":1,"created_at":"2018-03-20T01:08:03Z","updated_at":"2018-04-06T17:02:54Z","closed_at":null,"author_association":"NONE","body":"Is it possible to include menus within the navbar_links list (similar to 'page' and 'site' links)?\r\n\r\nIt seems like this would be a good format\r\n\r\n```\r\n'navbar_links':[\r\n'help_menu':[\r\n(\"this\",\"here/there\"),\r\n(\"that\",\"over/there\"),\r\n],\r\n```\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/ryan-roemer/sphinx-bootstrap-theme/issues/comments/379315073","html_url":"https://github.com/ryan-roemer/sphinx-bootstrap-theme/issues/178#issuecomment-379315073","issue_url":"https://api.github.com/repos/ryan-roemer/sphinx-bootstrap-theme/issues/178","id":379315073,"user":{"login":"svenevs","id":5871461,"avatar_url":"https://avatars0.githubusercontent.com/u/5871461?v=4","gravatar_id":"","url":"https://api.github.com/users/svenevs","html_url":"https://github.com/svenevs","followers_url":"https://api.github.com/users/svenevs/followers","following_url":"https://api.github.com/users/svenevs/following{/other_user}","gists_url":"https://api.github.com/users/svenevs/gists{/gist_id}","starred_url":"https://api.github.com/users/svenevs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/svenevs/subscriptions","organizations_url":"https://api.github.com/users/svenevs/orgs","repos_url":"https://api.github.com/users/svenevs/repos","events_url":"https://api.github.com/users/svenevs/events{/privacy}","received_events_url":"https://api.github.com/users/svenevs/received_events","type":"User","site_admin":false},"created_at":"2018-04-06T17:02:54Z","updated_at":"2018-04-06T17:02:54Z","author_association":"COLLABORATOR","body":"@iwelch82 that sounds interesting, would you be willing to expand on how the mechanics of that play out?  E.g. what is written in RST, does the user need to customize `layout.html` for this?\r\n\r\nThe reason I ask is something that's been on the (very) back burner I'd like to contribute is reworking how the menus are achieved.  As far as I can tell the global toc is generated for every page, which means that larger projects get significantly slower build times.  More than twice slower than RTD theme, for example.\r\n\r\nI am worried that introducing another toc-like thing will make this worse, but in all honesty how all of the layout stuff works is still confusing to me.\r\n\r\n@sdayers you may be able to override `layout.html` and use hard-coded options for now, but this will likely not be an easy process.  See the [sphinx templating docs](http://www.sphinx-doc.org/en/stable/templating.html) for how to override.  One thing the docs don't make super clear is how you actually get the override in there.  In your `conf.py` there's likely the following commented out section:\r\n\r\n```py\r\n# Add any paths that contain templates here, relative to this directory.\r\n# templates_path = ['_templates']\r\n```\r\n\r\nUn-comment the `templates_path` variable.  Now `mkdir _templates` and create `_templates/layout.html`.  The name must be exact.  Then Sphinx should use your new template.\r\n\r\nIn terms of what to change, I *think* you want to override the `{% content %}` meta-block\r\n\r\nhttps://github.com/ryan-roemer/sphinx-bootstrap-theme/blob/28c53695c63990d2bc20cf172776cb6f1ccce828/sphinx_bootstrap_theme/bootstrap/layout.html#L71-L82\r\n\r\nThen I think you basically want to copy-paste most of that code, only remove the call to `navBar()`.  Test that first, it should result in no navbar.  The navbar macro is defined above, and basically just includes the right version:\r\n\r\nhttps://github.com/ryan-roemer/sphinx-bootstrap-theme/blob/28c53695c63990d2bc20cf172776cb6f1ccce828/sphinx_bootstrap_theme/bootstrap/layout.html#L28-L30\r\n\r\nSo what you'll want to do now is work off of the navbar code (see the files in that same directory), and essentially copy-paste everything you want, **and** add these special links.\r\n\r\nHaving this as a bypass in the theme itself would definitely be nice (since that gets pretty bloody), but if you really really want it I think the above will get you close. Good luck!"}}
{"actor":{"display_login":"svenevs"}}