- Thu Apr 13, 2017 9:24 am
#64910
cwr wrote:Yes, but I want to use the docs, not develop them.
I do understand that but to me those two aren't sooo different (I guess mean 'serve' vs. 'build').
cwr wrote:And I'm pretty sure that if you try selecting one of the entries on the first index page, the browser will crash out.
No, it doesn't. As I said it works for me.
Code: Select all~/Data/NodeMCU/nodemcu-firmware (dev) > mkdocs build
INFO - Cleaning site directory
INFO - Building documentation to directory: /Users/marcelstoer/Data/NodeMCU/nodemcu-firmware/site
~/Data/NodeMCU/nodemcu-firmware (dev) > open site/index.html
~/Data/NodeMCU/nodemcu-firmware (dev) >
This opens the page in the default browser at 'file:///~/Data/NodeMCU/nodemcu-firmware/site/index.html'. If I then hit the "English" link in the second paragraph the browser navigates to 'file:///~/Data/NodeMCU/nodemcu-firmware/site/en/' and shows a listing of the local file system. Since the files aren't served through a web server the file 'index.html' has no special meaning and I need to select it manually.
This intermediate step can be avoided by setting 'use_directory_urls: false' as you said but due to the JavaScript issue I mentioned you still won't be seeing the left-hand navigation tree.