Commit graph

13 commits

Author SHA1 Message Date
benjamin melançon
01d74994bc Switch from recommonmark to MyST parser for Sphinx 2020-06-02 10:47:10 -04:00
benjamin melançon
80569c6037 Add MyST markdown to be able to do admonitions (notes)
Thanks to https://github.com/readthedocs/recommonmark/issues/189#issuecomment-637440853
comment by chrisjsewell
2020-06-02 10:01:16 -04:00
benjamin melançon
31c39db060 Nope it's probably source parsers that's obsoleted by autodoc 2020-03-23 13:53:59 -04:00
benjamin melançon
04f8a49ac6 Try commenting out thing recommonmark's conf.py doesn't have
Trying to avoid this error:

 Running Sphinx v1.8.5
loading translations [en]... done
making output directory...

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/agaric-documentation/envs/latest/lib/python2.7/site-packages/sphinx/cmd/build.py", line 303, in build_main
    args.tags, args.verbosity, args.jobs, args.keep_going)
  File "/home/docs/checkouts/readthedocs.org/user_builds/agaric-documentation/envs/latest/lib/python2.7/site-packages/sphinx/application.py", line 251, in __init__
    self.emit('config-inited', self.config)
  File "/home/docs/checkouts/readthedocs.org/user_builds/agaric-documentation/envs/latest/lib/python2.7/site-packages/sphinx/application.py", line 510, in emit
    return self.events.emit(event, self, *args)
  File "/home/docs/checkouts/readthedocs.org/user_builds/agaric-documentation/envs/latest/lib/python2.7/site-packages/sphinx/events.py", line 80, in emit
    results.append(callback(*args))
  File "/home/docs/checkouts/readthedocs.org/user_builds/agaric-documentation/envs/latest/lib/python2.7/site-packages/sphinx/util/compat.py", line 38, in deprecate_source_parsers
    app.add_source_parser(suffix, parser)
  File "/home/docs/checkouts/readthedocs.org/user_builds/agaric-documentation/envs/latest/lib/python2.7/site-packages/sphinx/application.py", line 1211, in add_source_parser
    self.registry.add_source_parser(*args, **kwargs)
  File "/home/docs/checkouts/readthedocs.org/user_builds/agaric-documentation/envs/latest/lib/python2.7/site-packages/sphinx/registry.py", line 310, in add_source_parser
    filetype)
ExtensionError: source_parser for 'md' is already registered

Extension error:
source_parser for 'md' is already registered
2020-03-23 13:49:38 -04:00
benjamin melançon
8d001ad2b1 Add options enabled in recommonmark repository
That powers https://recommonmark.readthedocs.io/en/latest/index.html
2020-03-23 13:38:54 -04:00
benjamin melançon
ef376e3dcd Try removing deprecated option even set to false 2020-03-23 13:19:54 -04:00
benjamin melançon
37d185ad01 Update our copyright date 2020-03-23 12:27:26 -04:00
benjamin melançon
1f863190f7 Add Edit on GitLab links 2018-09-05 19:37:44 -04:00
benjamin melançon
a4f34252a5 Add and configure recommonmark 2018-07-22 11:55:35 -04:00
Benjamin Melançon
2e73eccd41 Stick with *project* name
(it is assumed to be documentation for a project, so having documentation
in the project name is redundant for sphinx)
2018-06-17 17:18:26 -04:00
Benjamin Melançon
2174974088 Completed config file 2018-06-17 17:16:44 -04:00
Benjamin Melançon
360adab97f Update (largely replace with new sphinx-quickstart) config file 2018-06-17 16:25:25 -04:00
Benjamin Melançon
c7831ee138 Initial commit
Modified copy of Drutopia sphinx conf file (for Read the Docs)
2018-06-17 15:31:55 -04:00