Editing Views.pl (section)

==EPrints 3.2 example==
===cfg/cfg.d/views.pl===
  { id         => "target",  # The 'name' for this view
    allow_null => 0,
    hide_empty => 1,
    menus      => [
      { fields => ["broker_reponame"], # The field(s) to use - in this case the 'reponame' sub-element of the 'broker' field
        new_column_at      => [0],    # force 2 columns, even if the
                                      # second is blank
        mode               => "sections",
        open_first_section => 1,
        group_range_function   => "EPrints::Update::Views::cluster_ranges_30",
        group_sorting_function => "EPrints::Update::Views::default_sort",
      },
    ],
    order => "-date/title",
    citation => 'router',    # This defines the file in cfg/citations/eprint/
    layout   => 'router',    # This is used in Views.pm to determine how to
                             # join individual citations together...
  },

This creates a view, which will be 2-columns wide.
Two important definitions here are:
* '''citation''' defines the citation file used to create the block of html for each record to be displayed, and
* '''layout''' indicates how those blocks are joined together.

====Layout====
'''Layout''' can be one of:
* paragraph (the default)
puts &lt;p> elements round each citation

* orderedlist
makes an ordered list (1,2,3,4 or whatever the CSS defines)

* unorderedlist
makes an unordered list

* ''anything else''
just puts a newline (in the page source) after each citation

====citation====
In our example, we're using a home-made citation layout

The citation file is in <code>/cfg/citations/eprint/</code>

In the above view, we have defined the citation format to be '''router''', therefore we need a file called '''router.xml''' in the citations directory.

Remember this format is used for each record, so needs to be complete in it's own right - and if you want records to line up vertically, you need to plan that in advance.


    &lt;?xml version="1.0" ?>
    &lt;!-- 
  	Full citation for an eprint. 
    -->
    &lt;cite:citation xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns="http://eprints.org/ep3/control" xmlns:cite="http://eprints.org/ep3/citation" >
    &lt;table class='ep_rt_citation'>;
    &lt;tr>&lt;td colspan='2'>
    &lt;choose>
      &lt;when test="type = 'book' and is_set( creators )">
        &lt;span class='strong'>&lt;print expr="creators_name"/></span>
      &lt;/when>
      .... more code ....
    &lt;/choose>
    &lt;/td>&lt;td style="width:8em">
    &lt;if test="date">&lt;span class='right strong'>(&lt;print expr="date" opts="res=year"/>)&lt;/span>&lt;/if>
    &lt;/td>&lt;/tr>
    &lt;tr>&lt;td style="width:50%">
      &lt;cite:linkhere>&lt;xhtml:em>&lt;print expr="title" opts="magicstop"/>&lt;/xhtml:em>&lt;/cite:linkhere>
    &lt;/td>
    &lt;choose>
     .... more code
    &lt;when test="type = 'article'">
    &lt;td>
      &lt;if test="publication">&lt;print expr="publication"/>
        &lt;if test="volume">, &lt;print expr="volume"/>&lt;/if>
        &lt;if test="number"> (&lt;print expr="number"/>)&lt;/if>
        .&lt;/if>
      &lt;if test="pagerange"> &lt;print expr="pagerange"/>.&lt;/if>
      &lt;/td>&lt;td>
      &lt;if test="issn"><span class='right'> ISSN <print expr="issn"/></span></if>
      &lt;/td>
    &lt;/when>
    .... more code
  &lt;/choose>
  &lt;/tr>
  &lt;if test=" ! type.one_of( 'patent','thesis' )">
    &lt;if test="ispublished.one_of('unpub', 'submitted', 'inpress')">
    &lt;tr>&lt;td colspan='2'>
     (&lt;print expr="ispublished"/>)
    &lt;/td>&lt;/tr>
    &lt;/if>
  &lt;/if>
  &lt;/table>
  &lt;/cite:citation>

This creates a table for each record, and CSS is used to manage the size & position of the various elements

===cfg/cfg.d/eprint_render.pl===
When viewing a record, the main abstract view page can also be altered

In <code>cfg/cfg.d/eprint_render.pl</code>, towards the bottom of the subroutine <code>$c->{eprint_render}</code> is the following line:

   my $page = $eprint->render_citation( "router_page", %fragments, flags=>$flags );

Here, '''router_page''' is the name of the citation file for creating the abstract page..... '''router_page.xml''' in this case