如何强制Oasis在给定目录中构建文档



我正在为OCaml项目使用Oasis构建系统,我想构建文档并在${projectroot}/doc/api/中获得它。

现在,我的_oasis文件是这样的:

OASISFormat: 0.4
Name: MyProject
Version: 0.1alpha
Plugins: META (0.4)
BuildTools: ocamlbuild
AlphaFeatures: ocamlbuild_more_args
PostDistcleanCommand: $rm _tags myocamlbuild.ml setup.ml setup.data
Document api
Title: MyProject API
Type: ocamlbuild (0.4)
BuildTools: ocamldoc
XOCamlbuildPath: src
XOCamlbuildExtraArgs: -docflags -d,doc/api,-colorize-code,-charset,utf-8

然后,运行以下命令:

$> oasis setup
$> ocaml setup.ml -configure
...
$> ocaml setup.ml -doc
...

然后,我在项目的顶部目录中得到一个链接api.docdir/ --> _build/src/api.docdir/,链接到我期望的文档。但是,似乎没有考虑到带有附加参数的-d doc/api

我错过了什么?

正确的方法是使用install命令,将您的文档(以及其他数据)复制到适当的位置,可以使用configure命令或InstallDir字段进行自定义。

同样,如果您仍然希望在项目中迁移文档,而不进行安装,那么您可以使用PostCommand字段,并使用一个小脚本(或只是一行代码)将文档移动到更好的位置。

相关内容

  • 没有找到相关文章

最新更新