Leaflet / Leafdoc

A lightweight NaturalDocs-like LeafletJS-style documentation generator
54 stars 19 forks source link

Output multiple files (f.e. one doc file per source file) #45

Open trusktr opened 5 years ago

trusktr commented 5 years ago

Any thoughts on how to do it?

I am thinking of a few options:

  1. add ability to leafdoc to output to separate files, one per source file, so that it keeps context across all files.
  2. Write to a single file (or stdout), and have a secondary process split files based on some delimiter (maybe also the path/filename.ext included by the delimiter too, for outputting files in the same structure). This would also maintain context across files.
  3. Invoke leafdoc on each file separately, but this currently loses context (from what I can tell). We'd need a way to link across files. Maybe we can treat names as paths to other files, and have only a single class per file? That would be somewhat restrictive and performance heavy though. Hmmm 🤔