Age | Commit message (Collapse) | Author | Files | Lines |
|
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
Typeset each step in a scenario, including captures in the steps.
Previously the scenario was just one <pre> element, now things can be
styled with CSS.
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
Make it easier to edit the CSS file, and also add some styles for
upcoming scenario typesetting.
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
The --merciful option allows this if the user really wants it.
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
Make bindings parsing more strict, and validate that strictness
Closes #320
See merge request subplot/subplot!364
|
|
feat: generate library documentation from bindings files
Closes #341
See merge request subplot/subplot!362
|
|
|
|
Add a `doc` field to a binding. It's a string meant to contain
markdown.
Add subcommand `subplot libdocgen YAML -o MD` to read a bindings file
and output a markdown file documenting the steps in the bindings file,
and the type of captures, and the documentation for the step.
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
This is a start. We'll need to add more as we add more support for
styling the output.
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
This is in the meta data field "css_urls".
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
This is in the meta data field "css_embed".
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
Signed-off-by: Lars Wirzenius <liw@liw.fi>
Sponsored-by: author
|
|
They're not great, but we can't make them great without forcing the
user to specify a caption for each diagram.
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
messages
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
We don't use the bibliographies for anything so there's not point in
allowing users to specify it. If and when we add support for
bibliographies again, we may well want to do it in a different way.
Alas, we also have to disable reference.md because the release it
refers to uses bibliographies. We'll have to re-enable it again after
the next release.
Sponsored-by: author
|
|
This makes it more clear what kind of files we're talking about. The
old name could've meant, say, the markdown files.
Sponsored-by: author
|
|
The extra method doesn't provide anything useful to it's better inline.
Sponsored-by: author
|
|
HTML generation uses write!, which can fail, so to_html must return a
Result.
Sponsored-by: author
|
|
If we ever need a class other than .pikchr, the comment won't help us.
Sponsored-by: author
|
|
Sponsored-by: author
|
|
To both improve debugability when writing scenarios, and also
to protect against future incompatibilities which might occur
if we add more classes which are appropriate for named code
blocks, we require that named blocks have one of `file` or `example`
as classes or else we warn.
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
Some day we will have syntax for continuing a step to the next line.
This change makes it easier to introduce that syntax, without a
breaking change.
Sponsored-by: author
|
|
fix: allow docgen to handle a subplot not in current directory
Closes #324
See merge request subplot/subplot!336
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
We have long had a feature for docgen that checks the time stamps of
all input files and the output file and avoids running Pandoc to
produce the output file, if the output file won't change. This has
always been a little imperfect: sometimes the output file would change
due to other changes than what's in the input files. For example, when
Pandoc changes, or when Subplot code changes. This has led to
surprised users. We no longer user Pandoc at all. Drop the time stamp
checking functionality and have docgen always write the output file.
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Sponsored-by: author
|
|
It's _document_ metadata, not metadata for a specific markdown file.
It belongs in Document, not Markdown. Make it so.
Sponsored-by: author
|
|
Thank you Milo Moisson.
Sponsored-by: author
|
|
When I changed Subplot to use pulldown_cmark for parsing markdown, I
introduced a bug: if a scenario title uses markup (e.g., bold face),
that part of the title was dropped when it was converted into scenario
title. Fix that.
Sponsored-by: author
|
|
Sponsored-by: author
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
This was probably a copy-paste error.
Sponsored-by: author
|
|
Sponsored-by: author
|