User Tools

Site Tools


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
Next revisionBoth sides next revision
en:beginner:customization [2023/03/13 01:46] – external edit 127.0.0.1en:beginner:customization [2023/03/13 20:43] – [Customization] kjdon
Line 11: Line 11:
 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:
-  * The [[en:directory_structure|directory structure]] page can help you locate important files and folders in your installation.+ <!-- * The [[en:directory_structure|directory structure]] page can help you locate important files and folders in your installation.-->
   * Understanding how Greenstone URLs ([[en:user:gs3_urls|gs3]], [[en:user:gs2_urls|gs2]]) work, including CGI arguments, can help you create links to various pages in your collection.   * Understanding how Greenstone URLs ([[en:user:gs3_urls|gs3]], [[en:user:gs2_urls|gs2]]) work, including CGI arguments, can help you create links to various pages in your collection.
   * Knowing the [[en:user:configuration_files|files that configure]] specific aspects of your installation is very important as you begin to customize.   * Knowing the [[en:user:configuration_files|files that configure]] specific aspects of your installation is very important as you begin to customize.
Line 19: Line 19:
  
  
-<tabbox Greenstone3+=====Greenstone3===== 
-===== Site, interfaces, and libraries =====+==== Site, interfaces, and libraries ====
 Sites and interfaces contain the content and presentation information, respectively,  Sites and interfaces contain the content and presentation information, respectively, 
 for the digital library.   for the digital library.  
Line 52: Line 52:
 Finally, every site-interface combination you create is considered a **library**  Finally, every site-interface combination you create is considered a **library** 
 (in technical terms, each library is actually a servlet). (in technical terms, each library is actually a servlet).
-<tabbox Greenstone2+=====Greenstone2===== 
-===== Collection level vs. library level =====+==== 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 60:
 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:user:gs2_format_statements|format statements]],  The //content// of a Greenstone collection is handled by [[en:user:gs2_format_statements|format statements]], 
 which can be modified in the GLI (under ''Format -> Format Features''). So, if you want to change how documents appear which can be modified in the GLI (under ''Format -> Format Features''). So, if you want to change how documents appear
Line 66: Line 66:
 to make changes. to make changes.
  
-===== Macros =====+==== Macros ====
  
 Greenstone2 is built on [[en:user:macros|macros]], which look like ''_this_'' and basically stand for Greenstone2 is built on [[en:user:macros|macros]], which look like ''_this_'' and basically stand for
 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 101:
   * [[https://cheatsheetseries.owasp.org/cheatsheets/Cross_Site_Scripting_Prevention_Cheat_Sheet.html|OWASP XSS cheat sheet]]   * [[https://cheatsheetseries.owasp.org/cheatsheets/Cross_Site_Scripting_Prevention_Cheat_Sheet.html|OWASP XSS cheat sheet]]
  
-</tabbox>+
  
 ===== Useful Links for Customisation ===== ===== Useful Links for Customisation =====
en/beginner/customization.txt · Last modified: 2023/03/13 20:51 by kjdon