Sage
Welcome to Sage
Volume (9%) Hide Volume
Topics
Sage Markup

Introduction

Sage is a markup language used to generate web pages for the Sage Wiki. Sage was heavily influenced by Markdown, but it is a separate language, with several novel features.

Example

Let's start with a brief example of the Sage language…

This is an example of the Sage language. /Please/ read on to learn more about Sage [--] it will be *well* worth the effort! Features you will learn about include[...] [list] #* Text formatting #* Making lists #* Highlighting code in other languages #* Linking to other articles [end] For more information, [link #Example]click here[end].

The above Sage code produces the following HTML…


This is an example of the Sage language.

Please read on to learn more about Sage — it will be well worth the effort! Features you will learn about include…
  • Text formatting
  • Making lists
  • Highlighting code in other languages
  • Linking to other articles
For more information, click here.


This example illustrates several important concepts:
  • Like HTML, Sage word wraps text.
  • Unlike HTML, in Sage, a blank line signifies a paragraph break.
  • In Sage, surround text in asterisks to use a bold typeface.
  • Similarly, surround text in forward slashes to use italics.
  • Sage uses several tags, enclosed in square brackets. A few examples are shown above...
    • The [--] tag denotes an em dash.
    • The [...] tag denotes an ellipsis.
    • The [list] tag begins a list.
    • The [end] tag ends the list (and many other tags, including the [link] tag).
    • The [link] tag denotes a link to other Sage content. A related tag, [url] denotes a link to non-Sage resources.
  • Between the [list] and [end] tags, any line starting with #* becomes an unordered (bullet) list item. For ordered (numbered) list items, use ## instead.
  • Sage markup is stored in plain text files, using the .sage file extension. These files are checked into the Code Vault source control system. As such, lines in .sage files should not exceed 70 columns, in general.

More Information…

Visit the other articles in this topic, using the tree on the left-hand side of the page.


Last Modified: 10/24 9:45:52 am

Topic contents...
In this article (top)  View article's Sage markup
10/24 9:45:52 am