Andrey Makarov
417b90a7e5
Improve Markdown code blocks & start moving docs to Markdown style ( #19954 )
...
- add additional parameters parsing (other implementations will just
ignore them). E.g. if in RST we have:
.. code:: nim
:test: "nim c $1"
...
then in Markdown that will be:
```nim test="nim c $1"
...
```
- implement Markdown interpretation of additional indentation which is
less than 4 spaces (>=4 spaces is a code block but it's not
implemented yet). RST interpretes it as quoted block, for Markdown it's
just normal paragraphs.
- add separate `md2html` and `md2tex` commands. This is to separate
Markdown behavior in cases when it diverges w.r.t. RST significantly —
most conspicously like in the case of additional indentation above, and
also currently the contradicting inline rule of Markdown is also turned
on only in `md2html` and `md2tex`. **Rationale:** mixing Markdown and
RST arbitrarily is a way to nowhere, we need to provide a way to fix the
particular behavior. Note that still all commands have **both** Markdown
and RST features **enabled**. In this PR `*.nim` files can be processed
only in Markdown mode, while `md2html` is for `*.md` files and
`rst2html` for `*.rst` files.
- rename `*.rst` files to `.*md` as our current default behavior is
already Markdown-ish
- convert code blocks in `docgen.rst` to Markdown style as an example.
Other code blocks will be converted in the follow-up PRs
- fix indentation inside Markdown code blocks — additional indentation
is preserved there
- allow more than 3 backticks open/close blocks (tildas \~ are still not
allowed to avoid conflict with RST adornment headings) see also
https://github.com/nim-lang/RFCs/issues/355
- better error messages
- (other) fix a bug that admonitions cannot be used in sandbox mode; fix
annoying warning on line 2711
2022-07-15 19:27:54 +02:00
..
2022-01-20 13:58:59 +01:00
2022-04-13 11:53:02 +02:00
2022-04-13 11:53:02 +02:00
2019-04-05 15:27:04 +02:00
2021-04-02 13:11:03 +02:00
2021-06-19 11:24:46 -07:00
2020-11-20 08:07:51 +01:00
2017-09-16 19:09:44 +01:00
2020-03-30 13:45:32 +02:00
2018-11-26 10:28:44 +01:00
2018-10-28 13:34:57 +01:00
2020-10-29 18:12:14 +01:00
2018-12-11 21:23:21 +01:00
2020-11-13 16:15:13 +08:00
2020-12-14 10:58:29 +01:00
2020-12-28 14:13:21 +01:00
2020-11-05 14:00:49 +01:00
2022-04-13 11:53:02 +02:00
2021-04-21 19:47:01 +02:00
2021-05-29 12:44:39 -07:00
2022-04-13 11:53:02 +02:00
2022-04-13 11:53:02 +02:00
2022-04-07 17:38:01 -04:00
2022-04-13 11:53:02 +02:00
2021-01-07 19:16:26 +01:00
2020-12-27 19:46:21 +01:00
2021-02-18 08:26:50 +01:00
2021-01-05 17:50:15 +01:00
2021-02-24 10:14:19 +01:00
2020-12-28 14:13:21 +01:00
2021-04-04 13:47:28 -07:00
2021-01-05 17:52:26 +01:00
2022-01-20 20:57:50 +01:00
2020-12-17 13:41:05 +01:00
2021-04-07 14:17:48 +02:00
2020-11-28 11:59:08 -08:00
2022-01-04 13:29:50 +01:00
2020-12-28 14:13:21 +01:00
2021-04-29 09:51:54 +02:00
2020-12-28 14:13:21 +01:00
2021-03-10 08:08:24 -08:00
2022-01-20 13:55:19 +01:00
2020-06-16 11:43:48 +02:00
2022-03-09 12:55:20 +01:00
2020-06-15 13:27:33 +02:00
2020-06-15 13:27:33 +02:00
2021-01-05 20:51:51 +01:00
2021-02-17 19:27:48 +01:00
2021-04-02 13:11:03 +02:00
2020-04-24 09:18:44 +02:00
2021-07-27 09:36:19 +02:00
2022-05-07 20:46:45 +02:00
2021-07-17 07:54:47 +02:00
2021-10-04 21:28:13 +02:00
2021-02-15 13:57:15 +01:00
2022-07-15 19:27:54 +02:00
2020-12-28 14:13:21 +01:00
2020-03-20 17:11:39 +01:00
2020-03-20 17:11:39 +01:00
2021-12-14 12:22:10 +00:00
2021-06-30 10:22:38 -07:00
2022-04-13 11:53:02 +02:00
2020-12-28 14:13:21 +01:00
2021-06-19 11:24:46 -07:00
2020-11-20 08:07:51 +01:00
2021-02-22 20:13:08 +01:00
2021-03-26 13:05:51 +01:00
2021-04-13 09:33:28 +02:00
2021-12-14 18:16:49 +01:00
2018-11-23 11:58:28 +01:00
2018-12-11 21:23:21 +01:00
2022-04-13 11:53:02 +02:00
2018-11-23 11:58:28 +01:00
2022-04-13 11:53:02 +02:00
2022-01-10 10:27:59 +01:00
2021-04-06 16:21:58 +02:00
2021-10-24 11:51:57 +02:00
2021-12-20 17:29:03 +01:00
2022-03-08 18:12:31 +01:00
2022-02-14 14:35:33 +01:00
2022-01-15 13:19:05 +01:00
2018-12-11 21:23:21 +01:00
2018-07-06 17:27:02 +02:00
2018-11-23 11:58:28 +01:00
2021-04-24 07:54:31 +02:00
2018-12-11 21:23:21 +01:00
2022-01-16 11:08:38 +01:00
2018-11-23 11:58:28 +01:00
2021-07-05 10:12:58 -07:00
2020-03-25 19:15:34 +01:00
2022-02-14 08:56:35 +01:00
2020-11-23 19:53:57 +01:00
2021-02-22 11:09:25 +01:00
2021-05-31 13:39:19 +02:00
2021-12-17 09:01:33 +01:00
2022-04-13 11:53:02 +02:00
2020-06-15 13:27:33 +02:00
2021-03-27 10:22:42 +01:00
2022-04-13 11:53:02 +02:00
2020-12-27 14:45:57 +01:00
2021-01-07 09:38:31 +01:00
2021-07-16 15:50:02 +02:00
2021-02-24 22:17:16 +00:00
2019-05-16 21:06:04 +02:00
2021-08-12 16:50:08 +02:00
2021-09-29 09:32:39 +02:00
2022-01-17 13:06:31 +01:00
2022-07-05 22:29:05 +02:00
2021-03-07 12:08:41 +01:00
2020-11-13 14:12:51 +01:00
2021-03-28 09:57:40 -07:00
2020-11-24 19:06:41 +01:00
2022-01-04 13:29:50 +01:00
2022-04-13 11:53:02 +02:00
2020-12-27 14:45:57 +01:00
2021-08-16 15:14:35 +02:00
2020-12-28 14:13:21 +01:00
2021-10-04 21:27:13 +02:00
2018-11-23 11:58:28 +01:00
2021-02-20 18:08:13 +01:00
2021-11-12 22:51:58 -05:00
2021-01-22 19:51:11 +01:00
2021-09-02 14:12:14 +02:00
2021-02-06 17:33:11 +01:00
2021-12-13 07:29:22 +01:00
2018-12-11 21:23:21 +01:00
2021-03-29 10:50:58 +02:00
2022-01-04 13:29:50 +01:00
2020-10-18 12:57:13 -04:00
2021-02-22 19:58:37 +01:00
2022-07-15 19:27:54 +02:00
2022-07-15 19:27:54 +02:00
2021-10-16 11:25:05 +02:00
2021-03-08 10:39:39 +01:00
2022-04-13 11:53:02 +02:00
2021-06-16 11:31:20 +02:00
2020-12-28 14:13:21 +01:00
2021-08-11 12:17:17 +02:00
2021-01-07 16:09:57 +01:00
2018-11-23 11:58:28 +01:00
2022-01-16 11:08:38 +01:00
2018-12-11 21:23:21 +01:00
2022-04-13 11:53:02 +02:00
2020-10-05 12:00:06 +02:00
2020-05-19 09:41:31 +02:00
2021-08-23 00:13:39 +02:00
2020-04-28 19:56:01 +02:00
2021-09-02 12:10:14 +02:00
2022-04-13 11:53:02 +02:00
2022-07-15 09:42:54 +02:00
2021-04-12 07:32:37 +02:00
2021-02-24 13:47:36 +01:00
2020-11-24 19:06:41 +01:00
2021-11-02 09:06:46 +01:00
2022-04-13 11:53:02 +02:00
2021-07-19 12:43:31 +02:00
2020-12-28 14:13:21 +01:00
2020-08-09 14:12:53 +02:00
2020-06-10 14:10:57 +02:00
2022-06-07 10:35:06 +02:00
2021-02-09 13:04:36 +01:00
2020-12-28 14:13:21 +01:00
2021-03-15 10:21:25 +01:00
2021-07-18 15:16:26 +02:00
2020-12-28 14:13:21 +01:00
2022-07-06 13:06:41 +02:00
2021-07-18 11:04:19 +02:00
2020-07-12 03:31:03 -04:00
2020-11-10 09:23:58 +08:00
2020-10-13 17:39:32 +01:00
2021-05-08 17:13:47 +02:00
2021-03-08 14:37:52 +01:00
2022-04-13 11:53:02 +02:00
2022-04-13 11:53:02 +02:00
2022-04-13 11:53:02 +02:00
2022-04-07 17:38:01 -04:00
2022-04-13 11:53:02 +02:00
2020-11-27 12:41:22 +08:00
2020-07-14 13:14:32 +02:00
2021-02-24 21:02:33 +01:00
2018-05-28 05:24:04 +03:00
2020-12-27 09:16:53 +01:00
2020-02-11 21:33:06 +01:00
2022-05-30 12:09:18 +02:00
2021-04-17 11:48:22 +02:00
2021-02-24 13:44:10 +01:00
2022-04-13 11:53:02 +02:00
2021-06-24 11:55:31 +02:00
2018-04-30 11:16:56 +02:00
2020-11-27 20:47:49 +01:00
2020-11-27 20:47:49 +01:00
2021-07-08 10:21:30 +08:00
2020-12-28 14:13:21 +01:00
2021-09-02 07:41:14 +02:00
2021-05-15 06:50:39 +02:00