agaric/documentation
10
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
141 commits 2 branches 0 tags 1.3 MiB
Commit graph

141 commits

This branch
This branch
All branches
Author SHA1 Message Date
benjamin melançon
9edcaadff2 Remove ReCommonMark rst identifiers 
No longer needed in the world of MyST Parser.
 2020-06-05 20:55:42 -04:00
benjamin melançon
6be50b52d6 Have filename match title 2020-06-05 20:52:57 -04:00
benjamin melançon
75348a4556 Blabbered on about the background 2020-06-05 20:52:22 -04:00
benjamin melançon
0626861e23 Update our notes howto documentation 2020-06-05 20:44:02 -04:00
benjamin melançon
538940874c Back to the simplest requirements 2020-06-03 08:20:05 -04:00
benjamin melançon
b3ef6f57f1 Update to follow conventions defined in readthedocs docs 
Namely: https://docs.readthedocs.io/en/stable/config-file/v2.html
 2020-06-03 08:11:12 -04:00
benjamin melançon
9d5b128b3d Add Read the docs configuration file (introduced 2018 after Drutopia/Agaric docs started) 
Per https://github.com/executablebooks/MyST-Parser/issues/155#issuecomment-638020179
 2020-06-03 07:45:45 -04:00
benjamin melançon
77dfec4535 try with underscore 2020-06-02 23:31:23 -04:00
benjamin melançon
f7e433a863 Just throw things at it 2020-06-02 23:28:36 -04:00
benjamin melançon
702c4eadbe Fix typo 2020-06-02 11:06:12 -04:00
benjamin melançon
5b6bd9f105 Revert "attempt to help it find myst_parser and realize as i type this it's my typo" 
This reverts commit fe23fdb9e4.
 2020-06-02 11:05:50 -04:00
benjamin melançon
fe23fdb9e4 attempt to help it find myst_parser and realize as i type this it's my typo 2020-06-02 11:05:34 -04:00
benjamin melançon
01d74994bc Switch from recommonmark to MyST parser for Sphinx 2020-06-02 10:47:10 -04:00
benjamin melançon
c8325055a8 Add emphasis and make note more sensible *and* note-formatted 
all that is to say, give us a sense of purpose
 2020-06-02 10:02: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
a7d56db04a Almost have a page now 2020-06-01 06:18:37 -04:00
benjamin melançon
a96ed17ad5 Add Zulip section and give up on having an RST-style note' 2020-05-26 12:49:06 -04:00
benjamin melançon
ffcc173715 Try converting note (admonition) to Markdown 
See https://python-markdown.github.io/extensions/admonition/
 2020-05-26 12:28:55 -04:00
benjamin melançon
a7019b6947 Convert link to markdown 2020-05-26 12:22:37 -04:00
benjamin melançon
fde03ce1bd Add old/partial notes on better meeting planning 2020-05-26 12:22:19 -04:00
benjamin melançon
ae99e62c17 Start switching a mal-formatted ReStructuredText page to Markdown 2020-05-26 12:21:53 -04:00
benjamin melançon
62bdd63528 Start decision-making stub 2020-05-13 00:03:47 -04:00
benjamin melançon
daaefe07fe Add facilitation roles 2020-04-10 16:35:08 -04:00
benjamin melançon
15cb127b11 delete stray plaintexted command 2020-04-03 22:56:04 -04:00
benjamin melançon
71b3a4503c Add roles to main contents listing 2020-04-03 22:55:38 -04:00
benjamin melançon
e59352dfa4 Incorporate link into text and soften implication that cooperatives and cooperative principles began in England in 1844 2020-04-03 22:53:12 -04:00
benjamin melançon
60f97bf595 Use consistent markdown styling for headers 2020-04-03 22:51:17 -04:00
benjamin melançon
2f2df09cef Add documentation on roles 2020-04-03 22:50:50 -04:00
benjamin melançon
c15389a15e Note how to run locally 2020-03-24 20:08:53 -04:00
benjamin melançon
fbfe804a89 link to May First 2020-03-24 19:45:05 -04:00
benjamin melançon
f00122f18f Move generic steps from wiki to public doc here 2020-03-24 19:40:26 -04:00
benjamin melançon
6e859f4237 Add calendars page to main index 2020-03-23 23:35:39 -04:00
benjamin melançon
da3558ff09 Finish CalDAV documentation 2020-03-23 23:34:04 -04:00
benjamin melançon
8a969ccc98 Integrate detailed steps with images for adding calendar 2020-03-23 20:12:01 -04:00
benjamin melançon
c6eb992011 Require latest recommonmark so it'll do alt text correctly 
https://github.com/readthedocs/recommonmark/issues/88
 2020-03-23 19:13:49 -04:00
benjamin melançon
5adee33fa4 Add first step to adding NextCloud calendar to thunderbird plus all images 2020-03-23 18:36:19 -04:00
benjamin melançon
78fe6e358f Mark up our calendars page with RST 2020-03-23 14:17:26 -04:00
benjamin melançon
5319c32cbe Try a link to our non-annotated calendars page 2020-03-23 14:11:50 -04:00
benjamin melançon
cdea22d2dc Add stub calendars page, with test links 2020-03-23 14:09:46 -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
9e2fc60cb7 Add *a* title but not identical to as-yet-non-working RST slug 2020-03-23 13:11:50 -04:00
benjamin melançon
633574a7f0 Add link to public raw notes (and also trigger rebuild of page to test link to translation 
.. now that we've added a rst section at the top of the translation markdown)
 2020-03-23 12:58:50 -04:00
benjamin melançon
c864851625 Add rst-powered name to translation markdown-formatted page 2020-03-23 12:49:28 -04:00
benjamin melançon
0f280fde83 Add test with no RST in target at all 2020-03-23 12:46:22 -04:00
benjamin melançon
077df3b62e Doesn't look like we'll need any additional requirements at all! 2020-03-23 12:41:47 -04:00
benjamin melançon
9ce02fc8f1 Switch to name-only links to see if eval_rst is truly working now 2020-03-23 12:36:00 -04:00
benjamin melançon
37d185ad01 Update our copyright date 2020-03-23 12:27:26 -04:00