Path issues with sub-folders under windows
See original GitHub issueI am using the latest 0.7.0b2 on Windows 10, with Anaconda Python 3.7.
I am able to create and compile the template project as per the project documentation. However, building fails when I move a file to a subfolder (which I need to do for a much larger document). To reproduce the issue:
- Move
contend.md
tofolder\content.md
- Modify
_toc.yml
so that the relevant line read- file: folder/content
- Clean, then rebuild the book
The build is successful, but several files are no longer included, with the output given below. It appears to be an issue with relative paths using \\
.
I believe that this is due to how jupyter-book
converts windows paths before handing on to Sphinx, as I have had no problems running Sphinx with a heavily nested project on this machine.
<project root path>\folder\content.md:7: WARNING: toctree contains reference to nonexisting document 'folder/..\\markdown'
<project root path>\folder\content.md:7: WARNING: toctree contains reference to nonexisting document 'folder/..\\notebooks'
<project root path>\intro.md:9: WARNING: toctree contains reference to nonexisting document 'folder\\content'
looking for now-outdated files... none found
pickling environment... done
checking consistency... <project root path>\folder\content.md: WARNING: document isn't included in any toctree
<project root path>\markdown.md: WARNING: document isn't included in any toctree
<project root path>\notebooks.ipynb: WARNING: document isn't included in any toctree
Issue Analytics
- State:
- Created 3 years ago
- Reactions:1
- Comments:18 (13 by maintainers)
Top Results From Across the Web
How to include subfolders in a Windows path? - Super User
It's not feasible to include every possible subfolder. The guide doesn't address this issue. Is there any way to specify the path including ......
Read more >win 11 folder subfolder issues - Microsoft Community
I have a folder on my desktop i would like to move back into its correct place. I get a message saying, "The...
Read more >Windows Batch File - Display All Folder & Sub-Folder relative ...
The issue comes with the /S switch that allows the DIR command to recurse into sub-folders. Is there a simple way, using only...
Read more >The File Name or Destination Path You Specified is Not Valid ...
Microsoft Windows has a MAX_PATH limit of ~256 characters. ... Note: This allows you to browse down the sub-folders to a path length...
Read more >How to Create a Directory or Folder - Computer Hope
Steps on how to create a directory or folder in Microsoft Windows, ... add a folder, subfolder, directory, and subdirectory on a computer....
Read more >Top Related Medium Post
No results found
Top Related StackOverflow Question
No results found
Troubleshoot Live Code
Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start FreeTop Related Reddit Thread
No results found
Top Related Hackernoon Post
No results found
Top Related Tweet
No results found
Top Related Dev.to Post
No results found
Top Related Hashnode Post
No results found
Top GitHub Comments
definitely get the impression that we’re all unix immigrants here. I’m writing a windows developer guide (4 of our group of 6 on our project are windows users which is why I spent my weekend on windows). for anyone in my situation, my two top tips for conda on windows:
https://github.com/eoas-ubc/eoas_tlef/blob/master/docs/support_files/Microsoft.PowerShell_profile.ps1
Hey @jlperla, as of v0.11 the ToC handling has now all been moved to https://github.com/executablebooks/sphinx-external-toc, and there is specifically Windows testing there. So I’m hoping this should no longer be an issue.
Perhaps if someone with Windows could re-check this and confirm. Then @choldgraf can update the documentation