Setext

Setext

Setext

Lightweight markup language for text documents

Setext (Structure Enhanced Text)[2] is a lightweight markup language used to format plain text documents such as e-newsletters, Usenet postings, and e-mails. In contrast to some other markup languages (such as HTML), the markup is easily readable without any parsing or special software.

Quick Facts Filename extension, Developed by ...

Setext was first introduced in 1991 by Ian Feldman for use in the TidBITS electronic newsletter.

Purpose

Setext allows viewing of marked-up documents without special viewing software. When appropriate software is used, however, a rich text-style experience is available to the user.

Smaller documents are trivial to create in any text editor.

To prevent errors, most large setext publications are created using a markup language such as HTML or SGML and then converted. The setext document can then be distributed without the need for the recipient to use a HTML email or web viewer.

Multiple setext documents in the same file

Multiple setext documents can be stored in the same file, similarly to how the mbox format can store multiple e-mail messages together.

It was initially announced[1] that multiple documents could be included in a single stream, separated by a special <end> tag serving as a document delimiter[lower-alpha 2]. After several months, it was clarified[3] that this tag was not an official part of setext, and that multiple documents should instead be delimited by $$ appearing at the end of a line of text.

Regardless of the number of documents stored in the same file, basic metadata can be stored about any or all of them by using the subject-tt tag syntax.

Setext tags

The following are the ten most common of the 16 different setext tags.[4][5][lower-alpha 3]

More information Name, Example ...


Standalone Setext files

By default all properly setext-ized files will have an ".etx" or ".ETX" suffix. This stands for an "emailable/enhanced text".[1]

See also

Other lightweight markup languages (inspired by Setext):

References

Notes

  1. ("enhanced/ e-mailable text") [1]
  2. This was to function much in the same way as the original purpose of the ASCII “File Separator” (FS; 0x1C; typed as Ctrl-\) C0 control character but it proved too visually distracting and so was removed before setext was finalized.
  3. (Not currently shown in table: note-tt, quote-tt, subject-tt, suppress-tt, twobuck-tt, and twodot-tt)
  4. (For a document to be valid setext, the only required tag is either ‘subhead-tt’ or ‘title-tt’ - all others are optional.)
  5. “(A) formal definition of what makes a setext: a text that contains at least one verified setext subhead or setext title” [6][7]
  6. (‘-tt’ stands for ‘typotag’, the Feldman’s shorthand for ‘typographic tags’; contrast with the ‘tags’ used in modern systems for categorizing data or photos into groups)
  7. (i.e. the actual text as stored / transmitted, except in the case of bullet-tt. Visual appearance would be defined/controlled by the program displaying the document.)
  8. "synonymous with the ‘grouped’ style of HyperCard"

References

  1. [1]
    "TidBITS in new format". TidBITS. 1992-01-06. Retrieved 2022-07-01.
  2. [2]
    Engst, Adam C. "comp.sys.mac.announce / TidBITS file server available". UseNet. Retrieved 21 December 2015.
  3. [3]
    "Administrivia". TidBITS. 1992-03-09. Retrieved 2022-07-01.
  4. [4]
    Oliver, Erik. "Setext command reference". Erik Oliver's Home Page. Archived from the original on 2022-08-16. Retrieved 2022-07-01.
  5. [5]
    Feldman, Ian (1992-08-16). "What is setext". bsdi.org. Archived from the original on 2001-04-30.
  6. [6]
    Feldman, Ian (1992-03-15). "setext sermon – Part 1". bsdi.com. Archived from the original on 2001-03-09.
  7. [7]
    Feldman, Ian (1992-03-29). "setext sermon – Part 2". bsdi.org. Archived from the original on 2001-04-30.
  8. [8]
    "Setext2LaTeX". freecode.com. Archived from the original on 26 June 2014. Retrieved 16 August 2022.
    Oliver, Erik (2007). "Setext2LaTeX – setext -> LaTeX converter". Erik Oliver's Home Page. Archived from the original on 26 June 2014. Retrieved 16 August 2022.

Implementations
Share this article:

This article uses material from the Wikipedia article Setext, and is written by contributors. Text is available under a CC BY-SA 4.0 International License; additional terms may apply. Images, videos and audio are available under their respective licenses.