codoc
codoc copied to clipboard
Support incremental linking and indexing
Assuming that I am reading the code correctly, it seems that the only way to get any meaningful resolution is to run codoc link on an index file (or directory containing such a file), which then performs linking on all files in the index, against all other files in the index.
Ideally, I would like to separate out the list of files for which linked xml is to be produced, from the list of files against which links can be resovled (which should be a superset of the first list).
Something like:
codoc link -I bar/index.xml foo/index.xml -o linked/foo/index.xml
which would read each file in the foo/index.xml index and resolve all the references to files that are either in foo/index.xml or bar/index.xml, and output the resulting linked files in linked/foo/index.xml.
This would allow linking to be done incrementally.
Yes, this isn't supported right now but should be.
I believe this is actually currently possible using -o and --package and linking a file path. There is currently no way to link against trees that are not subtrees of a common root, however. Also, the phasing of index generation needs to be worked on.