Home Reference Source Repository

referencers/iso690fr.js

/**
 * iso690 bibliographic norm formatter (lang: fr)
 * @module referencers/iso690fr
 * @todo Not finished resourceType-to-citation mapping (documented properly only books and journal articles - setup a default presentation for others)
 * Doc 1 : http://revues.refer.org/telechargement/fiche-bibliographie.pdf
 * Doc 2 : https://www.mpl.ird.fr/documentation/download/FormBibliog.pdf
 */

import React from 'react';
import {InlineCitationModel, BlockCitationModel} from './../core/utils/citationUtils/citationModels.js';
import {
  StructuredPerson,
  StructuredDate,
  StructuredParentJournal,
  StructuredSpan,
  StructuredPublisher,
  StructuredCite
} from './../core/components/';
import Radium from 'radium';

/**
 * Renders additionnal citation information, such as pages mentions, translations, etc.
 * @param {Object} props - the React element props
 * @return {ReactElement} markup
 */
const renderAdditionnal = (props) =>{
  const details = props.contextualization.contextualizer;
  if (!details) {
    return '';
  }
  return (
    <span className="peritext-citation-details">
      {details.page || details.pages || props.resource.caption || props.resource.note || props.resource.translation || props.resource.original ? ', ' : ''}
      {details.page ?
        <span className="peritext-citation-quote-pages">
        p. {details.page}
        </span>
       : ''}
       {details.pages ?
        <span className="peritext-citation-quote-pages">
        pp. {details.pages}
        </span>
       : ''}
       {(details.page || details.pages) && props.resource.caption ? ', ' : ''}
       {props.resource.caption ?
        <StructuredSpan htmlClass="peritext-citation-comment" property="comment" value={props.resource.caption} />
       : ''}
       {(details.page || details.pages) && props.resource.note ? ', ' : ''}
       {props.resource.note ?
        <StructuredSpan htmlClass="peritext-citation-comment" property="comment" value={props.resource.note} />
       : ''}
       {props.resource.translation ?
          <span className="peritext-citation-translation">
            . Traduction : <q>details.translation</q>
          </span>
          : ''
        }
       {props.resource.translation ?
          <span className="peritext-citation-original">
            . Citation originale : <q>details.original</q>
          </span>
          : ''
        }
    </span>
  );
};

/**
 * Dumb component for rendering a iso690fr block citation
 */
@Radium
export class BlockCitation extends BlockCitationModel {
  /**
   * constructor
   * @param {object} props
   */
  constructor() {
    super();
  }
  /**
   * Renders additionnal citation information, such as pages mentions, translations, etc.
   */
  renderAdditionnal = renderAdditionnal;
  /**
   * Renders the representation of involved author (from resource), for long citations outputs
   * @return {ReactElement} markup
   */
  renderAuthors() {
    const pattern = '${lastName:capitals}, ${firstName}';
    if (this.props.resource.author && this.props.resource.author.length <= 2) {

      return (<span className="peritext-citation-authors">
          {this.props.resource.author.map((author, index) => {
            return (
                <span key={author.citeKey}>
                  <StructuredPerson resource={author} pattern={pattern} property="author" />
                  {(index < this.props.resource.author.length - 1) ? ' et ' : ''}
                </span>
              );
          })}
      </span>);
    } else if (this.props.resource.author) {
      return (
          <span className="peritext-citation-authors">
            <StructuredPerson resource={this.props.resource.author[0]} pattern={pattern} property="author" />
            <i className="peritext-citation-etal">et al.</i>
          </span>
      );
    }
    return '';
  }

  /**
   * Renders the complete reference of a resource
   * @return {ReactElement} markup
   */
  renderCompleteReference() {
    switch (this.props.resource.bibType) {
    /* case book not set because is default for now
    case 'book':
    break;*/
    case 'article':
      if (this.props.opCit === true) {
        return (
          <span className="peritext-citation-detailed-reference-container">
            {this.renderAuthors()}, <i className="peritext-citation-opcit">op.cit.</i>
          </span>
        );
      }
      const pages = (Array.isArray(this.props.resource.pages)) ? this.props.resource.pages : this.props.resource.pages.split('-');
      return (
        <span className="peritext-citation-detailed-reference-container">
          {this.renderAuthors()}
          <span>. </span>
          <StructuredCite value={this.props.resource.title} />
          <span>. </span>
          <StructuredParentJournal resource={this.props.resource} pattern="${journal}, ${date}, vol. ${volume}, n° ${issue}, ISSN : ${issn}" />
          {this.props.resource.pages ? ', pp. ' : ''}
          {this.props.resource.pages ? <StructuredSpan htmlClass="peritext-citation-pages-in-publication" property="pageStart" value={pages[0]} /> : ''}
          {this.props.resource.pages ? '-' : ''}
          {this.props.resource.pages ? <StructuredSpan htmlClass="peritext-citation-pages-in-publication" property="pageEnd" value={pages[1]} /> : ''}
        </span>
      );
    default:
      if (this.props.opCit === true) {
        return (
          <span className="peritext-citation-detailed-reference-container">
            {this.renderAuthors()}, <i className="peritext-citation-opcit">op.cit.</i>
          </span>
        );
      }
      return (
        <span className="peritext-citation-detailed-reference-container">
          {this.renderAuthors()}
          {this.props.resource.author ? <span>. </span> : ''}
          <StructuredCite value={this.props.resource.title} />
          {this.props.resource.edition ? '. ' : ''}
          {this.props.resource.edition ? <StructuredSpan htmlClass="peritext-citation-publication-edition" property="bookEdition" value={this.props.resource.edition} /> : ''}
          {this.props.resource.publisher ? '. ' : ''}
          {this.props.resource.publisher ? <StructuredPublisher resource={this.props.resource} /> : ''}
          {this.props.resource.year || this.props.resource.date ? ', ' : ''}
          {this.props.resource.year || this.props.resource.date ? <StructuredSpan htmlClass="peritext-citation-publication-edition" property="datePublished" value={(this.props.resource.year || this.props.resource.date)} /> : ''}
        </span>
      );
    }
  }

