question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Path issues with sub-folders under windows

See original GitHub issue

I 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 to folder\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:open
  • Created 3 years ago
  • Reactions:1
  • Comments:18 (13 by maintainers)

github_iconTop GitHub Comments

2reactions
phaustincommented, May 12, 2020

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:

  1. install windows terminal from the microsoft store
  2. use a powershell profile (not the anaconda shortcut) to start a conda environment with readline editing and environmental variables:

https://github.com/eoas-ubc/eoas_tlef/blob/master/docs/support_files/Microsoft.PowerShell_profile.ps1

1reaction
chrisjsewellcommented, Jun 25, 2021

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

Read more comments on GitHub >

github_iconTop 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 >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found