Add index.html generation for redirecting to ./stable or ./dev

src/Documenter.jl

@@ -607,6 +607,10 @@ function git_push(
             # This must always happen after the folder copying.
             Writers.HTMLWriter.generate_version_file(joinpath(dirname, "versions.js"), entries, symlinks)
 
+            # Create the index.html file to redirect ./stable or ./dev.
+            # This must always happen after the folder copying.
+            Writers.HTMLWriter.generate_redirect_file(joinpath(dirname, "index.html"), entries, devurl, versions)
+
             # generate the symlinks, make sure we don't overwrite devurl
             cd(dirname) do
                 for kv in symlinks

src/Writers/HTMLWriter.jl

@@ -1405,6 +1405,30 @@ function generate_version_file(versionfile::AbstractString, entries, symlinks =
     end
 end
 
+# write redirect file
+function generate_redirect_file(redirectfile::AbstractString, entries, devurl, versions)
+    # If `versions` contains "stable"=>"v^" and `entries` contains "stable", then version="stable".
+    # In other cases, version="dev".
+
+    comment = "<!--This file is automatically generated by Documenter.jl-->"
+
+    isfile(redirectfile) && !startswith(read(redirectfile, String), comment) && return
+
+    version = devurl
+    stable_index = findfirst(v -> last(v)=="v^", versions)
+    if stable_index !== nothing
+        stable_version = first(versions[stable_index])
+        if stable_version in entries
+            version = stable_version
+        end
+    end
+
+    open(redirectfile, "w") do buf
+        println(buf, comment)
+        println(buf, "<meta http-equiv=\"refresh\" content=\"0; url=./$(version)/\"/>")
+    end
+end
+
 function generate_siteinfo_file(dir::AbstractString, version::AbstractString)
     open(joinpath(dir, "siteinfo.js"), "w") do buf
         println(buf, "var DOCUMENTER_CURRENT_VERSION = \"$(version)\";")

test/htmlwriter.jl

@@ -3,7 +3,7 @@ module HTMLWriterTests
 using Test
 using Documenter
 using Documenter: DocSystem
-using Documenter.Writers.HTMLWriter: HTMLWriter, generate_version_file, expand_versions
+using Documenter.Writers.HTMLWriter: HTMLWriter, generate_version_file, generate_redirect_file, expand_versions
 
 function verify_version_file(versionfile, entries)
     @test isfile(versionfile)
@@ -16,6 +16,13 @@ function verify_version_file(versionfile, entries)
     end
 end
 
+function verify_redirect_file(redirectfile, version)
+    @test isfile(redirectfile)
+    content = read(redirectfile, String)
+
+    occursin(content, "url=./$(version)/")
+end
+
 @testset "HTMLWriter" begin
     @test isdir(HTMLWriter.ASSETS)
     @test isdir(HTMLWriter.ASSETS_SASS)
@@ -104,6 +111,8 @@ end
 
     mktempdir() do tmpdir
         versionfile = joinpath(tmpdir, "versions.js")
+        redirectfile = joinpath(tmpdir, "index.html")
+        devurl = "dev"
         versions = ["stable", "dev",
                     "2.1.1", "v2.1.0", "v2.0.1", "v2.0.0",
                     "1.1.1", "v1.1.0", "v1.0.1", "v1.0.0",
@@ -124,6 +133,8 @@ end
                            "v1.1.1"=>"1.1.1", "v0.1.1"=>"0.1.1"]
         generate_version_file(versionfile, entries)
         verify_version_file(versionfile, entries)
+        generate_redirect_file(redirectfile, entries, devurl, versions)
+        verify_redirect_file(redirectfile, "stable")
 
         versions = ["v#"]
         entries, symlinks = expand_versions(tmpdir, versions)
@@ -133,6 +144,8 @@ end
                            "v2.1.1"=>"2.1.1", "v1.1.1"=>"1.1.1", "v0.1.1"=>"0.1.1"]
         generate_version_file(versionfile, entries)
         verify_version_file(versionfile, entries)
+        generate_redirect_file(redirectfile, entries, devurl, versions)
+        verify_redirect_file(redirectfile, "dev")
 
         versions = ["v#.#.#"]
         entries, symlinks = expand_versions(tmpdir, versions)
@@ -143,6 +156,8 @@ end
                            "v2.0"=>"v2.0.1", "v1.1"=>"1.1.1", "v1.0"=>"v1.0.1", "v0.1"=>"0.1.1"]
         generate_version_file(versionfile, entries)
         verify_version_file(versionfile, entries)
+        generate_redirect_file(redirectfile, entries, devurl, versions)
+        verify_redirect_file(redirectfile, "dev")
 
         versions = ["v^", "devel" => "dev", "foobar", "foo" => "bar"]
         entries, symlinks = @test_logs(
@@ -155,6 +170,8 @@ end
         @test ("devel" => "dev") in symlinks
         generate_version_file(versionfile, entries)
         verify_version_file(versionfile, entries)
+        generate_redirect_file(redirectfile, entries, devurl, versions)
+        verify_redirect_file(redirectfile, "dev")
 
         versions = ["stable" => "v^", "dev" => "stable"]
         @test_throws ArgumentError expand_versions(tmpdir, versions)