12

The original title of this site was, as I recall, "TeX, LaTeX, and friends". That seems to have now been trimmed down to just "TeX - LaTeX", but other variants such as ConTeXt are still on topic. How broad does it get?

To be specific, I'm trying to generate PDF documents from PHP. There will be a standard template, but different actual content each time. Escaping values from PHP to produce valid LaTeX looks very very tricky. It would be easy to introduce all sorts of subtle security bugs by missing some escape sequences.

SILE has a similar aim to LaTeX, but has two syntaxes, one intended to be human-editable (and similar to LaTeX), the other based on XML. XML is a mature technology easy to manipulate with a programming language. Using SILE instead of LaTeX may be an excellent idea. On the other hand, if I run into difficulties with SILE, can I ask about them here? Is it on topic?

(A search on Meta for SILE finds nothing.)

  • 8
    not authoritative, but my understanding is that if the input is processed by an engine that is either the original tex engine or a clone or modification of that engine, it is covered here. if the engine is not tex-based (e.g. mathjax), then even if the input looks like (la)tex syntax, it is not covered. – barbara beeton Aug 4 '17 at 19:20
  • 3
    But bibtex and pdfcrop are also covered. So... – Symbol 1 Aug 4 '17 at 22:44
  • 7
    Since the SILE readme on GitHub says 'Conceptually, SILE is similar to TeX—from which it borrows some concepts and even syntax and algorithms—but the similarities end there. Rather than being a derivative of the TeX family SILE is a new typesetting and layout engine written from the ground up [...].' I'd guess SILE is not really on-topic here. I guess most things that are covered on this site and are not a TeX engine at least ship with TeX live/MikTeX, are on CTAN and/or are common TeX helper programs (BibTeX, Biber, xindy, ...). – moewe Aug 5 '17 at 6:54
  • 6
    Note, however, that the developer of SILE is active here tex.stackexchange.com/users/33124/simon-cozens and that there are three answers that touch on SILE: tex.stackexchange.com/a/121978, tex.stackexchange.com/a/200810, tex.stackexchange.com/a/194602. But they are rather meta answers than real answers about SILE problems. – moewe Aug 5 '17 at 7:00
  • 3
    A workaround: Use ConTeXt to process XML input. Then if you run into difficulties, you can ask here :-) – Aditya Aug 7 '17 at 16:46
15

Well, to me it seems that there are four categories of software:

  1. TeX-based software. To see whether your software is TeX-based, there are IMHO two basic questions:

    • Are vast majority of TeX primitives relevant to the software in any way?
    • Is the software based on an expansion language?

    The answer to both questions is certainly "yes" for LaTeX, ConTeXt, LaTeX3, e-TeX, Lua(La)TeX etc.

  2. TeX-inspired software. There is certainly MathJaX and LilyPond here, for instance.

  3. Software with LaTeX output. Think GnuPlot, PanDoc or even SageMath and Maple.

  4. Auxiliary software. These are stuff like BibTeX, MakeIndex, PDFCrop etc.

Now, (at least in my opinion) Categories 1 and 4 are clearly covered, Category 2 is clearly not covered (unless you in some way compare such software to something from category 1, this could be on-topic), and Category 3 is covered partially (based on whether it's the output code that's discussed or not).

There are two main reasons for the strong distinction between Categories 1 and 2. First, pragmatically, people here specialize in TeX-based software. Second, conceptually, we tend to strongly distinguish the way how the software works inside.

SILE seems to be in Category 2 and whence is not covered.

  • 2
    I fear you may be right. But having experimented with producing valid LaTeX from PHP, I think I'll still go with SILE. I'll just have to ask about any problems I run into elsewhere. – TRiG Aug 7 '17 at 9:31
  • It's not even as clear-cut as this. For example inkscape could be included in category 3 or 4 depending on what you're doing (e.g. the svg package puts it into 4) -- or completely unrelated and a better fit at graphicdesign.se – Chris H Aug 15 '17 at 14:58
  • 1
    @ChrisH Since Gödel we've known that no finite system of rules can descibe the reality :) – yo' Aug 15 '17 at 21:23
12

I think we need to start here by thinking about the broader picture. The aim of TeX-sx is to provide answers to questions on topics 'somewhat' related to TeX. In particular, the site needs to offer a realistic chance of the questions being answered well, and for there to be some logic to looking here rather than elsewhere. This fits into the general StackOverflow model: provide useful answers to both the original questioner and to others with the same issues/queries.

The site has always been 'TeX, LaTeX and friends' to avoid limiting just to LaTeX and to have 'LaTeX' in the title so 'TeX' doesn't put people off! That's a bit wordy hence the 'TeX-sx' or similar abbreviation. At the same time, we've never aimed to cover 'Computer typography' or 'Programmatic typography' as a whole. So how do we define the 'friends' to fit in with the above idea of wanting answers? There needs to be some reasonable probably of a good answer (or answers) from a set of people with relevant expertise (both to answer and to review/vote). (People may well have expertise on non-TeX topics too, but those questions can still belong elsewhere.)

The answer by yo' has provided four categories of material that we might divide questions into, and he suggests that SILE falls outside of our scope. I'd look at this slightly differently (though not massively). Where a question is about SILE ('How do I do X in SILE?') it seems to me to be off-topic: it's not something 'we' have expertise on and is likely directly at a single person (the SILE author). On the other hand, where there is some link to TeX code we might regard it as on-topic. For example, a 'compare and contrast' for the paragraph-breaking algorithm, which might contrast SILE with TeX90 and ask what can be done in LuaTeX to match SILE might well be on-topic.

  • 2
    Very good point about software comparison between "my" categories 1 and 2. – yo' Aug 7 '17 at 9:35

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .