You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
As discovered in #68, the way symlinks are handled in Windows with Git is problematic, and so to be on the safe side, we'll disable MultiDocumenter deployments on Windows for now. This issue tracks fixing the underlying symlink problems.
The fundamental problem with Windows appears to be that Git does not create symlinks by default in Windows. Instead, what are symlinks on the Git branch end up being simple text files. This is a problem, since Documenter deployments rely on organizing things with symlinks, and MultiDocumenter wants to traverse those symlinks sometimes.
You can force Git to create symlinks with git config --global core.symlinks true (although I think you also need to make sure you have the appropriate permissions, which includes being an administrator on older Windows versions, i.e. < 11?). But those still do not work -- Julia's isdir, for example, will throw permission errors even when running as an admin.
Just as a thought: one potential fix could be to use git ls-files -s to go through the list of files and "dereference" the symlinks ourselves (i.e. remove the text or symlink file and create a copy the destination directory). Unfortunately, it doesn't look like there's an option for Git to have it do that automatically when it checks out the repo.
The text was updated successfully, but these errors were encountered:
As discovered in #68, the way symlinks are handled in Windows with Git is problematic, and so to be on the safe side, we'll disable MultiDocumenter deployments on Windows for now. This issue tracks fixing the underlying symlink problems.
A brief description of the blockers faced in #68:
git config --global core.symlinks true
(although I think you also need to make sure you have the appropriate permissions, which includes being an administrator on older Windows versions, i.e. < 11?). But those still do not work -- Julia'sisdir
, for example, will throw permission errors even when running as an admin.Just as a thought: one potential fix could be to use
git ls-files -s
to go through the list of files and "dereference" the symlinks ourselves (i.e. remove the text or symlink file and create a copy the destination directory). Unfortunately, it doesn't look like there's an option for Git to have it do that automatically when it checks out the repo.The text was updated successfully, but these errors were encountered: