yelp-build: link to pages in another directory?
- From: "A. Jesse Jiryu Davis" <jesse emptysquare net>
- To: gnome-doc-devel-list gnome org
- Subject: yelp-build: link to pages in another directory?
- Date: Sun, 26 Apr 2015 17:10:52 -0400
Hi Gnome folk,
I'm taking over a project, the MongoDB C Driver, that Christian Hergert documented in Mallard. It builds with yelp-build. The documentation is split into two directories, one here:
And the other here:
Pages in the latter directory include references to pages in the former. (But not vice versa.) We build each directory with a separate invocation of "yelp-build html <directory>".
THE PROBLEM: when a page in the "mongo-c-driver" directory reference pages in the "libbson" directory, our current build system doesn't make correct HTML links. For example, the "bson_error_t" link here:
... tries to link to a bson_error_t.html page in the *same* directory, instead of to the proper page here:
I tried just putting the two invocations into a single one:
$ yelp-build html libbson/doc mongo-c-driver/doc
But that munges all the documentation together badly, instead of link from one to the other. Here's the output of that:
How can I tell yelp-build to take a reference from a file in "mongo-c-driver/" to an id in the other directory, like "bson_error_t", and render it as a URL like "../libbson/bson_error_t.html"? Instead of what it does right now, which is render a link to "bson_error_t.html" in the current directory, where no such file exists.
Thanks!
Jesse
[Date Prev][
Date Next] [Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]