Try to clarify that SILE doesn't require a custom input language #1805
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR is because I've been a bit frustrated with chatter abut Typst and folks comparing it to SILE without having any idea what they are talking about. Don't get me wrong Typst has done some things right and other things well. Of course it also does some things poorly or not at all. Sometimes it just makes significantly different design choices and that's fine (e.g. sandboxing everything so documents are "safe" and cannot read the network or write to files at render time vs. SILE that just lets you have a full featured programming language ecosystem and treats documents as unsafe programs).
On the other hand it feels bad to be put down for things that just aren't true. Our documentation is a contributing factor to that confusion.
One of the most egregious issues brought up several times is that (supposedly) Typist uses a generic input language "based on Markdown" while SILE "requires everything to be written in a custom input language". In fact the exact opposite is true. Typst is the one that invented a Turing complete custom input language, while SILE is the one uses generic off the shelf components like XML for input and Lua for programability. And SILE is the one that can actually process Markdown. The Typst language has similarities to Markdown that it was derived from, but it's not interchangeable at all. SILE is. The SIL input syntax is there as an easier to type XML alternative, but certainly not required in any way.
</end rant>