Entity Page Styling
How to use the formatting and layout features of the ixo-WebApp
The Page View for any entity displayed in the ixo-WebApp is configured using pre-built cards.
In the Create <entity> Studio view, the page layout can be modified using the drag-and-drop feature to move the order of cards.
The Main Section Card at the top of this page cannot be moved or removed, as this contains the minimum required information for setting up an entity and having it display in the Explorer interface.
All information included in the Main Section card is publicly visible and will be stored on the chain. Therefore please do not include sensitive information, or personall identifiable information that would compromise any user's privacy or data protection rights.
If you do not want to include a card type on the page, the sections in the card can be removed by selecting - Remove
Additional sections can be added within each card by selecting + Add Section
Within the card text fields, you can use basic Markdown for formatting the text, using the syntax shown below.

Markdown Styling Options

Implements Showdown (check out their documentation).

Paragraphs

Paragraphs in Showdown are just one or more lines of consecutive text followed by one or more blank lines.
1
On July 2, an alien mothership entered Earth's orbit and deployed several dozen
2
saucer-shaped "destroyer" spacecraft, each 15 miles (24 km) wide.
3
4
On July 3, the Black Knights, a squadron of Marine Corps F/A-18 Hornets,
5
participated in an assault on a destroyer near the city of Los Angeles.
Copied!
The implication of the “one or more consecutive lines of text” is that Showdown supports “hard-wrapped” text paragraphs. This means the following examples produce the same output:
1
A very long line of text
Copied!
1
A very
2
long line
3
of text
Copied!
If you DO want to add soft line breaks (which translate to <br> in HTML) to a paragraph, you can do so by adding 3 space characters to the end of the line ( ).
You can also force every line break in paragraphs to translate to <br> (as Github does) by enabling the option simpleLineBreaks.

Headings

Atx Style

You can create a heading by adding one or more # symbols before your heading text. The number of # you use will determine the size of the heading. This is similar to atx style.
1
# The largest heading (an <h1> tag)
2
## The second largest heading (an <h2> tag)
3
4
###### The 6th largest heading (an <h6> tag)
Copied!
The space between # and the heading text is not required but you can make that space mandatory by enabling the option requireSpaceBeforeHeadingText.
You can wrap the headings in #. Both leading and trailing # will be removed.
1
## My Heading ##
Copied!
If, for some reason, you need to keep a leading or trailing #, you can either add a space or escape it:
1
# # My header # #
2
3
#\# My Header \# #
Copied!

Setext style

You can also use setext style headings, although only two levels are available.
1
This is an H1
2
=============
3
4
This is an H2
5
-------------
Copied!

Header IDs

Showdown generates bookmarks anchors in titles automatically, by adding an id property to an heading.
1
# My cool header with ID
Copied!
1
<h1 id="mycoolheaderwithid">My cool header with ID</h1>
Copied!
This behavior can be modified with options:
  • noHeaderId disables automatic id generation;
  • ghCompatibleHeaderId generates header ids compatible with github style (spaces are replaced with dashes and a bunch of non alphanumeric chars are removed)
  • prefixHeaderId adds a prefix to the generated header ids (either automatic or custom).
  • headerLevelStart sets the header starting level. For instance, setting this to 3 means that # header will be converted to <h3>.
Read the README.md for more info

Blockquotes

You can indicate blockquotes with a >.
1
In the words of Abraham Lincoln:
2
3
> Pardon my french
Copied!
Blockquotes can have multiple paragraphs and can have other block elements inside.
1
> A paragraph of text
2
>
3
> Another paragraph
4
>
5
> - A list
6
> - with items
Copied!

Bold and Italic

You can make text bold or italic.
1
*This text will be italic*
2
**This text will be bold**
Copied!
Both bold and italic can use either a * or an _ around the text for styling. This allows you to combine both bold and italic if needed.
1
**Everyone _must_ attend the meeting at 5 o'clock today.**
Copied!

Strikethrough

With the option strikethrough enabled, Showdown supports strikethrough elements. The syntax is the same as GFM, that is, by adding two tilde (~~) characters around a word or groups of words.
1
a ~~strikethrough~~ element
Copied!
a strikethrough element

Emojis

Since version 1.8.0, showdown supports github's emojis. A complete list of available emojis can be foun here.
1
this is a :smile: smile emoji
Copied!
this is a
smile emoji

Code formatting

Inline formats

Use single backticks (`) to format text in a special monospace format. Everything within the backticks appear as-is, with no other special formatting.
1
Here's an idea: why don't we take `SuperiorProject` and turn it into `**Reasonable**Project`.
Copied!
1
<p>Here's an idea: why don't we take <code>SuperiorProject</code> and turn it into <code>**Reasonable**Project</code>.</p>
Copied!

Multiple lines

To create blocks of code you should indent it by four spaces.
1
this is a piece
2
of
3
code
Copied!
If the options ghCodeBlocks is activated (which is by default), you can use triple backticks (```) to format text as its own distinct block.
1
Check out this neat program I wrote:
2
3
```
4
x = 0
5
x = 2 + 2
6
what is x
7
```
Copied!

Lists

Showdown supports ordered (numbered) and unordered (bulleted) lists.

Unordered lists

You can make an unordered list by preceding list items with either a *, a - or a +. Markers are interchangeable too.
1
* Item
2
+ Item
3
- Item
Copied!

Ordered lists

You can make an ordered list by preceding list items with a number.
1
1. Item 1
2
2. Item 2
3
3. Item 3
Copied!
It’s important to note that the actual numbers you use to mark the list have no effect on the HTML output Showdown produces. So you can use the same number in all items if you wish to.

TaskLists (GFM Style)

Showdown also supports GFM styled takslists if the tasklists option is enabled.
1
- [x] checked list item
2
- [ ] unchecked list item
Copied!
  • checked list item
  • unchecked list item

List syntax

List markers typically start at the left margin, but may be indented by up to three spaces.
1
* this is valid
2
* this is too
Copied!
List markers must be followed by one or more spaces or a tab.
To make lists look nice, you can wrap items with hanging indents:
1
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
2
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
3
viverra nec, fringilla in, laoreet vitae, risus.
4
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
5
Suspendisse id sem consectetuer libero luctus adipiscing.
Copied!
But if you want to be lazy, you don’t have to
If one list item is separated by a blank line, Showdown will wrap all the list items in <p> tags in the HTML output. So this input:
1
* Bird
2
3
* Magic
4
* Johnson
Copied!
Results in:
1
<ul>
2
<li><p>Bird</p></li>
3
<li><p>Magic</p></li>
4
<li><p>Johnson</p></li>
5
</ul>
Copied!
This differs from other markdown implementations such as GFM (github) or commonmark.

Nested blocks

List items may consist of multiple paragraphs. Each subsequent paragraph in a list item must be indented by either 4 spaces or one tab:
1
1. This is a list item with two paragraphs. Lorem ipsum dolor
2
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
3
mi posuere lectus.
4
5
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
6
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
7
sit amet velit.
8
9
2. Suspendisse id sem consectetuer libero luctus adipiscing.
Copied!
This is valid for other block elements such as blockquotes:
1
* A list item with a blockquote:
2
3
> This is a blockquote
4
> inside a list item.
Copied!
or event other lists.

Nested lists

You can create nested lists by indenting list items by four spaces.
1
1. Item 1
2
1. A corollary to the above item.
3
2. Yet another point to consider.
4
2. Item 2
5
* A corollary that does not need to be ordered.
6
* This is indented four spaces
7
* You might want to consider making a new list.
8
3. Item 3
Copied!
This behavior is consistent with the original spec but differs from other implementations such as GFM or commonmark. Prior to version 1.5, you just needed to indent two spaces for it to be considered a sublist. You can disable the four spaces requirement with option disableForced4SpacesIndentedSublists
To nest a third (or more) sublist level, you need to indent 4 extra spaces (or 1 extra tab) for each level.
1
1. level 1
2
1. Level 2
3
* Level 3
4
2. level 2
5
1. Level 3
6
1. Level 1
Copied!

Nested code blocks

You can nest fenced codeblocks the same way you nest other block elements, by indenting by fours spaces or a tab:
1
1. Some code:
2
3
```js
4
var foo = 'bar';
5
console.log(foo);
6
```
Copied!
To put a indented style code block within a list item, the code block needs to be indented twice — 8 spaces or two tabs:
1
1. Some code:
2
3
var foo = 'bar';
4
console.log(foo);
Copied!

