Class: BibSonomy::CSL

Inherits:
Object
  • Object
show all
Defined in:
lib/bibsonomy/csl.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(user_name, api_key) ⇒ CSL

Create a new BibSonomy instance.

Parameters:



76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/bibsonomy/csl.rb', line 76

def initialize(user_name, api_key)
  super()
  @bibsonomy = BibSonomy::API.new(user_name, api_key, 'csl')
  # setting some defaults
  @style = 'apa.csl'
  @pdf_dir = nil
  @css_class = 'publications'
  @year_headings = true
  @public_doc_postfix = '_oa.pdf'

  # optional parts to be rendered (or not)
  @doi_link = true
  @url_link = true
  @bibtex_link = true
  @bibsonomy_link = true
  @opt_sep = ' | '
end

Instance Attribute Details

Returns whether links to BibSonomy shall be rendered. (default: true).

Returns:

  • (Boolean) —

    whether links to BibSonomy shall be rendered. (default: true)



60
61
62
 
# File 'lib/bibsonomy/csl.rb', line 60

def bibsonomy_link
  @bibsonomy_link
end

#bibtex_link ⇒ Boolean

Returns whether links to the BibTeX data of a post (in BibSonomy) shall be rendered. (default: true).

Returns:

  • (Boolean) —

    whether links to the BibTeX data of a post (in BibSonomy) shall be rendered. (default: true)



57
58
59
 
# File 'lib/bibsonomy/csl.rb', line 57

def bibtex_link
  @bibtex_link
end

#css_class ⇒ String

Returns the CSS class used to render the surrounding ‘<ul>` list (default: ’publications’).

Returns:

  • (String) —

    the CSS class used to render the surrounding ‘<ul>` list (default: ’publications’)



48
49
50
 
# File 'lib/bibsonomy/csl.rb', line 48

def css_class
  @css_class
end

#doi_link ⇒ Boolean

Returns whether links for DOIs shall be rendered. (default: true).

Returns:

  • (Boolean) —

    whether links for DOIs shall be rendered. (default: true)



51
52
53
 
# File 'lib/bibsonomy/csl.rb', line 51

def doi_link
  @doi_link
end

#opt_sep ⇒ String

Returns the separator between options. (default: ‘ | ’).

Returns:

  • (String) —

    the separator between options. (default: ‘ | ’)



63
64
65
 
# File 'lib/bibsonomy/csl.rb', line 63

def opt_sep
  @opt_sep
end

#pdf_dir ⇒ String

Returns the output directory for downloaded PDF files. If set to nil, no documents are downloaded. (default: nil).

Returns:

  • (String) —

    the output directory for downloaded PDF files. If set to nil, no documents are downloaded. (default: nil)



39
40
41
 
# File 'lib/bibsonomy/csl.rb', line 39

def pdf_dir
  @pdf_dir
end

#public_doc_postfix ⇒ String

Returns When a post has several documents and the filename of one of them ends with public_doc_postfix, only this document is downloaded and linked, all other are ignored. (default: ‘_oa.pdf’).

Returns:

  • (String) —

    When a post has several documents and the filename of one of them ends with public_doc_postfix, only this document is downloaded and linked, all other are ignored. (default: ‘_oa.pdf’)



69
70
71
 
# File 'lib/bibsonomy/csl.rb', line 69

def public_doc_postfix
  @public_doc_postfix
end

#style ⇒ String

Returns the / CSL style used for rendering. (default: apa.csl).

Returns:

  • (String) —

    the / CSL style used for rendering. (default: apa.csl)



42
43
44
 
# File 'lib/bibsonomy/csl.rb', line 42

def style
  @style
end

#url_link ⇒ Boolean

Returns whether URLs of posts shall be rendered. (default: true).

Returns:

  • (Boolean) —

    whether URLs of posts shall be rendered. (default: true)



54
55
56
 
# File 'lib/bibsonomy/csl.rb', line 54

def url_link
  @url_link
end

#year_headings ⇒ Boolean

Returns whether year headings shall be rendered. (default: true).

Returns:

  • (Boolean) —

    whether year headings shall be rendered. (default: true)



45
46
47
 
# File 'lib/bibsonomy/csl.rb', line 45

def year_headings
  @year_headings
end

Instance Method Details

#render(user, tags, count) ⇒ String

Download count posts for the given user and ‘tag(s)` and render them with / CSL.

Parameters:

  • user (String) —

    the name of the posts’ owner

  • tags (Array<String>) —

    the tags that all posts must contain (can be empty)

  • count (Integer) —

    number of posts to download

Returns:

  • (String) —

    the rendered posts as HTML



101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
 
# File 'lib/bibsonomy/csl.rb', line 101

def render(user, tags, count)
  # get posts from BibSonomy
  posts = JSON.parse(@bibsonomy.get_posts_for_user(user, 'publication', tags, 0, count))

  # render them with citeproc
  cp = CiteProc::Processor.new style: @style, format: 'html'
  cp.import posts

  # to check for duplicate file names
  file_names = []

  # sort posts by year
  sorted_keys = posts.keys.sort { |a,b| get_sort_posts(posts[b], posts[a]) }

  result = ""

  # print first heading
  last_year = 0

  if @year_headings and sorted_keys.length > 0
    last_year = get_year(posts[sorted_keys[0]])
    result += "<h3>" + last_year + "</h3>"
  end

  result += "<ul class='#{@css_class}'>\n"
  for post_id in sorted_keys
    post = posts[post_id]

    # print heading
    if @year_headings
      year = get_year(post)
      if year != last_year
        last_year = year
        result += "</ul>\n<h3>" + last_year + "</h3>\n<ul class='#{@css_class}'>\n"
      end
    end

    # render metadata
    csl = cp.render(:bibliography, id: post_id)
    result += "<li class='" + post["type"] + "'>#{csl[0]}"

    # extract the post's id
    intra_hash, user_name = get_intra_hash(post_id)

    # optional parts
    options = []
    # attach documents
    if @pdf_dir
      for doc in get_public_docs(post["documents"])
        # fileHash, fileName, md5hash, userName
        file_path = get_document(@bibsonomy, intra_hash, user_name, doc, @pdf_dir, file_names)
        options << "<a href='#{file_path}'>PDF</a>"
      end
    end
    # attach DOI
    doi = post["DOI"]
    if @doi_link and doi != ""
      options << "DOI:<a href='http://dx.doi.org/#{doi}'>#{doi}</a>"
    end
    # attach URL
    url = post["URL"]
    if @url_link and url != ""
      options << "<a href='#{url}'>URL</a>"
    end
    # attach BibTeX
    if @bibtex_link
      options << "<a href='http://www.bibsonomy.org/bib/publication/#{intra_hash}/#{user_name}'>BibTeX</a>"
    end
    # attach link to BibSonomy
    if @bibsonomy_link
      options << "<a href='http://www.bibsonomy.org/publication/#{intra_hash}/#{user_name}'>BibSonomy</a>"
    end

    # attach options
    if options.length > 0
      result += " <span class='opt'>[" + options.join(@opt_sep) + "]</span>"
    end

    result += "</li>\n"
  end
  result += "</ul>\n"

  return result
end