en:beginner:customization
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
en:beginner:customization [2023/03/13 01:46] – external edit 127.0.0.1 | en:beginner:customization [2023/03/13 20:49] – kjdon | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | |||
Line 11: | Line 10: | ||
There are a few pages that, though not directly concerned with customization, | There are a few pages that, though not directly concerned with customization, | ||
can be very useful during the process: | can be very useful during the process: | ||
- | | + | < |
* Understanding how Greenstone URLs ([[en: | * Understanding how Greenstone URLs ([[en: | ||
* Knowing the [[en: | * Knowing the [[en: | ||
Line 19: | Line 18: | ||
- | < | + | =====Greenstone3===== |
- | ===== Site, interfaces, and libraries | + | ==== Site, interfaces, and libraries ==== |
Sites and interfaces contain the content and presentation information, | Sites and interfaces contain the content and presentation information, | ||
for the digital library. | for the digital library. | ||
Line 28: | Line 27: | ||
You can have multiple separate sites in a single Greenstone3 installation. | You can have multiple separate sites in a single Greenstone3 installation. | ||
- | An **[[en: | + | An **[[en: |
with a set of XSLT files used for translating XML output from the library into an appropriate form -- | with a set of XSLT files used for translating XML output from the library into an appropriate form -- | ||
HTML generally. XSLT (and therefore every Greenstone interface) is built around things called **templates**, | HTML generally. XSLT (and therefore every Greenstone interface) is built around things called **templates**, | ||
tell Greenstone how to display pages depending on the content for that page (e.g. a document' | tell Greenstone how to display pages depending on the content for that page (e.g. a document' | ||
the names of the collections in your site, what browsing classifier have been defined, etc.). | the names of the collections in your site, what browsing classifier have been defined, etc.). | ||
+ | |||
+ | A **library** is a combination of one site with one interface - in technical terms, each library is a servlet. | ||
+ | |||
+ | You can create any number of interfaces in your Greenstone3 installation, | ||
//If all of that sounds really confusing, don't worry! | //If all of that sounds really confusing, don't worry! | ||
Unless you want to make extreme changes to an interface (or define your own), | Unless you want to make extreme changes to an interface (or define your own), | ||
you can largely avoid XSLT. // | you can largely avoid XSLT. // | ||
+ | |||
+ | ==== Customizations ==== | ||
While the interfaces (i.e. the files that dictate how each page looks) themselves are separate from the content, you can override any part of | While the interfaces (i.e. the files that dictate how each page looks) themselves are separate from the content, you can override any part of | ||
Line 45: | Line 50: | ||
* The GLI's **Format Features** section: The GLI provides an easy way to override parts of interface on a collection-level. Instead of having to create your own XSL files, you can type templates into the Format Features section of the Format panel. | * The GLI's **Format Features** section: The GLI provides an easy way to override parts of interface on a collection-level. Instead of having to create your own XSL files, you can type templates into the Format Features section of the Format panel. | ||
- | You can create any number of interfaces in your Greenstone3 installation, | + | ==== Useful Links==== |
- | present the same content in different ways. For example, you may want to provide two interfaces | + | |
- | for your sites: one interface for visitors using computers and another interface for mobile users. In addition, | + | |
- | multiple sites can make use of the same interface. | + | |
- | Finally, every site-interface combination you create is considered a **library** | + | |
- | (in technical terms, each library is actually | + | |
- | <tabbox Greenstone2> | + | |
- | ===== Collection level vs. library level ===== | + | |
+ | * [[en: | ||
+ | * [[en: | ||
+ | * [[en: | ||
+ | |||
+ | //**Now that you know the basics of using and customizing Greenstone, there are a few other features, functions, and resources you should be aware of. The final section of this Beginner' | ||
+ | |||
+ | =====Greenstone2===== | ||
+ | ==== Collection level vs. library level ==== | ||
Customization can be done at either collection level or library level. Any changes made in the GLI | Customization can be done at either collection level or library level. Any changes made in the GLI | ||
Line 60: | Line 70: | ||
enacted on a collection or library basis. | enacted on a collection or library basis. | ||
- | ===== Format Statements | + | ==== Format Statements ==== |
The //content// of a Greenstone collection is handled by [[en: | The //content// of a Greenstone collection is handled by [[en: | ||
which can be modified in the GLI (under '' | which can be modified in the GLI (under '' | ||
Line 66: | Line 76: | ||
to make changes. | to make changes. | ||
- | ===== Macros | + | ==== Macros ==== |
Greenstone2 is built on [[en: | Greenstone2 is built on [[en: | ||
a block of text or code. | a block of text or code. | ||
- | ===== Maintaining security when customising GS2 macros | + | ==== Maintaining security when customising GS2 macros ==== |
A large part of Greenstone 2's security against cross-site scripting (XSS) is implemented in Greenstone 2.87+ in the macros files. This means that if you are customising it by reusing macros such as in new forms or paragraphs, you will need to be aware of how to do so in a secure way. | A large part of Greenstone 2's security against cross-site scripting (XSS) is implemented in Greenstone 2.87+ in the macros files. This means that if you are customising it by reusing macros such as in new forms or paragraphs, you will need to be aware of how to do so in a secure way. | ||
Line 101: | Line 111: | ||
* [[https:// | * [[https:// | ||
- | </ | ||
- | ===== Useful Links for Customisation ===== | + | |
+ | ====Useful Links ==== | ||
* [[en: | * [[en: | ||
- | |||
- | **Greenstone3: | ||
- | * [[en: | ||
- | * [[en: | ||
- | * [[en: | ||
- | * [[en: | ||
- | * [[en: | ||
- | * [[en: | ||
- | |||
- | **Greenstone2: | ||
* [[en: | * [[en: | ||
* [[en: | * [[en: |
en/beginner/customization.txt · Last modified: 2023/03/13 20:51 by kjdon