Simple

If you wrap a valid URL or email in <> it will be turned into a link whose text is the link itself.
1
link to <http://www.google.com/>
2
3
this is my email <[email protected]>
Copied!
In the case of email addreses, Showdown will also perform a bit of randomized decimal and hex entity-encoding to help obscure your address from address-harvesting spambots. You can disable this obfuscation setting encodeEmails option to false.
With the option simplifiedAutoLink enabled, Showdown will automagically turn every valid URL it finds in the text body to links for you, without the need to wrap them in <>.
1
link to http://www.google.com/
2
3
this is my email [email protected]
Copied!

Inline

You can create an inline link by wrapping link text in brackets ( [ ] ), and then wrapping the link in parentheses ( ( ) ).
For example, to create a hyperlink to github.com/showdownjs/showdown, with a link text that says, Get Showdown!, you'd write this in Markdown: [Get Showdown!](https://github.com/showdownjs/showdown).

Reference Style

You can also use the reference style, like this:
1
this is a [link to google][1]
2
3
[1]: www.google.com
Copied!
Showdown also supports implicit link references:
1
this is a link to [google][]
2
3
[google]: www.google.com
Copied!

Images

Markdown uses an image syntax that is intended to resemble the syntax for links, also allowing for two styles: inline and reference.

Inline

Inline image syntax looks like this:
1
![Alt text](url/to/image)
2
3
![Alt text](url/to/image "Optional title")
Copied!
That is:
  • An exclamation mark: !;
  • followed by a set of square brackets, containing the alt attribute text for the image;
  • followed by a set of parentheses, containing the URL or path to the image, and an optional title attribute enclosed in double or single quotes.

Reference Style

Reference-style image syntax looks like this:
1
![Alt text][id]
Copied!
Where “id” is the name of a defined image reference. Image references are defined using syntax identical to link references:
1
[id]: url/to/image "Optional title attribute"
Copied!
Implicit references are also supported in images, similar to what happens with links:
1
![showdown logo][]
2
3
[showdown logo]: http://showdownjs.github.io/demo/img/editor.logo.white.png
Copied!

Image dimensions

When the option parseImgDimension is activated, you can also define the image dimensions, like this:
1
![Alt text](url/to/image =250x250 "Optional title")
Copied!
or in reference style:
1
![Alt text][id]
2
3
[id]: url/to/image =250x250
Copied!

Base64 encoded images

Showdown also supports Base64 encoded images, both reference and inline style. Since version 1.7.4, wrapping base64 strings, which are usually extremely long lines of text, is supported. You can add newlines arbitrarily, as long as they are added after the , character.
inline style
1
![Alt text](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAIAAAA7l
2
jmRAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAAY
3
SURBVBhXYwCC/2AAZYEoOAMs8Z+BgQEAXdcR7/Q1gssAAAAASUVORK5CYII=)
Copied!
reference style
1
![Alt text][id]
2
3
[id]:
4
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAIAAAA7l
5
jmRAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7D
6
AcdvqGQAAAAYSURBVBhXYwCC/2AAZYEoOAMs8Z+BgQEAXdcR7/Q1gssAAAAASUVORK5CYII=
Copied!
Please note that with reference style base64 image sources, regardless of "wrapping", a double newline is needed after the base64 string to separate them from a paragraph or other text block (but references can be adjacent).
wrapped reference style
1
![Alt text][id]
2
![Alt text][id2]
3
4
[id]:
5
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAIAAAA7l
6
jmRAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7D
7
AcdvqGQAAAAYSURBVBhXYwCC/2AAZYEoOAMs8Z+BgQEAXdcR7/Q1gssAAAAASUVORK5CYII=
8
[id2]:
9
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAADCAIAAAA7l
10
jmRAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7D
11
AcdvqGQAAAAYSURBVBhXYwCC/2AAZYEoOAMs8Z+BgQEAXdcR7/Q1gssAAAAASUVORK5CYII=
12
13
this text needs to be separated from the references by 2 newlines
Copied!