en:user:gs3_list_of_format_options
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
en:user:gs3_list_of_format_options [2019/09/24 00:54] – [Options] kjdon | en:user:gs3_list_of_format_options [2019/10/21 21:18] – [Miscellaneous Things] kjdon | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== List of Greenstone3 Format Items ====== | ====== List of Greenstone3 Format Items ====== | ||
- | This page describes all the things that can go into the < | + | This page describes all the things that can go into the < |
+ | |||
+ | Format | ||
+ | |||
+ | ''< | ||
+ | |||
+ | |||
See also the description of [[en: | See also the description of [[en: | ||
- | ''< | ||
- | ===== Options ===== | + | ===== Top Level Elements ===== |
+ | |||
+ | There are three main types of format items: options, parameter defaults, and templates. | ||
+ | |||
+ | ==== Options | ||
- | There are a few options available. They are specified by adding < | + | There are a few options available. They are specified by adding |
^Option name^Values^Format^Description^ | ^Option name^Values^Format^Description^ | ||
Line 29: | Line 39: | ||
|viewSelection|false|display|If false, will not show the text/ | |viewSelection|false|display|If false, will not show the text/ | ||
|slideShow|false|display|If false, will not display the slideshow option for paged image documents | | |slideShow|false|display|If false, will not display the slideshow option for paged image documents | | ||
- | |[[user_comments|AllowUserComments]]|true|display|If set to true, will allow users to add comments to public collections. Users need not have editing permissions for a collection they wish to add comments to. They just need to have an account on that Greenstone Digital Library.| | + | |[[user_comments|allowUserComments]]|true|display|If set to true, will allow users to add comments to public collections. Users need not have editing permissions for a collection they wish to add comments to. They just need to have an account on that Greenstone Digital Library. |
- | |[[en: | + | |[[en: |
+ | |[[en: | ||
- | ===== Parameter Defaults | + | ==== Parameter Defaults ==== |
Inside a format element you can set default values for parameters, using the following syntax | Inside a format element you can set default values for parameters, using the following syntax | ||
Line 45: | Line 56: | ||
To see what parameters you have that you can change, you can look at the page source for a query page and see what names and values the form elements have. | To see what parameters you have that you can change, you can look at the page source for a query page and see what names and values the form elements have. | ||
- | These can be added inside the < | + | These can be added inside the < |
- | ===== Templates ===== | + | |
- | ^Format Element^Greenstone2 equivalent^Description^ | + | ==== Templates ==== |
- | | ||| | + | |
- | |''< | + | Templates are the containers that hold all format statements. The value of '' |
+ | ''< | ||
- | ===== Links ===== | + | ===== What can go inside a template? |
+ | ==== Links ==== | ||
^Format Element^Greenstone2 equivalent^Description^ | ^Format Element^Greenstone2 equivalent^Description^ | ||
Line 71: | Line 83: | ||
|''< | |''< | ||
- | ===== Icons and Images | + | ==== Icons and Images ==== |
^Format Element^Greenstone2 equivalent^Description^ | ^Format Element^Greenstone2 equivalent^Description^ | ||
| ||| | | ||| | ||
Line 87: | Line 99: | ||
|''< | |''< | ||
|''< | |''< | ||
- | ===== Text and Metadata | + | |
+ | ==== Text and Metadata ==== | ||
^Format Element^Greenstone2 equivalent^Description^ | ^Format Element^Greenstone2 equivalent^Description^ | ||
| ||| | | ||| | ||
Line 105: | Line 118: | ||
|''< | |''< | ||
- | ==== gsf: | + | === gsf: |
By default, gsf: | By default, gsf: | ||
Line 145: | Line 158: | ||
- | ===== Miscellaneous Things ===== | + | ==== Text Strings |
^Format Element^Greenstone2 equivalent^Description^ | ^Format Element^Greenstone2 equivalent^Description^ | ||
| ||| | | ||| | ||
- | |''< | ||
|''< | |''< | ||
|''< | |''< | ||
|''< | |''< | ||
|''< | |''< | ||
- | |''< | + | |
+ | ==== Miscellaneous Things ==== | ||
+ | ^Format Element^Greenstone2 equivalent^Description^ | ||
+ | | ||| | ||
+ | |''< | ||
|''< | |''< | ||
+ | |''< | ||
+ | |||
- | ===== Conditional | + | ==== Conditional ==== |
^Format Element^Greenstone2 equivalent^Description^ | ^Format Element^Greenstone2 equivalent^Description^ | ||
| ||| | | ||| | ||
Line 165: | Line 183: | ||
- | ====Preprocess Options | + | ===Preprocess Options === |
The preprocess attribute specifies something to do to the metadata value before performing the test. For example, you may want to lower case the value before comparing it to your text string. That way you don't need to worry about handling case variation in the metadata value. | The preprocess attribute specifies something to do to the metadata value before performing the test. For example, you may want to lower case the value before comparing it to your text string. That way you don't need to worry about handling case variation in the metadata value. | ||
Line 179: | Line 197: | ||
- | ==== Test options | + | === Test options === |
Sometimes you may want to output different things depending on the value of the metadata element. There are many tests you can make on the metadata value, listed below, which are specified using the test attribute. They all take a second parameter, specified using the test-value attribute, which is the value to compare to (with the exception of exists, which needs no test value). The preprocessing | Sometimes you may want to output different things depending on the value of the metadata element. There are many tests you can make on the metadata value, listed below, which are specified using the test attribute. They all take a second parameter, specified using the test-value attribute, which is the value to compare to (with the exception of exists, which needs no test value). The preprocessing | ||
option, if specified, is carried out first, before performing the test. | option, if specified, is carried out first, before performing the test. | ||
Line 199: | Line 217: | ||
- | ===== Iteration | + | ==== Iteration ==== |
^Format Element^Greenstone2 equivalent^Description^ | ^Format Element^Greenstone2 equivalent^Description^ | ||
| ||| | | ||| | ||
Line 206: | Line 224: | ||
- | ==== gsf: | + | === gsf: |
^gsf: | ^gsf: | ||
Line 220: | Line 238: | ||
|sort|true|Sort the metadata values (alphabetically, | |sort|true|Sort the metadata values (alphabetically, | ||
- | ==== gsf:sort attributes | + | === gsf:sort attributes === |
^gsf:sort Attribute^Possible Values^Description^ | ^gsf:sort Attribute^Possible Values^Description^ | ||
Line 229: | Line 247: | ||
|data-type|text/ | |data-type|text/ | ||
- | ===== Additional Notes ===== | + | ==== Additional Notes ==== |
Some of these options (< | Some of these options (< |
en/user/gs3_list_of_format_options.txt · Last modified: 2024/03/11 20:16 by kjdon