feat: write pages with .html permalink to corresponding file(#115)

Author: joelpaulkoch

lib/mix/tasks/tableau.build.ex

@@ -55,11 +55,12 @@ defmodule Mix.Tasks.Tableau.Build do
     token = mods |> extensions_for(:pre_write) |> run_extensions(token)
 
     for %{body: body, permalink: permalink} <- pages do
-      dir = Path.join(out, permalink)
+      file_path = build_file_path(out, permalink)
+      dir = Path.dirname(file_path)
 
       File.mkdir_p!(dir)
 
-      File.write!(Path.join(dir, "index.html"), body)
+      File.write!(file_path, body)
     end
 
     if File.exists?(config.include_dir) do
@@ -71,6 +72,15 @@ defmodule Mix.Tasks.Tableau.Build do
     token
   end
 
+  @file_extensions [".html"]
+  defp build_file_path(out, permalink) do
+    if Path.extname(permalink) in @file_extensions do
+      Path.join(out, permalink)
+    else
+      Path.join([out, permalink, "index.html"])
+    end
+  end
+
   defp validate_config(module, raw_config) do
     if function_exported?(module, :config, 1) do
       module.config(raw_config)

test/mix/tasks/tableau.build_test.exs

@@ -194,4 +194,30 @@ defmodule Mix.Tasks.Tableau.BuildTest do
     assert File.exists?(Path.join(out, "/a-bing-bong-blog-post/index.html"))
     assert File.exists?(Path.join(out, "/some/deeply/nested/page/my-page/index.html"))
   end
+
+  @tag :tmp_dir
+  test "writes page with permalink with .html file extension to corresponding file", %{tmp_dir: out} do
+    pages = out |> Path.join("_pages") |> tap(&File.mkdir_p!/1)
+    Application.put_env(:tableau, Tableau.PageExtension, enabled: true, dir: pages)
+
+    File.write(Path.join(pages, "404.md"), """
+    ---
+    layout: Mix.Tasks.Tableau.BuildTest.RootLayout
+    title: A 404 error page
+    permalink: /404.html
+    ---
+
+    ## Ooops
+
+    Nothing here.
+    """)
+
+    with_io(:stderr, fn ->
+      with_log(fn ->
+        _documents = Build.run(["--out", out])
+      end)
+    end)
+
+    assert File.exists?(Path.join(out, "/404.html"))
+  end
 end