head

manual/source/display_tags.rst

@@ -0,0 +1,71 @@
+.. _display-tags:
+
+============
+Display Tags
+============
+
+OpenLP has the ability to add additional formatting to text in songs and custom
+slides through the use of :ref:`g-display-tags`. :ref:`g-display-tags` provide 
+a shortcut to use HTML and CSS to format text. 
+
+:ref:`g-display-tags` consist of two parts, a starting and an ending tag, each
+tag consists of brace, tag identifier, brace. 
+
+Using a display tag
+-------------------
+
+To use :ref:`g-display-tags` surround the text with a starting tag {} followed
+by the text to be formatted. End the text to be formatted with an ending tag
+{/}.
+
+Example of use
+--------------
+
+To italicize a section of text you would do the following in a custom slide or
+song::
+
+  Amazing grace how {it} sweet {/it} the sound.
+  
+This will yield the text as:
+
+  Amazing grace how *sweet* the sound.
+  
+Included display tags
+---------------------
+
+The following tags are included with OpenLP
+
+* **{r}** red text
+* **{b}** black text
+* **{bl}** blue text
+* **{y}** yellow text
+* **{g}** green text
+* **{pk}** pink text
+* **{o}** orange text
+* **{pp}** purple text
+* **{w}** white text
+* **{sb}** subscript text
+* **{p}** paragraph
+* **{st}** bold
+* **{it}** italics
+
+Configuring display tags
+------------------------
+
+To add new :ref:`g-display-tags` go to :menuselection:`Settings -> Configure 
+Display Tags`
+
+.. image:: pics/configure_display_tags.png
+
+Click the :guilabel:`New` button to add new :ref:`g-display-tags`. Enter the 
+description of the display tag followed by the tag. The tag must be unique.
+Tags do not need to put the in braces {} here, only when using the tag.
+Finally, enter in the HTML or CSS for the tag and click :guilabel:`Save` to
+complete adding new :ref:`g-display-tags`.
+
+To delete :ref:`g-display-tags` that you have entered click on the display tag
+from the list and click :guilabel:`Delete`.
+
+**Note** if a tag is deleted that is in use in a song or custom slide the slide
+will display the tags {} without any formatting.  The deleted tags will need to
+be manually deleted from the songs or custom slides.

manual/source/glossary.rst

@@ -8,6 +8,14 @@ The developers of OpenLP have strived to make it a straightforward and easy to
 use application. However, it is good to be familiar with a few terms that will
 be used throughout this documentation, and when seeking support.
 
+.. _g-display-tags:
+
+Display Tags
+------------
+
+:ref:`display-tags` give you the ability to add additional text formatting to text in
+songs and custom slides.
+
 .. _g-main-window:
 
 Main Window

manual/source/index.rst

@@ -25,6 +25,7 @@ Reference Manual
    dualmonitors
    mediamanager
    print_service
+   display_tags
    themes
    songs
    bibles