ESciDoc Services CitationStyleManager

From MPDLMediaWiki
Revision as of 14:12, 25 April 2012 by Webers (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
eSciDoc SOA

SOAP and REST style interfaces
Service layers

Core services
Context Handler · Item Handler
Container Handler
Organizational Unit Handler
User Account Handler
Authentication
Content Model Handler
Semantic Store Handler

Intermediate services
Validation Service
Statistics Manager
Technical Metadata extraction
PIDManager
Basket Handler
Duplication detection
ImageHandler(Digilib)

Application services
Depositing
Searching
Search&Export
Control of Named Entities
Citation style Manager
RightsChecking
DataAcquisition
Transformation
Fledged Data
PID Cache
OAI-PMH

SOA Introduction

edit

Work in progress

ID (Label)[edit]

CSM

Complete Name[edit]

Citation Style Manager Service

Status[edit]

Implemented.

Description[edit]

This service formats the descriptive metadata of a content item (or a list of content items) in accordance with specific citation style definition for styles such as APA, MLA, Chicago, MPG Yearbook citation style and others and generates a file with specific output format such as RTF, ODT, PDF or HTML. Currently implemented style definitions: APA, AJP

Operations[edit]

Operation Status Input Output Description
explainStyles implemented none List of styles and supported output formats in accordance with the explain_styles.xsd This operation retrieves a list of supported citation styles and for each of them supported output format such as RTF, PDF, HTML, ODT, SNIPPET.
getOutput implemented String citationStyle

String outputFormat
String itemList

byte [] The service takes as an input citationStyle identifier, an output format identifier and a list of content items and returns a byte array with metadata formatted in accordance with selected citation style and output format.

Note: in future it is planned to return a URL from where the temporary file can be downloaded.

isCitationStyle implemented String citationStyle boolean The method returns true if citationStyle is in the list of available citation styles, false otherwise
getStyles implemented none String[] The method returns the list of available citation styles
getOutputFormats implemented String citationStyle String[] The method returns the list of available output formats for citationStyle
getMimeType implemented String citationStyle
String outputFormat
String The method returns the mime-type for citationStyle and outputFormat

Output formats[edit]

snippet[edit]

is an XML format of the data, defined by the eSciDoc Item.xsd schema. It is enriched with the HTML formatted output of the selected citation style e.g. APA as

<dcterms:bibliographicCitation/>

in the

<content-model-specific/>

part of the item XML representation.

Example:

<dcterms:bibliographicCitation xmlns:dcterms="http://purl.org/dc/terms/">
  <![CDATA[
    <span class="Default">Sengbusch, R. v.
      <span class="DisplayDateStatus"> (1963).</span> 
    </span>
    <span class="Italic">FISCHE "OHNE GRÄTEN".</span>
    <span class="Default"><br/></span>
  ]]>
</dcterms:bibliographicCitation>

html_plain[edit]

is a list of exported citations in plain HTML format with basic formatting. Any formatted element of the citation is surrounded with classed tag, thereby it can be referenced by css selector later in local CMS system:

<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   </head>
   <body>
      <div class="Pubman">
         <p>Eisner, F., Weber, A., & Melinger, A. <span class="DisplayDateStatus">(2010).</span> Generalization of learning in pre-lexical
            adjustments to word-final devoicing [Abstract].<span class="Italic"><i> Journal of the Acoustical Society of America</i></span>,
            <span class="Italic"><i>128</i></span>, 2323. doi:10.1121/1.3508195.
         </p>

         <p>Brandmeyer, A., Sadakata, M., Timmers, R., & Desain, P. <span class="DisplayDateStatus">(2010).</span> Learning expressive
            percussion performance under different visual feedback conditions.<span class="Italic"><i> Psychological Research. Advance
            online publication</i></span>. doi:10.1007/s00426-010-0291-6.
         </p>
         <p>Abadie, J., Abbott, B., Abbott, R., Accadia, T., Acernese, F., Adhikari, R., Ajith, P., Allen, B., Allen, G., Ceron, E. A.,
            Amin, R. S., Anderson, S. B., Anderson, W. G., Antonucci, F., Aoudia, S., Arain, M. A., Araya, M., Arun, K. G., Aso, Y., Aston,
            S., et al. <span class="DisplayDateStatus">(2010).</span> Search for gravitational-wave inspiral signals associated with short
            Gamma-Ray Bursts during LIGO's fifth and Virgo's first science run.<span class="Italic"><i> Astrophysical Journal</i></span>,
            <span class="Italic"><i>715</i></span>(2), 1453-1461. doi:10.1088/0004-637X/715/2/1453.
         </p>

         <p>Bishop, N. T., Gomez, R., Husa, S., Lehner, L., & Winicour, J. <span class="DisplayDateStatus">(2003).</span> A numerical
            relativistic model of a massive particle in orbit near a Schwarzschild black hole.<span class="Italic"><i> Physical Review
            D</i></span>, <span class="Italic"><i>68</i></span>.
         </p>

      </div>
   </body>
</html>

List of the possible class names is available in the global font styles definition XML or in the citation style specific font styles definition XML, e.g. for APA(CJK). Check @css-class attribute of the font-style element.

html_linked[edit]

is an output format similar to the html_plain format with additional links to the source item itself, attached components and external locators:

<html>
   <head>
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   </head>
   <body>
      <div class="Pubman">
         <p>Eisner, F., Weber, A., & Melinger, A. <span class="DisplayDateStatus">(2010).</span> Generalization of learning in pre-lexical
            adjustments to word-final devoicing [Abstract].<span class="Italic"><i> Journal of the Acoustical Society of America</i></span>,
            <span class="Italic"><i>128</i></span>, 2323. doi:10.1121/1.3508195.<br><a href="http://pubman.mpdl.mpg.de/pubman/item/escidoc:550547:6" class="Item">[Item] </a></p>

         <p>Brandmeyer, A., Sadakata, M., Timmers, R., & Desain, P. <span class="DisplayDateStatus">(2010).</span> Learning expressive
            percussion performance under different visual feedback conditions.<span class="Italic"><i> Psychological Research. Advance
            online publication</i></span>. doi:10.1007/s00426-010-0291-6.<br><a href="http://pubman.mpdl.mpg.de/pubman/item/escidoc:458242:4" class="Item">[Item] </a><a href="http://pubman.mpdl.mpg.de/pubman/item/escidoc:458242:4/component/escidoc:551571/Brandmeyer_Learning expressive percussion_Psych_Res_advance_online.pdf" class="File">[File 1]</a></p>

         <p>Bishop, N. T., Gomez, R., Husa, S., Lehner, L., & Winicour, J. <span class="DisplayDateStatus">(2003).</span> A numerical
            relativistic model of a massive particle in orbit near a Schwarzschild black hole.<span class="Italic"><i> Physical Review
            D</i></span>, <span class="Italic"><i>68</i></span>.<br><a href="http://pubman.mpdl.mpg.de/pubman/item/escidoc:151751:2" class="Item">[Item] </a><a href="http://pubman.mpdl.mpg.de/pubman/item/escidoc:151751:2/component/escidoc:151750/50946.pdf" class="File">[File 1]</a></p>

      </div>
   </body>
</html>

pdf, rtf, odt, html_styled[edit]

are output formats for the formatted list of selected citation style, presented as paginated (except html_styled format ) report.

Service interfaces[edit]

  • export manager

Download[edit]

Future Development[edit]

  • new citation styles (AJP, etc.)
  • creation of the more sophisticated semantic JUnit tests
  • command-line based workflow for creation and testing of the new citation styles
  • Citation Manager Library WEB Interface, further development