update conf.py for query help

.github/workflows/generate-query-help-docs.yml

@@ -42,21 +42,21 @@ jobs:
     - name: Query help to markdown
       run: |
         PATH="$PATH:codeql-cli/codeql" python codeql/docs/language/query-help-markdown.py
-  #  - name: Run Sphinx for query help
-  #    uses: ammaraskar/sphinx-action@master
-  #    with:
-  #      docs-folder: "query-help/"
-  #      pre-build-command: "python -m pip install --upgrade recommonmark"
-  #      build-command: "sphinx-build -b html . _build" 
+    - name: Run Sphinx for query help
+      uses: ammaraskar/sphinx-action@master
+      with:
+        docs-folder: "query-help/"
+        pre-build-command: "python -m pip install --upgrade recommonmark"
+        build-command: "sphinx-build -b html . _build" 
     - name: Check docs folder postscript 1
       working-directory: '${{ github.workspace }}/query-help'  
       run: ls -la  
-  #  - name: Check docs folder postscript 2
-  #    working-directory: '${{ github.workspace }}/query-help/_build'  
-  #    run: ls -la 
-    #- name: Upload HTML artifacts
-    #  uses: actions/upload-artifact@v2
-    #  with:
-    #    name: query-help-html
-    #    path: query-help/_build
+    - name: Check docs folder postscript 2
+      working-directory: '${{ github.workspace }}/query-help/_build'  
+      run: ls -la 
+    - name: Upload HTML artifacts
+      uses: actions/upload-artifact@v2
+      with:
+        name: query-help-html
+        path: query-help/_build
     

docs/language/query-help/conf.py

@@ -45,12 +45,12 @@ project = u'CodeQL query help'
 
 # Add md parser to process query help markdown files 
 
-#source_parsers = {
-#   '.md': 'recommonmark.parser.CommonMarkParser',
-#}
-
-source_suffix = ['.rst']
+extensions =['recommonmark']
 
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown',
+}
 
 # -- Project-specifc options for HTML output ----------------------------------------------