DOC: Deploy docs to gh-pages from CircleCI - with versioning

.circleci/config.yml

@@ -158,8 +158,8 @@ jobs:
             - /tmp/ds005/derivatives/freesurfer
 
   test_pytest:
-    machine:
-      image: circleci/classic:201711-01
+    docker:
+      - image: circleci/python:latest
     working_directory: /home/circleci/src/smriprep
     steps:
       - checkout
@@ -173,8 +173,7 @@ jobs:
       - run:
           name: Setup Python environment
           command: |
-            pyenv global 3.5.2
-            pip install --upgrade "setuptools>=30.3.0" "pip>=18.1" twine docutils
+            pip install --user --upgrade "setuptools>=30.3.0" "pip>=18.1" twine docutils
       - run:
           name: Check PyPi preconditions
           command: |
@@ -183,7 +182,7 @@ jobs:
       - run:
           name: Install sMRIPrep
           no_output_timeout: 30m
-          command: pip install ".[test]"
+          command: pip install --user ".[test]"
       - run:
           name: Run sMRIPrep tests
           no_output_timeout: 2h
@@ -427,6 +426,53 @@ jobs:
       - store_artifacts:
           path: /tmp/ds054
 
+  build_docs:
+    docker:
+      - image: python:latest
+    environment:
+      - FSLOUTPUTTYPE: NIFTI
+    steps:
+      - checkout
+      - run:
+          name: Install Graphviz
+          command: apt update && apt -y install graphviz
+      - run:
+          name: Install deps
+          command: pip install -r requirements.txt && pip install -r docs/requirements.txt
+      - run:
+          name: Build only this commit
+          command: sphinx-build -W ./docs ./docs/_build/no_version_html
+      - run:
+          name: Generate Docs
+          command: sphinx-versioning -vv build -r ci_doc_deploy ./docs ./docs/_build/html/
+      - persist_to_workspace:
+          root: docs/_build
+          paths: html
+      - store_artifacts:
+          path: ./docs/_build/html
+
+  deploy_docs:
+    docker:
+      - image: node:8.10.0
+    steps:
+      - checkout
+      - attach_workspace:
+          at: docs/_build
+      - run:
+          name: Disable jekyll builds
+          command: touch docs/_build/html/.nojekyll
+      - run:
+          name: Install and configure dependencies
+          command: |
+            npm install -g --silent [email protected]
+            git config user.email "[email protected]"
+            git config user.name "ci-build"
+      - add_ssh_keys:
+          fingerprints:
+            - "45:a6:cb:50:27:5a:c7:39:4c:1f:aa:2c:0f:87:8a:a6"
+      - run:
+          name: Deploy docs to gh-pages branch
+          command: gh-pages --dotfiles --message "[skip ci] Updates" --dist docs/_build/html
 
 workflows:
   version: 2
@@ -446,17 +492,32 @@ workflows:
             tags:
               only: /.*/
 
-      # - build_docs:
-      #     requires:
-      #       - build
-      #     filters:
-      #       branches:
-      #         ignore:
-      #           - /tests?\/.*/
-      #           - /ds005\/.*/
-      #           - /ds054\/.*/
-      #       tags:
-      #         only: /.*/
+      - build_docs:
+          #requires:
+          #  - deploy_docker
+          #  - deploy_pypi
+          filters:
+            branches:
+              ignore:
+                - /tests?\/.*/
+                - /ds005\/.*/
+                - /ds054\/.*/
+            tags:
+              only: /.*/
+
+      - deploy_docs:
+          requires:
+            - build_docs
+            - deploy_docker
+            - deploy_pypi
+          filters:
+            branches:
+              ignore:
+                - /tests?\/.*/
+                - /ds005\/.*/
+                - /ds054\/.*/
+            tags:
+              only: /.*/
 
       - update_cache:
           requires:

CHANGES.rst

@@ -102,4 +102,4 @@ in `poldracklab/fmriprep#1588 <https://github.com/poldracklab/fmriprep/issues/15
 0.0.2 (January 8, 2019)
 ========================
 
-First functional version after forking from fMRIPrep
+* First functional version after forking from fMRIPrep

README.rst

@@ -0,0 +1,11 @@
+.. include:: links.rst
+
+smriprep: A Robust Preprocessing Pipeline for Structural MRI Data
+=================================================================
+
+This pipeline is developed by the `Poldrack lab at Stanford University
+<https://poldracklab.stanford.edu/>`_ for use at the `Center for Reproducible
+Neuroscience (CRN) <http://reproducibility.stanford.edu/>`_, as well as for
+open-source software distribution.
+
+This package is called directly from fMRIPrep_.

docs/Makefile

@@ -0,0 +1,19 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)