Rustdoc和Travis上了h页

Question

我用cargo doc生成了文档cargo doc，它是在目标/doc目录中生成的。我希望允许用户在没有本地副本的情况下查看这些文档，但我想不出如何将这些文档推送到存储库的gh页面分支。崔维斯·CI会帮助我自动做到这一点，但我也无法让它发挥作用。我遵循本指南，并设置了一个.travis.yml文件和一个deploy.sh脚本。根据构建日志，一切都进行得很好，但是gh页面分支从未得到更新。我的操作系统是Windows 7。

Answer 1

最好使用特拉维斯-货物，它的目的是简化部署docs，并且还具有其他特性。它的自述文件提供了一个.travis.yml文件的示例，尽管在最简单的形式下它可以如下所示：

language: rust
sudo: false

rust:
  - nightly
  - beta
  - stable

before_script:
  - pip install 'travis-cargo<0.2' --user && export PATH=$HOME/.local/bin:$PATH

script:
  - |
      travis-cargo build &&
      travis-cargo test &&
      travis-cargo --only beta doc

after_success:
  - travis-cargo --only beta doc-upload

# needed to forbid travis-cargo to pass `--feature nightly` when building with nightly compiler
env:
  global:
    - TRAVIS_CARGO_NIGHTLY_FEATURE=""

这是非常自我描述，所以这是显而易见的，例如，如果您想要使用另一个锈蚀释放培训来构建文档。

为了使上面的.travis.yml工作，您需要以某种方式设置GH_TOKEN。基本上有两种方法可以做到这一点:通过加密的字符串在.travis.yml内部，或者通过在Travis本身中在项目选项中配置它。我更喜欢后一种方式，所以我不需要安装travis命令行工具或污染我的.travis.yml (因此上面的配置文件不包含secure选项)，但您可以选择其他方式。