ExDoc 介紹

要 @doc 產生 HTML 格式的文件和原始碼 @moduledoc 屬性，新增 ex_doc 和降價的處理器，現在 ExDoc 支援撥出 ， Pandoc ，農村舞會和 Cmark ，作為依賴到你 mix.exs 檔案：

# config/mix.exs

def deps do
  [{:ex_doc, "~> 0.11", only: :dev},
   {:earmark, "~> 0.1", only: :dev}]
end

如果要使用其他 Markdown 處理器，可以在更改降價工具部分中找到更多資訊。

你可以在 Elixir @doc 和 @moduledoc 屬性中使用 Markdown。

然後，執行 mix docs。

要記住的一件事是 ExDoc 允許配置引數，例如：

  def project do
    [app: :my_app,
     version: "0.1.0-dev",
     name: "My App",
     source_url: "https://github.com/USER/APP",
     homepage_url: "http://YOUR_PROJECT_HOMEPAGE",
     deps: deps(),
     docs: [logo: "path/to/logo.png",
            output: "docs",
            main: "README",
            extra_section: "GUIDES",
            extras: ["README.md", "CONTRIBUTING.md"]]]
  end

你可以使用 mix help docs 檢視有關此配置選項的更多資訊