Age | Commit message (Collapse) | Author | Files | Lines |
|
Make bindings parsing more strict, and validate that strictness
Closes #320
See merge request subplot/subplot!364
|
|
|
|
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
|
|
feat! drop support for bibliographies in document metadata
Closes #326
See merge request subplot/subplot!346
|
|
docs: make it clear that cleanups are call only on successful steps
Closes #261
See merge request subplot/subplot!344
|
|
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
|
|
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
|
|
Sponsored-by: author
|
|
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
|
|
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
|
|
We may add this back later, but for now, it's not wanted.
Sponsored-by: author
|
|
A fenced code block can't start in middle of text, so add an empty
line to avoid doing that.
Sponsored-by: author
|
|
Rename the field "author", which takes a single string value, to
"authors", which takes a list of strings. This way we're consistent
for single- and multi-author documents.
Sponsored-by: author
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
The "pandoc" key gets added to the metadata given to Pandoc as-is.
Sponsored-by: author
|
|
This means that if only the subplot is modified, docgen will rebuild
the output.
Sponsored-by: author
|
|
This is a huge change all in one commit, sorry. However, as it changes
a fundamental part of the command line interface (namely, what
constitutes as the input file), there doesn't seem a way to break this
into a tidy series of small commits.
Most of the diff is in subplot.md, where every scenario that invokes
Subplot needs multiple changes, thus touching much of the file.
The overall change is that where we previously had document metadata
in embedded YAML in the Markdown file, we now have it in a separate
YAML file. The Markdown file is named in the YAML file.
We still parse the Markdown with Pandoc for everything, except
codegen. Switching from Pandoc to pulldown_cmark for parsing will be
another big change that I didn't want to include in this huge change
set.
Sponsored-by: author
|
|
When we change Subplot to take a YAML file instead of a Markdown file
as input, it doesn't make sense to act as a Pandoc filter anymore:
Pandoc doesn't understand our YAML file.
In any case, I seem to have been the only user ever of that feature,
so it won't really bother anyone else. Even so, we should treat this
as a breaking change.
"subplot docgen" still works as before.
Sponsored-by: author
|
|
When errors have a source, i.e., an underlying error, it results in
better error messages to the user.
Also, refactor the way the source chain is printed, to code that is
clearer to me.
I will need this to for loading document metadata from an external
YAML file.
Sponsored-by: author
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
Change everywhere to use the word "diagram" instead of "graph. Diagram
seems like the better word. It's mostly used in comments and
documentation, but there was one filename and one trait name that
needed changing.
I used "rg -iw graph" and "find -iname '*graph*'" to find everywhere
that needed changing.
Sponsored-by: author
|
|
Add a --merciful option to subcommands for which this matters. Adjust
tests to invoke subplot with that option as necessary.
Sponsored-by: author
|
|
|
|
|
|
|
|
|
|
On a first reading, this sentence seemed circular to me.
After many, many rereadings, the only way I could interpret it
was as shown here.
Since the second paragraph is now repeating the first, prune it
and rearrange the line break in the second sentence.
|
|
Unusual in headings and not done elsewhere in the document
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
This changes typesetting of scenarios so that when two adjacent
scenario steps have the same keyword, "and" is used on the second one.
This means that when input has
when I do foo
when I do bar
the output will have
when I do foo
and I do bar
I didn't bother to make this configurable. I don't feel that level of
configuration is good.
The "keyword aliases" scenario is repurposed to verify this.
Sponsored-by: author
|
|
Signed-off-by: Daniel Silverstone <dsilvers@digital-scurf.org>
|
|
This is merely a warning, for now, to stderr. subplot.md has two
embedded files used as examples, and I'm too tired to add a way to
indicate that it's OK for a specific file to not be used. That should
probably be added later, though.
Sponsored-by: author
|
|
The embedded file with markdown was insufficiently escaped.
Sponsored-by: author
|