将Sphinx文档设为私有

Question

所以这是一个经常发生的问题，我没有资格解决它，但我需要解决它，因此我将必须学习。见这个问题的一个过时的/没有可行的解决方案，并为没有回答过类似的问题。

基本问题，我需要提供私有python模块的文档。该项目托管在gitlab上，我使用CI生成文档。它们对全世界都是可见的，这并不理想。这是一个已知问题，gitlab可能最终会提供解决方案。我等不了那么久。我的计划是使用此项目（crypto-js）代码并将其包含在dockerRunner中。不幸的是，我不知道该怎么做，甚至是否可能。

我的ci.yml是：

image: tsgkadot/sphinx-plantuml

stages:
  - build
pages:
  stage: build
  script:
    #- pip install -r requirements.txt -U
    - sphinx-build -b html ./doc public
  artifacts:
    paths:
      - public
  tags:
    - docker

据我所知，crypto-js与之类似的接口是：

var unencrypted = document.getElementById('unencrypted_html').value;
var passphrase = document.getElementById('passphrase').value;
var encrypted = CryptoJS.AES.encrypt(unencrypted, passphrase);
var hmac = CryptoJS.HmacSHA256(encrypted.toString(), CryptoJS.SHA256(passphrase)).toString();
var encryptedMsg = hmac + encrypted;

从sphinx生成的html文件必须传递给js，然后输出替换文件。另外，我读到有可能在sphinx中包含js，但我看不到文件如何加密自己。我不介意使用一个密码来加密所有文档，然后与相关各方共享密码。

我也在gitlab的相关问题上发布了这些想法，但是由于他们正在寻找更完整的解决方案，因此似乎没有什么进展。

如果有像gitlab这样的git托管服务提供诸如私有存储库私有的页面之类的服务，我也很乐意切换到该服务。关于如何实现这一点的任何想法或指示？

Answer 1

所以我做了一个基本的修复程序，现在可以使用：

这个gitlab仓库在这里显示了一个有效的例子。

它使用静态密码保护，本期也将对此进行讨论。