Editing Translation (section)

=== Setting document language ===

Each document file has its own language. The same document might be submitted in different languages. In the default Eprints workflow the reference to the language field is commented out; you only has to enable it. It is in file [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/workflows/eprint|cfg/workflows/eprint/default.xml]], stage "files":

 <stage name="files">
   <component type="XHTML">...</component>
   <component type="Upload">
      <field ref="format" />
      <field ref="formatdesc" />
      <field ref="security" />
      <field ref="license" />
      <field ref="date_embargo" />
      <field ref="language" /> &lt;!-- UNCOMMENT! --&gt;
  </component>
 </stage>

The default value is set in [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/cfg.d|cfg/cfg.d/document_fields_default.pl]] to the language of the session:

 $c->{set_document_defaults} = sub
 {
        my( $data, $session, $eprint ) = @_;
  ###### HERE:
        $data->{language} = $session->get_langid();
        $data->{security} = "public";
 };

The available language values are listed in [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/namedsets|cfg/namedsets/languages]], you might consider revising this set.
The "undefined" language is rendered as a question mark (?).

You might also want to print the language as well. To this end, edit the [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/citations/document|cfg/citations/document/default.xml]] file. Show the language only when it is set, and the document's mime type is ''text/plain'', ''application/pdf'', ''application/postscript'', ''application/msword'', or ''other''. (For a full list of available mime type see [[EPrints_Directory_Structure/eprints3/archives/ARCHIVEID/cfg/namedsets|cfg/namedsets/document]] )

 <cite:linkhere>...</cite:linkhere>
 <epc:if test="security != 'public'"> ... </epc:if>
 &lt;!-- NEW!!! --&gt;
 <epc:if test="is_set(language) and format.one_of( 'text/plain' ,
     'application/pdf', 'application/postscript', 'application/msword', 'other')" >
    <epc:phrase ref="citation:doc_language">
         <epc:param name="lang">
              <epc:print expr="language"/>
         </epc:param>
    </epc:phrase>
  </epc:if>

and, of course, one has to define the "citation:doc_language" phrase (see below) in all languages. In the phrase definition we have the pin "lang" which contains the document language in the actual language (defined as the phrase "<tt>languages_typename_XX</tt>"):

  <epp:phrase id="citation:doc_language">
    (The document's language is <epc:pin name="lang"/>.)
 </epp:phrase>

<span style="color: red; font-weight:bold">WARNING!</span> The example above works only after you've applied the "Citation phrases with embedded pins" patch in the [[#Patches|Patches]] section.