Greenstone Wiki

User Tools

Site Tools

You are here: index » en » beginner » customization
en:beginner:customization

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
en:beginner:customization [2023/03/13 20:43] – [Customization] kjdonen:beginner:customization [2023/03/13 20:51] (current) – [Customizations] kjdon
Line 1: Line 1:
- 
  
  
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:user:interfaces|interface]]** is a set of images (and, potentially, CSS and Javascript) along+An **[[en:user:interfaces|interface]]** is a set of images, Css and Javascript along
 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**, which will HTML generally. XSLT (and therefore every Greenstone interface) is built around things called **templates**, which will
 tell Greenstone how to display pages depending on the content for that page (e.g. a document's metadata, tell Greenstone how to display pages depending on the content for that page (e.g. a document's metadata,
 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, which is especially useful for when you want to present the same content in different ways. In addition, multiple sites can make use of the same interface. The servlet configuration determines which libraries will be presented.
  
 //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 42: Line 47:
 make modifying or overriding an interface easier: make modifying or overriding an interface easier:
   * **[[en:user:themes|Themes]]**, are the easiest way to change how your library looks. The default Greenstone3 interface is built using JQuery themes, which allow you to change the color-scheme (as well as things like roundness of corners) effortlessly. While even advanced users will find themes useful, they are especially valuable for non-technical users, because they require //absolutely no// knowledge of CSS, HTML, or XSL   * **[[en:user:themes|Themes]]**, are the easiest way to change how your library looks. The default Greenstone3 interface is built using JQuery themes, which allow you to change the color-scheme (as well as things like roundness of corners) effortlessly. While even advanced users will find themes useful, they are especially valuable for non-technical users, because they require //absolutely no// knowledge of CSS, HTML, or XSL
-  * **[[en:user:gs3_format_statements|Format statements]]**: In many cases, if you do not know XSL, you can instead use [[en:user:gs3_format_statements|Greenstone's statement format (''gsf'')]], which Greenstone will translate (behind-the-scenes) into XSL. ''gsf'' syntax is XML-based. (If you don't know XML, don't worry; it looks and acts very similarly to HTML.)+  * **[[en:user:gs3_format_statements|Format statements]]**: In many cases, if you do not know XSL, you can instead use [[en:user:gs3_format_statements|Greenstone's format elements (''gsf'')]], which Greenstone will translate (behind-the-scenes) into XSL. ''gsf'' syntax is XML-based. (If you don't know XML, don't worry; it looks and acts very similarly to HTML.)
   * 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, which is especially useful for when you want to  +==== 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, +  * [[en:gli:format_panel| GLI's format panel]] 
-multiple sites can make use of the same interface. +  * [[en:user:gs3_format_statements|Format statements]] 
 +  * [[en:user:gs3_list_of_format_options|Full list of Format options]] 
 +  * [[en:user:gs3_sample_format_statements| Sample format statements]] 
 +  * [[en:user:themes|Themes]] 
 +  * [[en:user:interfaces| Customising the Greenstone 3 Interface]] 
 +  * [[en:user:gs3_sample_interface_modifications|Sample interface modifications]] 
 + 
 +//**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's Guide presents [[en:beginner:additional_topics|additional Greenstone topics]].**//
  
-Finally, every site-interface combination you create is considered a **library**  
-(in technical terms, each library is actually a servlet). 
 =====Greenstone2===== =====Greenstone2=====
 ==== Collection level vs. library level ==== ==== Collection level vs. library level ====
Line 103: Line 113:
  
  
-===== Useful Links for Customisation =====+====Useful Links ====
  
   * [[en:gli:format_panel| GLI's format panel]]   * [[en:gli:format_panel| GLI's format panel]]
- 
-**Greenstone3:** 
-  * [[en:user:gs3_format_statements|Format statements]] 
-  * [[en:user:gs3_list_of_format_options|Full list of Format options]] 
-  * [[en:user:gs3_sample_format_statements| Sample format statements]] 
-  * [[en:user:themes|Themes]] 
-  * [[en:user:interfaces| Customising the Greenstone 3 Interface]] 
-  * [[en:user:gs3_sample_interface_modifications|Sample interface modifications]] 
- 
-**Greenstone2:** 
   * [[en:user:gs2_format_statements|Format statements]]   * [[en:user:gs2_format_statements|Format statements]]
   * [[en:user:gs2_sample_format_statements| Sample format statements]]   * [[en:user:gs2_sample_format_statements| Sample format statements]]
en/beginner/customization.1678740191.txt.gz · Last modified: 2023/03/13 20:43 by kjdon