yaml-v2

Use a YAML v2 configuration with many options.

(at this time, since V2 is not allowed to all the projects, this project has enabled the feature allow_v2_config_file manually from the Django shell)

YAML file used to build this docs,

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
version: 2

build:
  image: latest

formats: []

sphinx:

  # At this moment, the builder has to match to the DB setting from
  # "Advanced settings" because otherwise we will receive a build
  # error. This behavior could probably change in the future to take
  # precedence by the YAML config. More context on this at
  # https://github.com/rtfd/readthedocs.org/issues/4638
  builder: html

  configuration: docs/conf.py
  fail_on_warning: false

python:
  version: 3.6
  install:
    - requirements: requirements.txt

conda:
    environment: docs/environment.yml

Time

>>> # Build at
>>> import datetime
>>> datetime.datetime.utcnow()  # UTC
datetime.datetime(2020, 10, 20, 17, 1, 44, 92088)