From 538642b269d891ea064458d5a5dacc21bf472b6a Mon Sep 17 00:00:00 2001 From: Eduardo Cueto Mendoza Date: Sat, 13 Jun 2020 23:48:49 -0600 Subject: [PATCH] Written some text --- faq/troubleshooting.md | 55 ----------------------------------- index.md | 66 +----------------------------------------- 2 files changed, 1 insertion(+), 120 deletions(-) delete mode 100644 faq/troubleshooting.md diff --git a/faq/troubleshooting.md b/faq/troubleshooting.md deleted file mode 100644 index 6ab700a..0000000 --- a/faq/troubleshooting.md +++ /dev/null @@ -1,55 +0,0 @@ -@def hascode = true - -# FAQ - Troubleshooting - -This page is about some of the known errors you may encounter when using Franklin and how to deal with them. -If you encounter an error that is not mentioned here, then it's probably a bug and it would be great if you could open an issue! - -\toc - -## Error on interruption - -You may (rarely) get an an error thrown at you when interrupting the server with `+C`, particularly when using Juno. -There are a couple of reasons this may happen, both unrelated to Franklin. - -### Juno - -Juno (very rarely) crashes if you coincidentally press `+C` while Juno is doing something in the background (Juno issue [#309](https://github.com/JunoLab/Juno.jl/issues/309)). - -The stacktrace you will see will seem particularly obscure, for instance: - -``` -InterruptException: -_string_n at string.jl:60 [inlined] -StringVector at iobuffer.jl:31 [inlined] -#IOBuffer#320(::Bool, ::Bool, ::Nothing, ::Bool, ::Int64, ::Int64, ::Type{Base.GenericIOBuffer{Array{UInt8,1}}}) at iobuffer.jl:114 -(...) -``` - -or - -``` -julia> "miniERROR: InterruptException: -Stacktrace: - [1] poptaskref(::Base.InvasiveLinkedListSynchronized{Task}) at ./task.jl:564 - [2] wait() at ./task.jl:591 -(...) -``` - -**Solution**: ignore the error, kill then restart the server or, failing that, kill and restart Julia. - -### Not-Juno - -The [`LiveServer.jl`](https://github.com/asprionj/LiveServer.jl) package, which handles the live-serving of the files, is based upon [`HTTP.jl`](https://github.com/asprionj/LiveServer.jl). -The latter has a fairly complex codebase with a number of asynchronous tasks and is known to sometimes crash in (somewhat) mysterious ways. - -If the stacktrace mentions `uv_write`, `uv_write_async`, `libuv` or something of the sorts, then this is an example of _known but mysterious way_. - -Like the "Juno" case, these errors are caused when you happen to press interrupt just as the package was doing something important in the background. -This is very rare but can happen and you can safely ignore it. - -**Solution**: ignore the error, kill then restart the server or, failing that, kill and restart Julia. - -## IOStream error - -See the comment about HTTP.jl in the [subsection above](#Not-Juno-1). diff --git a/index.md b/index.md index 8e1753b..a8cd192 100644 --- a/index.md +++ b/index.md @@ -30,68 +30,4 @@ end ## A bit about myself -My interest in science started from a very early age I was in love with physics because a teacher in elementary school had a copy of the book `COSMOS` which he lend me and I was marveled by the words of [Carl Sagan](https://en.wikipedia.org/wiki/Carl_Sagan) - - \ No newline at end of file +My interest in science started from a very early age I was in love with physics because a teacher in elementary school had a copy of the book `COSMOS` which he lend me and I was marveled by the words of [Carl Sagan](https://en.wikipedia.org/wiki/Carl_Sagan)