A refined document viewer for Elixir and Phoenix
- ⏩ Dynamic Document Update without
mix docs
- 🌈 Syntax Highlight
- 🐦 Embeddable to Phoenix (1.3 & 1.4 supported)
- 📄 Interactively Execute Function on document
mix.exs
def deps do
[
{:ex_doc_refined, "~> 0.1.1", only: [:dev]}
]
end
Add it to applications (if application
block exists)
def application do
[applications: [:ex_doc_refined]]
end
start your application
$ ➜ iex -S mix
Erlang/OTP 21 [erts-10.1] [source] [64-bit] [smp:16:16] [ds:16:16:10] [async-threads:1] [hipe]
05:51:25.379 [info] ExDocRefined started listening on http://localhost:5600
Interactive Elixir (1.7.4) - press Ctrl+C to exit (type h() ENTER for help)
then open http://localhost:5600
Basically ExDoc Refined can works as standalone elixir app.
But you can also integrate ExDoc Refined with Phoenix as well.
- Add route for ExDocRefined
router.ex
scope "/" do
pipe_through(:browser)
get("/", MyAppWeb.PageController, :index)
end
# Added route for docs
forward("/docs", ExDocRefined.Router)
❗ Phoenix depends Cowboy HTTP server and Cowboy 2.0 had breaking change, so you must change configuration according to Phoenix and Cowboy version.
phoenix | cowboy |
---|---|
~> 1.3 |
~> 1.0 |
Add socket endpoint to your endpoint.ex
.
endpoint.ex
socket("/docs", ExDocRefined.PhoenixSocket)
❗️ This path MUST same with the path you defined in router.
phoenix | cowboy |
---|---|
~> 1.4 |
~> 1.0 |
This case is for if you have upgraded Phoenix 1.3 to 1.4 and still using cowboy 1.0
endpoint.ex
socket "/docs", ExDocRefined.PhoenixSocket,
websocket: true,
longpoll: false
phoenix | cowboy |
---|---|
~> 1.4 |
~> 2.0 |
config/config.exs
Add dispatch option for cowboy.
Please CHANGE app name to your app name. (:my_app
, MyAppWeb
)
config :my_app, MyAppWeb.Endpoint,
http: [
dispatch: [
{:_,
[
{"/docs/websocket", ExDocRefined.WebSocketHandler, []},
{:_, Phoenix.Endpoint.Cowboy2Handler, {MyAppWeb.Endpoint, []}}
]}
]
]
then start the phoenix and open http://localhost:4000/docs in your browser to view docs
If you are using phoenix integration and standalone server is not necessary, you can disable standalone server. Defaults to true
.
config/config.exs
config :ex_doc_refined, standalone: false
If you want to change standalone server port, you can change by specify port
. Defaults to 5600
.
config/config.exs
config :ex_doc_refined, port: 4002
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
- Clone this repo
mix deps.get && iex -S mix
- Open another window to run nuxt.js
cd src && npm install && npm run dev
- UI improvement
- Use ex_doc's function to follow the change of elixir official release
- Provide option to disable function runner on docs
MIT