我正在为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
字段,并使用一个小脚本(或只是一行代码)将文档移动到更好的位置。