About this guide...

This is the Programmer's Guide for ioL.

Assumed knowledge

This guide won't teach you how to program from scratch. It is assumed that you already know how to write simple programs in a language such as Python (or another programming language that may also be available on your system).

This guide focuses on an essential aspect of programming - dealing with input and output - which an ioL console manages in a different way to a traditional terminal. It will teach you how to make your program deal with input and output in a way that takes full advantage of the capabilities provided by ioL.

The ioL console interprets your output

Many of the example programs and excerpts in this guide are written in Python because it is easy to read and follow, but ioL is not a feature of Python or of any one programming language. When your program runs in an ioL console, the console uses your program's output to build its user interface. That output must follow the rules of ioL, and the console interprets it and renders it as a rich user interface with interactive content. The programming language you use to write the program is separate from this interface layer: it is the tool for telling the program what to do, while ioL is the language for describing what should appear on screen.

If you prefer another programming language, the examples in this guide will still apply; you will just need to use the input and output syntax that is appropriate to that language. For example, Python uses a print(...) statement for program output, while another language may use a different function or keyword for the same task.

How the guides are structured

• The Programmer's Guide introduces basic concepts chapter by chapter, eventually moving on to more advanced concepts and practices. The chapters are brief, and the fastest way to get up to speed with ioL is to read and work through this guide in order.
• Once you grasp the basics, the Language Reference is where you can look up the various tags (presentation tags and logic tags) available in ioL and how to use them.

█▐←

Navigate through the sections using the right-hand menu near the top of this page.