Large Text Type
A block of text, which may contain QL expressions
Large Text is one of the central Types in Querki: it is an arbitrarily long block of text,
which may contain QL expressions in it. Most Querki Spaces use Large Text Properties frequently.
When you edit a Large Text, you will see a multi-line input box. This will grow automatically as
you enter more text, and can get pretty much as large as you like. (There are limits, but they
are pretty substantial -- multi-page Large Texts are not unusual.)
Every Thing automatically has one Large Text Property available, named Default View. This is what
gets shown when you simply look at this Thing in the browser. Most of the time, you want to fill in
the Default View on your Model, with a page that includes all the interesting Properties on the Model.
Then, all of the Instances of that Model will automatically pick up that Default View, and look right.
Large Text is the most-commonly used text type in Querki, but there are a couple of others. Text Type
is identical to Large Text, just smaller -- it only has a one-line input box, and is intended for short
texts of a paragraph or less. Plain Text can not contain QL expressions, so it is only for simple, literal
blocks of text.
QText
Large Text Properties are mainly composed of QText -- an easy-to-use "markup" format, that lets you
describe concepts like boldface, paragraphs, links, bullet lists and so on in fairly intuitive ways, without
needing to use HTML. For details on all the different things you can do with QText, see
the
QText Reference.
QL
A Large Text Property may also contain QL expressions. These are simple expressions contained in
double-square-brackets. The tutorial for QL is still being written, but for new users, you really only
need two kinds of QL expressions to get going.
First, say that your Space has a page named Instructions, and you want another page to link to that.
You show that link by simply saying:
[[Instructions]]
It's as easy as that, but keep in mind that you need to use the other page's Link Name, which may be
slightly different from its normal Name. If you're not sure, look in the small subtitle line on
that page -- it should give the "Link Name", which is what you should use.
Second -- Querki is all about Things with Properties. Say that you want to show the value of the Property
named "Details" on your Thing. You would just say:
[[Details]]
That's it -- Querki is smart enough to know that, since you're naming a Property, it should just insert the
value of that Property here.
Properties that are based on Large Text Type