feat(ci): add ci submodule

.github/workflows/base-ci.yml

@@ -29,20 +29,29 @@ jobs:
     container: baoproject/bao:latest
     steps:
       - uses: actions/checkout@v2
-      - run: | 
+        with:
+          fetch-depth: 0
+          submodules: recursive
+      - run: |
           git config --global --add safe.directory $(realpath .)
           make spelling
 
-  format-check:
+  docformat:
     runs-on: ubuntu-latest
     container: baoproject/bao:latest
     steps:
       - uses: actions/checkout@v2
-      - run: doc8 source/ --ignore D000
+        with:
+          fetch-depth: 0
+          submodules: recursive
+      - run: make rst-format
 
   build:
     runs-on: ubuntu-latest
     container: baoproject/bao:latest
     steps:
       - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+          submodules: recursive
       - run: make html

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "ci"]
+	path = ci
+	url = [email protected]:bao-project/bao-ci.git

Makefile

@@ -1,6 +1,6 @@
 # Minimal makefile for Sphinx documentation
 #
-
+root_dir:=$(realpath .)
 # You can set these variables from the command line, and also
 # from the environment for the first two.
 SPHINXOPTS    ?= -W -a
@@ -12,16 +12,17 @@ BUILDDIR      = build
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
-.PHONY: help format Makefile ci
+.PHONY: help
+
+# Instantiate CI rules
+include ci/ci.mk
 
-# doc8 format checker
-# Checks the format of the reST sources.
-format:
-	@doc8 source/ --ignore D000
+$(call ci, rstformat, $(SOURCEDIR))
 
 # 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)
 
-ci: format html spelling
+ci: rst-format html spelling
+.PHONY: ci