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

244 commits

This branch
This branch
All branches
Author SHA1 Message Date
benjamin melançon
54d4e3dd5c Place note at bottom 2020-06-08 09:15:47 -04:00
benjamin melançon
d3deb33127 Fix note syntax 2020-06-07 23:45:06 -04:00
benjamin melançon
9cbac6e931 Convert to markdown & make use of our link flexibility 2020-06-07 23:15:07 -04:00
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