Merge pull request #86 from tpapp/flexible-fig-path

Added a formatter for Hugo.

src/formatters.jl

@@ -85,6 +85,28 @@ const github = Markdown("Github markdown",
                                 :doctype=> "github"
                                                ))
 
+"""
+Formatter for Hugo: https://gohugo.io/
+
+When `uglyURLs` is `false`, prepend figure path by `..`.
+"""
+immutable Hugo
+    description::AbstractString
+    formatdict::Dict{Symbol,Any}
+    uglyURLs::Bool
+end
+
+const hugo = Hugo("Hugo markdown (using shortcodes)",
+                  Dict{Symbol,Any}(
+                      :codestart => "````julia",
+                      :codeend => "````\n\n",
+                      :outputstart => "````",
+                      :outputend => "````\n\n",
+                      :fig_ext => ".png",
+                      :extension => "md",
+                      :doctype => "hugo"),
+                  false)
+
 #Julia markdown
 type JMarkdown2HTML
  description::AbstractString
@@ -394,6 +416,22 @@ function formatfigures(chunk, docformat::Markdown)
     return result
 end
 
+function formatfigures(chunk, docformat::Hugo)
+    relpath = docformat.uglyURLs ? "" : ".."
+    function format_shortcode(index_and_fig)
+        index, fig = index_and_fig
+        if index > 1
+            warn("Only the first figure gets a caption.")
+            title_spec = ""
+        else
+            caption = chunk.options[:fig_cap]
+            title_spec = caption == nothing ? "" : "title=\"$(caption)\" "
+        end
+        "{{< figure src=\"$(joinpath(relpath, fig))\" $(title_spec) > }}"
+    end
+    mapreduce(format_shortcode, *, "", enumerate(chunk.figures))
+end
+
 function formatfigures(chunk, docformat::MultiMarkdown)
     fignames = chunk.figures
     caption = chunk.options[:fig_cap]
@@ -480,6 +518,7 @@ const formats = Dict{AbstractString, Any}("tex" => tex,
                                           "pandoc2pdf" => pandoc,
                                           "md2pdf" => md2tex,
                                           "github" => github,
+                                          "hugo" => hugo,
                                           "multimarkdown" => multimarkdown,
                                           "rst" => rst,
                                           "asciidoc" => adoc,