Replace jldoctest by example (#13)

* replace jldoctest with example

* format

* Update src/trixi_include.jl

Co-authored-by: Hendrik Ranocha <ranocha@users.noreply.github.com>

* fix version of JuliaFormatter

* use old formatting style again

---------

Co-authored-by: Hendrik Ranocha <ranocha@users.noreply.github.com>

Author: JoshuaLampert

.github/workflows/FormatCheck.yml

@@ -28,7 +28,7 @@ jobs:
         #
         # julia  -e 'using Pkg; Pkg.add(PackageSpec(name = "JuliaFormatter", version = "0.13.0"))'
         run: |
-          julia  -e 'using Pkg; Pkg.add(PackageSpec(name = "JuliaFormatter"))'
+          julia  -e 'using Pkg; Pkg.add(PackageSpec(name = "JuliaFormatter", version="1.0.45"))'
           julia  -e 'using JuliaFormatter; format(".")'
       - name: Format check
         run: |

docs/make.jl

@@ -38,7 +38,8 @@ copy_file("LICENSE.md",
           "\n" => "\n> ", r"^" => "# License\n\n> ")
 
 # Make documentation
-makedocs(sitename = "TrixiBase.jl",
+makedocs(modules = [TrixiBase],
+         sitename = "TrixiBase.jl",
          # Provide additional formatting options
          format = Documenter.HTML(
                                   # Disable pretty URLs during manual testing

src/trixi_include.jl

@@ -18,7 +18,9 @@ for ODEs, see the "Miscellaneous" section of the
 
 # Examples
 
-```jldoctest
+```@example
+julia> using TrixiBase, Trixi
+
 julia> redirect_stdout(devnull) do
          trixi_include(@__MODULE__, joinpath(examples_dir(), "tree_1d_dgsem", "elixir_advection_extended.jl"),
                        tspan=(0.0, 0.1))