Supply Marked-up Texts

How to write marked-up texts in a document?

Fill marked-up text screenshot

Wrote the description for the document 'multibazaar2009'. The description contains italic text, namely 350 people and organizations, boldfaced text, namely address, and underlined text, namely Malvin City. Italic, boldface and underline are examples of markup.

Ensure that in some way you have set the document in edit mode. Click in a marked-up text inputfield, which is a multiline inputfield with clickable letters ('buttons') above it, at least 'B' for boldface, 'I' for italic and 'U' for underline. The text you type may consist of more than one line and also may contain markup, which you may add using the markup 'buttons' above the inputfield.

The Hippo CMS supplies two different types of fields for markuped text. One for simple markuped text, as shown in the above example and one with much more capabilities. Which capabilities will depend on the configuration of you system. Note that:

  1. A markuped field will at first be in review mode, even if the whole document is in edit mode. In review mode, clicking the buttons will have no effect. The buttons have a gray color.
  2. Click in the markuped field to get it into edit mode. The buttons become colored and can be used.
  3. Only one markuped field can be in edit mode at any time. If you are editing in one and click in another, the first will go back to read mode.
  4. If the cursor is on a link in a markuped field and the field is in review mode, the address of the link is shown in the lower left corner of the CMS window. In edit mode, link addresses are not shown. For external links the address shown is the URL. For internal links the address shown is a pseudo-URL. It is a abbreviation of the URL with the domain of the CMS in front of it. In your website the full URL for the abbreviation will be used. The abbreviation normally is the name of the document linked to, possibly with an underscore and a number after it. However, this is not required and if the document is renamed, the abbreviation will not change along, but the link will still work. On the other hand, the abbreviation being the correct document name is no guarantee that the link will work.
  5. You can copy/paste structurally markuped text from other applications into a Hippo markup field: Structural markup like Boldface, italic, underline, headers and tables will all be preserved.
  6. If you copy/paste style markuped text into a Hippo markup field, the style markup will be removed by a filter during save. Thus, colors will be removed. This is to ensure that the website of your company will have one style. If every author would be allowed to add all kinds of colors, your companies website would become an ugly mess of disharmonic colors. You company can allow writers to add particular colors, by configuring special markup elements.
  7. A filter will change anything that looks remotely like a URL into an external link. This includes any sequence of characters that contains points with more than one character between the points.

The following notes are only important if you copy/paste from external application or if your markuped text fields are configured so that you have an html mode where you can add xhtml tags directly.

  1. A filter will remove all none-xhtml elements from the markuped text, ensuring that the text will always be correct xhtml, which is processable in the websites.
  2. If the contents of the markuped field does not comply to xhtml rules, the filter will apply changes to ensure that it does. These changes may have effects you did not expect. For example: img tags are not allowed in pre tags. If the filter finds an img tag inside of a pre tag it will probably add a pre end tag before the img tag and an pre start tag after the img element. It may also try an other solution for the non-compliance.
  3. Some external application contain lots of non-compliant markup, so if weird changes happen to such text, improve by hand and try to avoid that external application.
  4. Apparently, in some cases, the filter changes xhtml comments into normal text. You will then see text starting with '<!--' in the text. You can safely remove that.

As with any inputfield: ensure that you know what type of information is expected in your company for this inputfield and fill in an appropriate piece of text.

Hippo Europe: +31 (0)20 5224466
Hippo North America: +1 (707) 773-4646