Editing My First Bazaar Package (section)

= Adding the missing phrases=

As EPrints is designed to be multi-language, phrases should be used instead of embedded text.

In this section we add the phrase file to define a title and a description for our screen.

Create the English language directory that will contain the package's English language phrase file:

 $ mkdir -p lib/lang/en/phrases/

Create a phrase file:

 $ gedit lib/lang/en/phrases/hello_world.xml

<source lang="xml">
  <?xml version="1.0" encoding="iso-8859-1" standalone="no" ?>
  <!DOCTYPE phrases SYSTEM "entities.dtd">
  
  <epp:phrases xmlns="http://www.w3.org/1999/xhtml" xmlns:epp="http://eprints.org/ep3/phrase" xmlns:epc="http://eprints.org/ep3/control">
 
        <epp:phrase id="Plugin/Screen/Hello:title">Hello</epp:phrase>
        <epp:phrase id="Plugin/Screen/Hello:description">My First Bazaar Package</epp:phrase>
        
        <epp:phrase id="Plugin/Screen/Hello:text">Hello World - This is the my first bazaar package calling.</epp:phrase>
 
  </epp:phrases>
</source>
 
Don't worry too much about the wrapping here, the important thing is the phrases of which we have created 3. 

Note that 2 of these (the top 2) will get used instantly by our package however the 3rd needs to be added to the render method of our screen. 

In order to do this edit the Hello.pm screen created in Step 1 and add the following in the appropriate place in the render method.

  $frag->appendChild($repository->xml->create_element("br"));
  $frag->appendChild($self->html_phrase("text"));

For some hints on loading and manipulating EPrints see [[Manipulating eprints in 3.2]].

'''Don't Forget''' to add the phrase file to your bazaar package using the developer tools tab and commit them to git!

'''WARNING: if your package overrides any existing EPrints phrases then your overrides will be applied to ALL repositories even if they have not enabled your package. In this case you would add your override phrases to a separate file - eg. lib/epm/hello_world/cfg/lang/en/phrases/hello_world_overrides.xml - this file will then only be considered when a repository enables your package.



[[Category:EPrints_Bazaar]]