feat(m2r): use m2r to convert automatic .md files to .rst

.travis.yml

@@ -46,6 +46,8 @@ jobs:
       language: node_js
       node_js: lts/*
       before_install: skip
+      # install:
+      #   - sudo pip install m2r
       script:
         # Update `AUTHORS.md`
         - export MAINTAINER_TOKEN=${GH_TOKEN}

docs/index.rst

@@ -8,11 +8,13 @@ Welcome to template-formula's documentation!
 ============================================
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
    :caption: Contents
    :numbered:
    :glob:
 
    README <README>
    CONTRIBUTING
    TOFS_pattern
+   AUTHORS
+   CHANGELOG

release.config.js

@@ -14,7 +14,7 @@ module.exports = {
         prepareCmd: 'sh ./update_FORMULA.sh ${nextRelease.version}',
       }],
       ['@semantic-release/git', {
-        assets: ['*.md', 'FORMULA'],
+        assets: ['*.md', 'docs/*.rst', 'FORMULA'],
       }],
       '@semantic-release/github',
   ],

update_FORMULA.sh

@@ -1,2 +1,13 @@
 #!/bin/sh
 sed -i -e "s_^\(version:\).*_\1 ${1}_" FORMULA
+
+# m2r
+sudo -H python3 -m pip install m2r
+cp *.md docs/
+cd docs/
+m2r --overwrite *.md
+sed -i -e '/^=.*$/s/=/-/g' CHANGELOG.rst
+sed -i -e '1,4s/-/=/g' CHANGELOG.rst
+cat AUTHORS.rst
+cat CHANGELOG.rst
+cd ..