savemethod. I'm looking at the example for this function at http://lexiconjl.readthedocs.org/en/latest/api/Lexicon/, and I'm wondering how to get multiple pages in the resulting html build? Is it true that Lexicon produces one page per
Module? I'm asking because I have a module with many things to document, and so would like to have subpages. You could argue that I should split that
Moduleup into more
Modules. just trying to understand. thanks!
filtermethods to separate out which entries you want per page:
import Docile, Lexicon all_meta = Docile.Interface.metadata(Docile.Collector) only_functions = filter(all_meta) do ent Docile.Interface.category(ent) == :function end only_methods = filter(all_meta) do ent Docile.Interface.category(ent) == :method end only_macros = filter(Docile.Interface.metadata(Docile.Legacy)) do ent Docile.Interface.category(ent) == :macro end Lexicon.save("functions.md", MIME"text/md"(), only_functions, Lexicon.Config()) Lexicon.save("methods.md", MIME"text/md"(), only_methods, Lexicon.Config()) Lexicon.save("macros.md", MIME"text/md"(), only_macros, Lexicon.Config())
The interface is undergoing some changes at the moment so things definitely aren't as simple to do as I'd like.
I'd recommend using the markdown output rather than HTML, since the HTML hasn't had very much attention recently.
submodulesfunction used in Docile that you could use to implement something like what you want. https://github.com/MichaelHatherly/Docile.jl/blob/f648849035531255854ad2168f94c37c719a7bf9/src/Collector/search.jl#L3-L15. I'll probably add something like this to Lexicon during the next major release.