Attempt to fix Literate + LiveServer + Documenter on Windows#203
Open
Ickaser wants to merge 1 commit into
Open
Attempt to fix Literate + LiveServer + Documenter on Windows#203Ickaser wants to merge 1 commit into
Ickaser wants to merge 1 commit into
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
I ran into #181 , and this PR basically implements the one-line suggested fix there. As far as I can tell, it seems to fix things on the LiveServer end.
HOWEVER: the slick functionality of
servedocsis still not operational on my Windows machine. I'm documenting the errors here, although I'm pretty sure it has more to do with either Documenter or upstream Julia or general Windows struggles.Following the example at https://juliadocs.org/LiveServer.jl/stable/man/ls+lit/, I set up an example directory. (In the
make.jl, I addremotes=nothingto themakedocscall--can add that to PR somewhere if useful.) Then, in the REPL, I executeWhen I open
localhost:8000everything looks alright. Then, I make a minor modification toindex.md(like, adding some plain text), and LiveServer triggers a rebuild, emitting the following (plus some other noise about not having a Git repo):At this point, it hangs indefinitely. If I make another edit to
index.md, it repeats this little loop. Ctrl+C kills LiveServer as expected, then if I runservedocs(...)again, I getwhich suggests to me that for some reason Documenter is getting hung up. At this point, if I delete the
builddirectory myself from a file explorer, I can runservedocsagain and things start over.