  /**
   * Renders additionnal reference information (isbn, doi, url)
   * @return {ReactElement} markup
   */
  renderReferenceDecoration() {
    if (this.props.resource.isbn || this.props.resource.url || this.props.resource.doi) {
      return (
        <span className="peritext-citation-reference-decoration-container">
          {this.props.resource.isbn ? '. ISBN : ' : ''}
          {this.props.resource.isbn ? <StructuredSpan htmlClass="peritext-citation-isbn" property="isbn" value={this.props.resource.isbn} /> : ''}
          {this.props.resource.doi ? '. DOI : ' : ''}
          {this.props.resource.doi ?
            <a className="peritext-citation-doi" target="blank" itemProp="sameAs" property="sameAs" href={this.props.resource.doi}>
              {this.props.resource.doi}
            </a> : ''}
          {this.props.resource.doi ? '. Accessible en ligne : ' : ''}
          {this.props.resource.doi ?
            <a className="peritext-citation-url" target="blank" itemProp="url" property="url" href={this.props.resource.url}>
              {this.props.resource.url}
            </a> : ''}
        </span>
      );
    }
  }

  /**
   * Renders final markup of the contextualization
   * @return {ReactElement} markup
   */
  renderReference() {
    return (
      <span
        className="peritext-citation-reference-container"
      >
        {this.props.ibid === true ?
          <i
            className="peritext-citation-ibid"
          >
            ibid.
          </i> : ''}
        {this.renderCompleteReference()}
        {this.renderReferenceDecoration()}
        <span>.</span>
      </span>
    );
  }
}


/**
 * Dumb component for rendering a iso690fr inline citation
 */
@Radium
export class InlineCitation extends InlineCitationModel {
  /**
   * constructor
   * @param {object} props
   */
  constructor() {
    super();
  }

  /**
   * Renders additionnal citation information, such as pages mentions, translations, etc.
   */
  renderAdditionnal = renderAdditionnal;

  /**
   * Renders the representation of involved author (from resource), for short citations outputs
   * @return {ReactElement} markup
   */
  renderAuthors() {
    if (this.props.resource.author.length <= 2) {
      return this.props.resource.author.map((author, index) => {
        return (
          <span key={author.citeKey} className="peritext-citation-authors">
            <StructuredPerson resource={author} pattern="${lastName:capitals}" property="author" />
            {(index < this.props.resource.author.length - 1) ? ' et ' : ''}
          </span>
        );
      });
    }
    return (
        <span className="peritext-citation-authors">
          <StructuredPerson resource={this.props.resource.author[0]} pattern="${lastName:capitals}" property="author" />
          <i className="peritext-citation-et-al">et al.</i>
        </span>
    );
  }

  /**
   * Renders final markup of the contextualization
   * @return {ReactElement} markup
   */
  renderReference() {
    if (this.props.ibid === true) {
      return (
        <span className="peritext-citation-brief-reference">
          <i
            className="peritext-citation-ibid"
          >
            ibid.
          </i>
        </span>
      );
    } else if (this.props.opCit === true) {
      return (
        <span className="peritext-citation-brief-reference">
          {this.renderAuthors()}
          <span>, </span>
          <i
            className="peritext-citation-opcit"
          >
            op.cit.
          </i>
        </span>
      );
    } else if (this.props.resource.date !== undefined || this.props.resource.year !== undefined) {
      const value = this.props.resource.date || this.props.resource.year;
      return (
        <span className="peritext-citation-brief-reference">
          {this.renderAuthors()}
          <span>, </span>
          <StructuredDate value={value} modificator="year" />
          <span className="peritext-citation-year-suffix">{this.props.contextualization.yearSuffix}</span>
        </span>
      );
    }
    return (
      <span className="peritext-citation-brief-reference">
        {this.renderAuthors()}
      </span>
    );
  }
}