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 [2018/10/29 20:37] – [List of Greenstone3 Format Items] kjdon | en:user:gs3_list_of_format_options [2019/10/21 21:41] – [Additional Notes] kjdon | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== List of Greenstone3 Format Items ====== | ====== List of Greenstone3 Format Items ====== | ||
- | The full list of formatting items is shown here. There are three main types of format items: options, parameter defaults, and templates. | + | This page describes all the things that can go into the <format> element in the collectionConfig.xml file - or can be added in the Format-> |
+ | |||
+ | 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 164: | 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 178: | 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 198: | Line 217: | ||
- | ===== Iteration | + | ==== Iteration ==== |
^Format Element^Greenstone2 equivalent^Description^ | ^Format Element^Greenstone2 equivalent^Description^ | ||
| ||| | | ||| | ||
Line 205: | Line 224: | ||
- | ==== gsf: | + | === gsf: |
^gsf: | ^gsf: | ||
Line 219: | 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 228: | Line 247: | ||
|data-type|text/ | |data-type|text/ | ||
- | ===== Additional Notes ===== | + | ==== Utility Functions ==== |
+ | |||
+ | There are many utility functions defined in src/ | ||
+ | |||
+ | They can be called explicitly using | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | args is a comma separated list of args. They can be XSLT variables, numbers, strings, XSLT elements/ | ||
+ | |||
+ | For example: | ||
+ | < | ||
+ | < | ||
+ | The collection was last built on < | ||
+ | </ | ||
+ | |||
+ | This code is getting the buildDate timestamp from collection metadata. Then it is formatting it using the formatTimeStamp function. | ||
+ | This function takes 4 arguments: | ||
+ | * the timestamp - here we use the raw_date variable we have just made | ||
+ | * an integer for timestamp type - 0 is seconds, 1 is milliseconds | ||
+ | * an integer for output format tupe - 0 is date, 1 is time, 2 is date and time, 3 is days ago | ||
+ | * the language code for which language you want the output in - here we use the attribute from the page element. | ||
+ | |||
+ | We could change this output to days ago: | ||
+ | The collection was last built < | ||
+ | |||
+ | ==== 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