# Help with tips on debugging Travis: Documenter generation of HTML

**URL:** <https://discourse.julialang.org/t/help-with-tips-on-debugging-travis-documenter-generation-of-html/1078>\
**Category:** Offtopic\
**Created:** [December 20, 2016, 11:48pm UTC](https://discourse.julialang.org/t/help-with-tips-on-debugging-travis-documenter-generation-of-html/1078 "2016-12-20T23:48:22Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![tshort](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tshort/32/43_2.png) [@tshort](https://discourse.julialang.org/u/tshort)\
**Post date:** [December 20, 2016, 11:48pm UTC](https://discourse.julialang.org/t/help-with-tips-on-debugging-travis-documenter-generation-of-html/1078/1 "2016-12-20T23:48:22Z")

</div>

I’m trying out Documenter’s ability to generate HTML, and I’m trying to get Travis to do this automatically. Documenter works fine locally, but Travis complains and doesn’t generate HTML. Does anyone have any tips for debugging this sort of thing?

The output of Travis is here:

[https://s3.amazonaws.com/archive.travis-ci.org/jobs/185349274/log.txt](https://s3.amazonaws.com/archive.travis-ci.org/jobs/185349274/log.txt)

One thing I’m doing a bit different is autogenerating some Markdown files. One of those autogenerated files is the subject of the error message.

---

<div class="post-metadata">

**Author:** ![ChrisRackauckas](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/chrisrackauckas/32/77_2.png) [@ChrisRackauckas](https://discourse.julialang.org/u/ChrisRackauckas)\
**Post date:** [December 20, 2016, 11:50pm UTC](https://discourse.julialang.org/t/help-with-tips-on-debugging-travis-documenter-generation-of-html/1078/2 "2016-12-20T23:50:25Z")

</div>

In Travis, set an environment variable `DOCUMENTER_DEBUG` with value `true` and push a new commit. That will make it print out debugging info.

---

<div class="post-metadata">

**Author:** ![mike](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mike/32/39_2.png) [@mike](https://discourse.julialang.org/u/mike)\
**Post date:** [December 21, 2016, 5:33am UTC](https://discourse.julialang.org/t/help-with-tips-on-debugging-travis-documenter-generation-of-html/1078/3 "2016-12-21T05:33:06Z")

</div>

> [@ChrisRackauckas](#):
>
> set an environment variable DOCUMENTER\_DEBUG with value true and push a new commit.

The error is happening prior to `deploydocs` so setting the debug variable won’t help in this case.

> [@tshort.rlists](#):
>
> One thing I’m doing a bit different is autogenerating some Markdown files. One of those autogenerated files is the subject of the error message.

The generated files are being created in the wrong directory. In `.travis.yml` the command is

```julia
cd(Pkg.dir("Sims")); include(joinpath("docs", "make.jl"))

```

whereas I assume locally you’re doing something like `julia make.jl` while in the `docs/` directory. Just adjust the paths in your travis script so that you `include` from within `docs/` and everything should work correctly.

Re: generated files: perhaps have a look at [`@autodocs`](https://juliadocs.github.io/Documenter.jl/stable/man/syntax.html#@autodocs-block-1) and see if that helps to simplify the `make.jl` script. I’m open to ideas for improvements to it if it’s doesn’t do everything you need (open an issue rather than going off-topic here is probably best).

---

<div class="post-metadata">

**Author:** ![tshort](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/tshort/32/43_2.png) [@tshort](https://discourse.julialang.org/u/tshort)\
**Post date:** [December 22, 2016, 6:11pm UTC](https://discourse.julialang.org/t/help-with-tips-on-debugging-travis-documenter-generation-of-html/1078/4 "2016-12-22T18:11:44Z")

</div>

Thanks for the help! I needed both tips to get it working.
